From owner-cvs-all  Tue Sep 10  7:11:31 2002
Delivered-To: cvs-all@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 931)
	id 978BE37B400; Tue, 10 Sep 2002 07:11:26 -0700 (PDT)
Date: Tue, 10 Sep 2002 07:11:26 -0700
From: Juli Mallett <jmallett@FreeBSD.org>
To: Tony Finch <fanf@FreeBSD.org>
Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject: Re: cvs commit: src/share/man/man9 style.9
Message-ID: <20020910071126.B44916@FreeBSD.org>
References: <200209101054.g8AAseoS004374@freefall.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5.1i
In-Reply-To: <200209101054.g8AAseoS004374@freefall.freebsd.org>; from fanf@FreeBSD.org on Tue, Sep 10, 2002 at 03:54:40AM -0700
Organisation: The FreeBSD Project <http://FreeBSD.org>
X-Alternate-Addresses: <jmallett@NewGold.NET>, <jmallett@xMach.org>, <juli@jerkcity.com>, <flata@toxic.magnesium.net>, <jmallett@OpenDarwin.org>
X-Towel: Yes
X-LiveJournal: flata, jmallett
X-Negacore: Yes
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

* De: Tony Finch <fanf@FreeBSD.org> [ Data: 2002-09-10 ]
	[ Subjecte: cvs commit: src/share/man/man9 style.9 ]
> fanf        2002/09/10 03:54:40 PDT
> 
>   Modified files:
>     share/man/man9       style.9 
>   Log:
>   Remove a sentence about wrapping macro definitions in bare braces,
>   which became wrong after using do { } while (0) became recommended.
>   Move the definition of what braces are to their new first occurrence.
>   
>   Reviewed by:    bde

Any chance of us adopting the Mach (and Lites) policy of doing
<sys/macro_help.h> (actually <mach/macro_help.h>), and having some
macros like

#define	MACRO_BEGIN	do {
#define	MACRO_END	} while(0)	/* or with a ; if you like that */

?

IMHO this actually reduces the amount of obfuscation, because it makes
it clear what the statements are actually there to accomplish, and
keeps the braces from running into/obfuscating braces with meaning.
--
Juli Mallett <jmallett@FreeBSD.org>       | FreeBSD: The Power To Serve
Will break world for fulltime employment. | finger jmallett@FreeBSD.org

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