MAN pages authoritativeness

Robert Huff roberthuff at rcn.com
Tue May 2 14:29:09 UTC 2006


John Nielsen writes:

>  > They state that the MAN pages are authoritative in OpenBSD, "... In
>  > OpenBSD, the UNIX manual pages are considered authoritative. If a
>  > program or function call does not behave exactly as the manual
>  > describes, this is considered a bug...."
>  >
>  > I was just curious to know if this was also true in FreeBSD.
>  

>  In my experience, yes.  AFAIK having detailed, accurate man pages
>  for everything in the base system has always been a design goal.
>  And if I find something that doesn't work like the manpage
>  describes, then I submit a bug report.  Sometimes the bug is with
>  the manpage, though. :)

	"Goal" being the operative word.  A very quick look at open doc
PRs suggests there could be as many as 50 PRs about man pages.


				Robert Huff




More information about the freebsd-questions mailing list