Re: [PATCH 31/40] xargs/xargs.1: Set file names in bold, not roman.

"G. Branden Robinson" <[email protected]> Thu, 13 Nov 2025 16:16:27 -0600
Newsgroups	gmane.comp.gnu.findutils.bugs
Message-ID	<20251113221627.vftijqyqvhfucmtt@illithid>
The title/summary of this commit is incorrect.  s/bold/italic/

The rest of the commit is as I intended.

Sorry about the goof.

Regards,
Branden

At 2025-11-13T10:50:24-0600, G. Branden Robinson wrote:
> groff_man_style(7):
>    Font style macros
> ...
>      .I [text]
>             Set text in an italic or oblique face.  Given no argument, I
>             plants a one‐line input trap; text on the next line, which
>             can be further formatted with a macro, is set in an italic
>             or oblique face.
> 
>             Use italics for file and path names, for environment
>             variables, for C data types, for enumeration or preprocessor
>             constants in C, for variant (user‐replaceable) portions of
>             syntax synopses, for the first occurrence (only) of a
>             technical concept being introduced, for names of journals
>             and of literary works longer than an article, and anywhere a
>             parameter requiring replacement by the user is encountered.
>             An exception involves variant text in a context already
>             typeset in italics, such as file or path names with
>             replaceable components; in such cases, follow the convention
>             of mathematical typography: set the file or path name in
>             italics as usual but use roman for the variant part (see IR
>             and RI below), and italics again in running roman text when
>             referring to the variant material.
> ---
>  xargs/xargs.1 | 12 ++++++------
>  1 file changed, 6 insertions(+), 6 deletions(-)
> 
> diff --git a/xargs/xargs.1 b/xargs/xargs.1
> index 3b7f5f86..958159e6 100644
> --- a/xargs/xargs.1
> +++ b/xargs/xargs.1
> @@ -402,9 +402,9 @@ .SH "EXAMPLES"
>  .fi
>  .P
>  Find files named
> -.B core
> +.I core
>  in or below the directory
> -.B /tmp
> +.I /tmp
>  and delete them.
>  Note that this will work incorrectly if there are
>  any filenames containing newlines or spaces.
> @@ -413,9 +413,9 @@ .SH "EXAMPLES"
>  .B "find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f"
>  .P
>  Find files named
> -.B core
> +.I core
>  in or below the directory
> -.B /tmp
> +.I /tmp
>  and delete them, processing filenames in such a way that file or
>  directory names containing spaces or newlines are correctly handled.
>  .
> @@ -423,9 +423,9 @@ .SH "EXAMPLES"
>  .B "find /tmp \-depth \-name core \-type f \-delete"
>  .P
>  Find files named
> -.B core
> +.I core
>  in or below the directory
> -.B /tmp
> +.I /tmp
>  and delete them, but more efficiently than in the previous example
>  (because we avoid the need to use
>  .BR fork (2)
> -- 
> 2.30.2
>
signature.asc (application/pgp-signature, 833 B)