-Wdocumentation should not check the @returns command for Objective-C
authorAlex Lorenz <arphaman@gmail.com>
Wed, 26 Apr 2017 13:09:28 +0000 (13:09 +0000)
committerAlex Lorenz <arphaman@gmail.com>
Wed, 26 Apr 2017 13:09:28 +0000 (13:09 +0000)
commit00353a0bf9d23fdd05a0bb3f2639366c971d7f6d
tree149e123155590ae14b676623f6a2ccdb8db7af69
parente093594074daaa01dba739e085f7b2fa9c5a9c9d
-Wdocumentation should not check the @returns command for Objective-C
function/block pointer properties

The commit r300981 allowed @param/@return commands for function/block
pointer property declarations. This meant that -Wdocumentation started warning
about @return that was used to document properties whose function/block type
returned void. However, prior to that commit, we allowed @return for all
property declarations, because it can be used to document the value that's
returned by the property getter. This commit restores the previous behaviour:
now the @return command can be used to document all properties without warnings.

rdar://24978538

llvm-svn: 301402
clang/lib/AST/CommentSema.cpp
clang/test/Sema/warn-documentation.m