Horton

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

Quan Zongliang <quanzongliang@yeah.net>

View thread
From: Quan Zongliang <quanzongliang@yeah.net>
To: pgsql-hackers@lists.postgresql.org
Date: 2025-09-22T01:27:38Z
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 →

  1. doc: Add link targets to CREATE/ALTER FOREIGN TABLE reference pages

  2. Doc: add XML ID attributes to <sectN> and <varlistentry> tags.


On 9/19/25 11:08 AM, jian he wrote:
> 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>.

LGTM

And I tested this patch on macOS Intel.

--
Quan Zongliang