Re: Adding xreflable - Mailing list pgsql-docs

From Tom Lane
Subject Re: Adding xreflable
Date
Msg-id 19807.1589551746@sss.pgh.pa.us
Whole thread Raw
In response to Re: Adding xreflable  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Adding xreflable
List pgsql-docs
Bruce Momjian <bruce@momjian.us> writes:
> On Fri, May 15, 2020 at 09:37:30AM -0400, Tom Lane wrote:
>> Why?  Our convention generally is to refer to the command, not to the ref
>> page as such.

> Uh, for the release notes, I am referencing the doc page about the
> feature, and without the xref, I have to mention it twice, e.g.:

Oh, you're talking about the application man pages not the SQL command
ones.  I'd still be inclined to solve it with something paralleling
the way we handle SQL command references.

Quickly comparing the pgupgrade page to a couple of SQL commands,
it's not real obvious what is missing.  Maybe there's something
in the stylesheet support, not the ref pages as such?

            regards, tom lane



pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Adding xreflable
Next
From: "Daniel Westermann (DWE)"
Date:
Subject: Relnotes for 13: There is word missing in UUID generation sentence