Re: <xref> vs <command> formatting in the docs

Peter Eisentraut <peter.eisentraut@2ndquadrant.com>

From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
To: Dagfinn Ilmari Mannsåker <ilmari@ilmari.org>, Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Date: 2020-07-10T15:05:04Z
Lists: pgsql-hackers
On 2020-06-21 18:57, Dagfinn Ilmari Mannsåker wrote:
> Attached are two patches: the first adds the missing <application> tags,
> the second adds <command> to all the SQL commands (specifically anything
> with <manvolnum>7</manvolnum>).

I have committed the first one.

I have some concerns about the second one.  If you look at the diff of 
the source of the man pages before and after, it creates a bit of a 
mess, even though the man pages look okay when rendered.  I'll need to 
think about this a bit more.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services



Commits

  1. Improve <xref> vs. <command> formatting in the documentation

  2. Add missing <application> tags in application doc <refentrytitle>s