From owner-freebsd-questions@FreeBSD.ORG  Tue May  2 14:29:09 2006
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
X-Original-To: freebsd-questions@freebsd.org
Delivered-To: freebsd-questions@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4D7D716A40F
	for <freebsd-questions@freebsd.org>;
	Tue,  2 May 2006 14:29:09 +0000 (UTC)
	(envelope-from roberthuff@rcn.com)
Received: from smtp01.lnh.mail.rcn.net (mx12.mrf.mail.rcn.net [207.172.4.11])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 364F043D5A
	for <freebsd-questions@freebsd.org>;
	Tue,  2 May 2006 14:29:07 +0000 (GMT)
	(envelope-from roberthuff@rcn.com)
Received: from 209-6-102-190.c3-0.smr-ubr1.sbo-smr.ma.cable.rcn.com (HELO
	jerusalem.litteratus.org.litteratus.org) ([209.6.102.190])
	by smtp01.lnh.mail.rcn.net with ESMTP; 02 May 2006 10:29:41 -0400
X-IronPort-AV: i="4.05,80,1146456000"; 
	d="scan'208"; a="196407815:sNHT106098356"
From: Robert Huff <roberthuff@rcn.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Message-ID: <17495.27738.747676.78293@jerusalem.litteratus.org>
Date: Tue, 2 May 2006 10:27:38 -0400
To: freebsd-questions@freebsd.org
In-Reply-To: <200605020928.31886.lists@jnielsen.net>
References: <e572718c0605020318i5175e90u127feefff4cf28e9@mail.gmail.com>
	<200605020928.31886.lists@jnielsen.net>
X-Mailer: VM 7.17 under 21.5  (beta26) "endive" XEmacs Lucid
Subject: Re: MAN pages authoritativeness
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 02 May 2006 14:29:09 -0000

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