Re: Please provide stable target anchors

On tor, 2010-07-08 at 15:54 +0100, Daniele Varrazzo wrote:
> In psycopg documentation I've often referenced specific parts of
> PostgreSQL docs, e.g. libpq functions, using the anchors found in the
> html docs (see [1] for example). Unfortunately these anchors are not
> stable and the ones I've linked to have changed, leaving half-broken
> links referring to the correct page but to not existing fragments ([2]
> for the example above).

If you can tell us which places you want to link to, we can make stable
anchors.

> The html anchors seem generated from the <indexterm> tags in the sgml
> documentation. Would it be possible to generate stable anchors for
> these targets, e.g. "slugifying" the content of the <primary> tag
> contained in them?

No, the anchors are made from the id attributes.  But if there is no id
attribute, the toolchain generates an identifier for the anchor, which
is some number that is obviously not stable.  The fix is then to put
id's into these places.

> Uhm... looking at the currently published html doc, it seems there is
> a problem: the index [3] doesn't use these anchors at all. See for
> example the entries for any libpq function.

I'm not sure I'm seeing what you're seeing.  Could you provide examples?