Quotes around the .Nd argument in 1/6 of manual pages
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 27 Jul 2022 09:13:54 UTC
The examples in
https://docs.freebsd.org/en/books/fdp-primer/manual-pages/#manual-pages-sample-structures
use quotes around the .Nd argument, but only about 1/6 of actual manual
pages (outside contrib/) use them:
~/FreeBSD/src% git grep -E '^\.Nd "[^ ]* ' | grep -v -E '^contrib/' | wc
-l # .Nd "foo bar"
615
~/FreeBSD/src% git grep -E '^\.Nd [^"][^ ]* ' | grep -v -E '^contrib/' |
wc -l # .Nd baz quux
2683
~/FreeBSD/src% git grep -E '^\.Nd ' | grep -v -E '^contrib/' | wc -l #
.Nd
3320
Unless some manual pages need the quotes or there are other reasons to
keep them, I'm planning -to align the manual pages to the quoteless form
and adjust the FDP primer accordingly. Opinions?
--
#BlackLivesMatter #TransWomenAreWomen #AccessibilityMatters
#StandWithUkrainians
English: he/him/his (singular they/them/their/theirs OK)
French: il/le/lui (iel/iel and ielle/ielle OK)
Tagalog: siya/niya/kaniya (please avoid sila/nila/kanila)