From owner-freebsd-doc@FreeBSD.ORG  Wed Jul  2 04:10:06 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CA5831065677
	for <freebsd-doc@hub.freebsd.org>; Wed,  2 Jul 2008 04:10:06 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id B8E608FC1A
	for <freebsd-doc@hub.freebsd.org>; Wed,  2 Jul 2008 04:10:06 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m624A6ih062744
	for <freebsd-doc@freefall.freebsd.org>; Wed, 2 Jul 2008 04:10:06 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m624A6AN062743;
	Wed, 2 Jul 2008 04:10:06 GMT (envelope-from gnats)
Date: Wed, 2 Jul 2008 04:10:06 GMT
Message-Id: <200807020410.m624A6AN062743@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: "Ben Kaduk" <minimarmot@gmail.com>
Cc: 
Subject: Re: docs/75995: hcreate(3) documentation(?) bug
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Ben Kaduk <minimarmot@gmail.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, 02 Jul 2008 04:10:06 -0000

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
 
 --- hcreate.3.0 2008-07-01 23:29:00.000000000 -0400
 +++ hcreate.3   2008-07-01 23:53:17.000000000 -0400
 @@ -1,6 +1,6 @@
  .\" $FreeBSD: src/lib/libc/stdlib/hcreate.3,v 1.5 2005/01/20 09:17:04 ru Exp $
  .\"
 -.Dd May 8, 2001
 +.Dd July 1, 2008
  .Os
  .Dt HCREATE 3
  .Sh NAME
 @@ -23,6 +23,7 @@
  and
  .Fn hsearch
  functions manage hash search tables.
 +Only one hash table per process may be active at any given time.
  .Pp
  The
  .Fn hcreate
 @@ -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;
  otherwise, it returns non-zero.
  .Pp
  The
 @@ -199,6 +200,8 @@
  .Bl -tag -width Er
  .It Bq Er ENOMEM
  Insufficient storage space is available.
 +.It Bq Er EINVAL
 +A table already exists.
  .El
  .Sh SEE ALSO
  .Xr bsearch 3 ,