Skip to content

Commit

Permalink
Added a brief section documenting the preference of tabs over spaces.
Browse files Browse the repository at this point in the history
There are a few touch-ups in this commit, too.
  • Loading branch information
jparise committed Nov 26, 2000
1 parent dca467f commit 45807e6
Showing 1 changed file with 15 additions and 7 deletions.
22 changes: 15 additions & 7 deletions CODING_STANDARDS
Original file line number Original file line Diff line number Diff line change
Expand Up @@ -5,8 +5,9 @@ PHP Coding Standards
This file lists several standards that any programmer, adding or changing This file lists several standards that any programmer, adding or changing
code in PHP, should follow. Since this file was added at a very late code in PHP, should follow. Since this file was added at a very late
stage of the development of PHP v3.0, the code base does not (yet) fully stage of the development of PHP v3.0, the code base does not (yet) fully
follow it, but it's going in that general direction. Since we are now follow it, but it's going in that general direction. Since we are now
at version 4.0.3, many sections have been recoded to use these rules. well into the version 4 releases, many sections have been recoded to use
these rules.




Code Implementation Code Implementation
Expand Down Expand Up @@ -109,25 +110,32 @@ Syntax and indentation
is known to accept C++-style comments in C code. is known to accept C++-style comments in C code.


[2] Use K&R-style. Of course, we can't and don't want to [2] Use K&R-style. Of course, we can't and don't want to
force anybody to use a style she's not used to, but force anybody to use a style he or she is not used to, but,
at the very least, when you write code that goes into the core at the very least, when you write code that goes into the core
of PHP or one of its standard modules, please maintain the K&R of PHP or one of its standard modules, please maintain the K&R
style. This applies to just about everything, starting with style. This applies to just about everything, starting with
indentation and comment styles and up to function decleration indentation and comment styles and up to function decleration
syntax. syntax.


[3] Be generous with whitespace and braces. Always prefer [3] Be generous with whitespace and braces. Always prefer:
if (foo) {
if (foo) {
bar; bar;
} }
to
to:

if(foo)bar; if(foo)bar;

Keep one empty line between the variable decleration section and Keep one empty line between the variable decleration section and
the statements in a block, as well as between logical statement the statements in a block, as well as between logical statement
groups in a block. Maintain at least one empty line between groups in a block. Maintain at least one empty line between
two functions, preferably two. two functions, preferably two.


[4] When indenting, use the tab character. A tab is expected to represent
four spaces. It is important to maintain consistency in indenture so
that definitions, comments, and control structures line up correctly.

Documentation and Folding Hooks Documentation and Folding Hooks
------------------------------- -------------------------------


Expand Down

0 comments on commit 45807e6

Please sign in to comment.