In both command line usage and manual output format, find's options
and primaries behave the same, but their mdoc(7) markup is different and
therefore causes different tag names:
-x (option) can be looked up with ":tx<Enter>" in the manual pager,
whereas -amin (primary) requires ":t-amin<Enter>" including the dash.
I'd like primaries to behave the same like options when it comes to tags
in manuals, is that a reasonable expectation?
If so, diff below switches all primaries from `Cm -amin' to `Fl amin'
markup such that their resulting tag name is "amin" not "-amin"; man's
output stays identical.
Feedback? OK?
Index: find.1
===================================================================
RCS file: /cvs/src/usr.bin/find/find.1,v
retrieving revision 1.98
diff -u -p -U0 -r1.98 find.1
--- find.1 2 Sep 2019 21:18:41 -0000 1.98
+++ find.1 19 Mar 2020 22:59:33 -0000
@@ -149 +149 @@ the last option given overrides the othe
-.It Ic -amin Ar n
+.It Fl amin Ar n
@@ -156 +156 @@ minutes.
-.It Ic -anewer Ar file
+.It Fl anewer Ar file
@@ -160 +160 @@ True if the current file has a more rece
-.It Ic -atime Ar n
+.It Fl atime Ar n
@@ -167 +167 @@ was started, rounded up to the next full
-.It Ic -cmin Ar n
+.It Fl cmin Ar n
@@ -175 +175 @@ minutes.
-.It Ic -cnewer Ar file
+.It Fl cnewer Ar file
@@ -179 +179 @@ True if the current file has a more rece
-.It Ic -ctime Ar n
+.It Fl ctime Ar n
@@ -187 +187 @@ was started, rounded up to the next full
-.It Ic -delete
+.It Fl delete
@@ -205 +205 @@ Following symlinks is incompatible with
-.It Ic -depth
+.It Fl depth
@@ -211 +211 @@ option.
-.It Ic -empty
+.It Fl empty
@@ -214,2 +214,2 @@ True if the current file or directory is
-.It Ic -exec Ar utility Oo Ar argument ... Oc \&;
-.It Ic -exec Ar utility Oo Ar argument ... Oc {} +
+.It Fl exec Ar utility Oo Ar argument ... Oc \&;
+.It Fl exec Ar utility Oo Ar argument ... Oc {} +
@@ -256 +256 @@ does not exceed
-.It Ic -execdir Ar utility Oo Ar argument ... Oc \&;
+.It Fl execdir Ar utility Oo Ar argument ... Oc \&;
@@ -284 +284 @@ flags specified exactly match those of t
-.It Ic -follow
+.It Fl follow
@@ -290 +290 @@ option.
-.It Ic -fstype Ar type
+.It Fl fstype Ar type
@@ -303 +303 @@ mounted read-only.
-.It Ic -group Ar gname
+.It Fl group Ar gname
@@ -312 +312 @@ is treated as a group ID.
-.It Ic -iname Ar pattern
+.It Fl iname Ar pattern
@@ -317 +317 @@ primary except that the matching is done
-.It Ic -inum Ar n
+.It Fl inum Ar n
@@ -321 +321 @@ True if the file has inode number
-.It Ic -links Ar n
+.It Fl links Ar n
@@ -326 +326 @@ links.
-.It Ic -ls
+.It Fl ls
@@ -339 +339 @@ The format is identical to that produced
-.It Ic -maxdepth Ar n
+.It Fl maxdepth Ar n
@@ -343 +343 @@ True if the current search depth is less
-.It Ic -mindepth Ar n
+.It Fl mindepth Ar n
@@ -347 +347 @@ True if the current search depth is at l
-.It Ic -mmin Ar n
+.It Fl mmin Ar n
@@ -354 +354 @@ minutes.
-.It Ic -mtime Ar n
+.It Fl mtime Ar n
@@ -361 +361 @@ was started, rounded up to the next full
-.It Ic -name Ar pattern
+.It Fl name Ar pattern
@@ -367 +367 @@ which may use any of the special charact
-.It Ic -newer Ar file
+.It Fl newer Ar file
@@ -371 +371 @@ True if the current file has a more rece
-.It Ic -nogroup
+.It Fl nogroup
@@ -374 +374 @@ True if the file belongs to an unknown g
-.It Ic -nouser
+.It Fl nouser
@@ -377 +377 @@ True if the file belongs to an unknown u
-.It Ic -ok Ar utility Oo Ar argument ... Oc \&;
+.It Fl ok Ar utility Oo Ar argument ... Oc \&;
@@ -393 +393 @@ expression is false.
-.It Ic -path Ar pattern
+.It Fl path Ar pattern
@@ -427 +427 @@ Note, the first character of a symbolic
-.It Ic -print
+.It Fl print
@@ -434 +434 @@ character.
-.It Ic -print0
+.It Fl print0
@@ -442 +442 @@ option to
-.It Ic -prune
+.It Fl prune
@@ -453 +453 @@ option was specified.
-.It Ic -size Ar n Ns Op Cm c
+.It Fl size Ar n Ns Op Cm c
@@ -465 +465 @@ bytes.
-.It Ic -type Ar t
+.It Fl type Ar t
@@ -486 +486 @@ socket
-.It Ic -user Ar uname
+.It Fl user Ar uname
@@ -495 +495 @@ is treated as a user ID.
-.It Ic -xdev
+.It Fl xdev
