diff --git a/doc/coding b/doc/coding index 04765546..3f410f07 100644 --- a/doc/coding +++ b/doc/coding @@ -168,7 +168,7 @@ You are encouraged to format multi-line comments like this: /* * Please use complete sentences, with proper grammer, - * capitalization and puntuation. Use two spaces between + * capitalization and punctuation. Use two spaces between * sentences. */ @@ -179,6 +179,13 @@ But please avoid elaborate boxes like this: * ugly, too. * ***********************************************************/ +Do not use + + // C++/C99 comments + +because they are not portable C89. + + Conditional compilation Unless the conditional code is very short, please comment it like