mirror/findutils
1
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/findutils.git synced 2026-01-26 07:37:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

xargs.1: set file names in italics

Browse Source 
...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
This commit is contained in:
G. Branden Robinson 2025-11-18 21:49:04 -06:00 committed by Bernhard Voelker
parent 6d695cc480
commit c5dfe4c378
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
xargs/xargs.1
View File

@ -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)