[Bug 211970] FreeBSD Man Pages: Make(1)

[bugzilla-noreply at freebsd.org]

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 at FreeBSD.org
          Reporter: djensen at 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.