Lines Matching full:comments
466 Sentences in comments start with an uppercase letter.
468 Single line comments::
472 Multi-line comments::
478 * Larger multi-line comments should be split into paragraphs.
481 No tail comments:
483 Please refrain from using tail comments. Tail comments disturb the
491 Use freestanding comments instead::
504 Comments should be added where the operation is not obvious. Documenting
516 Instead, comments should explain the non-obvious details and document
533 Function documentation comments:
536 and not free form comments::
553 usage of descriptive function names often replaces these tiny comments.
559 Documenting locking requirements is a good thing, but comments are not
577 if the caller doesn't hold the lock. Comments can't do that.
694 this often results in strangely formatted comments and the struct members