From: Peter Eisentraut <peter_e@gmx.net>
To: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Please provide stable target anchors
Date: Fri, 09 Jul 2010 01:01:26 +0300
Message-ID: <1278626486.2767.5.camel@vanquo.pezone.net> (raw)
In-Reply-To: <AANLkTinQJhTJ1LCjxP6Cy_Uha4R2TT1PhZWDpRxGhGlD@mail.gmail.com>
References: <AANLkTikAgIyYfwy_2Zj8GafoC7ZFlGv5iCdab1l7VuDp@mail.gmail.com>
<1278612590.25038.2.camel@vanquo.pezone.net>
<AANLkTinQJhTJ1LCjxP6Cy_Uha4R2TT1PhZWDpRxGhGlD@mail.gmail.com>
On tor, 2010-07-08 at 20:01 +0100, Daniele Varrazzo wrote:
> I can surely provide you a list, there are just a dozen of them (I'll
> tell you which ones later, now I can't). But then I should bother you
> every time I need a new link, or write a patch for it and wait for it
> to be applied and then for the result to be rendered and published on
> /docs... so I thought generating all of them programmatically would
> improve the docs quality and would be a better solution for the
> future.
Sure, if you have an idea how to do that.
> If you open the manual index [1], scroll down manually to the "PQflush
> " entry and click on the link, you will be redirected on the correct
> page, but at its top. An anchor to be placed on the correct point is
> available (at the time of writing it is [2]) but the index doesn't
> refer to it. It seems a bug.
I think this is a design decision. The index entries mean, "this topic
is discussed in this section", rather than "this is the line the word is
mentioned".
> For love of consistency I may (try to) write a script to be run once
> which would add an id to all the indexterm (or wherever they should be
> added) based on the "primary" value. There is the possibility that
> this would fix the index bug (the index entry for the sections seem
> correct and they refer to the id), it should be tested. Would it be of
> interest?
I think the index stuff has nothing to do with your actual problem. You
need to id attributes to the places you link to, or devise a way to
generate stable link anchors in some other way.
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: peter_e@gmx.net, daniele.varrazzo@gmail.com
Subject: Re: Please provide stable target anchors
In-Reply-To: <1278626486.2767.5.camel@vanquo.pezone.net>
* 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