Re: DOCS QUESTION - space added within synopsis replaceable tag.

From: Peter Smith <smithpb2250(at)gmail(dot)com>
To: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: DOCS QUESTION - space added within synopsis replaceable tag.
Date: 2026-07-23 08:55:32
Message-ID: CAHut+PuTULk_8O5jgVLciJN9eSwO6rsuiR8rS=r=-nzkL5L_DA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

I've been studying this some more...

As described in my previous post, I discovered that a leading space
was present in some <replaceable> terms as a hacky workaround to help
the rendering. Sometimes this space was added, and sometimes it
wasn't, therefore some synopses would appear OK and some would look
more squishy.

By more careful arrangement of the <arg> and <group> SGML tags I've
eliminated the need for this spacing hack completely.

Now the synopses for all the client/server applications [1][2] render
properly with no squishiness. Basically, nothing has changed at all
for each synopsis content, but now the spacing is all how it should
be.

PSA patch v1.

======
[1] https://www.postgresql.org/docs/19/reference-client.html
[2] https://www.postgresql.org/docs/19/reference-server.html

Kind Regards,
Peter Smith.
Fujitsu Australia

Attachment Content-Type Size
v1-0001-Fix-synopsis-spacing.patch application/octet-stream 6.2 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Richard Guo 2026-07-23 08:57:05 Re: Fix missing FORMAT when deparsing JSON_ARRAY(query)
Previous Message Anthonin Bonnefoy 2026-07-23 08:42:34 Re: Don't use pq_putmessage in socket comm function