Merge pull request #2491 from MicrosoftDocs/master

11/13/2019 AM Publish

Author: Taojunshen

docs/assembler/masm/masm-for-x64-ml64-exe.md

@@ -6,7 +6,7 @@ ms.assetid: 89059103-f372-4968-80ea-0c7f90bb9c91
 ---
 # MASM for x64 (ml64.exe)
 
-Visual Studio includes both 32-bit and 64-bit hosted versions of Microsoft Assembler (MASM) to target x64 code. Named ml64.exe, this is the assembler that accepts x64 assembler language. The MASM command-line tools are installed when you choose a C++ workload during Visual Studio installation. The MASM tools are not available as a separate download. For instructions on how to download and install a copy of Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). If you do not want to install the complete Visual Studio IDE, but only want the command-line tools, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/).
+Visual Studio includes both 32-bit and 64-bit hosted versions of Microsoft Assembler (MASM) to target x64 code. Named ml64.exe, this is the assembler that accepts x64 assembler language. The MASM command-line tools are installed when you choose a C++ workload during Visual Studio installation. The MASM tools are not available as a separate download. For instructions on how to download and install a copy of Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). If you do not want to install the complete Visual Studio IDE, but only want the command-line tools, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019).
 
 To use MASM to build code for x64 targets on the command line, you must use a developer command prompt for x64 targets, which sets the required path and other environment variables. For information on how to start a developer command prompt, see [Build C/C++ code on the command line](../../build/building-on-the-command-line.md).
 

docs/build/building-on-the-command-line.md

@@ -2,13 +2,17 @@
 title: "Use the Microsoft C++ toolset from the command line"
 description: "Use the Microsoft C++ compiler toolchain (MSVC) from the command line outside of the Visual Studio IDE."
 ms.custom: "conceptual"
-ms.date: "10/22/2019"
+ms.date: "11/12/2019"
 helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"]
 ms.assetid: 7ca9daed-a003-4162-842d-908f79058365
 ---
 # Use the Microsoft C++ toolset from the command line
 
-You can build C and C++ applications on the command line by using tools that are included in Visual Studio. The Microsoft C++ (MSVC) compiler toolset is also downloadable as a standalone package from the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/) page. It's part of the **Build Tools for Visual Studio** package. You can choose to download only the tools you need for C++ development.
+You can build C and C++ applications on the command line by using tools that are included in Visual Studio. The Microsoft C++ (MSVC) compiler toolset is also downloadable as a standalone package that doesn't include the Visual Studio IDE.
+
+## Download and install the tools
+
+If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019). When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **C++ build tools** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015 or 2017 toolsets, select the optional MSVC v140 or MSVC v141 build tools. When you're satisfied with your selections, choose **Install**.
 
 ## How to use the command-line tools
 

docs/build/walkthrough-compile-a-c-program-on-the-command-line.md

@@ -17,7 +17,7 @@ To complete this walkthrough, you must have installed either Visual Studio and t
 
 Visual Studio is a powerful integrated development environment that supports a full-featured editor, resource managers, debuggers, and compilers for many languages and platforms. For information on these features and how to download and install Visual Studio, including the free Visual Studio Community edition, see [Install Visual Studio](/visualstudio/install/install-visual-studio).
 
-The Build Tools for Visual Studio version of Visual Studio installs only the command-line toolset, the compilers, tools, and libraries you need to build C and C++ programs. It's perfect for build labs or classroom exercises and installs relatively quickly. To install only the command-line toolset, download Build Tools for Visual Studio from the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/) page and run the installer.
+The Build Tools for Visual Studio version of Visual Studio installs only the command-line toolset, the compilers, tools, and libraries you need to build C and C++ programs. It's perfect for build labs or classroom exercises and installs relatively quickly. To install only the command-line toolset, download Build Tools for Visual Studio from the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019) page and run the installer. In the Visual Studio installer, select the **C++ build tools** workload, and choose **Install**.
 
 Before you can build a C or C++ program on the command line, you must verify that the tools are installed, and that you can access them from the command line. Visual C++ has complex requirements for the command-line environment to find the tools, headers, and libraries it uses. **You can't use Visual C++ in a plain command prompt window** without some preparation. You need a *developer command prompt* window, which is a regular command prompt window that has all the required environment variables set. Fortunately, Visual C++ installs shortcuts for you to launch developer command prompts that have the environment set up for command line builds. Unfortunately, the names of the developer command prompt shortcuts and where they're located are different in almost every version of Visual C++ and on different versions of Windows. Your first walkthrough task is to find the right shortcut to use.
 

docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md

@@ -20,7 +20,7 @@ To complete this walkthrough, you must have installed either Visual Studio and t
 
 Visual Studio is a powerful integrated development environment (IDE) that supports a full-featured editor, resource managers, debuggers, and compilers for many languages and platforms. For information on how to download and install Visual Studio, including the free Visual Studio Community edition, and to include support for C/C++ development, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md).
 
-The Build Tools for Visual Studio installs only the command-line compilers, tools, and libraries you need to build C and C++ programs. It's perfect for build labs or classroom exercises and installs relatively quickly. To install only the command-line tools, look for Build Tools for Visual Studio on the [Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/) page.
+The Build Tools for Visual Studio installs only the command-line compilers, tools, and libraries you need to build C and C++ programs. It's perfect for build labs or classroom exercises and installs relatively quickly. To install only the command-line tools, look for Build Tools for Visual Studio on the [Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019) page.
 
 Before you can build a C or C++ program on the command line, you must verify that the tools are installed, and that you can access them from the command line. Visual C++ has complex requirements for the command-line environment to find the tools, headers, and libraries it uses. **You can't use Visual C++ in a plain command prompt window** without doing some preparation. Fortunately, Visual C++ installs shortcuts for you to launch a developer command prompt that has the environment set up for command line builds. Unfortunately, the names of the developer command prompt shortcuts and where they're located are different in almost every version of Visual C++ and on different versions of Windows. Your first walkthrough task is finding the right one to use.
 

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md

@@ -13,7 +13,7 @@ An invalid warning specifier was used with **pragma** [warning](../../preprocess
 
 The following sample generates C4615:
 
-```
+```cpp
 // C4615.cpp
 // compile with: /W1 /LD
 #pragma warning(enable : 4401)   // C4615, 'enable' not valid specifier

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md

@@ -13,7 +13,7 @@ The warning number specified in the [warning](../../preprocessor/warning.md) pra
 
 The following sample generates C4616:
 
-```
+```cpp
 // C4616.cpp
 // compile with: /W1 /c
 #pragma warning( disable : 0 )   // C4616

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md

@@ -15,7 +15,7 @@ The pragma was processed without the argument.
 
 The following sample generates C4618:
 
-```
+```cpp
 // C4618.cpp
 // compile with: /W1 /LD
 #pragma code_seg("")   // C4618

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md

@@ -13,7 +13,7 @@ There is no postfix increment operator defined for the given type. The compiler
 
 This warning can be avoided by defining a postfix `++` operator. Create a two-argument version of the `++` operator as shown here:
 
-```
+```cpp
 // C4620.cpp
 // compile with: /W1
 class A

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md

@@ -13,7 +13,7 @@ There was no postfix decrement operator defined for the given type. The compiler
 
 This warning can be avoided by defining a postfix `--` operator. Create a two-argument version of the `--` operator as shown below:
 
-```
+```cpp
 // C4621.cpp
 // compile with: /W1
 class A

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md

@@ -13,7 +13,7 @@ A destructor was not accessible or deleted in a base class and was therefore not
 
 The following sample generates C4624 and shows how to fix it:
 
-```
+```cpp
 // C4624.cpp
 // compile with: /W1 /c
 class B {

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md

@@ -15,7 +15,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default](
 
 The following sample generates C4628:
 
-```
+```cpp
 // C4628.cpp
 // compile with: /WX
 #pragma warning(default : 4628)

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md

@@ -11,7 +11,7 @@ ms.assetid: d8926376-7acc-4fc7-8438-6f0de3468870
 
 A data member or member function is defined as `extern`. Members cannot be external, although entire objects can. The compiler ignores the `extern` keyword. The following sample generates C4630:
 
-```
+```cpp
 // C4630.cpp
 // compile with: /W1 /LD
 class A {

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md

@@ -13,7 +13,7 @@ The path to .xdc file (`file`) was not valid, and no .xdc file created.
 
 The following sample generates C4632:
 
-```
+```cpp
 // C4632.cpp
 // compile with: /clr /docv:\\falsedir /LD /W1
 // C4632 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md

@@ -11,7 +11,7 @@ ms.assetid: e29ba8db-7917-43f6-8e34-868b752279ae
 
 The .drectve option was used to pass an option to the linker. Instead use pragma [comment](../../preprocessor/comment-c-cpp.md) for passing a linker option.
 
-```
+```cpp
 // C4659.cpp
 // compile with: /W1 /LD
 #pragma code_seg(".drectve")   // C4659

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md

@@ -13,7 +13,7 @@ A member of the template class is not defined.
 
 ## Example
 
-```
+```cpp
 // C4661.cpp
 // compile with: /W1 /LD
 template<class T> class MyClass {

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md

@@ -13,7 +13,7 @@ The specified template-class was declared, but not defined.
 
 ## Example
 
-```
+```cpp
 // C4662.cpp
 // compile with: /W1 /LD
 template<class T, int i> class MyClass; // no definition

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md

@@ -13,7 +13,7 @@ You cannot instantiate a function template that has not been declared.
 
 The following sample will cause C4667:
 
-```
+```cpp
 // C4667a.cpp
 // compile with: /LD /W1
 template
@@ -22,7 +22,7 @@ void max(const int &, const int &); // C4667 expected
 
 To avoid this warning, first declare the function template:
 
-```
+```cpp
 // C4667b.cpp
 // compile with: /LD
 // Declare the function template

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md

@@ -13,7 +13,7 @@ A cast contains a Windows Runtime or managed type. The compiler completes the ca
 
 The following sample generates C4669 and shows how to fix it:
 
-```
+```cpp
 // C4669.cpp
 // compile with: /clr /W1
 ref struct A {

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md

@@ -15,7 +15,7 @@ The signature of a conversion operator was not correct. The method is not consid
 
 The following sample generates C4674.
 
-```
+```cpp
 // C4674.cpp
 // compile with: /clr /WX /W1 /LD
 ref class G {

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md

@@ -15,7 +15,7 @@ A type that has public accessibility outside the assembly uses a type that has p
 
 The following sample generates C4677.
 
-```
+```cpp
 // C4677.cpp
 // compile with: /clr /c /W1
 delegate void TestDel();

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md

@@ -13,7 +13,7 @@ You used an attribute that should not commonly be used.
 
 The following sample generates C4684:
 
-```
+```cpp
 // C4684.cpp
 // compile with: /W1 /LD
 [module(name="xx")]; // C4684 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md

@@ -15,7 +15,7 @@ A constraint list has an assembly private type, meaning it will not be available
 
 The following sample generates C4688.
 
-```
+```cpp
 // C4688.cpp
 // compile with: /clr /c /W1
 ref struct A {};   // private type

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md

@@ -19,7 +19,7 @@ However, unexpected behavior can occur if the compiler uses a definition that is
 
 This sample contains the original type definition.
 
-```
+```cpp
 // C4691_a.cpp
 // compile with: /clr /LD /W1
 public ref class Original_Type {};
@@ -29,7 +29,7 @@ public ref class Original_Type {};
 
 This sample references C4691_a.dll and declares a field of type Original_Type.
 
-```
+```cpp
 // C4691_b.cpp
 // compile with: /clr /LD
 #using "C4691_a.dll"
@@ -45,7 +45,7 @@ The following sample generates C4691.  Notice this sample contains a definition
 
 To resolve, reference the metadata file that contains the original type definition and remove the local declaration and definition.
 
-```
+```cpp
 // C4691_c.cpp
 // compile with: /clr /LD /W1
 // C4691 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md

@@ -19,7 +19,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha
 
 The following sample generates C4692.
 
-```
+```cpp
 // C4692.cpp
 // compile with: /W1 /c /clr
 #pragma warning(default:4692)

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md

@@ -13,7 +13,7 @@ The specified function can potentially not return a value.
 
 ## Example
 
-```
+```cpp
 // C4715a.cpp
 // compile with: /W1 /LD
 int func1( int i )
@@ -25,7 +25,7 @@ int func1( int i )
 
 To prevent this warning, modify the code so that all paths assign a return value to the function:
 
-```
+```cpp
 // C4715b.cpp
 // compile with: /LD
 int func1( int i )
@@ -37,7 +37,7 @@ int func1( int i )
 
 It is possible that your code may contain a call to a function that never returns, as in the following example:
 
-```
+```cpp
 // C4715c.cpp
 // compile with: /W1 /LD
 void fatal()

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md

@@ -19,7 +19,7 @@ This warning is automatically promoted to an error. If you wish to modify this b
 
 The following sample generates C4716:
 
-```
+```cpp
 // C4716.cpp
 // compile with: /c /W1
 // C4716 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md

@@ -13,7 +13,7 @@ Every path through a function contains a call to the function. Since there is no
 
 The following sample generates C4717:
 
-```
+```cpp
 // C4717.cpp
 // compile with: /W1 /c
 // C4717 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md

@@ -17,7 +17,7 @@ To resolve, remove the function call that causes the destructor to not return.
 
 The following sample generates C4722:
 
-```
+```cpp
 // C4722.cpp
 // compile with: /O1 /W1 /c
 #include <stdlib.h>

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md

@@ -15,7 +15,7 @@ To safely use `__m64` types and floating-point types in the same function, each
 
 The following sample generates C4730:
 
-```
+```cpp
 // C4730.cpp
 // compile with: /W1
 // processor: x86

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md

@@ -13,7 +13,7 @@ A frame pointer register was modified. You must save and restore the register in
 
 The following sample generates C4731:
 
-```
+```cpp
 // C4731.cpp
 // compile with: /W1 /LD
 // processor: x86

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md

@@ -15,7 +15,7 @@ To resolve this warning, either remove the FS:0 definition or turn off this warn
 
 The following sample generates C4733:
 
-```
+```cpp
 // C4733.cpp
 // compile with: /W1 /c
 // processor: x86

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md

@@ -15,7 +15,7 @@ To resolve this warning, only assign a value to a variable whose size can accomm
 
 The following sample generates C4739:
 
-```
+```cpp
 // C4739.cpp
 // compile with: /RTCs /Zi /W1 /c
 char *pc;

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md

@@ -19,7 +19,7 @@ For more information, see [pack](../../preprocessor/pack.md) and [__alignof Oper
 
 This is the first file that defines the type.
 
-```
+```c
 // C4742a.c
 // compile with: /c
 struct X {
@@ -31,7 +31,7 @@ struct X {
 
 The following sample generates C4742.
 
-```
+```c
 // C4742b.c
 // compile with: C4742a.c /W1 /GL
 // C4742 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md

@@ -20,7 +20,7 @@ C4744 is emitted only when files are compiled with /GL.  For more information, s
 
 This sample contains the first definition.
 
-```
+```c
 // C4744.c
 // compile with: /c /GL
 int global;
@@ -30,7 +30,7 @@ int global;
 
 The following sample generates C4744.
 
-```
+```c
 // C4744b.c
 // compile with: C4744.c /GL /W1
 // C4744 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md

@@ -23,7 +23,7 @@ For more information, see [Initialization of Mixed Assemblies](../../dotnet/init
 
 The following sample generates C4747.
 
-```
+```cpp
 // C4747.cpp
 // compile with: /clr /c /W1
 // C4747 expected

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md

@@ -25,7 +25,7 @@ The 'identifier' function forces inline expansion of the [_alloca](../../c-runti
 
 The following code example calls `MyFunction` in a loop, and `MyFunction` calls the `_alloca` function. The `__forceinline` modifier causes the inline expansion of the `_alloca` function.
 
-```
+```cpp
 // c4750.cpp
 // compile with: /O2 /W1 /c
 #include <intrin.h>