From owner-cvs-all Wed Aug 30 8:20:40 2000 Delivered-To: cvs-all@freebsd.org Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by hub.freebsd.org (Postfix) with ESMTP id 7604537B42C; Wed, 30 Aug 2000 08:20:35 -0700 (PDT) Received: from fledge.watson.org (robert@fledge.pr.watson.org [192.0.2.3]) by fledge.watson.org (8.9.3/8.9.3) with SMTP id LAA12321; Wed, 30 Aug 2000 11:20:18 -0400 (EDT) (envelope-from robert@fledge.watson.org) Date: Wed, 30 Aug 2000 11:20:18 -0400 (EDT) From: Robert Watson X-Sender: robert@fledge.watson.org To: Sheldon Hearn Cc: Ruslan Ermilov , "Andrey A. Chernov" , cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: src/lib/libalias alias_proxy.c In-Reply-To: <83666.967647763@axl.fw.uunet.co.za> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Wed, 30 Aug 2000, Sheldon Hearn wrote: > Looking at the manual page, strtok() is implicitly defined as > non-reentrant when strtok_r is explicitly defined as reentrant. > > 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. Solaris explicitely documents the thread safety of each function in each man page, and I think that's actually a good idea, especially given that we'll have multiple threading models in the future. We already include thread implementation information in syscall manpages for the same reason. Call the new section "THREAD SAFETY" or something. (Or maybe that was IRIX, in any case, it's very useful) Robert N M Watson robert@fledge.watson.org http://www.watson.org/~robert/ PGP key fingerprint: AF B5 5F FF A6 4A 79 37 ED 5F 55 E9 58 04 6A B1 TIS Labs at Network Associates, Safeport Network Services To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message