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

From: jian he <jian(dot)universality(at)gmail(dot)com>
To: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Doc: add XML ID attributes to <varlistentry> tags for create_foreign_table, alter_foreign_table
Date: 2025-09-19 03:08:55
Message-ID: CACJufxE6fW2jFAyTFWEYdUSDP=9P2yYerdksPTgxqDM4DZvvvw@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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>.

Attachment Content-Type Size
v1-0001-Doc-add-XML-ID-attributes-to-varlistentry-tags-for-create_foreign.patch text/x-patch 8.1 KB
v1-0002-Doc-add-XML-ID-attributes-to-varlistentry-tags-for-alter_foreign_.patch text/x-patch 11.8 KB

Browse pgsql-hackers by date

  From Date Subject
Next Message Amit Kapila 2025-09-19 03:26:10 Re: Reword messages using "as" instead of "because"
Previous Message Fujii Masao 2025-09-19 02:43:28 Re: Suggestion to add --continue-client-on-abort option to pgbench