From owner-freebsd-doc@FreeBSD.ORG  Fri Oct 13 02:28:42 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@freebsd.org
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 2794516A49E;
	Fri, 13 Oct 2006 02:28:42 +0000 (UTC)
	(envelope-from mi+mx@aldan.algebra.com)
Received: from corbulon.video-collage.com
	(static-151-204-231-237.bos.east.verizon.net [151.204.231.237])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 65A6843D68;
	Fri, 13 Oct 2006 02:27:52 +0000 (GMT)
	(envelope-from mi+mx@aldan.algebra.com)
Received: from [172.21.130.86] (mx-broadway [38.98.68.18])
	by corbulon.video-collage.com (8.13.6/8.13.6) with ESMTP id
	k9D2Qjxt018349
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Thu, 12 Oct 2006 22:26:46 -0400 (EDT)
	(envelope-from mi+mx@aldan.algebra.com)
From: Mikhail Teterin <mi+mx@aldan.algebra.com>
Organization: Virtual Estates, Inc.
To: Tom Rhodes <trhodes@freebsd.org>, jmacd@cs.berkeley.edu
Date: Thu, 12 Oct 2006 22:26:39 -0400
User-Agent: KMail/1.9.1
References: <200610120845.k9C8jDdc070356@freefall.freebsd.org>
In-Reply-To: <200610120845.k9C8jDdc070356@freefall.freebsd.org>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="koi8-u"
Content-Transfer-Encoding: 8bit
Content-Disposition: inline
Message-Id: <200610122226.39844.mi+mx@aldan.algebra.com>
X-Virus-Scanned: ClamAV 0.88.4/2028/Thu Oct 12 16:36:51 2006 on
	corbulon.video-collage.com
X-Virus-Status: Clean
X-Scanned-By: MIMEDefang 2.43
Cc: freebsd-doc@freebsd.org, mi@aldan.algebra.com
Subject: Re: docs/65530: [patch] minor improvement to getgrent(3)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
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: Fri, 13 Oct 2006 02:28:42 -0000

ÞÅÔ×ÅÒ 12 ÖÏ×ÔÅÎØ 2006 04:45, Tom Rhodes ÎÁÐÉÓÁ×:
> This information is duplicated from the /usr/include/grp.h
> header file, we should change both or none.

Why? Header files are only a second-from-last sources of information 
(implementation being the last). A good manual page leaves no need to look at 
the declaration.

> I don't see a good reason to really change them right now as it seems seems
> self-explainatory. šThanks for the submission!

?? The information was put there in 1996 -- it just got lost because of a cvs 
mishap.

I don't believe it to be self-explanatory -- there is not even a single 
example in the man-page. One could *guess*, that the list is null terminated, 
but it should be explicit, or else time will be wasted searching for other 
api (getgroupnumber() ?) or writing test-programs.

Yours,

	-mi

http://www.freebsd.org/cgi/query-pr.cgi?pr=65530