Index: share/man/man9/style.9 =================================================================== --- share/man/man9/style.9 +++ share/man/man9/style.9 @@ -57,11 +57,17 @@ /* Most single-line comments look like this. */ +// Although they may look like this. + /* * Multi-line comments look like this. Make them real sentences. Fill * them so they look like real paragraphs. */ .Ed +C++ comments should only be used for single line comments, or comments at the +end of a statement. +C++ comments should not be introduced into existing code and should be +consistently used within a file. .Pp The copyright header should be a multi-line comment, with the first line of the comment having a dash after the star like so: