Date: Thu, 18 Aug 2016 17:17:20 +0000 From: bugzilla-noreply@freebsd.org To: freebsd-doc@FreeBSD.org Subject: [Bug 211970] FreeBSD Man Pages: Make(1) Message-ID: <bug-211970-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D211970 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: djensen@macsales.com URL:=20 https://www.freebsd.org/cgi/man.cgi?query=3Dmake&apropos=3D0&sektion=3D0&ma= npath=3DFreeBSD+10.3-RELEASE+and+Ports&arch=3Ddefault&format=3Dhtml 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 =E2=80=94= A Tutorial. This would then imply that the version of Make the page is referencing is P= Make 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 #freena= s) changed the version of PMake to BMake and then to FMake =E2=80=94 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 =E2=80=94 it might be a thorough description of a "previous ver= sion" of Make but it is by no means a description of the Make reflected on the Man P= age. 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 =E2=80=94 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. --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-211970-9>