Re: DOCS: Make the Server Application docs synopses more consistent

2025-04-21 Thread Peter Smith
My previous v2 patch needed a rebase anyway, so I've taken this opportunity also to restructure everything. Although it would be easier to post a single patch, some of the changes are still debatable. For this reason, now I've split the previous v2 patch into multiple parts, hoping that it will hel

Re: DOCS: Make the Server Application docs synopses more consistent

2025-03-12 Thread David G. Johnston
On Wednesday, March 12, 2025, David G. Johnston wrote: > > > My take on this is that the presence of environment variables doesn’t > impact whether a given CLI option is shown optional or mandatory. We are, > in effect, communicating that “datadir” must be specified for this > command. And then

DOCS: Make the Server Application docs synopses more consistent

2025-03-12 Thread David G. Johnston
On Wednesday, March 12, 2025, Peter Smith wrote: > > > I've made some updates and attached the v2 patch. Thanks. Full review later. Pg_controldata - TODO. The page structure looks strange. There should be an "Options" > section to describe -D, -V, and -? Agreed. > > [7] pg_resetwal [ -f |

Re: DOCS: Make the Server Application docs synopses more consistent

2025-03-12 Thread Peter Smith
On Wed, Mar 12, 2025 at 3:18 AM David G. Johnston wrote: > > On Thu, Dec 12, 2024 at 8:25 PM Peter Smith wrote: >> >> [1] initdb [option...] [ --pgdata | -D ] directory >> [2] pg_archivecleanup [option...] archivelocation oldestkeptwalfile >> [3] pg_checksums [option...] [[ -D | --pgdata ]datadir

Re: DOCS: Make the Server Application docs synopses more consistent

2025-03-11 Thread David G. Johnston
On Thu, Dec 12, 2024 at 8:25 PM Peter Smith wrote: > [1] initdb [option...] [ --pgdata | -D ] directory > [2] pg_archivecleanup [option...] archivelocation oldestkeptwalfile > [3] pg_checksums [option...] [[ -D | --pgdata ]datadir] > [4] pg_controldata [option] [[ -D | --pgdata ]datadir] > [5] pg

DOCS: Make the Server Application docs synopses more consistent

2024-12-12 Thread Peter Smith
Hi, While reviewing the synopsis for pg_createsubscriber I compared it with all the other synopses of the various Server Applications. In doing so I found some minor differences between them all. The differences are more apparent when you list everything together, like below: [1] initdb [option..