Re: Add id's to various elements in protocol.sgml

From: Brar Piening <brar(at)gmx(dot)de>
To: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Add id's to various elements in protocol.sgml
Date: 2021-12-15 11:07:47
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers

On Dec 14, 2021 at 20:47, Alvaro Herrera wrote:
> Hmm, I think we tend to avoid xreflabels; see

Ok, thank you for the hint.
I added them because <varlistentry> doesn't automatically generate
labels and they were present in the current docs for

After reading the aforementioned thread to
I infer the following conclusions:
a) Do *not* include xreflabel for elements that get numbered.
b) There should be some general utility for the xreflabel, not just the
linking needs of one particular source location.
c) Generally, xreflabels are a bit of antipattern, so there need to be
solid arguments in favor of adding more.

Since I can't argue towards some general utility for the xreflabels and
don't have any other solid argument in favor of adding more, I will
remove them from my current patch but leave the existing ones intact.


In response to


Browse pgsql-hackers by date

  From Date Subject
Next Message Shay Rojansky 2021-12-15 12:35:24 Privilege required for IF EXISTS event if the object already exists
Previous Message Juan José Santamaría Flecha 2021-12-15 10:32:38 Re: Windows default locale vs initdb