[PATCH 23/42] find.1: set file name literals in italics

"G. Branden Robinson" <[email protected]> Tue, 18 Nov 2025 21:47:32 -0600

Newsgroups	gmane.comp.gnu.findutils.bugs
Message-ID	<20251119034732.3ibjj3xaauozqo7z@illithid>

...not roman, and protect them from hyphenation.

GNU troff, Heirloom Doctools troff, and mandoc all support use of the
`\%` hyphenation control escape sequence at the _beginning_ of a word
suppress its hyphenation.  Other troffs do not.  Indirect this
application of the escape sequence through a string, interpolating
nothing on formatters that don't advertise GNU compatibility via the
`.g` register.  (This means that literals can hyphenate undesirably on
DWB, Solaris, and Plan 9 troffs.)

GNU troff, Heirloom Doctools troff, and mandoc all also support the GNU
`\:` extension to mark break points that should not produce hyphens.
Apply the same technique to avoid undesired formatting of a ':'
character on DWB, Solaris, and Plan 9 troffs.
---
 find/find.1 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/find/find.1 b/find/find.1
index 199f5240..d79ecfbc 100644
--- a/find/find.1
+++ b/find/find.1
@@ -5,6 +5,8 @@
 .  ds '  \(aq
 .  ds ~  \(ti
 .  ds en \(en
+.  ds %  \%
+.  ds :  \:
 .\}
 .el \{\
 .  \" \*" is not usable in macro arguments on AT&T troff.
@@ -12,6 +14,8 @@
 .  ds '  '
 .  ds ~  ~
 .  ds en \-
+.  ds %  \" empty
+.  ds :  \" empty
 .\}
 .SH NAME
 find \- search for files in a directory hierarchy
@@ -319,7 +323,9 @@ .SH OPTIONS
 .B "\-fstype\ \fIFOO\fR"
 predicate and specify a filesystem type
 .I FOO
-which is not known (that is, present in `/etc/mtab') at the time
+which is not known (that is, present in
+.IR \*%/etc/\*:mtab )
+at the time
 .B find
 starts, that predicate is equivalent to
 .BR \-false .
-- 
2.30.2

signature.asc (application/pgp-signature, 833 B)