From owner-freebsd-standards Wed Mar 12 3:42:48 2003 Delivered-To: freebsd-standards@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 23E6737B401; Wed, 12 Mar 2003 03:42:47 -0800 (PST) Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8404043F3F; Wed, 12 Mar 2003 03:42:43 -0800 (PST) (envelope-from bde@zeta.org.au) Received: from katana.zip.com.au (katana.zip.com.au [61.8.7.246]) by mailman.zeta.org.au (8.9.3/8.8.7) with ESMTP id WAA18682; Wed, 12 Mar 2003 22:42:36 +1100 Date: Wed, 12 Mar 2003 22:42:35 +1100 (EST) From: Bruce Evans X-X-Sender: bde@gamplex.bde.org To: Sean Chittenden Cc: standards@FreeBSD.ORG Subject: Re: environ.7 update (#include ?)... In-Reply-To: <20030312091658.GS79234@perrin.int.nxad.com> Message-ID: <20030312222222.F29327@gamplex.bde.org> References: <20030312091658.GS79234@perrin.int.nxad.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-standards@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Wed, 12 Mar 2003, Sean Chittenden wrote: > Simple question: should environ(7) be updated to include in > its SYNOPSIS? > > It's not required, but I think it's good form to do so. There was > some debate as to this on IRC so I'm positing the question. No. Includes don't belong in section 7 man pages, and environ isn't even declared in . It is intentionally not declared in any header in POSIX.1-2001(draft7): 547 2.2.2 The Name Space 548 All identifiers in this volume of IEEE Std 1003.1-200x, except environ, are defined in at least one 549 of the headers, as shown in the Base Definitions volume of IEEE Std 1003.1-200x, Chapter 13, ... 2229 A.8.1 Environment Variable Definition 2230 The variable environ is not intended to be declared in any header, but rather to be declared by the 2231 user for accessing the array of strings that is the environment. This is the traditional usage of the 2232 symbol. Putting it into a header could break some programs that use the symbol for their own 2233 purposes. Bruce To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-standards" in the body of the message