man*/: ffix (Place short options after long options)

This increases the chances that the paragraph will start in the same
line as the tag, wasting less vertical space.

The result seems visually better to me.

On Wed, Oct 25, 2023 at 09:11:03AM -0500, G. Branden Robinson wrote:
> I also like your suggestion that if we really want to economize on
> space, we could present a command's long option form before its short,
> old-style Unix synonym, which will work well when the short option (plus
> its argument, if any) fits within the space for the paragraph tag.  This
> might be a good idea for another reason; in GNU user space, the long
> option is the much more self-documenting form, and the single-character
> option name a kind of "expert mode" alternative.  As a general rule,
> when presenting technical material, one should not lead with "expert
> mode".

Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

2 files changed, 16 insertions, 16 deletions

diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8
index 95cfcdb03..edd42388d 100644
--- a/man8/iconvconfig.8
+++ b/man8/iconvconfig.8
@@ -40,9 +40,9 @@ is not set.
 Do not search the system default gconv directory,
 only the directories provided on the command line.
 .TP
-.BI \-o\~ outputfile
-.TQ
 .BI \-\-output= outputfile
+.TQ
+.BI \-o\~ outputfile
 Use
 .I outputfile
 for output instead of the system default cache location.
@@ -58,17 +58,17 @@ the gconv module configuration would be read from
 and the cache would be written to
 .IR foo/usr/lib/gconv/gconv\-modules.cache .
 .TP
-.B \-?
-.TQ
 .B \-\-help
+.TQ
+.B \-?
 Print a usage summary and exit.
 .TP
 .B \-\-usage
 Print a short usage summary and exit.
 .TP
-.B \-V
-.TQ
 .B \-\-version
+.TQ
+.B \-V
 Print the version number, license, and disclaimer of warranty for
 .BR iconv .
 .SH EXIT STATUS
diff --git a/man8/ldconfig.8 b/man8/ldconfig.8
index 2f974ad7d..01862b55c 100644
--- a/man8/ldconfig.8
+++ b/man8/ldconfig.8
@@ -89,9 +89,9 @@ Failure to follow this pattern may result in compatibility issues
 after an upgrade.
 .SH OPTIONS
 .TP
-.BI \-c\~ fmt
-.TQ
 .BI \-\-format= fmt
+.TQ
+.BI \-c\~ fmt
 (Since glibc 2.2)
 .\" commit 45eca4d141c047950db48c69c8941163d0a61fcd
 Use cache format
@@ -121,9 +121,9 @@ Use
 instead of
 .IR /etc/ld.so.conf .
 .TP
-.B \-i
-.TQ
 .B \-\-ignore\-aux\-cache
+.TQ
+.B \-i
 (Since glibc 2.7)
 .\" commit 27d9ffda17df4d2388687afd12897774fde39bcc
 Ignore auxiliary cache file.
@@ -148,9 +148,9 @@ Unless
 is also specified,
 links are still updated.
 .TP
-.B \-p
-.TQ
 .B \-\-print\-cache
+.TQ
+.B \-p
 Print the lists of directories and candidate libraries stored in
 the current cache.
 .TP
@@ -159,18 +159,18 @@ Change to and use
 .I root
 as the root directory.
 .TP
-.B \-v
-.TQ
 .B \-\-verbose
+.TQ
+.B \-v
 Verbose mode.
 Print current version number,
 the name of each directory as it is scanned,
 and any links that are created.
 Overrides quiet mode.
 .TP
-.B \-V
-.TQ
 .B \-\-version
+.TQ
+.B \-V
 Print program version.
 .TP
 .B \-X