Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 15 Jul 2025 01:11:33 +0000
From:      bugzilla-noreply@freebsd.org
To:        bugs@FreeBSD.org
Subject:   [Bug 211948] make(1): various corrections and edits
Message-ID:  <bug-211948-227-ROPcGrxSzX@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-211948-227@https.bugs.freebsd.org/bugzilla/>

index | next in thread | previous in thread | raw e-mail

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 the assignee for the bug.

home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-211948-227-ROPcGrxSzX>