-Specific guidelines:
-
-
Indentation
===========
* It extends over multiple lines
*/
-Generally comments should say things that is clear from the code
+Generally comments should say things that aren't clear from the code
itself. If too many comments say obvious things, then people will just
stop reading all comments, including the good ones.
if (condition) foo (); else bar (); /* Yuck! */
-* Do eliminate trailing whitespace (space or tab characters) on any
- line. Also, avoid putting initial or final blank lines into any
- file, and never use multiple blank lines instead of a single blank
- line.
-
-* Do enable the default git pre-commit hook that detect trailing
- whitespace for you and help you to avoid corrupting cairo's tree
- with it. Do that as follows:
-
- chmod a+x .git/hooks/pre-commit
-
-* You might also find the git-stripspace utility helpful which acts as
- a filter to remove trailing whitespace as well as initial, final,
- and duplicate blank lines.
-
Function Definitions
====================
Function definitions should take the following form:
void
- my_function (argument)
+ my_function (int argument)
{
do_my_things ();
}
* vim:sw=4:sts=4:ts=8:tw=78:fo=tcroq:cindent:cino=\:0,(0
* vim:isk=a-z,A-Z,48-57,_,.,-,>
*/
+