Merge pull request #1382 from msebolt/walkthrough-review-pr4

walkthrough review pr4

Author: TrishaMc

docs/windows/walkthrough-creating-a-standard-cpp-program-cpp.md

@@ -1,7 +1,7 @@
 ---
 title: "Walkthrough: Creating a Standard C++ Program (C++) | Microsoft Docs"
 ms.custom: "get-started-article"
-ms.date: "11/04/2016"
+ms.date: "09/18/2018"
 ms.technology: ["cpp-windows"]
 ms.topic: "conceptual"
 f1_keywords: ["vcfirstapp", "vccreatefirst"]
@@ -31,41 +31,48 @@ To complete this walkthrough, you must understand the fundamentals of the C++ la
 
 1. Create a project by pointing to **New** on the **File** menu, and then clicking **Project**.
 
-2. In the **Visual C++** project types pane, click **Windows Desktop**, and then click **Windows Console Application**.
+1. In the **Visual C++** project types pane, click **Windows Desktop**, and then click **Windows Console Application**. 
 
-3. Type a name for the project.
+   > [!NOTE]
+   > For versions of Visual Studio older than 2017, in the **New Project** dialog box, expand **Installed** > **Templates** > **Visual C++**, and then select **Win32**. In the center pane, select **Win32 Console Application**. 
+
+   Type a name for the project.
 
    By default, the solution that contains the project has the same name as the project, but you can type a different name. You can also type a different location for the project.
 
    Click **OK** to create the project.
 
-4. If **Solution Explorer** is not displayed, on the **View** menu, click **Solution Explorer**.
+   > [!NOTE]
+   > For versions of Visual Studio older than 2017, complete the **Win32 Application Wizard**. Click **Next**, then make sure **Console Application** is selected and uncheck the **Precompiled Headers** box. Click **Finish**.
+
+1. If **Solution Explorer** is not displayed, on the **View** menu, click **Solution Explorer**.
 
-5. Add a new source file to the project, as follows.
+1. Add a new source file to the project, as follows.
 
    1. In **Solution Explorer**, right-click the **Source Files** folder, point to **Add**, and then click **New Item**.
 
-   2. In the **Code** node, click **C++ File (.cpp)**, type a name for the file, and then click **Add**.
+   1. In the **Code** node, click **C++ File (.cpp)**, type a name for the file, and then click **Add**.
 
    The .cpp file appears in the **Source Files** folder in **Solution Explorer**, and the file is opened in the Visual Studio editor.
 
-6. In the file in the editor, type a valid C++ program that uses the C++ Standard Library, or copy one of the sample programs and paste it in the file.
+1. In the file in the editor, type a valid C++ program that uses the C++ Standard Library, or copy one of the sample programs and paste it in the file.
 
-7. Save the file.
+1. Save the file.
 
-8. On the **Build** menu, click **Build Solution**.
+1. On the **Build** menu, click **Build Solution**.
 
    The **Output** window displays information about the compilation progress, for example, the location of the build log and a message that indicates the build status.
 
-9. On the **Debug** menu, click **Start without Debugging**.
+1. On the **Debug** menu, click **Start without Debugging**.
 
    If you used the sample program, a command window is displayed and shows whether certain integers are found in the set.
 
 ## Next Steps
 
-**Previous:** [Console Applications in Visual C++](../windows/console-applications-in-visual-cpp.md). **Next:**[Walkthrough: Compiling a Native C++ Program on the Command Line](../build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md).
+**Previous:** [Console Applications in Visual C++](../windows/console-applications-in-visual-cpp.md)<br/>
+**Next:** [Walkthrough: Compiling a Native C++ Program on the Command Line](../build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md)<br/>
 
 ## See Also
 
 [C++ Language Reference](../cpp/cpp-language-reference.md)<br/>
-[C++ Standard Library](../standard-library/cpp-standard-library-reference.md)
+[C++ Standard Library](../standard-library/cpp-standard-library-reference.md)<br/>

docs/windows/walkthrough-creating-and-using-a-static-library-cpp.md

@@ -1,7 +1,7 @@
 ---
 title: "Walkthrough: Creating and Using a Static Library (C++) | Microsoft Docs"
 ms.custom: "get-started-article"
-ms.date: "07/12/2018"
+ms.date: "09/18/2018"
 ms.technology: ["cpp-windows"]
 ms.topic: "conceptual"
 dev_langs: ["C++"]
@@ -37,35 +37,44 @@ An understanding of the fundamentals of the C++ language.
 
 1. On the menu bar, choose **File** > **New** > **Project**.
 
-2. In the left pane of the **New Project** dialog box, expand **Installed, Visual C++**, and then select **Windows Desktop**.
+1. In the left pane of the **New Project** dialog box, expand **Installed** > **Visual C++**, and then select **Windows Desktop**. In the center pane, select **Windows Desktop Wizard**.
 
-3. In the center pane, select **Windows Desktop Wizard**.
+   > [!NOTE]
+   > For versions of Visual Studio older than 2017, in the **New Project** dialog box, expand **Installed** > **Templates** > **Visual C++**, and then select **Win32**. In the center pane, select **Win32 Console Application**.
+
+1. Specify a name for the project—for example, *MathFuncsLib*—in the **Name** box. Specify a name for the solution—for example, *StaticLibrary*—in the **Solution Name** box. Choose the **OK** button.
+
+    - For Visual Studio 2017,
 
-4. Specify a name for the project—for example, *MathFuncsLib*—in the **Name** box. Specify a name for the solution—for example, *StaticLibrary*—in the **Solution Name** box. Choose the **OK** button.
+        1. Under **Application type**, select **Static Library (.lib)**.
 
-5. Under **Application type**, select Static Library (.lib).
+        1. Under **Additioal Options**, un-check the **Precompiled header** check box.
 
-6. Under **Additional Options**, un-check the **Precompiled header** check box.
+        1. Choose **OK** to create the project.
 
-7. Choose **OK** to create the project.
+    - For versions of Visual Studio older than 2017,
+
+        1. Click **Next**.
+
+        1. Under **Application type**, select **Static library**. Then uncheck the **Precompiled header** box and choose **Finish**.
 
 ##  <a name="AddClassToLib"></a> Adding a class to the static library
 
 ### To add a class to the static library
 
-1. To create a header file for a new class, open the shortcut menu for the **MathFuncsLib** project in **Solution Explorer**, and then choose **Add**, **New Item**. In the **Add New Item** dialog box, in the left pane, under **Visual C++**, select **Code**. In the center pane, select **Header File (.h)**. Specify a name for the header file—for example, *MathFuncsLib.h*—and then choose the **Add** button. A blank header file is displayed.
+1. To create a header file for a new class, open the shortcut menu for the **MathFuncsLib** project in **Solution Explorer**, and then choose **Add** > **New Item**. In the **Add New Item** dialog box, in the left pane, under **Visual C++**, select **Code**. In the center pane, select **Header File (.h)**. Specify a name for the header file—for example, *MathFuncsLib.h*—and then choose the **Add** button. A blank header file is displayed.
 
-2. Add a class named `MyMathFuncs` to do common mathematical operations such as addition, subtraction, multiplication, and division. The code should resemble this:
+1. Add a class named `MyMathFuncs` to do common mathematical operations such as addition, subtraction, multiplication, and division. The code should resemble this:
 
    [!code-cpp[NVC_Walkthrough_Create_Static_Lib#100](../windows/codesnippet/CPP/walkthrough-creating-and-using-a-static-library-cpp_1.h)]
 
-3. To create a source file for the new class, open the shortcut menu for the **MathFuncsLib** project in **Solution Explorer**, and then choose **Add**, **New Item**. In the **Add New Item** dialog box, in the left pane, under **Visual C++**, select **Code**. In the center pane, select **C++ File (.cpp)**. Specify a name for the source file—for example, *MathFuncsLib.cpp*—and then choose the **Add** button. A blank source file is displayed.
+1. To create a source file for the new class, open the shortcut menu for the **MathFuncsLib** project in **Solution Explorer**, and then choose **Add** > **New Item**. In the **Add New Item** dialog box, in the left pane, under **Visual C++**, select **Code**. In the center pane, select **C++ File (.cpp)**. Specify a name for the source file—for example, *MathFuncsLib.cpp*—and then choose the **Add** button. A blank source file is displayed.
 
-4. Use this source file to implement the functionality for **MyMathFuncs**. The code should resemble this:
+1. Use this source file to implement the functionality for **MyMathFuncs**. The code should resemble this:
 
    [!code-cpp[NVC_Walkthrough_Create_Static_Lib#110](../windows/codesnippet/CPP/walkthrough-creating-and-using-a-static-library-cpp_2.cpp)]
 
-5. Compile the static library by selecting **Build** > **Build Solution** on the menu bar. This creates a static library that can be used by other programs.
+1. Compile the static library by selecting **Build** > **Build Solution** on the menu bar. This creates a static library that can be used by other programs.
 
    > [!NOTE]
    > When you build on the Visual Studio command line, you must build the program in two steps. First, run `cl /c /EHsc MathFuncsLib.cpp` to compile the code and create an object file that's named `MathFuncsLib.obj`. (The `cl` command invokes the compiler, Cl.exe, and the `/c` option specifies compile without linking. For more information, see [/c (Compile Without Linking)](../build/reference/c-compile-without-linking.md).) Second, run `lib MathFuncsLib.obj` to link the code and create the static library `MathFuncsLib.lib`. (The `lib` command invokes the Library Manager, Lib.exe. For more information, see [LIB Reference](../build/reference/lib-reference.md).)
@@ -76,44 +85,54 @@ An understanding of the fundamentals of the C++ language.
 
 1. On the menu bar, choose **File** > **New** > **Project**.
 
-2. In the left pane of the **New Project** dialog box, expand **Installed, Visual C++**, and then select **Windows Desktop**.
+1. In the left pane of the **New Project** dialog box, expand **Installed** > **Visual C++**, and then select **Windows Desktop**. In the center pane, select **Windows Desktop Wizard**. 
+
+   > [!NOTE]
+   > For versions of Visual Studio older than 2017, in the **New Project** dialog box, expand **Installed** > **Templates** > **Visual C++**, and then select **Win32**. In the center pane, select **Win32 Console Application**.
+
+1. Specify a name for the project—for example, *MyExecRefsLib*—in the **Name** box. In the drop-down list next to **Solution**, select **Add to Solution**. This adds the new project to the solution that contains the static library. Choose the **OK** button.
+
+    - For Visual Studio 2017,
+
+        1. Under **Application type**, select **Console Application (.exe)**.
+
+        1. Under **Additioal Options**, un-check the **Precompiled header** check box.
 
-3. In the center pane, select **Windows Desktop Wizard**.
+        1. Choose **OK** to create the project.
 
-4. Specify a name for the project—for example, *MyExecRefsLib*—in the **Name** box. In the drop-down list next to **Solution**, select **Add to Solution**. This adds the new project to the solution that contains the static library. Choose the **OK** button.
-5. Under **Application type**, select **Console Application (.exe)**.
+    - For versions of Visual Studio older than 2017,
 
-6. Under **Additioal Options**, un-check the **Precompiled header** check box.
+        1. Click **Next**.
 
-7. Choose **OK** to create the project.
+        1. Make sure **Console application** is selected. Then check the **Empty Project** box and choose **Finish**.
 
 ##  <a name="UseLibInApp"></a> Using the functionality from the static library in the app
 
 ### To use the functionality from the static library in the app
 
 1. After you create a console app, an empty program is created for you. The name for the source file is the same as the name that you chose earlier. In this example, it's named `MyExecRefsLib.cpp`.
 
-2. Before you can use the math routines in the static library, you must reference it. To do this, open the shortcut menu for the **MyExecRefsLib** project in **Solution Explorer**, and then choose **Add** > **Reference**.
+1. Before you can use the math routines in the static library, you must reference it. To do this, open the shortcut menu for the **MyExecRefsLib** project in **Solution Explorer**, and then choose **Add** > **Reference**.
 
-3. The **Add Reference** dialog box lists the libraries that you can reference. The **Projects** tab lists the projects in the current solution and any libraries that they contain. On the **Projects** tab, select the **MathFuncsLib** check box, and then choose the **OK** button.
+1. The **Add Reference** dialog box lists the libraries that you can reference. The **Projects** tab lists the projects in the current solution and any libraries that they contain. On the **Projects** tab, select the **MathFuncsLib** check box, and then choose the **OK** button.
 
-4. To reference the `MathFuncsLib.h` header file, you must modify the included directories path. In the **Property Pages** dialog box for **MyExecRefsLib**, expand the **Configuration Properties** node, expand the **C/C++** node, and then select **General**. Next to **Additional Include Directories**, specify the path of the **MathFuncsLib** directory or browse for it.
+1. To reference the `MathFuncsLib.h` header file, you must modify the included directories path. In the **Property Pages** dialog box for **MyExecRefsLib**, expand the **Configuration Properties** node, expand the **C/C++** node, and then select **General**. Next to **Additional Include Directories**, specify the path of the **MathFuncsLib** directory or browse for it.
 
    To browse for the directory path, open the property value drop-down list, and then choose **Edit**. In the **Additional Include Directories** dialog box, in the text box, select a blank line and then choose the ellipsis button (**...**) at the end of the line. In the **Select Directory** dialog box, select the **MathFuncsLib** directory and then choose **Select Folder** button to save your selection and close the dialog box. In the **Additional Include Directories** dialog box, choose the **OK** button, and then in the **Property Pages** dialog box, choose the **OK** button to save your changes to the project.
 
-5. You can now use the `MyMathFuncs` class in this app. To do this, replace the contents of `MyExecRefsLib.cpp` with this code:
+1. You can now use the `MyMathFuncs` class in this app. To do this, replace the contents of `MyExecRefsLib.cpp` with this code:
 
    [!code-cpp[NVC_Walkthrough_Create_Static_Lib#120](../windows/codesnippet/CPP/walkthrough-creating-and-using-a-static-library-cpp_3.cpp)]
 
-6. Build the executable by choosing **Build** > **Build Solution** on the menu bar.
+1. Build the executable by choosing **Build** > **Build Solution** on the menu bar.
 
 ##  <a name="RunApp"></a> Running the app
 
 ### To run the app
 
 1. Make sure that **MyExecRefsLib** is selected as the default project by opening the shortcut menu for **MyExecRefsLib** in **Solution Explorer**, and then choosing **Set as StartUp Project**.
 
-2. To run the project, on the menu bar, choose **Debug** > **Start Without Debugging**. The output should resemble this:
+1. To run the project, on the menu bar, choose **Debug** > **Start Without Debugging**. The output should resemble this:
 
     ```Output
     a + b = 106.4
@@ -125,4 +144,4 @@ An understanding of the fundamentals of the C++ language.
 ## See Also
 
 [Walkthrough: Creating and Using a Dynamic Link Library (C++)](../build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md)<br/>
-[Desktop Applications (Visual C++)](../windows/desktop-applications-visual-cpp.md)
+[Desktop Applications (Visual C++)](../windows/desktop-applications-visual-cpp.md)<br/>

docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md

@@ -1,7 +1,7 @@
 ---
 title: "Walkthrough: Create a traditional Windows Desktop application (C++) | Microsoft Docs"
 ms.custom: "get-started-article"
-ms.date: "06/12/2018"
+ms.date: "09/18/2018"
 ms.technology: ["cpp-windows"]
 ms.topic: "conceptual"
 dev_langs: ["C++"]
@@ -107,7 +107,7 @@ Next, you'll learn how to create the code for a Windows desktop application in V
    For information about the parameters and return value of this function, see [WinMain entry point](https://msdn.microsoft.com/library/windows/desktop/ms633559).
 
    > [!NOTE]
-   > What are all those extra words, such as `CALLBACK`, or `HINSTANCE`, or `_In_`? The traditional Windows API uses typedefs and preprocessor macros extensively to abstract away some of the details of types and platform-specific code, such as calling conventions, **__declspec** declarations, and compiler pragmas. In Visual Studio, you can use the IntelliSense [Quick Info](/visualstudio/ide/using-intellisense#quick-info) feature to see what these typedefs and macros define. Hover your mouse over the word of interest, or select it and press ctrl-K, ctrl-I for a small pop-up window that contains the definition. For more information, see [Using IntelliSense](/visualstudio/ide/using-intellisense). Parameters and return types often use *SAL Annotations* to help you catch programming errors. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](/visualstudio/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects).
+   > What are all those extra words, such as `CALLBACK`, or `HINSTANCE`, or `_In_`? The traditional Windows API uses typedefs and preprocessor macros extensively to abstract away some of the details of types and platform-specific code, such as calling conventions, **__declspec** declarations, and compiler pragmas. In Visual Studio, you can use the IntelliSense [Quick Info](/visualstudio/ide/using-intellisense#quick-info) feature to see what these typedefs and macros define. Hover your mouse over the word of interest, or select it and press **Ctrl**+**K**, **Ctrl**+**I** for a small pop-up window that contains the definition. For more information, see [Using IntelliSense](/visualstudio/ide/using-intellisense). Parameters and return types often use *SAL Annotations* to help you catch programming errors. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](/visualstudio/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects).
 
 1. Windows desktop programs require <windows.h>. <tchar.h> defines the `TCHAR` macro, which resolves ultimately to **wchar_t** if the UNICODE symbol is defined in your project, otherwise it resolves to **char**.  If you always build with UNICODE enabled, you don't need TCHAR and can just use **wchar_t** directly.