Hi Branden,

On 1/5/23 23:52, G. Branden Robinson wrote:
> * Set page topic in lowercase.
> * Rewrite synopses to use groff man(7) `SY`/`YS` extension macros.
> * Rewrite synopses to use man(7) font macros instead of *roff font
>    selection escape sequences.
> * In synopses, set ellipses as separate "operands" to better suggest
>    argument separation by white space.

Please keep the ellipses as a separate one.  I want to discuss it separately.

Cheers,

Alex

> * In synopses, prevent breaks within option brackets.
> * Typeset ellipses more attractively on troff devices.
> * Rewrite option list to use man(7) font macros instead of *roff font
>    selection escape sequences.
> * Use groff man(7) `TQ` extension macro to include multiple tags for
>    options with long synonyms instead of comma notation.
> * Set literals used as arguments to `-c` option in bold, not italics.
> 
> Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
> ---
>   man8/ldconfig.8 | 68 ++++++++++++++++++++++++++++++++-----------------
>   1 file changed, 44 insertions(+), 24 deletions(-)
> 
> diff --git a/man8/ldconfig.8 b/man8/ldconfig.8
> index cee0c7583..3460275ad 100644
> --- a/man8/ldconfig.8
> +++ b/man8/ldconfig.8
> @@ -5,22 +5,30 @@
>   .\"
>   .\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com>
>   .\"   Change listed order of /usr/lib and /lib
> -.TH LDCONFIG 8 (date) "Linux man-pages (unreleased)"
> +.TH ldconfig 8 (date) "Linux man-pages (unreleased)"
>   .SH NAME
>   ldconfig \- configure dynamic linker run-time bindings
>   .SH SYNOPSIS
> -.PD 0
> -.BR /sbin/ldconfig " [" \-nNvVX "] [" \-C " \fIcache\fP] [" \-f " \fIconf\fP] [" \-r " \fIroot\fP]"
> -.IR directory ...
> -.PP
> -.B /sbin/ldconfig
> +.SY /sbin/ldconfig
> +.\" TODO?: -c, --format, -i, --ignore-aux-cache, --print-cache,
> +.\" --verbose, -V, --version, -?, --help, --usage
> +.RB [ \-nNvVX ]
> +.RB [ \-C\~\c
> +.IR cache ]
> +.RB [ \-f\~\c
> +.IR conf ]
> +.RB [ \-r\~\c
> +.IR root ]
> +.IR directory \~.\|.\|.
> +.YS
> +.SY /sbin/ldconfig
>   .B \-l
>   .RB [ \-v ]
> -.IR library ...
> -.PP
> -.B /sbin/ldconfig
> +.IR library \~.\|.\|.
> +.YS
> +.SY /sbin/ldconfig
>   .B \-p
> -.PD
> +.YS
>   .SH DESCRIPTION
>   .B \%ldconfig
>   creates the necessary links and cache to the most recent shared
> @@ -113,35 +121,41 @@ Failure to follow this pattern may result in compatibility issues
>   after an upgrade.
>   .SH OPTIONS
>   .TP
> -.BR \-c " \fIfmt\fP, " \-\-format=\fIfmt\fP
> +.BI \-c\~ fmt
> +.TQ
> +.BI \-\-format= fmt
>   (Since glibc 2.2)
>   .\" commit 45eca4d141c047950db48c69c8941163d0a61fcd
> -Cache format to use:
> -.IR old ,
> -.IR new ,
> +Use cache format
> +.IR fmt ,
> +which is one of
> +.BR old ,
> +.BR new ,
>   or
> -.IR \%compat .
> +.BR \%compat .
>   Since glibc 2.32,
>   the default is
> -.IR new .
> +.BR new .
>   .\" commit cad64f778aced84efdaa04ae64f8737b86f063ab
>   Before that,
>   it was
> -.IR \%compat .
> +.BR \%compat .
>   .TP
> -.BI "\-C " cache
> +.BI \-C\~ cache
>   Use
>   .I cache
>   instead of
>   .IR /etc/ld.so.cache .
>   .TP
> -.BI "\-f " conf
> +.BI \-f\~ conf
>   Use
>   .I conf
>   instead of
>   .IR /etc/ld.so.conf .
>   .TP
> -.BR \-i ", " \-\-ignore\-aux\-cache
> +.B \-i
> +.TQ
> +.B \-\-ignore\-aux\-cache
>   (Since glibc 2.7)
>   .\" commit 27d9ffda17df4d2388687afd12897774fde39bcc
>   Ignore auxiliary cache file.
> @@ -167,23 +181,29 @@ Unless
>   is also specified,
>   links are still updated.
>   .TP
> -.BR \-p ", " \-\-print\-cache
> +.B \-p
> +.TQ
> +.B \-\-print\-cache
>   Print the lists of directories and candidate libraries stored in
>   the current cache.
>   .TP
> -.BI "\-r " root
> +.BI \-r\~ root
>   Change to and use
>   .I root
>   as the root directory.
>   .TP
> -.BR \-v ", " \-\-verbose
> +.B \-v
> +.TQ
> +.B \-\-verbose
>   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
> -.BR \-V ", " \-\-version
> +.B \-V
> +.TQ
> +.B \-\-version
>   Print program version.
>   .TP
>   .B \-X

-- 
<http://www.alejandro-colomar.es/>