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

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