From c5dfe4c378927db9b126d241b47588ba80a726bb Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Tue, 18 Nov 2025 21:49:04 -0600
Subject: [PATCH] xargs.1: set file names in italics
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

...not roman.

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: Do the above.

Discussed at:
https://lists.gnu.org/r/bug-findutils/2025-11/msg00094.html

Copyright-paperwork-exempt: Yes
---
 xargs/xargs.1 | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/xargs/xargs.1 b/xargs/xargs.1
index 27349f46..94b6a963 100644
--- a/xargs/xargs.1
+++ b/xargs/xargs.1
@@ -401,9 +401,9 @@ because it would not actually conflict.
 .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.
@@ -412,9 +412,9 @@ any filenames containing newlines or spaces.
 .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.
 .
@@ -422,9 +422,9 @@ directory names containing spaces or newlines are correctly handled.
 .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)