From owner-cvs-all  Wed Aug 21 11:33:17 2002
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 8445F37B400; Wed, 21 Aug 2002 11:33:12 -0700 (PDT)
Received: from khavrinen.lcs.mit.edu (khavrinen.lcs.mit.edu [18.24.4.193])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 0569C43E6A; Wed, 21 Aug 2002 11:33:12 -0700 (PDT)
	(envelope-from wollman@khavrinen.lcs.mit.edu)
Received: from khavrinen.lcs.mit.edu (localhost [IPv6:::1])
	by khavrinen.lcs.mit.edu (8.12.3/8.12.5) with ESMTP id g7LIXAiG001533
	(version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=OK);
	Wed, 21 Aug 2002 14:33:11 -0400 (EDT)
	(envelope-from wollman@khavrinen.lcs.mit.edu)
Received: (from wollman@localhost)
	by khavrinen.lcs.mit.edu (8.12.3/8.12.5/Submit) id g7LIXAv0001530;
	Wed, 21 Aug 2002 14:33:10 -0400 (EDT)
	(envelope-from wollman)
Date: Wed, 21 Aug 2002 14:33:10 -0400 (EDT)
From: Garrett Wollman <wollman@lcs.mit.edu>
Message-Id: <200208211833.g7LIXAv0001530@khavrinen.lcs.mit.edu>
To: Warner Losh <imp@FreeBSD.org>
Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject: cvs commit: src/share/man/man9 style.9
In-Reply-To: <200208210658.g7L6wMxu017178@freefall.freebsd.org>
References: <200208210658.g7L6wMxu017178@freefall.freebsd.org>
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

<<On Tue, 20 Aug 2002 23:58:22 -0700 (PDT), Warner Losh <imp@FreeBSD.org> said:

>   Suggest that function prototypes in kernel headers be alphabetical,
>   unless there's a compelling reason to deviate.
  
It should probably suggest that prototypes visible to user programs be
first blocked in order of increasing namespace before being
alphabetized.  It is more readable to have:

	#if FOO_AND_BAR_VISIBLE
	int bar(...);
	int foo(...);
	#endif

	#if BAZ_VISIBLE
	int baz(...);
	#endif

	#if FOO_BAR_AND_QUUX_VISIBLE
	int quux(...);
	#endif

...rather than:

	#if FOO_AND_BAR_VISIBLE
	int bar(...);
	#endif
	#if BAZ_VISIBLE
	int baz(...);
	#endif
	#if FOO_AND_BAR_VISIBLE
	int foo(...);
	#if FOO_BAR_AND_QUUX_VISIBLE
	int quux(...);
	#endif
	#endif

-GAWollman


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message