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: Wed, 21 Jul 2010 22:32:45 +0300
Message-ID: <1279740765.10881.13.camel@vanquo.pezone.net> (raw)
In-Reply-To: <AANLkTilQDmA5fJNIeyODH8o2npTTq32Z2_08IuxEeB1W@mail.gmail.com>
References: <AANLkTikAgIyYfwy_2Zj8GafoC7ZFlGv5iCdab1l7VuDp@mail.gmail.com>
<1278612590.25038.2.camel@vanquo.pezone.net>
<AANLkTinQJhTJ1LCjxP6Cy_Uha4R2TT1PhZWDpRxGhGlD@mail.gmail.com>
<1278626486.2767.5.camel@vanquo.pezone.net>
<AANLkTilQDmA5fJNIeyODH8o2npTTq32Z2_08IuxEeB1W@mail.gmail.com>
On ons, 2010-07-21 at 03:16 +0100, Daniele Varrazzo wrote:
> Attached there is a patch adding an id to the indexterms currently
> referred by psycopg documentation, to be applied to the current head.
> However I've tried to render the html docs with the head itself and I
> see anchors are not generated anymore, while they are generated by the
> makefile shipped in 8.4.4. Is this a decision or it just happened? In
> the former case there is no point in applying the patch then.
Hmm, never noticed that, but it appears to come from the changes we made
in the build process to not build the index twice and thus speed up the
build.
> I've also played with good results with a script to inject ids in all
> the indexterm, but if the decision is to not provide anchors in the
> middle of the page I think you wouldn't be interested in it.
I think it's a bit weird to link to indexentry elements. I can't quite
wrap my head around it. I think you could just as well link to the
varlistentry elements or some other element close by. Check out how we
link to the configuration parameters in config.sgml.
Btw., try to use some kind of hierarchical scheme for the id's. If
something is in the libpq chapter, use something like
id="libpq-pqtransactionstatus".
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: <1279740765.10881.13.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