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)


Reply via email to