Re: Allow pg_archivecleanup to remove backup history files - Mailing list pgsql-hackers

From torikoshia
Subject Re: Allow pg_archivecleanup to remove backup history files
Date
Msg-id 3fe4af5a0a81fc6a2ec01cb484c0a487@oss.nttdata.com
Whole thread Raw
In response to Re: Allow pg_archivecleanup to remove backup history files  (Kyotaro Horiguchi <horikyota.ntt@gmail.com>)
Responses Re: Allow pg_archivecleanup to remove backup history files
List pgsql-hackers
On 2023-06-16 11:22, Kyotaro Horiguchi wrote:
> At Thu, 15 Jun 2023 21:38:28 +0900, torikoshia
> <torikoshia@oss.nttdata.com> wrote in
>> On 2023-06-15 15:20, Kyotaro Horiguchi wrote:
>> Thanks for your review!
>> > + printf(_(" -x, --strip-extension=EXT strip this extention before
>> > identifying files fo clean up\n"));
>> > + printf(_(" -?, --help show this help, then exit\n"));
>> > After this change, some of these lines corss the boundary of the 80
>> > columns width.  (is that policy viable noadays? I am usually working
>> > using terminal windows with such a width..) It's somewhat unrelated to
>> > this patch, but a help line a few lines further down also exceeds the
>> > width. We could shorten it by removing the "/mnt/server" portion, but
>> > I'm not sure if it's worth doing.
>> 
>> I also highlight 80th column according to the wiki[1].
>> Since usage() in other files like pg_rewind.c and initdb.c also
>> exceeded the 80th column, I thought that was something like a guide.
> 
> I think the page is suggesting about program code, not the messages
> that binaries print.

Thanks, now I understand what you meant.

> ASAICS the main section of the "pg_rewind --help" fits within 80
> columns. However, "initdb --help" does output a few lines exceeding
> the 80-column limit. Judging by the surrounding lines, I believe we're
> still aiming to maintain these the given width. I think we need to fix
> initdb in that regard.

Hmm, it seems some other commands also exceeds 80 columns:

   pg_amcheck:
       --skip=OPTION               do NOT check "all-frozen" or 
"all-visible" blocks
       --startblock=BLOCK          begin checking table(s) at the given 
block number
       --endblock=BLOCK            check table(s) only up to the given 
block number

   --no-synchronized-snapshots  do not use synchronized snapshots in 
parallel jobs

   pg_isready:
   -t, --timeout=SECS       seconds to wait when attempting connection, 0 
disables (default: 3)

   pg_receivewal:
       --create-slot      create a new replication slot (for the slot's 
name see --slot)
       --drop-slot        drop the replication slot (for the slot's name 
see --slot)

If you don't mind, I'm going to create another thread about this point.
I'll also discuss below line since it's unrelated to current thread
as you pointed out:

| pg_archivecleanup /mnt/server/archiverdir 
000000010000000000000010.00000020.backup


Attached patch fixes the number of columns per row exceeding 80 by
changing to use getopt_long.


On 2023-06-16 11:30, Kyotaro Horiguchi wrote:
> At Fri, 16 Jun 2023 11:22:31 +0900 (JST), Kyotaro Horiguchi
> <horikyota.ntt@gmail.com> wrote in
>> ASAICS the main section of the "pg_rewind --help" fits within 80
>> columns. However, "initdb --help" does output a few lines exceeding
>> the 80-column limit. Judging by the surrounding lines, I believe we're
>> still aiming to maintain these the given width. I think we need to fix
>> initdb in that regard.
> 
> Mmm, the message was introduced in 2012 by 8a02339e9b. I haven't
> noticed this until now...
> 
> regards.

-- 
Regards,

--
Atsushi Torikoshi
NTT DATA CORPORATION
Attachment

pgsql-hackers by date:

Previous
From: Masahiko Sawada
Date:
Subject: Re: Subscription statistics are not dropped at DROP SUBSCRIPTION in some cases
Next
From: James Coleman
Date:
Subject: path->param_info only set for lateral?