[Bug 211948] make(1): various corrections and edits

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=211948

--- Comment #4 from Alexander Ziaee <ziaee@FreeBSD.org> ---
make(1) is maintained in NetBSD, so improvements need to be made there. This is
a very large and very old manual with a lot of tech debt actually, someone
could easily spend a week just cleaning it up from a technical standpoint.

> The project doesn't have a standard for American vs British English,

Yes it does. The standard is American English. See FDP section 12.2 [0]. Lot of
layers of docs, so it takes some time to just have a map of where everything
is. Normally things for manuals are not in the FDP primer, and there is some
conflicting differences between Good Style in the handbook (FDP) and manual
pages.

> or whether to use single or double quotes.

The spec there is to keep it consistent in the specific doc. In manual pages,
the macro for Quoted Literals uses single quotes, so those are preferred for
consistency, except in old pages that predate the deprecation of "Dq Li".

[0]: https://docs.freebsd.org/en/books/fdp-primer/book/

-- 
You are receiving this mail because:
You are on the CC list for the bug.