Difference between revisions of "Cpp Coding Standards/FORMAT"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Cpp Coding Standards/Topics/FORMAT moved to Cpp Coding Standards/Code Format: Improve Cpp_Coding_Standards structure.)
(Code Format (FORMAT) , added newlines)
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
== Code Format ==
+
== Code Format (FORMAT)==
How to format the code generally should not be governed by rules. Here are only a few things that are necessary for correct compiler behaviour or increase code readability significantly.
+
''Generally, how to format the code does not need to be be governed by rules. Here are only a few things necessary for correct compiler behaviour or to increase code readability significantly.''
----
+
=== Summary ===
+
==== NewlineEof ====
+
Always conclude your source file with a newline character.
+
  
==== SourceCharSet ====
+
===== Newline at End of File <span id="Eof">(Eof)</span> =====
Don't use non-ASCII characters.
+
Always conclude your source file with a newline character. [[/Eof|-> Details]]
  
Exception: Use UTF8 encoding in resource files.
+
===== Unix-style Newlines <span id="Newlines">(Newlines)</span> =====
 +
Always use unix-style (NL, not CR NL) newlines. [[/Newlines|-> Details]]
  
==== NoCppComments ====
+
===== Source Code Character Set  <span id="CharSet">(CharSet)</span> =====
Don't use C++ comments in C code or C headers.
+
Don't use non-ASCII characters.<br>
 +
Exception: Use UTF8 encoding in resource files.<br>
 +
[[/CharSet|-> Details]]
  
==== Indent4 ====
+
===== No Cpp Comments in C Code  <span id="CppComm">(CppComm)</span> =====
Indentation is 4 spaces.
+
Don't use C++ comments in C code or C headers. [[/CppComm|-> Details]]
  
==== NoTabs ====
+
===== Indentation  <span id="Indent">(Indent)</span> =====
Use spaces, not tabs.
+
Indentation is 4 spaces. [[/Indent|-> Details]]
----
+
 
=== Explanations ===
+
===== No Tabs  <span id="NoTabs">(NoTabs)</span> =====
 +
Use spaces, not tabs. [[/NoTabs|-> Details]]
  
 
----
 
----
 
[[Category:Coding Standards]]
 
[[Category:Coding Standards]]

Latest revision as of 15:26, 10 December 2008

Code Format (FORMAT)

Generally, how to format the code does not need to be be governed by rules. Here are only a few things necessary for correct compiler behaviour or to increase code readability significantly.

Newline at End of File (Eof)

Always conclude your source file with a newline character. -> Details

Unix-style Newlines (Newlines)

Always use unix-style (NL, not CR NL) newlines. -> Details

Source Code Character Set (CharSet)

Don't use non-ASCII characters.
Exception: Use UTF8 encoding in resource files.
-> Details

No Cpp Comments in C Code (CppComm)

Don't use C++ comments in C code or C headers. -> Details

Indentation (Indent)

Indentation is 4 spaces. -> Details

No Tabs (NoTabs)

Use spaces, not tabs. -> Details


Personal tools