Date: Wed, 30 Aug 2000 11:20:18 -0400 (EDT) From: Robert Watson <rwatson@freebsd.org> To: Sheldon Hearn <sheldonh@uunet.co.za> Cc: Ruslan Ermilov <ru@sunbay.com>, "Andrey A. Chernov" <ache@freebsd.org>, cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: src/lib/libalias alias_proxy.c Message-ID: <Pine.NEB.3.96L.1000830111221.12020C-100000@fledge.watson.org> In-Reply-To: <83666.967647763@axl.fw.uunet.co.za>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.96L.1000830111221.12020C-100000>