Skip to content
Browse files

Added a brief section documenting the preference of tabs over spaces.

There are a few touch-ups in this commit, too.
  • Loading branch information...
1 parent dca467f commit 45807e6dd997147f5de89b5d2d2fcddd3815fd1e @jparise jparise committed Nov 26, 2000
Showing with 15 additions and 7 deletions.
  1. +15 −7 CODING_STANDARDS
View
22 CODING_STANDARDS
@@ -5,8 +5,9 @@ PHP Coding Standards
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
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
-at version 4.0.3, many sections have been recoded to use these rules.
+follow it, but it's going in that general direction. Since we are now
+well into the version 4 releases, many sections have been recoded to use
+these rules.
Code Implementation
@@ -109,25 +110,32 @@ Syntax and indentation
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
- 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
of PHP or one of its standard modules, please maintain the K&R
style. This applies to just about everything, starting with
indentation and comment styles and up to function decleration
syntax.
-[3] Be generous with whitespace and braces. Always prefer
- if (foo) {
+[3] Be generous with whitespace and braces. Always prefer:
+
+ if (foo) {
bar;
}
- to
+
+ to:
+
if(foo)bar;
-
+
Keep one empty line between the variable decleration section and
the statements in a block, as well as between logical statement
groups in a block. Maintain at least one empty line between
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
-------------------------------

0 comments on commit 45807e6

Please sign in to comment.
Something went wrong with that request. Please try again.