Re: Add id's to various elements in protocol.sgml - Mailing list pgsql-hackers

From Brar Piening
Subject Re: Add id's to various elements in protocol.sgml
Date
Msg-id 767059d5-ed1f-3d16-cada-24175461f3db@gmx.de
Whole thread Raw
In response to Re: Add id's to various elements in protocol.sgml  (Chapman Flack <chap@anastigmatix.net>)
Responses Re: Add id's to various elements in protocol.sgml
Re: Add id's to various elements in protocol.sgml
List pgsql-hackers
On Feb 28, 2022 at 21:06, Chapman Flack wrote:
> I think that in other recent examples I've seen, there might be
> (something like a) consensus forming around the Unicode LINK SYMBOL
> 🔗 rather than # as the symbol for such things.

I intentionally opted for an ASCII character as that definitely won't
cause any display/font/portability issues but changing that is no problem.

> ... and now that the concept is proven, how hard would it be to broaden
> that template's pattern to apply to all the other DocBook constructs
> (such as section headings) that emit anchors?

As long as we stick to manually assigned ids in the same way my patch
does it, it shouldn't be too hard. Speaking of autogenerated ids, I
failed to make use of them since I wasn't able to reproduce the same
autogenerated id twice in order to use it for the link.

Also I'm not sure how well the autogenerated ids are reproducible over
time/versions/builds, and if it is wise to use them as targets to link
to from somewhere else.





pgsql-hackers by date:

Previous
From: Nathan Bossart
Date:
Subject: Re: Allow async standbys wait for sync replication
Next
From: Nathan Bossart
Date:
Subject: Re: Postgres restart in the middle of exclusive backup and the presence of backup_label file