summaryrefslogtreecommitdiffstats
path: root/clang-tools-extra/docs
diff options
context:
space:
mode:
authorJohn Thompson <John.Thompson.JTSoftware@gmail.com>2013-09-23 14:17:27 +0000
committerJohn Thompson <John.Thompson.JTSoftware@gmail.com>2013-09-23 14:17:27 +0000
commit8925d4622b169ddca7bf1f1c386d5c8918e03a24 (patch)
tree8c707f44fc6627ec620ea25d602c5eeb7a3fda67 /clang-tools-extra/docs
parent942dfe625bcadadb7cd514bfcaf3a804ffc95820 (diff)
downloadbcm5719-llvm-8925d4622b169ddca7bf1f1c386d5c8918e03a24.tar.gz
bcm5719-llvm-8925d4622b169ddca7bf1f1c386d5c8918e03a24.zip
Changed error messages to use source quoting.
llvm-svn: 191201
Diffstat (limited to 'clang-tools-extra/docs')
-rw-r--r--clang-tools-extra/docs/modularize.rst77
1 files changed, 38 insertions, 39 deletions
diff --git a/clang-tools-extra/docs/modularize.rst b/clang-tools-extra/docs/modularize.rst
index d23dd83b91a..a389a7ab2b8 100644
--- a/clang-tools-extra/docs/modularize.rst
+++ b/clang-tools-extra/docs/modularize.rst
@@ -53,52 +53,51 @@ Modularize will check for the following:
* #include directives inside 'extern "C/C++" {}' or 'namespace (name) {}' blocks
Modularize will do normal C/C++ parsing, reporting normal errors and warnings,
-but will also report special error messages like the following:
+but will also report special error messages like the following::
- | error: '(symbol)' defined at multiple locations:
- | (file):(row):(column)
- | (file):(row):(column)
+ error: '(symbol)' defined at multiple locations:
+ (file):(row):(column)
+ (file):(row):(column)
- error: header '(file)' has different contents depending on how it was
- included
+ error: header '(file)' has different contents depending on how it was included
-The latter might be followed by messages like the following:
+The latter might be followed by messages like the following::
- | note: '(symbol)' in (file) at (row):(column) not always provided
+ note: '(symbol)' in (file) at (row):(column) not always provided
Checks will also be performed for macro expansions, defined(macro)
expressions, and preprocessor conditional directives that evaluate
-inconsistently, and can produce error messages like the following:
-
- | (...)/SubHeader.h:11:5:
- | #if SYMBOL == 1
- | ^
- | error: Macro instance 'SYMBOL' has different values in this header,
- | depending on how it was included.
- | 'SYMBOL' expanded to: '1' with respect to these inclusion paths:
- | (...)/Header1.h
- | (...)/SubHeader.h
- | (...)/SubHeader.h:3:9:
- | #define SYMBOL 1
- | ^
- | Macro defined here.
- | 'SYMBOL' expanded to: '2' with respect to these inclusion paths:
- | (...)/Header2.h
- | (...)/SubHeader.h
- | (...)/SubHeader.h:7:9:
- | #define SYMBOL 2
- | ^
- | Macro defined here.
+inconsistently, and can produce error messages like the following::
+
+ (...)/SubHeader.h:11:5:
+ #if SYMBOL == 1
+ ^
+ error: Macro instance 'SYMBOL' has different values in this header,
+ depending on how it was included.
+ 'SYMBOL' expanded to: '1' with respect to these inclusion paths:
+ (...)/Header1.h
+ (...)/SubHeader.h
+ (...)/SubHeader.h:3:9:
+ #define SYMBOL 1
+ ^
+ Macro defined here.
+ 'SYMBOL' expanded to: '2' with respect to these inclusion paths:
+ (...)/Header2.h
+ (...)/SubHeader.h
+ (...)/SubHeader.h:7:9:
+ #define SYMBOL 2
+ ^
+ Macro defined here.
Checks will also be performed for '#include' directives that are
nested inside 'extern "C/C++" {}' or 'namespace (name) {}' blocks,
-and can produce error message like the following:
-
- | IncludeInExtern.h:2:3:
- | #include "Empty.h"
- | ^
- | error: Include directive within extern "C" {}.
- | IncludeInExtern.h:1:1:
- | extern "C" {
- | ^
- | The "extern "C" {}" block is here.
+and can produce error message like the following::
+
+ IncludeInExtern.h:2:3:
+ #include "Empty.h"
+ ^
+ error: Include directive within extern "C" {}.
+ IncludeInExtern.h:1:1:
+ extern "C" {
+ ^
+ The "extern "C" {}" block is here.
OpenPOWER on IntegriCloud