<html>
<head>
<base href="http://llvm.org/bugs/" />
</head>
<body><table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Bug ID</th>
<td><a class="bz_bug_link
bz_status_NEW "
title="NEW --- - -Wdocumentation warns on \return tag for @propertys"
href="http://llvm.org/bugs/show_bug.cgi?id=15234">15234</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>-Wdocumentation warns on \return tag for @propertys
</td>
</tr>
<tr>
<th>Product</th>
<td>clang
</td>
</tr>
<tr>
<th>Version</th>
<td>3.2
</td>
</tr>
<tr>
<th>Hardware</th>
<td>Macintosh
</td>
</tr>
<tr>
<th>OS</th>
<td>MacOS X
</td>
</tr>
<tr>
<th>Status</th>
<td>NEW
</td>
</tr>
<tr>
<th>Severity</th>
<td>normal
</td>
</tr>
<tr>
<th>Priority</th>
<td>P
</td>
</tr>
<tr>
<th>Component</th>
<td>Frontend
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedclangbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>fritza@manoverboard.org
</td>
</tr>
<tr>
<th>CC</th>
<td>llvmbugs@cs.uiuc.edu
</td>
</tr>
<tr>
<th>Classification</th>
<td>Unclassified
</td>
</tr></table>
<p>
<div>
<pre>Summary:
When documentation warnings are on, documentation comments attached to
properties that include @return (\return) notes are flagged as errors. (Xcode
4.6)
Steps to Reproduce:
Create an iOS-app target with -Wdocumentation set in Other Warning Flags.
In any convenient class declaration, include the following lines:
===
/// The full predicate to be used for drawing objects from the store.
/// It is an AND of the parent's `prefixPredicate` (e.g., the selection for
/// volume number) and the `filterPredicate` (selection by matching the
name).
/// @return `nil` if there is no search string, and no prefix.
@property(readonly) NSPredicate * andPredicate;
/// The predicate that matches the string to be searched for. This
/// @return `nil` if there is no search string.
@property(readonly) NSPredicate * filterPredicate;
===
Product > Build
Expected Results:
No issues are flagged for this code.
Actual Results:
The comments beginning "/// @return" are given warnings:
'\return' command used in a comment that is not attached to a function or
method declaration
Regression:
This is the clang that comes with Xcode 4.6.
Notes:
Properties are wrappers on methods, and the methods in question may return
signal values that must be documented. It is reasonable to expect that these
should be documented as return values.</pre>
</div>
</p>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are on the CC list for the bug.</li>
</ul>
</body>
</html>