public inbox for [email protected]  

help / color / mirror / Atom feed

From: Josh Kupershmidt <[email protected]>
To: Bruce Momjian <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: pgsql-docs <[email protected]>
Subject: Re: broken index references
Date: Sat, 30 Nov 2013 17:23:14 -0500
Message-ID: <CAK3UJRFy3NTJW+26=VU7WWTTOY1eJyuidsuSKU20VEH-Xs3A7w@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <CAK3UJRGCsAuq_k1L=OXZm9SaETHcvkfnynRNn617Gu+fuX0pLg@mail.gmail.com>
	<[email protected]>
	<CAK3UJRF3Eb-1zSkM_SkxD2LyS-w6pOo5JRqGLiuQNNN11vatkQ@mail.gmail.com>
	<[email protected]>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>

On Sat, Nov 30, 2013 at 2:53 PM, Bruce Momjian <[email protected]> wrote:
> On Fri, Mar 29, 2013 at 04:25:17PM -0700, Josh Kupershmidt wrote:
>> On Sat, Mar 23, 2013 at 11:12 AM, Tom Lane <[email protected]> wrote:
>> > A different PDF-output problem that I've been noticing for awhile is that
>> > certain intra-page links don't work.  The only clue I've found about it
>> > is the warnings in the TeX log, for instance:
>>
>> I could have overlooked a working example.. but as far as I've seen,
>> every link of the form:
>>
>>  <xref linkend="..." endterm="...">
>>
>> just goes to Page 1 in the PDFs. I checked against a recent 9.2-A4.pdf
>> from the website and my own 9.3-A4.pdf built on Debian; the psql page
>> (psql-ref.sgml) has a number of such links. The links seem to work OK
>> in the HTML version, though.
>
> Sorry to be looking at this late, but I just tested the 9.3.1 PDF at:
>
>         http://www.postgresql.org/files/documentation/pdf/9.3/postgresql-9.3-US.pdf
>
> and the link on page 1748 that links to section 31.14 worked fine:
>
>         For additional environment variables, see Section 31.14.)

[... jogging my memory ... ] I think the problem was specifically with
links of the form:

 <xref linkend="..." endterm="...">

having the "endterm" attribute specified -- your example didn't have
an "endterm". For an example, see the next page (p. 1749 according to
our page numbering, under the "Meta-Commands" sub-heading), for the
link to "SQL Interpolation" at the end of this paragraph:

    <para>
    If an unquoted colon (<literal>:</literal>) followed by a
    <application>psql</> variable name appears within an argument, it is
    replaced by the variable's value, as described in <xref
    linkend="APP-PSQL-interpolation" endterm="APP-PSQL-interpolation-title">.
    </para>

which at least in my PDF reader just sends one back to Page 1.

Josh


-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

view thread (7+ 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]
  Subject: Re: broken index references
  In-Reply-To: <CAK3UJRFy3NTJW+26=VU7WWTTOY1eJyuidsuSKU20VEH-Xs3A7w@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