From owner-freebsd-questions@FreeBSD.ORG  Tue May  2 13:29:15 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 6552D16A408
	for <freebsd-questions@freebsd.org>;
	Tue,  2 May 2006 13:29:15 +0000 (UTC)
	(envelope-from lists@jnielsen.net)
Received: from ns1.jnielsen.net (ns1.jnielsen.net [69.55.238.237])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1B17243D45
	for <freebsd-questions@freebsd.org>;
	Tue,  2 May 2006 13:29:14 +0000 (GMT)
	(envelope-from lists@jnielsen.net)
Received: from localhost (jn@ns1 [69.55.238.237]) (authenticated bits=0)
	by ns1.jnielsen.net (8.12.9p2/8.12.9) with ESMTP id k42DTDQN087396;
	Tue, 2 May 2006 06:29:14 -0700 (PDT)
	(envelope-from lists@jnielsen.net)
From: John Nielsen <lists@jnielsen.net>
To: freebsd-questions@freebsd.org
Date: Tue, 2 May 2006 09:28:31 -0400
User-Agent: KMail/1.9.1
References: <e572718c0605020318i5175e90u127feefff4cf28e9@mail.gmail.com>
In-Reply-To: <e572718c0605020318i5175e90u127feefff4cf28e9@mail.gmail.com>
X-Face: #X5#Y*q>F:]zT!DegL3z5Xo'^MN[$8k\[4^3rN~wm=s=Uw(sW}R?3b^*f1Wu*.<=?utf-8?q?of=5F4NrS=0A=09P*M/9CpxDo!D6?=)IY1w<9B1jB;
	tBQf[RU-R<,I)e"$q7N7
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200605020928.31886.lists@jnielsen.net>
X-Virus-Scanned: ClamAV version 0.88,
	clamav-milter version 0.87 on ns1.jnielsen.net
X-Virus-Status: Clean
Cc: Pietro Cerutti <pietro.cerutti@gmail.com>
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 13:29:15 -0000

On Tuesday 02 May 2006 06:18, Pietro Cerutti wrote:
> I just read the InformIT article on OpenBSD 3.9, available here:
> http://www.informit.com/articles/article.asp?p=468055&f1=rss&rl=1
>
> 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. :)

JN