summaryrefslogtreecommitdiffstats
path: root/Help/manual
diff options
context:
space:
mode:
authorCraig Scott <craig.scott@crascit.com>2018-10-19 10:31:27 (GMT)
committerKitware Robot <kwrobot@kitware.com>2018-10-19 10:31:55 (GMT)
commit7053dd301c694bbc5e13b7e32febd34596b22d4e (patch)
tree800c40e691d829a9c7ebf0cfb369c7b276df6d30 /Help/manual
parent250b8c16620e6817478c9d64e6063773a9d3be81 (diff)
parent93f3f65516c65d79fe7bea54e883f1d767a99b6b (diff)
downloadCMake-7053dd301c694bbc5e13b7e32febd34596b22d4e.zip
CMake-7053dd301c694bbc5e13b7e32febd34596b22d4e.tar.gz
CMake-7053dd301c694bbc5e13b7e32febd34596b22d4e.tar.bz2
Merge topic 'help-syntax-highlighting'
93f3f65516 Help: Revise docs of modules AddFileDependencies..CheckFunctionExists fc7ee1ca45 Help: Override pygments CMakeLexer to support <..> and [..] 74b3eacdc7 Help: Use appropriate list types in FindPkgConfig Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2468
Diffstat (limited to 'Help/manual')
-rw-r--r--Help/manual/cmake-language.7.rst17
1 files changed, 10 insertions, 7 deletions
diff --git a/Help/manual/cmake-language.7.rst b/Help/manual/cmake-language.7.rst
index 71649ba..8740d97 100644
--- a/Help/manual/cmake-language.7.rst
+++ b/Help/manual/cmake-language.7.rst
@@ -206,9 +206,10 @@ enclosed content, such as `Escape Sequences`_ or `Variable References`_,
is performed. A bracket argument is always given to the command
invocation as exactly one argument.
-For example:
+.. No code-block syntax highlighting in the following example
+ (long string literal not supported by our cmake.py)
-.. code-block:: cmake
+For example::
message([=[
This is the first line in a bracket argument with bracket length 1.
@@ -253,9 +254,10 @@ closing quotes. Both `Escape Sequences`_ and `Variable References`_
are evaluated. A quoted argument is always given to the command
invocation as exactly one argument.
-For example:
+.. No code-block syntax highlighting in the following example
+ (escape \" not supported by our cmake.py)
-::
+For example::
message("This is a quoted argument containing multiple lines.
This is always one argument even though it contains a ; character.
@@ -264,11 +266,12 @@ For example:
It does end in an unescaped double quote.
")
+.. No code-block syntax highlighting in the following example
+ (for conformity with the two above examples)
+
The final ``\`` on any line ending in an odd number of backslashes
is treated as a line continuation and ignored along with the
-immediately following newline character. For example:
-
-.. code-block:: cmake
+immediately following newline character. For example::
message("\
This is the first line of a quoted argument. \