Page History

...

In this example, the call to the security-critical function is not executed.  A A reviewer examining this page could incorrectly assume that the code is executed.

If execution failure is failure is the result of an accidental omission, it is useful to use an editor that provides syntax highlighting or formats the code to help identify issues like missing end-comment delimiters.

...

Instead of using /* and */ to comment out blocks of code,  use use conditional compilation (for example, #if, #ifdef, or #ifndef):

#if 0  /*
        * Use of critical security function no
        * longer necessary.
         */
security_critical_function();
/* Some other comment */
#endif

...

This compliant solution takes advantage of the compiler's ability to remove unreachable (dead) code. The code inside the if block must remain acceptable to the compiler. If other parts of the program, such as macros, types, or function prototypes, later change in a way that would cause syntax errors, the unexecuted code must be brought up to date to correct the problem. Then, if it is needed again in the future,  the the programmer need only remove only remove the surrounding if statement and the NOTREACHED comment.

...

if (0) {  /*
           * Use of critical security function no
           * longer necessary, for now.
            */
  /*NOTREACHED*/
  security_critical_function();
  /* Some other comment */
}

This code is code is an instance of exception MSC07-C-EX2 to MSC07-C. Detect and remove dead code.

Noncompliant Code Example

Following are Following are some additional examples of comment styles that are confusing and should be avoided:

// */          /* Comment, not syntax error */

f = g/**//h;   /* Equivalent to f = g / h; */

//\
i();           /* Part of a two-line comment */

/\
/ j();         /* Part of a two-line comment */


/*//*/ l();    /* Equivalent to l(); */

m = n//**/o
+ p;           /* Equivalent to m = n + p; */

a = b //*divisor:*/c
+d;            /*
                * Interpreted as a = b/c + d; in c90
                * compiler and a = b + d; in c99 compiler.
                 */

Compliant Solution

Use a consistent style of commenting:

...

...