From owner-freebsd-doc@FreeBSD.ORG  Wed May  4 07:00:57 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3087716A4CF
	for <freebsd-doc@hub.freebsd.org>;
	Wed,  4 May 2005 07:00:57 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0C86143D68
	for <freebsd-doc@hub.freebsd.org>;
	Wed,  4 May 2005 07:00:57 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j4470OvM058629
	for <freebsd-doc@freefall.freebsd.org>; Wed, 4 May 2005 07:00:24 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j4470OJ2058622;
	Wed, 4 May 2005 07:00:24 GMT
	(envelope-from gnats)
Date: Wed, 4 May 2005 07:00:24 GMT
Message-Id: <200505040700.j4470OJ2058622@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Arne H Juul <arnej@europe.yahoo-inc.com>
Subject: Re: kern/80587: accept(2) can return EINVAL for undocumented reason
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Arne H Juul <arnej@europe.yahoo-inc.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 04 May 2005 07:00:57 -0000

The following reply was made to PR docs/80587; it has been noted by GNATS.

From: Arne H Juul <arnej@europe.yahoo-inc.com>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: kern/80587: accept(2) can return EINVAL for undocumented reason
Date: Wed, 4 May 2005 08:59:02 +0200 (CEST)

 On Wed, 4 May 2005, Giorgos Keramidas wrote:
 > I think that documenting both cases in a single paragraph of accept(2)
 > is ok too:
 >
 > 	 .It Bq Er EINVAL
 > 	 .Xr listen 2
 > 	-has not been called on the socket descriptor.
 > 	+has not been called on the socket descriptor or the
 > 	+.Fa addrlen
 > 	+argument is negative.
 
 This is just a style thing, and personally I don't really mind
 either way; other system call man pages have separate paragraphs
 for same errno with different reasons, so I think it's best
 to follow that style.
 
 -- 
 Arne H Juul                       Mail:  arnej@europe.yahoo-inc.com
 Release engineer                  Web:   http://www.yahoo.com/
 Yahoo Norway                      Phone: +47 7320 1219
 Prinsensgate 49, 7013 Trondheim   Fax:   +47 7320 1201