From owner-freebsd-doc@FreeBSD.ORG  Fri Oct 13 03:48:44 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 90D8B16A403;
	Fri, 13 Oct 2006 03:48:44 +0000 (UTC)
	(envelope-from trhodes@FreeBSD.org)
Received: from pittgoth.com (ns1.pittgoth.com [216.38.206.188])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E76F043D46;
	Fri, 13 Oct 2006 03:48:43 +0000 (GMT)
	(envelope-from trhodes@FreeBSD.org)
Received: from localhost (net-ix.gw.ai.net [205.134.160.6] (may be forged))
	(authenticated bits=0)
	by pittgoth.com (8.13.6/8.13.6) with ESMTP id k9D3mCP2085981
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Thu, 12 Oct 2006 23:48:13 -0400 (EDT)
	(envelope-from trhodes@FreeBSD.org)
Date: Thu, 12 Oct 2006 23:48:00 -0400
From: Tom Rhodes <trhodes@FreeBSD.org>
To: Mikhail Teterin <mi+mx@aldan.algebra.com>
Message-Id: <20061012234800.3131bd97.trhodes@FreeBSD.org>
In-Reply-To: <200610122226.39844.mi+mx@aldan.algebra.com>
References: <200610120845.k9C8jDdc070356@freefall.freebsd.org>
	<200610122226.39844.mi+mx@aldan.algebra.com>
Organization: The FreeBSD Project
X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd7.0)
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Cc: trhodes@FreeBSD.org, freebsd-doc@FreeBSD.org, mi@aldan.algebra.com,
	jmacd@cs.berkeley.edu
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 03:48:44 -0000

On Thu, 12 Oct 2006 22:26:39 -0400
Mikhail Teterin <mi+mx@aldan.algebra.com> wrote:

> =DE=C5=D4=D7=C5=D2 12 =D6=CF=D7=D4=C5=CE=D8 2006 04:45, Tom Rhodes =CE=C1=
=D0=C9=D3=C1=D7:
> > This information is duplicated from the /usr/include/grp.h
> > header file, we should change both or none.
>=20
> Why? Header files are only a second-from-last sources of information=20
> (implementation being the last). A good manual page leaves no need to loo=
k at=20
> the declaration.

Then we should patch both, not just one.

>=20
> > I don't see a good reason to really change them right now as it seems s=
eems
> > self-explainatory. =9AThanks for the submission!
>=20
> ?? The information was put there in 1996 -- it just got lost because of a=
 cvs=20
> mishap.
>=20
> I don't believe it to be self-explanatory -- there is not even a single=20
> example in the man-page. One could *guess*, that the list is null termina=
ted,=20
> but it should be explicit, or else time will be wasted searching for othe=
r=20
> api (getgroupnumber() ?) or writing test-programs.

To me it seems fine, but if you want both patched then go for
it.  Send me a patch please.  ;)

--=20
Tom Rhodes