public inbox for [email protected]
help / color / mirror / Atom feedFrom: Robert Haas <[email protected]>
To: Noah Misch <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: [email protected] <[email protected]>
Cc: pgsql-docs <[email protected]>
Subject: Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
Date: Wed, 5 Feb 2014 13:27:38 -0500
Message-ID: <CA+TgmobAS1wK7CgjC3bnT8CRscMEkjm2P+Ew9jt7yDTdoen5Vw@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
<[email protected]>
<CA+Tgmob0Jx_9v9KK95gojkjojeP2hTa38_P8JtOFXVDjjSkT=A@mail.gmail.com>
<[email protected]>
<[email protected]>
<[email protected]>
<CA+TgmobCN4ABNYS=4FwQP3MUNdJ8+rdoyedXNn5gGiWSEPdnWg@mail.gmail.com>
<[email protected]>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>
On Tue, Feb 4, 2014 at 11:43 PM, Noah Misch <[email protected]> wrote:
>> Right. I mean, a lot of the links say things like "Section 26.2"
>> which obviously makes no sense in a standalone text file.
>
> For <xref>s normally displayed that way, text output could emit a URL, either
> inline or in the form of a footnote. For link targets (e.g. SQL commands)
> having a friendly text fragment for <xref> sites, use the normal fragment.
True. If we're going to keep these things around, something like that
would avoid some annoyances for documentation authors. But I still
think we ought to just nuke them, because who cares?
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
--
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
view thread (19+ messages) latest in thread
reply
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: [email protected]
Cc: [email protected], [email protected], [email protected], [email protected]
Subject: Re: Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)
In-Reply-To: <CA+TgmobAS1wK7CgjC3bnT8CRscMEkjm2P+Ew9jt7yDTdoen5Vw@mail.gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox