From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Adding xreflable
Date: Fri, 15 May 2020 10:09:06 -0400
Message-ID: <19807.1589551746@sss.pgh.pa.us> (raw)
In-Reply-To: <20200515134900.GD3894@momjian.us>
References: <20200515123923.GB3894@momjian.us>
<18482.1589549850@sss.pgh.pa.us>
<20200515134900.GD3894@momjian.us>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, bruce@momjian.us
Subject: Re: Adding xreflable
In-Reply-To: <19807.1589551746@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox