summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDimitri van Heesch <dimitri@stack.nl>2016-12-29 11:09:24 (GMT)
committerDimitri van Heesch <dimitri@stack.nl>2016-12-29 11:09:24 (GMT)
commitfaac7312b54d45ce4d3c1c7b8c9436cf1c9393e8 (patch)
tree18ea887d06649f4c2abdf3bb3f2a0bbc518e1c80
parent5730198d20511d93c20aa7870fc2bd11f478db85 (diff)
parentee5885770c79733ddd447afb61a2b9cbfcfeb10b (diff)
downloadDoxygen-faac7312b54d45ce4d3c1c7b8c9436cf1c9393e8.zip
Doxygen-faac7312b54d45ce4d3c1c7b8c9436cf1c9393e8.tar.gz
Doxygen-faac7312b54d45ce4d3c1c7b8c9436cf1c9393e8.tar.bz2
Merge branch 'master' of github.com:doxygen/doxygen
-rw-r--r--src/memberdef.cpp47
-rw-r--r--src/memberdef.h1
2 files changed, 28 insertions, 20 deletions
diff --git a/src/memberdef.cpp b/src/memberdef.cpp
index 8f1573c..d37efb9 100644
--- a/src/memberdef.cpp
+++ b/src/memberdef.cpp
@@ -3013,26 +3013,7 @@ void MemberDef::writeDocumentation(MemberList *ml,
//if (Config_getBool(EXTRACT_ALL) && !hasDocs) ol.enable(OutputGenerator::Latex);
ol.popGeneratorState();
- //------------------------------------------------
-
- if (!Config_getBool(EXTRACT_ALL) &&
- Config_getBool(WARN_IF_UNDOCUMENTED) &&
- Config_getBool(WARN_NO_PARAMDOC) &&
- !Doxygen::suppressDocWarnings)
- {
- if (!hasDocumentedParams())
- {
- warn_doc_error(getDefFileName(),getDefLine(),
- "parameters of member %s are not (all) documented",
- qPrint(qualifiedName()));
- }
- if (!hasDocumentedReturnType() && isFunction() && hasDocumentation())
- {
- warn_doc_error(getDefFileName(),getDefLine(),
- "return type of member %s is not documented",
- qPrint(qualifiedName()));
- }
- }
+ warnIfUndocumentedParams();
}
// strip scope and field name from the type
@@ -3267,9 +3248,35 @@ void MemberDef::warnIfUndocumented()
warn_undoc(getDefFileName(),getDefLine(),"Member %s%s (%s) of %s %s is not documented.",
qPrint(name()),qPrint(argsString()),qPrint(memberTypeName()),t,qPrint(d->name()));
}
+ else if (!isDetailedSectionLinkable())
+ {
+ warnIfUndocumentedParams();
+ }
}
+void MemberDef::warnIfUndocumentedParams()
+{
+ if (!Config_getBool(EXTRACT_ALL) &&
+ Config_getBool(WARN_IF_UNDOCUMENTED) &&
+ Config_getBool(WARN_NO_PARAMDOC) &&
+ !Doxygen::suppressDocWarnings)
+ {
+ if (!hasDocumentedParams())
+ {
+ warn_doc_error(getDefFileName(),getDefLine(),
+ "parameters of member %s are not (all) documented",
+ qPrint(qualifiedName()));
+ }
+ if (!hasDocumentedReturnType() &&
+ isFunction() && hasDocumentation())
+ {
+ warn_doc_error(getDefFileName(),getDefLine(),
+ "return type of member %s is not documented",
+ qPrint(qualifiedName()));
+ }
+ }
+}
bool MemberDef::isFriendClass() const
{
diff --git a/src/memberdef.h b/src/memberdef.h
index cda1baf..c0825b2 100644
--- a/src/memberdef.h
+++ b/src/memberdef.h
@@ -389,6 +389,7 @@ class MemberDef : public Definition
ClassDef *cd,NamespaceDef *nd,FileDef *fd,GroupDef *gd);
void writeTagFile(FTextStream &);
void warnIfUndocumented();
+ void warnIfUndocumentedParams();
MemberDef *createTemplateInstanceMember(ArgumentList *formalArgs,
ArgumentList *actualArgs);