Horton

Re: House style for DocBook documentation?

Chapman Flack <chap@anastigmatix.net>

View thread View on postgr.es
From: Chapman Flack <chap@anastigmatix.net>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>, Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Pavel Stehule <pavel.stehule@gmail.com>, Markus Winand <markus.winand@winand.at>, Tom Lane <tgl@sss.pgh.pa.us>, PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Date: 2019-03-08T04:04:07Z
Lists: pgsql-hackers 
On 02/15/19 11:31, Peter Eisentraut wrote:
>> On 25/01/2019 15:37, Chapman Flack wrote:
>>> If they are already processed that way, does that mean the
>>>
>>> o  Do not use text with <ulink> so the URL appears in printed output
>>>
>>> in README.links should be considered obsolete, and removed even, and
>>> doc authors should feel free to put link text in <ulink> without
>>> hesitation?
> 
> Committed that change.

I only now noticed that probably this should also have been changed:

-o  If you want to supply text, use <link>, else <xref>
+o  If you want to supply text, use <link> or <ulink>, else <xref>

Regards,
-Chap

Commits

  1. Improve documentation about our XML functionality

  2. Improve documentation about our XML functionality.

  3. Add volatile qualifier missed in commit 2e616dee9.

  4. Fix crash with old libxml2

  5. Fix minor deficiencies in XMLTABLE, xpath(), xmlexists()

  6. Fix the BY {REF,VALUE} clause of XMLEXISTS/XMLTABLE

  7. doc: Update README.links

  8. XPath fixes: