mirror of
https://github.com/yuzu-mirror/yuzu
synced 2024-11-24 14:23:02 +00:00
Merge pull request #252 from yuriks/patch-1
Resolve doxycomment duplication debate
This commit is contained in:
commit
f06922268a
1 changed files with 1 additions and 0 deletions
|
@ -27,6 +27,7 @@ Follow the indentation/whitespace style shown below. Do not use tabs, use 4-spac
|
||||||
### Comments
|
### Comments
|
||||||
* For regular comments, use C++ style (`//`) comments, even for multi-line ones.
|
* For regular comments, use C++ style (`//`) comments, even for multi-line ones.
|
||||||
* For doc-comments (Doxygen comments), use `/// ` if it's a single line, else use the `/**` `*/` style featured in the example. Start the text on the second line, not the first containing `/**`.
|
* For doc-comments (Doxygen comments), use `/// ` if it's a single line, else use the `/**` `*/` style featured in the example. Start the text on the second line, not the first containing `/**`.
|
||||||
|
* For items that are both defined and declared in two separate files, put the doc-comment only next to the associated declaration. (In a header file, usually.) Otherwise, put it next to the implementation. Never duplicate doc-comments in both places.
|
||||||
|
|
||||||
```cpp
|
```cpp
|
||||||
namespace Example {
|
namespace Example {
|
||||||
|
|
Loading…
Reference in a new issue