From owner-freebsd-doc Mon Jul 5 16: 8:14 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 8DBEE1537C for ; Mon, 5 Jul 1999 16:02:47 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.2) id XAA81600; Mon, 5 Jul 1999 23:41:29 +0100 (BST) (envelope-from nik) Date: Mon, 5 Jul 1999 23:41:28 +0100 From: Nik Clayton To: Tim Singletary Cc: freebsd-doc@freebsd.org Subject: Re: ndbm function man pages? Message-ID: <19990705234127.Q71138@catkin.nothing-going-on.org> References: <14208.49169.526453.608283@talon.my.domain> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <14208.49169.526453.608283@talon.my.domain>; from Tim Singletary on Mon, Jul 05, 1999 at 10:59:59AM -0400 Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jul 05, 1999 at 10:59:59AM -0400, Tim Singletary wrote: > > A look in /usr/src/lib/libc/db/hash/ shows the dbm_* functions are > > defined here, but it also looks like the proper way to use them is > > via the dbopen(3) function. > > dbopen() is a much better interface, and any documentation of the > dbm_* functions should reference dbopen(3). > > But dbopen() is not in `The Single UNIX Specification' (somewhere > under http://www.opengroup.org/) and is not included in Solaris; the > dbm_* functions are. Since legacy and `portable' code calls the dbm_* > functions directly, FreeBSD should document these functions. Agreed. > I assume the best place for dbm_* man pages is the > /usr/src/lib/libc/db/man directory? Almost certainly. If you'd like to write some manual pages that'd be great. When you've done so, please make them available for others to check out, and post a heads-up message about them here and to -hackers. If someone else (preferably a FreeBSD committer) can then review them for accuracy I'll gladly commit them in to the tree. Thanks for volunteering to do this. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message