From owner-freebsd-doc@FreeBSD.ORG  Wed Jul  2 04:35:21 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id AF71E1065679
	for <freebsd-doc@freebsd.org>; Wed,  2 Jul 2008 04:35:21 +0000 (UTC)
	(envelope-from minimarmot@gmail.com)
Received: from yw-out-2324.google.com (yw-out-2324.google.com [74.125.46.29])
	by mx1.freebsd.org (Postfix) with ESMTP id 5B81B8FC16
	for <freebsd-doc@freebsd.org>; Wed,  2 Jul 2008 04:35:21 +0000 (UTC)
	(envelope-from minimarmot@gmail.com)
Received: by yw-out-2324.google.com with SMTP id 9so94174ywe.13
	for <freebsd-doc@freebsd.org>; Tue, 01 Jul 2008 21:35:20 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=domainkey-signature:received:received:message-id:date:from:to
	:subject:in-reply-to:mime-version:content-type
	:content-transfer-encoding:content-disposition:references;
	bh=7xWp/ovdJ7YrfviOTLHar/nVVkKYt0FfWha0gzbTpV8=;
	b=KgxNEgB1CG/ESb5G8JbCel6WppX7KEuIrpsbZnaQ21Gimy7akXHKJ4ZgOj4NP8bY2H
	61RWNwIG32UdV10AgBt/h7ILPQE1JdC/25v9zLm8e6sowAM4NwKEcuWgi8rrxI8AhZQh
	JX9KCu0wyIcLfjBfcKzSr6mHxVNOMh3zgC/3s=
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=message-id:date:from:to:subject:in-reply-to:mime-version
	:content-type:content-transfer-encoding:content-disposition
	:references;
	b=h8hw97XIiDf6STquFhrXfoI/XWzl3AN8jxcufK3jy7oaIM6xp/ApDD+Uyko0GvxXOU
	pJ9CeuRYII2d8yoUCPWHO1jyf2ekBcKEFvyeiqmM57SrjM9+NMeVrAqqdSNNAbNCjU3r
	dNEN2Qk5YzomrhxJu3y9TQOKIQwCGUCKFyoME=
Received: by 10.151.44.15 with SMTP id w15mr11912001ybj.209.1214973320298;
	Tue, 01 Jul 2008 21:35:20 -0700 (PDT)
Received: by 10.151.67.2 with HTTP; Tue, 1 Jul 2008 21:35:20 -0700 (PDT)
Message-ID: <47d0403c0807012135o294263e7k67ce7af85ef53e20@mail.gmail.com>
Date: Wed, 2 Jul 2008 00:35:20 -0400
From: "Ben Kaduk" <minimarmot@gmail.com>
To: freebsd-doc@freebsd.org
In-Reply-To: <200807020410.m624A6AN062743@freefall.freebsd.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <200807020410.m624A6AN062743@freefall.freebsd.org>
Subject: Re: docs/75995: hcreate(3) documentation(?) bug
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: Wed, 02 Jul 2008 04:35:21 -0000

On Wed, Jul 2, 2008 at 12:10 AM, Ben Kaduk <minimarmot@gmail.com> wrote:
> The following reply was made to PR docs/75995; it has been noted by GNATS.
>
> From: "Ben Kaduk" <minimarmot@gmail.com>
> To: bug-followup@FreeBSD.org
> Cc:
> Subject: Re: docs/75995: hcreate(3) documentation(?) bug
> Date: Wed, 2 Jul 2008 00:03:45 -0400
>
>  It definitely looks like a documentation bug.
>
>  I've put a patch up at
>  http://stuff.mit.edu/afs/sipb.mit.edu/user/kaduk/freebsd/patches/htcreate.diff.2008.07.01
>  in case gmail mangles the whitespace.
>
>  Thanks to sbahra on #bsddocs for pointing out that we should mention that
>  errno gets set.
>
>  -Ben Kaduk
[...]
>  @@ -111,7 +112,7 @@
>  .Sh RETURN VALUES
>  The
>  .Fn hcreate
>  -function returns 0 if it cannot allocate sufficient space for the table;
>  +function returns 0 if the table creation failed;

That should be
if the table creation failed and sets errno;
the linked patch is updated.

-Ben Kaduk

>  otherwise, it returns non-zero.
>  .Pp
>  The