Merge branch 'master' into cr-1896

Author: Colin Robertson

.gitignore

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

.markdownlint.json

@@ -1,6 +1,7 @@
 {
     "default": true,
     "MD002": false,
+    "DOCSMD006": false,
     "MD013": false,
     "MD024": { "siblings_only": true },
     "MD025": { "front_matter_title": "" },

.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",
@@ -7535,6 +7550,21 @@
       "redirect_url": "/cpp/mfc/reference/mfc-add-class-wizard",
       "redirect_document_id": false
     },
+    {
+      "source_path": "docs/mfc/drag-and-drop-customizing.md",
+      "redirect_url": "/cpp/mfc/drag-and-drop-ole#customize-drag-and-drop",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/mfc/drag-and-drop-implementing-a-drop-source.md",
+      "redirect_url": "/cpp/mfc/drag-and-drop-ole#implement-a-drop-source",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/mfc/drag-and-drop-implementing-a-drop-target.md",
+      "redirect_url": "/cpp/mfc/drag-and-drop-ole#implement-a-drop-target",
+      "redirect_document_id": false
+    },
     {
       "source_path": "docs/mfc/automatic-linking-of-mfc-library-version.md",
       "redirect_url": "/cpp/mfc/mfc-library-versions",

.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

@@ -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/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/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/>

docs/assembler/inline/calling-c-functions-in-inline-assembly.md

@@ -50,4 +50,4 @@ the example pushes pointers to `world`, `hello`, and `format`, in that order, an
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md

@@ -16,4 +16,4 @@ You can also call any functions declared with **extern "C"** linkage. This allow
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/data-directives-and-operators-in-inline-assembly.md

@@ -14,4 +14,4 @@ Although an `__asm` block can reference C or C++ data types and objects, it cann
 
 ## 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/>

docs/assembler/inline/debugging-and-listings-for-inline-assembly.md

@@ -20,4 +20,4 @@ If you create a mixed source and assembly listing with the [/FAs](../../build/re
 
 ## 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/>

docs/assembler/inline/defining-asm-blocks-as-c-macros.md

@@ -48,4 +48,4 @@ Be careful not to invoke macros of this type indiscriminately. For instance, inv
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/emit-pseudoinstruction.md

@@ -30,4 +30,4 @@ __asm {
 
 ## 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/>

docs/assembler/inline/even-and-align-directives.md

@@ -1,7 +1,6 @@
 ---
 title: "EVEN and ALIGN Directives"
 ms.date: "08/30/2018"
-f1_keywords: ["align", "EVEN"]
 helpviewer_keywords: ["EVEN directive", "directives, MASM", "MASM (Microsoft Macro Assembler), directives", "NOP (no operation instruction)", "ALIGN directive"]
 ms.assetid: 7357ab2d-4a5c-43ca-accb-a5f21cdfcde5
 ---
@@ -15,4 +14,4 @@ Although the inline assembler doesn't support most MASM directives, it does supp
 
 ## 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/>

docs/assembler/inline/inline-assembler-overview.md

@@ -54,4 +54,4 @@ __asm push ebp   __asm mov  ebp, esp   __asm sub  esp, __LOCAL_SIZE
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/inline-assembler.md

@@ -42,4 +42,4 @@ Inline assembly is not supported on the ARM and x64 processors.  The following t
 ## See also
 
 [Compiler Intrinsics and Assembly Language](../../intrinsics/compiler-intrinsics-and-assembly-language.md)<br/>
-[C++ Language Reference](../../cpp/cpp-language-reference.md)<br/>
+[C++ Language Reference](../../cpp/cpp-language-reference.md)<br/>

docs/assembler/inline/instruction-set-for-inline-assembly.md

@@ -15,4 +15,4 @@ The Microsoft C++ compiler supports all opcodes through the Pentium 4 and AMD At
 
 ## 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/>

docs/assembler/inline/intel-s-mmx-instruction-set.md

@@ -15,4 +15,4 @@ The Microsoft C++ compiler allows you to use Intel's MMX (multimedia extension)
 
 ## 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/>

docs/assembler/inline/jumping-to-labels-in-inline-assembly.md

@@ -71,4 +71,4 @@ farlabel:
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/masm-expressions-in-inline-assembly.md

@@ -14,4 +14,4 @@ Inline assembly code can use any MASM expression, which is any combination of op
 
 ## 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/>

docs/assembler/inline/masm-macro-directives-in-inline-assembly.md

@@ -14,4 +14,4 @@ The inline assembler is not a macro assembler. You cannot use MASM macro directi
 
 ## 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/>

docs/assembler/inline/optimizing-inline-assembly.md

@@ -14,4 +14,4 @@ The presence of an `__asm` block in a function affects optimization in several w
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/segment-references-in-inline-assembly.md

@@ -14,4 +14,4 @@ You must refer to segments by register rather than by name (the segment name `_T
 
 ## 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/>

docs/assembler/inline/type-and-variable-sizes-in-inline-assembly.md

@@ -2,7 +2,6 @@
 title: "Type and Variable Sizes in Inline Assembly"
 ms.date: "08/30/2018"
 ms.topic: "reference"
-f1_keywords: ["length", "Type"]
 helpviewer_keywords: ["variables, length", "size, getting in inline assembly", "size", "LENGTH operator", "TYPE operator", "SIZE operator", "inline assembly, operators", "variables, type", "variables, size"]
 ms.assetid: b62c2f2b-a7ad-4145-bae4-d890db86d348
 ---
@@ -36,4 +35,4 @@ the following C and assembly expressions yield the size of `arr` and its element
 
 ## 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/>

docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md

@@ -27,4 +27,4 @@ Some SSE types require eight-byte stack alignment, forcing the compiler to emit
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>

docs/assembler/inline/using-assembly-language-in-asm-blocks.md

@@ -38,4 +38,4 @@ The inline assembler has much in common with other assemblers. For example, it a
 
 ## See also
 
-[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>
+[Inline Assembler](../../assembler/inline/inline-assembler.md)<br/>