There are two cases where an inline comment is allowed without ending punctuation: when the comment ends with a URL, or with a function declaration.
Currently a regex is used for this which is very permissive: if a single non-alphanumeric character appears in the last word of the comment, then the test is skipped. Some examples:
- // Missing space after "do"
- // Descend into sub-directory
We also need to add the double colon (:) to the permitted line endings, these are used multiple times in the examples on API documentation and comment standards, here's an example:
/**
* Example usage:
* @code
* mymodule_print('Hello World!');
* @endcode
* Text to immediately follow the code block.
*/
This case is currently also skipped because of the too permissive sniffing.
| Comment | File | Size | Author |
|---|---|---|---|
| #2 | 2567055-1.patch | 5 KB | pfrenssen |
Comments
Comment #2
pfrenssenComment #3
klausiCommitted, thanks!