From owner-cvs-all Wed Aug 30 17:56:34 2000 Delivered-To: cvs-all@freebsd.org Received: from guru.mired.org (zoom3-114.telepath.com [216.14.3.114]) by hub.freebsd.org (Postfix) with SMTP id EA70A37B424 for ; Wed, 30 Aug 2000 17:56:31 -0700 (PDT) Received: (qmail 69068 invoked by uid 100); 31 Aug 2000 00:55:53 -0000 From: Mike Meyer MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <14765.44313.881341.349343@guru.mired.org> Date: Wed, 30 Aug 2000 19:55:53 -0500 (CDT) To: Sheldon Hearn Cc: cvs-all@freebsd.org Subject: Re: cvs commit: src/lib/libalias alias_proxy.c In-Reply-To: <64650712@toto.iv> X-Mailer: VM 6.72 under 21.1 (patch 10) "Capitol Reef" XEmacs Lucid X-face: "5Mnwy%?j>IIV\)A=):rjWL~NB2aH[}Yq8Z=u~vJ`"(,&SiLvbbz2W`;h9L,Yg`+vb1>RG% *h+%X^n0EZd>TM8_IB;a8F?(Fb"lw'IgCoyM.[Lg#r\ Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Sheldon Hearn writes: > On Wed, 30 Aug 2000 17:34:20 +0300, Ruslan Ermilov wrote: > I wouldn't feel comfortable with adding to the manual page of every > non-reentrant function, a warning against its use in library code. > To me, that feels like adding to every manual page for a utility that > produces output, a warning that redirecting the output to a file with > the shell ">" operator will destroy the existing contents of the file. > :-) Nah - that's documented in the shell man page, which is enough. Whether or not a function is or isn't reentrant should be documented somewhere. Can you suggest a better place than the man pages?