aboutsummaryrefslogtreecommitdiff
path: root/doc/manual.cli
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2019-11-01 16:07:42 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2019-11-01 16:07:42 +0200
commit3ca5421a788cb50004fe62f452c43132492778e1 (patch)
tree4b48ef13d8a7284fc9173572c77e92e237b30815 /doc/manual.cli
parent727f2cb9a46337cabf01e9186f06f136550023fa (diff)
Add note to manual on absolute cl.exe paths
Diffstat (limited to 'doc/manual.cli')
-rw-r--r--doc/manual.cli18
1 files changed, 12 insertions, 6 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index be39b1f..d525494 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -206,10 +206,11 @@ $ b config.cxx=clang++
version and build for the \c{x86_64} target (\c{x64} in the Microsoft's
terminology). You can, however, override these defaults by either running from
a suitable Visual Studio development command prompt or by specifying an
-absolute path to \c{cl} that you wish to use. For example:
+absolute path to \c{cl} that you wish to use. For example (notice the use
+of inner quotes):
\
-> b \"config.cxx=...\VC\Tools\MSVC\14.23.28105\bin\Hostx64\x86\cl\"
+> b \"config.cxx='...\VC\Tools\MSVC\14.23.28105\bin\Hostx64\x86\cl'\"
\
See \l{#cc-msvc MSVC Compiler Toolchain} for details.|
@@ -5265,11 +5266,16 @@ SDK and use that in the 64-bit mode.
Finally, if the compiler is specified as an absolute path to \c{cl}, then the
\c{cc} module will attempt to locate the corresponding Visual Studio
installation as well as the latest Platform SDK and use that in the mode
-corresponding to the specified \c{cl} executable.
+corresponding to the specified \c{cl} executable. Note that to specify an
+absolute path to \c{cl} (which most likely contains spaces) we have to
+use two levels of quoting:
-Note that the latter two methods are only available for Visual Studio 15 (2017)
-and later and for earlier versions the development command prompt must be
-used.
+\
+> b \"config.cxx='...\VC\Tools\MSVC\14.23.28105\bin\Hostx64\x86\cl'\"
+\
+
+\N|The latter two methods are only available for Visual Studio 15 (2017) and
+later and for earlier versions the development command prompt must be used.|
The default MSVC runtime selected by the \c{cc} module is multi-threaded
shared (the \c{/MD} \c{cl} option). An alternative runtime can be selected