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)