Re: Spacing of options in getopt_long processing

From: Peter Eisentraut <peter(at)eisentraut(dot)org>
To: Andrew Dunstan <andrew(at)dunslane(dot)net>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, Vaibhav Dalvi <vaibhav(dot)dalvi(at)enterprisedb(dot)com>
Subject: Re: Spacing of options in getopt_long processing
Date: 2025-11-05 16:41:08
Message-ID: aa2e897b-e46d-4457-9479-3a5986547a21@eisentraut.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 04.11.25 20:32, Andrew Dunstan wrote:
> Over at [1] Vaibhav complained that the patch was deleting a line
> following one of the case branches for handling command line options in
> pg_restore.c, and said this was not pertinent to the patch. That's
> reasonable, but it made me look into $subject a bit. pg_restore.c has a
> mixture, with some options being followed by blank lines and some not.
> pg_dumpall.c and pg_dump.c have a blank line after each option, while
> psql's startup.c has none. It would be nice to clean this up and have a
> consistent style. But what style? Personally I think having a blank line
> after each option looks cleaner, and we're not nearly so concerned with
> preserving vertical space as we might once have been. I haven't surveyed
> other utilities in our suite. Is this worth even pursuing? Do we care
> about making each file consistent, or making all the code consistent?

I think it depends. For example, looking through getopt_long() in
initdb.c or pg_receivewal.c, each option processing is very simple.
Would adding blank lines there add anything in terms of clarity? I
doubt it. But then there is pg_resetwal.c, where each option processing
is rather complex, and so the extra blank lines seem almost necessary.

Along those lines, I would suggest that pg_waldump.c adds some blank
lines, but perhaps pg_rewind.c could remove them.

Only what pg_restore.c is doing is clearly wrong. ;-)

I am mindful of the vertical space. Horizontal space is rather cheaper
and the stuff toward the right is usually less important, but that
doesn't apply vertically.

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Philip Alger 2025-11-05 17:03:10 Re: [PATCH] Add pretty formatting to pg_get_triggerdef
Previous Message Philip Alger 2025-11-05 16:21:48 Re: [PATCH] Add pretty formatting to pg_get_triggerdef