/// preprocessor is not available.
comments::FullComment *getCommentForDecl(const Decl *D,
const Preprocessor *PP) const;
+
+ comments::FullComment *cloneFullComment(comments::FullComment *FC,
+ const Decl *D) const;
private:
mutable comments::CommandTraits CommentCommandTraits;
class TemplateParameterList;
namespace comments {
-
+class FullComment;
/// Any part of the comment.
/// Abstract class.
class Comment {
return getNumArgs() > 0;
}
- StringRef getParamName(const Decl *OverridingDecl) const {
- if (OverridingDecl && isParamIndexValid()) {
- if (const ObjCMethodDecl *OMD = dyn_cast<ObjCMethodDecl>(OverridingDecl)) {
- const ParmVarDecl *ParamDecl = OMD->param_begin()[getParamIndex()];
- return ParamDecl->getName();
- }
- else if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(OverridingDecl)) {
- const ParmVarDecl *ParamDecl = FD->param_begin()[getParamIndex()];
- return ParamDecl->getName();
- }
- }
- return Args[0].Text;
- }
+ StringRef getParamName(comments::FullComment *FC) const;
SourceRange getParamNameRange() const {
return Args[0].Range;
/// A full comment attached to a declaration, contains block content.
class FullComment : public Comment {
llvm::ArrayRef<BlockContentComment *> Blocks;
-
DeclInfo *ThisDeclInfo;
- /// Declaration that a comment is being looked for. This declaration and
- /// CommentDecl in ThisDeclInfo are generally the same. But they could be
- /// different when ThisDecl does not have comment and uses CommentDecl's comment.
- const Decl *ThisDecl;
public:
- FullComment(llvm::ArrayRef<BlockContentComment *> Blocks, DeclInfo *D,
- Decl *TD) :
+ FullComment(llvm::ArrayRef<BlockContentComment *> Blocks, DeclInfo *D) :
Comment(FullCommentKind, SourceLocation(), SourceLocation()),
- Blocks(Blocks), ThisDeclInfo(D), ThisDecl(TD) {
+ Blocks(Blocks), ThisDeclInfo(D) {
if (Blocks.empty())
return;
}
child_iterator child_end() const {
- return reinterpret_cast<child_iterator>(Blocks.end());
+ return reinterpret_cast<child_iterator>(Blocks.end());
}
const Decl *getDecl() const LLVM_READONLY {
return ThisDeclInfo->CommentDecl;
}
-
- const Decl *getDeclForCommentLookup() const LLVM_READONLY {
- return ThisDecl;
- }
const DeclInfo *getDeclInfo() const LLVM_READONLY {
if (!ThisDeclInfo->IsFilled)
llvm::ArrayRef<BlockContentComment *> getBlocks() const { return Blocks; }
};
-
} // end namespace comments
} // end namespace clang
}
}
+comments::FullComment *ASTContext::cloneFullComment(comments::FullComment *FC,
+ const Decl *D) const {
+ comments::DeclInfo *ThisDeclInfo = new (*this) comments::DeclInfo;
+ ThisDeclInfo->CommentDecl = D;
+ ThisDeclInfo->IsFilled = false;
+ ThisDeclInfo->fill();
+ ThisDeclInfo->CommentDecl = FC->getDecl();
+ comments::FullComment *CFC =
+ new (*this) comments::FullComment(FC->getBlocks(),
+ ThisDeclInfo);
+ return CFC;
+
+}
+
comments::FullComment *ASTContext::getCommentForDecl(
const Decl *D,
const Preprocessor *PP) const {
ParsedComments.find(Canonical);
if (Pos != ParsedComments.end()) {
- if (Canonical != D &&
- (isa<ObjCMethodDecl>(D) || isa<FunctionDecl>(D))) {
- // case of method being redeclaration of the canonical, not
- // overriding it; i.e. method in implementation, canonical in
- // interface. Or, out-of-line cxx-method definition.
+ if (Canonical != D) {
comments::FullComment *FC = Pos->second;
- comments::FullComment *CFC =
- new (*this) comments::FullComment(FC->getBlocks(),
- FC->getThisDeclInfo(),
- const_cast<Decl *>(D));
+ comments::FullComment *CFC = cloneFullComment(FC, D);
return CFC;
}
return Pos->second;
overridden);
for (unsigned i = 0, e = overridden.size(); i < e; i++) {
if (comments::FullComment *FC = getCommentForDecl(overridden[i], PP)) {
- comments::FullComment *CFC =
- new (*this) comments::FullComment(FC->getBlocks(),
- FC->getThisDeclInfo(),
- const_cast<Decl *>(D));
+ comments::FullComment *CFC = cloneFullComment(FC, D);
return CFC;
}
}
IsFilled = true;
}
+StringRef ParamCommandComment::getParamName(comments::FullComment *FC) const {
+ if (FC && isParamIndexValid())
+ return FC->getThisDeclInfo()->ParamVars[getParamIndex()]->getName();
+ return Args[0].Text;
+}
+
} // end namespace comments
} // end namespace clang
FullComment *Sema::actOnFullComment(
ArrayRef<BlockContentComment *> Blocks) {
- FullComment *FC = new (Allocator) FullComment(Blocks, ThisDeclInfo, 0);
+ FullComment *FC = new (Allocator) FullComment(Blocks, ThisDeclInfo);
resolveParamCommandIndexes(FC);
return FC;
}
// RUN: mkdir %t
// RUN: c-index-test -test-load-source all -comments-xml-schema=%S/../../bindings/xml/comment-xml-schema.rng %s > %t/out
// RUN: FileCheck %s < %t/out
-// rdar://12378793
+// Test to search overridden methods for documentation when overriding method has none. rdar://12378793
// Ensure that XML we generate is not invalid.
// RUN: FileCheck %s -check-prefix=WRONG < %t/out
} else
Result << "<dt class=\"param-name-index-invalid\">";
- appendToResultWithHTMLEscaping(C->getParamName(FC->getDeclForCommentLookup()));
+ appendToResultWithHTMLEscaping(C->getParamName(FC));
Result << "</dt>";
if (C->isParamIndexValid()) {
void CommentASTToXMLConverter::visitParamCommandComment(const ParamCommandComment *C) {
Result << "<Parameter><Name>";
- appendToResultWithXMLEscaping(C->getParamName(FC->getDeclForCommentLookup()));
+ appendToResultWithXMLEscaping(C->getParamName(FC));
Result << "</Name>";
if (C->isParamIndexValid())