Merge remote-tracking branch 'upstream/master'

Author: Kevin Cadieux

.gitignore

@@ -6,6 +6,8 @@ _themes/
 _themes.MSDN.Modern/
 _themes.VS.Modern/
 
+# Ignore local configuration changes
+.github/
 .openpublishing.buildcore.ps1
 .vscode/
 

.openpublishing.redirection.json

@@ -685,6 +685,21 @@
       "redirect_url": "/cpp/build-insights/get-started-with-cpp-build-insights",
       "redirect_document_id": false
     },
+    {
+      "source_path": "docs/build-insights/vcperf-reference.md",
+      "redirect_url": "/cpp/build-insights/reference/vcperf-commands",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/build-insights/wpa-basics.md",
+      "redirect_url": "/cpp/build-insights/tutorials/wpa-basics",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/build-insights/wpa-views-reference.md",
+      "redirect_url": "/cpp/build-insights/reference/wpa-views",
+      "redirect_document_id": false
+    },
     {
       "source_path": "docs/c-language/index.md",
       "redirect_url": "/cpp/c-language/c-language-reference",

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+	"recommendations": [
+		"docsmsft.docs-authoring-pack"
+	]
+}

.vscode/settings.json

@@ -2,6 +2,16 @@
     "files.associations": {
         "random": "cpp"
     },
-
-    "git.ignoreLimitWarning": true
+    "git.ignoreLimitWarning": true,
+    "markdown.docsetLanguages": [
+        "ARM assembler",
+        "C",
+        "C#",
+        "C++",
+        "HTML",
+        "JSON",
+        "Makefile",
+        "VB.NET",
+        "XML"
+    ]
 }

CONTRIBUTING.md

@@ -6,11 +6,11 @@ In this topic, you'll see the basic process for adding or updating content in th
 
 In this topic, we'll cover:
 
-* [Process for contributing](#process-for-contributing)
-* [DOs and DON'Ts](#dos-and-donts)
-* [Building the docs](#building-the-docs)
-* [Contributing to samples](#contributing-to-samples)
-* [Contributor license agreement](#contributor-license-agreement)
+- [Process for contributing](#process-for-contributing)
+- [DOs and DON'Ts](#dos-and-donts)
+- [Building the docs](#building-the-docs)
+- [Contributing to samples](#contributing-to-samples)
+- [Contributor license agreement](#contributor-license-agreement)
 
 ## Process for contributing
 
@@ -36,11 +36,13 @@ Be sure to follow the proper Markdown syntax. See the [style guide](./styleguide
 
 ### Example structure
 
-    docs
-        /standard-library
-            wstring-convert-class.md
-            /media
-                wstring-conversion.png
+```
+docs
+    /standard-library
+        wstring-convert-class.md
+        /media
+            wstring-conversion.png
+```
 
 **Step 5:** Submit a Pull Request (PR) from your branch to `MicrosoftDocs/cpp-docs/master`.
 

docs/_breadcrumb/toc.yml

@@ -2,24 +2,24 @@
   tocHref: /
   topicHref: /
   items:
-  - name: Visual C++
+  - name: Microsoft C++
     tocHref: /cpp/
     topicHref: /cpp
     items:
     - name: Documentation
       tocHref: /cpp/
       topicHref: /cpp/overview/visual-cpp-in-visual-studio
       items:
-      - name: C++ Language
+      - name: C++ language
         tocHref: /cpp/cpp/
         topicHref: /cpp/cpp/cpp-language-reference
       - name: C Language
         tocHref: /cpp/c-language/
         topicHref: /cpp/c-language/c-language-reference
-      - name: C/C++ Preprocessor
+      - name: C/C++ preprocessor
         tocHref: /cpp/preprocessor/
         topicHref: /cpp/preprocessor/c-cpp-preprocessor-reference
-      - name: Compiler Intrinsics and Assembly Language
+      - name: Compiler intrinsics and assembly language
         tocHref: /cpp/intrinsics/
         topicHref: /cpp/intrinsics/compiler-intrinsics-and-assembly-language
         items:
@@ -32,86 +32,88 @@
         - name: MASM
           tocHref: /cpp/assembler/masm/
           topicHref: /cpp/assembler/masm/microsoft-macro-assembler-reference
-      - name: C Runtime Library
+      - name: C runtime library
         tocHref: /cpp/c-runtime-library/
         topicHref: /cpp/c-runtime-library/c-run-time-library-reference
         items:
         - name: Reference
           tocHref: /cpp/c-runtime-library/reference/
           topicHref: /cpp/c-runtime-library/reference/crt-alphabetical-function-reference
-      - name: C++ Standard Library
+      - name: C++ standard library
         tocHref: /cpp/standard-library/
         topicHref: /cpp/standard-library/cpp-standard-library-reference 
       - name: Windows
         tocHref: /cpp/windows/
         topicHref: /cpp/windows/overview-of-windows-programming-in-cpp
         items:
-        - name: ATL
-          tocHref: /cpp/atl/
-          topicHref: /cpp/atl/atl-com-desktop-components
-        - name: MFC
-          tocHref: /cpp/mfc/
-          topicHref: /cpp/mfc/mfc-desktop-applications
-          items:
-          - name: Reference
-            tocHref: /cpp/mfc/reference/
-            topicHref: /cpp/mfc/reference/mfc-classes
-        - name: ATL/MFC Shared Classes
-          tocHref: /cpp/atl-mfc-shared/
-          topicHref: /cpp/atl-mfc-shared/atl-mfc-shared-classes
-          items:
-          - name: Reference
-            tocHref: /cpp/atl-mfc-shared/reference/
-            topicHref: /cpp/atl-mfc-shared/reference/classes-shared-by-mfc-and-atl
-        - name: C++/CX
-          tocHref: /cpp/cppcx/
-          topicHref: /cpp/cppcx/visual-c-language-reference-c-cx
+      - name: ATL
+        tocHref: /cpp/atl/
+        topicHref: /cpp/atl/atl-com-desktop-components
+      - name: MFC
+        tocHref: /cpp/mfc/
+        topicHref: /cpp/mfc/mfc-desktop-applications
+        items:
+        - name: Reference
+          tocHref: /cpp/mfc/reference/
+          topicHref: /cpp/mfc/reference/mfc-classes
+      - name: ATL/MFC shared classes
+        tocHref: /cpp/atl-mfc-shared/
+        topicHref: /cpp/atl-mfc-shared/atl-mfc-shared-classes
+        items:
+        - name: Reference
+          tocHref: /cpp/atl-mfc-shared/reference/
+          topicHref: /cpp/atl-mfc-shared/reference/classes-shared-by-mfc-and-atl
+      - name: C++/CX
+        tocHref: /cpp/cppcx/
+        topicHref: /cpp/cppcx/visual-c-language-reference-c-cx
       - name: Linux
         tocHref: /cpp/linux/
         topicHref: /cpp/linux/download-install-and-setup-the-linux-development-workload
       - name: .NET
         tocHref: /cpp/dotnet/
         topicHref: /cpp/dotnet/dotnet-programming-with-cpp-cli-visual-cpp
-      - name: Parallel Programming
+      - name: Parallel programming
         tocHref: /cpp/parallel/
         topicHref: /cpp/parallel/parallel-programming-in-visual-cpp
-      - name: Data Access
+      - name: Data access
         tocHref: /cpp/data/
         topicHref: /cpp/data/data-access-in-cpp
         items:
         - name: OLEDB
           tocHref: /cpp/data/oledb/
-          topicHref:   /cpp/data/oledb/ole-db-programming
+          topicHref: /cpp/data/oledb/ole-db-programming
         - name: ODBC
           tocHref: /cpp/data/odbc/
           topicHref: /cpp/data/odbc/open-database-connectivity-odbc
       - name: Edit, navigate, and refactor code
         tocHref: /cpp/ide
-        topicHref: /cpp/overview-of-cpp-development
+        topicHref: /cpp/ide/read-and-understand-code-cpp
         items:
         - name: IDE
           tocHref: /cpp/ide/
           topicHref: /cpp/ide/using-the-visual-studio-ide-for-cpp-desktop-development
-      - name: Building C/C++ Projects
+      - name: Building C/C++ projects
         tocHref: /cpp/build/
         topicHref: /cpp/build/building-c-cpp-programs
         items:
-        - name: Build Reference
+        - name: Build reference
           tocHref: /cpp/build/reference/
           topicHref: /cpp/build/reference/c-cpp-building-reference
-          items:
-            - name: Compiler and tool errors and warnings
-              tocHref: /cpp/error-messages/
-              topicHref: /cpp/error-messages/compiler-errors-1/c-cpp-build-errors
-      - name: Porting and Upgrading
+      - name: Build insights
+        tocHref: /cpp/build-insights/
+        topicHref: /cpp/build-insights/get-started-with-cpp-build-insights
+      - name: Errors and warnings
+        tocHref: /cpp/error-messages/
+        topicHref: /cpp/error-messages/compiler-errors-1/c-cpp-build-errors
+      - name: Porting and upgrading
         tocHref: /cpp/porting/
         topicHref: /cpp/porting/visual-cpp-porting-and-upgrading-guide
-      - name: Text and Strings
+      - name: Text and strings
         tocHref: /cpp/text/
         topicHref: /cpp/text/text-and-strings-in-visual-cpp
       - name: Security
         tocHref: /cpp/security
         topicHref: /cpp/security/security-best-practices-for-cpp
-      - name: Cloud and Web
+      - name: Cloud and web
         tocHref: /cpp/cloud
         topicHref: /cpp/cloud/cloud-and-web-programming-in-visual-cpp

docs/assembler/arm/arm-assembler-command-line-reference.md

@@ -1,84 +1,82 @@
 ---
-title: "ARM Assembler Command-Line Reference"
-ms.date: "08/30/2018"
+title: "ARM Assembler command-line reference"
+description: "Reference guide to the Microsoft ARM assembler command-line options."
+ms.date: "02/09/2020"
 ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
 ---
-# ARM Assembler Command-Line Reference
+# ARM Assembler command-line reference
 
-This article provides command-line information about the Microsoft ARM assembler, *armasm*, which compiles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The linker can link COFF code with object code that is produced by the ARM assembler or by the C compiler, together with object libraries that are created by the librarian.
+This article provides command-line information about the Microsoft ARM assembler, **armasm**. **armasm** assembles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The linker can link COFF code objects produced by both the ARM assembler and the C compiler. It can link either together with object libraries created by the librarian.
 
 ## Syntax
 
-> **armasm** [*options*] *sourcefile* *objectfile*
-> **armasm** [*options*] **-o** *objectfile* *sourcefile*
+> **`armasm`** [*options*] *source_file* *object_file*\
+> **`armasm`** [*options*] **`-o`** *object_file* *source_file*
 
 ### Parameters
 
-*options*<br/>
-A combination of zero or more of the following:
+*options*\
+A combination of zero or more of the following options:
 
-- **-errors** *filename*<br/>
+- **`-errors`** *filename*\
    Redirect error and warning messages to *filename*.
 
-- **-i** *dir*[**;**<em>dir</em>]<br/>
+- **`-i`** *dir*[**`;`**<em>dir</em>]\
    Add the specified directories to the include search path.
 
-- **-predefine** *directive*<br/>
-   Specify a SETA, SETL, or SETS directive to predefine a symbol.<br/>
-   Example: **armasm.exe -predefine "COUNT SETA 150" source.asm**<br/>
+- **`-predefine`** *directive*\
+   Specify a SETA, SETL, or SETS directive to predefine a symbol.\
+   Example: `armasm.exe -predefine "COUNT SETA 150" source.asm`\
    For more information, see the [ARM Compiler armasm Reference Guide](http://infocenter.arm.com/help/topic/com.arm.doc.dui0802b/index.html).
 
-- **-nowarn**<br/>
+- **`-nowarn`**\
    Disable all warning messages.
 
-- **-ignore** *warning*<br/>
+- **`-ignore`** *warning*\
    Disable the specified warning. For possible values, see the section about warnings.
 
-- **-help**<br/>
+- **`-help`**\
    Print the command-line help message.
 
-- **-machine** *machine*<br/>
-   Specify the machine type to set in the PE header.  Possible values for *machine* are:<br/>
-   **ARM**—Sets the machine type to IMAGE_FILE_MACHINE_ARMNT. This is the default.<br/>
+- **`-machine`** *machine*\
+   Specify the machine type to set in the PE header.  Possible values for *machine* are:\
+   **ARM**—Sets the machine type to IMAGE_FILE_MACHINE_ARMNT. This option is the default.\
    **THUMB**—Sets the machine type to IMAGE_FILE_MACHINE_THUMB.
 
-- **-oldit**<br/>
+- **`-oldit`**\
    Generate ARMv7-style IT blocks.  By default, ARMv8-compatible IT blocks are generated.
 
-- **-via** *filename*<br/>
+- **`-via`** *filename*\
    Read additional command-line arguments from *filename*.
 
-- **-16**<br/>
-   Assemble source as 16-bit Thumb instructions.  This is the default.
+- **`-16`**\
+   Assemble source as 16-bit Thumb instructions.  This option is the default.
 
-- **-32**<br/>
+- **`-32`**\
    Assemble source as 32-bit ARM instructions.
 
-- **-g**<br/>
+- **`-g`**\
    Generate debugging information.
 
-- **-errorReport:** *option*<br/>
-   Specify how internal assembler errors are reported to Microsoft.  Possible values for *option* are:<br/>
-   **none**—Do not send reports.<br/>
-   **prompt**—Prompt the user to send reports immediately.<br/>
-   **queue**—Prompt the user to send reports at the next admin logon. This is the default.<br/>
-   **send**—Send reports automatically.
+- **`-errorReport:`** *option*\
+   This option is deprecated. Starting in Windows Vista, error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings.
 
-*sourcefile*<br/>
+*source_file*\
 The name of the source file.
 
-*objectfile*<br/>
+*object_file*\
 The name of the object (output) file.
 
 ## Remarks
 
 The following example demonstrates how to use armasm in a typical scenario. First, use armasm to build an assembly language source (.asm) file to an object (.obj) file. Then, use the CL command-line C compiler to compile a source (.c) file, and also specify the linker option to link the ARM object file.
 
-**armasm myasmcode.asm -o myasmcode.obj**
-
-**cl myccode.c /link myasmcode.obj**
+```cmd
+armasm myasmcode.asm -o myasmcode.obj
+cl myccode.c /link myasmcode.obj
+```
 
 ## See also
 
-[ARM Assembler Diagnostic Messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)<br/>
-[ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)<br/>
+[ARM Assembler diagnostic messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)\
+[ARM Assembler directives](../../assembler/arm/arm-assembler-directives.md)

docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md

@@ -66,4 +66,4 @@ You can access data members in C++ without regard to access restrictions. Howeve
 
 ## See also
 
-[Using C or C++ in __asm Blocks](../../assembler/inline/using-c-or-cpp-in-asm-blocks.md)<br/>
+[Using C or C++ in __asm Blocks](../../assembler/inline/using-c-or-cpp-in-asm-blocks.md)<br/>

docs/assembler/inline/advantages-of-inline-assembly.md

@@ -26,4 +26,4 @@ Inline assembly is a special-purpose tool. If you plan to port an application to
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/asm.md

@@ -77,4 +77,4 @@ Unlike braces in C and C++, the braces enclosing an `__asm` block don't affect v
 ## See also
 
 [Keywords](../../cpp/keywords-cpp.md)<br/>
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/assembly-language-comments.md

@@ -20,4 +20,4 @@ Because C macros expand into a single logical line, avoid using assembly-languag
 
 ## See also
 
-[Using Assembly Language in __asm Blocks](../../assembler/inline/using-assembly-language-in-asm-blocks.md)<br/>
+[Using Assembly Language in __asm Blocks](../../assembler/inline/using-assembly-language-in-asm-blocks.md)<br/>