Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Do not use the character sequence /* within a comment:

Code Block
bgColor#FFcccc
/* comment with end comment marker unintentionally omitted
security_critical_function();
/* some other comment */

In this example, the call to the security critical function is not executed. It is possible that , in reviewing a reviewer examining this page , a reviewer may incorrectly assume that the code is executed.

...

Because missing end deliminators are error prone and often viewed as a mistake, it is recommended that this approach not be used to comment is not recommended for commenting out code.

Compliant Solution (preprocessor)

...