Author: nico Date: Fri Apr 21 15:55:00 2017 New Revision: 301039 URL: http://llvm.org/viewvc/llvm-project?rev=301039&view=rev Log: Add comments to the diagnostic kinds in Diagnostic.td.
https://reviews.llvm.org/D32371 Modified: cfe/trunk/include/clang/Basic/Diagnostic.td Modified: cfe/trunk/include/clang/Basic/Diagnostic.td URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/include/clang/Basic/Diagnostic.td?rev=301039&r1=301038&r2=301039&view=diff ============================================================================== --- cfe/trunk/include/clang/Basic/Diagnostic.td (original) +++ cfe/trunk/include/clang/Basic/Diagnostic.td Fri Apr 21 15:55:00 2017 @@ -12,6 +12,8 @@ // //===----------------------------------------------------------------------===// +// See the Internals Manual, section The Diagnostics Subsystem for an overview. + // Define the diagnostic severities. class Severity<string N> { string Name = N; @@ -100,10 +102,20 @@ class SuppressInSystemHeader { class Error<string str> : Diagnostic<str, CLASS_ERROR, SEV_Error>, SFINAEFailure { bit ShowInSystemHeader = 1; } +// Warnings default to on (but can be default-off'd with DefaultIgnore). +// This is used for warnings about questionable code; warnings about +// accepted language extensions should use Extension or ExtWarn below instead. class Warning<string str> : Diagnostic<str, CLASS_WARNING, SEV_Warning>; +// Remarks can be turned on with -R flags and provide commentary, e.g. on +// optimizer decisions. class Remark<string str> : Diagnostic<str, CLASS_REMARK, SEV_Ignored>; +// Extensions are warnings about accepted language extensions. +// Extension warnings are default-off but enabled by -pedantic. class Extension<string str> : Diagnostic<str, CLASS_EXTENSION, SEV_Ignored>; +// ExtWarns are warnings about accepted language extensions. +// ExtWarn warnings are default-on. class ExtWarn<string str> : Diagnostic<str, CLASS_EXTENSION, SEV_Warning>; +// Notes can provide supplementary information on errors, warnings, and remarks. class Note<string str> : Diagnostic<str, CLASS_NOTE, SEV_Fatal/*ignored*/>; _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
