Req #7766 [NEW]: Reference to '1TBS' confusing

From: Date: Wed, 31 May 2006 03:29:53 +0000
Subject: Req #7766 [NEW]: Reference to '1TBS' confusing
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-7961@lists.php.net to get a copy of this message
From: dominics at gmail dot com Operating system: Package version: PHP version: Irrelevant Package: Documentation Bug Type: Feature/Change Request Bug description: Reference to '1TBS' confusing Description: ------------ http://pear.php.net/manual/en/standards.funcdef.php makes a reference to the 'One True Brace Style'. I think this reference is at best confusing and at worst contradictory to the example given. What I mean is that in every non-PHP resource I've been able to find, 1TBS refers to the style used by Kernighan and Ritchie ('K&R' style) - this is the style the Unix kernels are written in ('Kernel' style). The style used by PEAR would be commonly known as the 'BSD' or 'Allman' style. I'm not looking to start a holy war about brace style. I do, however, think that we should be clear about exactly which brace style PEAR uses, and, regardless of what 1TBS is understood to stand for, it is an ambiguous term - it means a different thing to someone coming from C. Wikipedia is a good reference for the indent style terminology listed above: http://en.wikipedia.org/wiki/One_True_Brace Expected result: ---------------- Function declarations follow the 'BSD' or 'Allman' convention: Actual result: -------------- Function declarations follow the "one true brace" convention: -- Edit bug report at http://pear.php.net/bugs/bug.php?id=7766&edit=1 --

« previous php.pear.doc (#7961) next »