From: Tom Lane <tgl@sss.pgh.pa.us>
To: Joe Conway <joseph.conway@home.com>
Cc: pgsql-docs@postgreSQL.org
Subject: Cross-references (was [PATCHES] PQescapeBytea documentation patch)
Date: Tue, 20 Nov 2001 16:09:03 -0500
Message-ID: <3946.1006290543@sss.pgh.pa.us> (raw)
In-Reply-To: <3BFABB2C.3020307@home.com>
References: <3BFABB2C.3020307@home.com>
[ redirected from patches to pgsql-docs ]
Joe Conway <joseph.conway@home.com> writes:
> I was trying (but gave up) to cross-reference back to the input escape
> table in the User's Guide, but could not get the documentation to
> compile with a cross-book xref (missing IDREF error). Can a cross-book
> xref be done?
AFAIK, not. If you look around you'll notice a bunch of vague cross-
references like
See the <citetitle>Administrator's Guide</> for details.
This pretty much sucks but as long as we maintain the notion that the
books should be separately buildable, I'm not sure there's a way to do
better.
As far as readers go, I don't see that there's any need for anything
but the integrated document --- and we could do better cross-references
in that setting than we are doing. The one good thing about the
separate books is that you can build just one (to check the markup of
a section you're working on) in a reasonable amount of time. Building
the integrated doc seems to take forever :-(
Anyone see a way out of this dilemma?
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, joseph.conway@home.com
Subject: Re: Cross-references (was [PATCHES] PQescapeBytea documentation patch)
In-Reply-To: <3946.1006290543@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