From eecd9b1d527b73756e23b68a0335a683b11fb37c Mon Sep 17 00:00:00 2001 From: Chris Lattner Date: Sun, 1 Sep 2013 15:48:08 +0000 Subject: Revert r189704, which removed the guidance about not duplicating doc comments. This is under active discussion. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@189730 91177308-0d34-0410-b5e6-96231b3b80d8 --- docs/CodingStandards.rst | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'docs') diff --git a/docs/CodingStandards.rst b/docs/CodingStandards.rst index 3bf62514a9..9418680edc 100644 --- a/docs/CodingStandards.rst +++ b/docs/CodingStandards.rst @@ -195,6 +195,13 @@ A documentation comment that uses all Doxygen features in a preferred way: /// \returns true on success. bool fooBar(bool Baz, StringRef Quux, std::vector &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 -- cgit v1.2.3