DOCS - pg_waldump synopsis sgml markup

On Tue, Feb 17, 2026 at 6:09 AM Peter Smith <smithpb2250@gmail.com> wrote:

Hi.

I found that the synopsis for pg_waldump is not using correct SGML markup.

The options part and the other startseg/endseg parameters should be
using <replaceable>, same as for all the other synopses of server
applications.

+1. I looked at a few other application document pages and we use
replaceable for replaceable arguments.

--
Best Wishes,
Ashutosh Bapat

On Feb 17, 2026, at 08:38, Peter Smith <smithpb2250@gmail.com> wrote:

Hi.

I found that the synopsis for pg_waldump is not using correct SGML markup.

The options part and the other startseg/endseg parameters should be
using <replaceable>, same as for all the other synopses of server
applications.

PSA patch for the same.

======
Kind Regards,
Peter Smith.
Fujitsu Australia
<v1-0001-DOCS-fix-pg_waldump-synopsis-markup.patch>

In my understanding, <option> is used for literal flags that the user types exactly as written, e.g. “-f”; <replaceable> is used for placeholder text that the user must substitute with a real value.

So, using <replaceable> for startseg/endseg in this patch looks correct to me.

Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/

On Tue, Feb 17, 2026 at 05:19:05PM +0530, Ashutosh Bapat wrote:

+1. I looked at a few other application document pages and we use
replaceable for replaceable arguments.

Done that, in passing.
--
Michael

Thanks for pushing!

I have marked the corresponding CF entry as "Committed".

======
Kind Regards,
Peter Smith.
Fujitsu Australia.