From 6fba6e564487adb5b215168600539369a382d2e4 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Thu, 17 Oct 2019 09:27:09 +0200
Subject: Update Visual Studio instructions in intro

---
 doc/intro.cli | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/doc/intro.cli b/doc/intro.cli
index e672f4d..41852a5 100644
--- a/doc/intro.cli
+++ b/doc/intro.cli
@@ -368,12 +368,7 @@ $ bdep init -C @clang cc config.cxx=clang++
 
 Things will also look pretty similar if you are on Windows instead of a
 UNIX-like operating system. For example, to initialize our project on Windows
-with Visual Studio, start the Visual Studio development command prompt and
-then run:
-
-\N|Currently we have to run \c{build2} tools from a suitable Visual Studio
-development command prompt. This requirement will likely be removed in the
-future.|
+with Visual Studio, start a command prompt and then run:
 
 \
 > bdep init -C ..\hello-debug @debug cc     ^
@@ -386,6 +381,20 @@ future.|
   config.cc.coptions=/O2
 \
 
+\N|For Visual Studio, \c{build2} by default will use the latest available
+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.exe} that you wish to use. For example:
+
+\
+> bdep init -C ..\hello-debug-32 @debug-32 cc                       ^
+  \"config.cxx=...\VC\Tools\MSVC\14.23.28105\bin\Hostx64\x86\cl.exe\"
+  ...
+\
+
+|
+
 \N|Besides the \c{coptions} (compile options) and \c{loptions} (link options),
 other commonly used \c{cc} module configuration variables are \c{poptions}
 (preprocess options) and \c{libs} (extra libraries to link). Here is the
@@ -1841,8 +1850,7 @@ created new configuration in /tmp/tools/
 $ cd tools
 \
 
-The same step on Windows using Visual Studio would look like this (again,
-remember to run this from the Visual Studio development command prompt):
+The same step on Windows using Visual Studio would look like this:
 
 \
 $ bpkg create -d tools cc ^
-- 
cgit v1.1