From nobody@FreeBSD.org  Thu Jul 12 06:43:00 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0C7AE37B401
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Jul 2001 06:43:00 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f6CDh0c29642;
	Thu, 12 Jul 2001 06:43:00 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200107121343.f6CDh0c29642@freefall.freebsd.org>
Date: Thu, 12 Jul 2001 06:43:00 -0700 (PDT)
From: Thierry Herbelot <thierry@herbelot.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: inconsistency in a man page (versus KERNEL config)
X-Send-Pr-Version: www-1.0

>Number:         28915
>Category:       docs
>Synopsis:       inconsistency in a man page (versus KERNEL config)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 12 06:50:00 PDT 2001
>Closed-Date:    Mon Aug 6 06:39:12 PDT 2001
>Last-Modified:  Mon Aug 06 06:40:13 PDT 2001
>Originator:     Thierry Herbelot
>Release:        4.3-Release
>Organization:
>Environment:
FreeBSD test.XXX 4.3-RELEASE FreeBSD 4.3-RELEASE #0: Wed Jul 11 15:50:08 CEST 2001     herbelot@test.XXX:/usr/src/sys/compile/test  i386  
>Description:
the man page for mkfifo(2) says :
--------------
ERRORS
     Mkfifo() will fail and no fifo will be created if:

     [ENOTSUP] The kernel has not been configured to support fifo's.
--------------

I do not see any FIFO config option in the LINT kernel config file, thus the man page seems to be wrong : it is not possible to compile a FreeBSD kernel without FIFO's

>How-To-Repeat:

>Fix:
the manual lines cited should be removed
>Release-Note:
>Audit-Trail:

From: Dima Dorfman <dima@unixfreak.org>
To: Thierry Herbelot <thierry@herbelot.com>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/28915: inconsistency in a man page (versus KERNEL config) 
Date: Fri, 13 Jul 2001 07:49:38 -0700

 Thierry Herbelot <thierry@herbelot.com> writes:
 > >Description:
 > the man page for mkfifo(2) says :
 > --------------
 > ERRORS
 >      Mkfifo() will fail and no fifo will be created if:
 > 
 >      [ENOTSUP] The kernel has not been configured to support fifo's.
 > --------------
 > 
 
 > I do not see any FIFO config option in the LINT kernel config file,
 > thus the man page seems to be wrong : it is not possible to compile
 > a FreeBSD kernel without FIFO's
 
 Man pages for calls that are defined by some standard (in this case,
 by POSIX.2) should document all allowed error returns even if they
 aren't possible in FreeBSD today.  This allows program authors to
 write portable code; portable not only across platforms, but across
 different versions of FreeBSD (who's to say there won't be a kernel
 option for this tomorrow?).
State-Changed-From-To: open->closed 
State-Changed-By: alex 
State-Changed-When: Mon Aug 6 06:39:12 PDT 2001 
State-Changed-Why:  
As Dima pointed out, this return code is for 
compatibility.  Remember software that is ported to other 
OSes. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=28915 
>Unformatted:
