|author||Carl Worth <firstname.lastname@example.org>||2005-08-23 12:48:17 +0000|
|committer||Carl Worth <email@example.com>||2005-08-23 12:48:17 +0000|
Revise the description of indentation and tabs to be clear (I hope).
Diffstat (limited to 'CODING_STYLE')
1 files changed, 24 insertions, 5 deletions
diff --git a/CODING_STYLE b/CODING_STYLE
index 143723d4f..268d8bcab 100644
@@ -24,14 +24,33 @@ Each new level is indented 4 more spaces than the previous level:
-Spaces or tabs (or a combination) can be used in indentation, but tabs
-must always be interpreted as 8 spaces. Code using single tabs for all
-indentation (expecting people to interpret tabs as 4 spaces) will not
-be accepted in cairo.
+This may be achieved with space characters or a combination of tab
+characters and space characters. It may not be achieved with tab
+characters exclusively (see below).
+The tab character must always be interepreted according to its
+ Advance to the next column which is a multiple of 8.
+With this definition, even levels of indentation can be achieved with
+a sequence of tab characters, while odd levels of indentation may
+begin with a sequence of tab character but must end with 4 space
+Some programmers have been misled by certain text editors into
+thinking that 4-space indentation can be achieved with tab characters
+exclusively by changing the meaning of tab character to be "advance to
+the next column which is a multiple of 4". Code formatted in this way,
+making an assumption of a fictitious 4-character-tab will not be
+accepted into cairo.
The rationale here is that tabs are used in the code for lining things
up other than indentation, (see the Whitespace section below), and
-changing the interpretation of tab from 8 characters will break this.
+changing the interpretation of tab from its traditional meaning will
+break this alignment.