diff options
-rw-r--r-- | docs/CodingStandards.rst | 7 |
1 files changed, 0 insertions, 7 deletions
diff --git a/docs/CodingStandards.rst b/docs/CodingStandards.rst index 9418680edc..3bf62514a9 100644 --- a/docs/CodingStandards.rst +++ b/docs/CodingStandards.rst @@ -195,13 +195,6 @@ A documentation comment that uses all Doxygen features in a preferred way: /// \returns true on success. bool fooBar(bool Baz, StringRef Quux, std::vector<int> &Result); -Don't duplicate the documentation comment in the header file and in the -implementation file. Put the documentation comments for public APIs into the -header file. Documentation comments for private APIs can go to the -implementation file. In any case, implementation files can include additional -comments (not necessarily in Doxygen markup) to explain implementation details -as needed. - Don't duplicate function or class name at the beginning of the comment. For humans it is obvious which function or class is being documented; automatic documentation processing tools are smart enough to bind the comment |