Doc: add XML ID attributes to <varlistentry> tags for create_foreign_table, alter_foreign_table

jian he <jian.universality@gmail.com>

From: jian he <jian.universality@gmail.com>

To: PostgreSQL-development <pgsql-hackers@postgresql.org>

Date: 2025-09-19T03:08:55Z

Lists: pgsql-hackers

Commits

Same data as JSON: GET /api/v1/messages/:b64id/commits the thread's linked commits as JSON, with link sources. API reference →

doc: Add link targets to CREATE/ALTER FOREIGN TABLE reference pages
- dea0812cda19 19 (unreleased) landed
Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
- 78ee60ed84bb 16.0 cited

Attachments

v1-0001-Doc-add-XML-ID-attributes-to-varlistentry-tags-for-create_foreign.patch (text/x-patch) patch v1-0001
v1-0002-Doc-add-XML-ID-attributes-to-varlistentry-tags-for-alter_foreign_.patch (text/x-patch) patch v1-0002

hi.

with commit like:
https://git.postgresql.org/cgit/postgresql.git/commit/?id=78ee60ed84bb3a1cf0b6bd9a715dcbcf252a90f5

we can make a url link that points directly to a specific subsection
of the document.
for example:
https://www.postgresql.org/docs/devel/sql-createtable.html#SQL-CREATETABLE-PARMS-LIKE-OPT-COMMENTS
will link to exactly the CREATE TABLE LIKE INCLUDING COMMENTS section.

The attached patch adds XML ID attributes to <varlistentry> tags for
create_foreign_table.sgml,
and alter_foreign_table.sgml.
While working on CREATE TABLE LIKE, I happened to find this issue.
Maybe we can have a way to automate all <varlistentry>, but there are
so many <varlistentry>.