https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=211970
Bug ID: 211970
Summary: FreeBSD Man Pages: Make(1)
Product: Documentation
Version: Latest
Hardware: Any
OS: Any
Status: New
Severity: Affects Many People
Priority: ---
Component: Documentation
Assignee: freebsd-doc@FreeBSD.org
Reporter: djen...@macsales.com
URL:
https://www.freebsd.org/cgi/man.cgi?query=make&apropos=0&sektion=0&manpath=FreeBSD+10.3-RELEASE+and+Ports&arch=default&format=html
On the above page is the FreeBSD Man Page documentation for Make(1) for
(FreeBSD 10.3-Release and Ports) however it is unclear what version of Make it
is describing. It does have a section where it states as follows:
This manual page is intended as a reference document only. For a more
thorough description of Make and makefiles, please refer to PMake — A
Tutorial.
This would then imply that the version of Make the page is referencing is PMake
but due to some major discrepancies between the PMake Tutorial and the Man Page
it is fairly obvious that this is not the case.
Still in trying to research this and find out exactly what version of Make this
page reflects I find out that FreeBSD may have (and I say may have because this
is all non-authoritative scuttlebutt gotten off of IRC #freebsd and #freenas)
changed the version of PMake to BMake and then to FMake — so there is no easy
way to determine what version the Man Page is referring to. I realize that (if
the versioning path I had described to me is correct) that BMake came from
PMake and FMake came from BMake and that both FMake and BMake are fully
backwards compatible but that still does not help solidify what version of Make
is represented within the Man Page documentation
Regardless if PMake (as it seems) is not the version of Make on the Man Page
then the above excerpt is in error because it is not a thorough description of
Make at all — it might be a thorough description of a "previous version" of
Make but it is by no means a description of the Make reflected on the Man Page.
It would be great if a denotation on the FreeBSD Man Page: Make(1) was made as
to what actual version of Make is being referenced upon the Man Page and the
reference to PMake — A Tutorial would be clarified and perhaps even stressed
that it is a "previous version" and not the current version reflected on the
Man Page.
--
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
freebsd-doc@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
