Received: from maia.hub.org (maia-5.hub.org [200.46.204.29])
	by mail.postgresql.org (Postfix) with ESMTP id 24EAC632EFC
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Thu,  8 Jul 2010 15:10:04 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024)
	with ESMTP id 66658-03 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Thu,  8 Jul 2010 18:09:56 +0000 (UTC)
X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6
Received: from mail.gmx.net (mail.gmx.net [213.165.64.20])
	by mail.postgresql.org (Postfix) with SMTP id 786A7632CC3
	for <pgsql-docs@postgresql.org>; Thu,  8 Jul 2010 15:09:55 -0300 (ADT)
Received: (qmail invoked by alias); 08 Jul 2010 18:09:52 -0000
Received: from a88-115-218-165.elisa-laajakaista.fi (EHLO [10.0.0.101])
	[88.115.218.165]
	by mail.gmx.net (mp013) with SMTP; 08 Jul 2010 20:09:52 +0200
X-Authenticated: #495269
X-Provags-ID: V01U2FsdGVkX1/y1hQ+D9vyOvduwUNfW9cryQ7SmP1+V9t7cDMEZt
	pBVvxx9MGBQwrW
Subject: Re: Please provide stable target anchors
From: Peter Eisentraut <peter_e@gmx.net>
To: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Cc: pgsql-docs@postgresql.org
In-Reply-To: <AANLkTikAgIyYfwy_2Zj8GafoC7ZFlGv5iCdab1l7VuDp@mail.gmail.com>
References: <AANLkTikAgIyYfwy_2Zj8GafoC7ZFlGv5iCdab1l7VuDp@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Date: Thu, 08 Jul 2010 21:09:50 +0300
Message-ID: <1278612590.25038.2.camel@vanquo.pezone.net>
Mime-Version: 1.0
X-Mailer: Evolution 2.30.1.2 
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-0.51 tagged_above=-5 required=5 tests=BAYES_05=-0.5,
	RCVD_IN_DNSWL_NONE=-0.0001, T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201007/70
X-Sequence-Number: 5726

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?