Merge pull request #2556 from MicrosoftDocs/master

12/10/2019 AM Publish

Author: Taojunshen

.openpublishing.publish.config.json

@@ -10,6 +10,7 @@
       "moniker_ranges": [
         ">= vs-2015"
       ],
+      "xref_query_tags": ["/dotnet", "/uwp/api"],
       "open_to_public_contributors": true,
       "type_mapping": {
         "Conceptual": "Content",

.openpublishing.redirection.json

@@ -835,6 +835,16 @@
       "redirect_url": "/cpp/c-runtime-library/c-run-time-library-reference",
       "redirect_document_id": false
     },
+    {
+      "source_path": "docs/c-runtime-library/inp-inpw.md",
+      "redirect_url": "/cpp/c-runtime-library/inp-inpw-inpd",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "docs/c-runtime-library/outp-outpw.md",
+      "redirect_url": "/cpp/c-runtime-library/outp-outpw-outpd",
+      "redirect_document_id": true
+    },
     {
       "source_path": "docs/c-runtime-library/precision-specification.md",
       "redirect_url": "/cpp/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions#precision",

docs/assembler/masm/comm.md

@@ -1,6 +1,6 @@
 ---
 title: "COMM"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["COMM"]
 helpviewer_keywords: ["COMM directive"]
 ms.assetid: a23548c4-ad04-41fa-91da-945f228de742
@@ -21,6 +21,8 @@ Each *definition* has the following form:
 
 ⟦*language-type*⟧ ⟦**NEAR** | **FAR**⟧ _label_**:**_type_⟦**:**_count_⟧
 
+The *language-type*, **NEAR**, and **FAR** arguments are valid only in 32-bit MASM.
+
 The optional *language-type* sets the naming conventions for the name that follows. It overrides any language specified by the **.MODEL** directive. The optional **NEAR** or **FAR** override the current memory model. The *label* is the name of the variable. The *type* can be any type specifier ([BYTE](../../assembler/masm/byte-masm.md), [WORD](../../assembler/masm/word.md), and so on) or an integer specifying the number of bytes. The optional *count* specifies the number of elements in the declared data object. The default *count* is one.
 
 ## Example

docs/assembler/masm/dot-code.md

@@ -1,11 +1,11 @@
 ---
 title: ".CODE"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: [".CODE"]
 helpviewer_keywords: [".CODE directive"]
 ms.assetid: 2b8c882c-c0d2-4fa3-8335-e6b12717a4f4
 ---
-# .CODE
+# .CODE (32-bit MASM)
 
 When used with [.MODEL](../../assembler/masm/dot-model.md), indicates the start of a code segment.
 

docs/assembler/masm/dot-const.md

@@ -1,11 +1,11 @@
 ---
 title: ".CONST"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: [".CONST"]
 helpviewer_keywords: [".CONST directive"]
 ms.assetid: d5c1d795-174c-48d2-8359-92fbbd7d4c6c
 ---
-# .CONST
+# .CONST (32-bit MASM)
 
 When used with [.MODEL](../../assembler/masm/dot-model.md), starts a constant data segment (with segment name **CONST**).
 

docs/assembler/masm/dot-data-q.md

@@ -1,11 +1,11 @@
 ---
 title: ".DATA?"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: [".DATA?"]
 helpviewer_keywords: [".DATA? directive"]
 ms.assetid: f454f8d7-e23b-458c-a2c4-8441f1afdc82
 ---
-# .DATA?
+# .DATA? (32-bit MASM)
 
 When used with [.MODEL](../../assembler/masm/dot-model.md), starts a near data segment for uninitialized data (segment name _BSS).
 

docs/assembler/masm/dot-data.md

@@ -1,11 +1,11 @@
 ---
 title: ".DATA"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: [".DATA"]
 helpviewer_keywords: [".DATA directive"]
 ms.assetid: 32797935-9c79-46e0-bf6f-07d0c2bf1dc1
 ---
-# .DATA
+# .DATA (32-bit MASM)
 
 When used with [.MODEL](../../assembler/masm/dot-model.md), starts a near data segment for initialized data (segment name _DATA).
 

docs/assembler/masm/end-masm.md

@@ -1,6 +1,6 @@
 ---
 title: "END (MASM)"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["end"]
 helpviewer_keywords: ["END directive"]
 ms.assetid: 128d1c17-f4c4-4ac6-bdb7-d14b4a9a7f4c
@@ -13,6 +13,10 @@ Marks the end of a module and, optionally, sets the program entry point to *addr
 
 > **END** ⟦*address*⟧
 
+## Remarks
+
+The *address* argument is valid in 32-bit MASM only.
+
 ## See also
 
 [Directives reference](directives-reference.md)

docs/assembler/masm/extern-masm.md

@@ -1,6 +1,6 @@
 ---
 title: "EXTERN (MASM)"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["extern"]
 helpviewer_keywords: ["EXTERN directive"]
 ms.assetid: 667d703d-3aaf-4139-a586-29bc5dab1aff
@@ -15,6 +15,8 @@ Defines one or more external variables, labels, or symbols called *name* whose t
 
 ## Remarks
 
+The *language-type* argument is valid in 32-bit MASM only.
+
 The *type* can be [ABS](../../assembler/masm/operator-abs.md), which imports *name* as a constant. Same as [EXTRN](../../assembler/masm/extrn.md).
 
 ## See also

docs/assembler/masm/externdef.md

@@ -1,6 +1,6 @@
 ---
 title: "EXTERNDEF"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["EXTERNDEF"]
 helpviewer_keywords: ["EXTERNDEF directive"]
 ms.assetid: 95a10de6-c345-4428-a2f2-90f7d411dc86
@@ -15,6 +15,8 @@ Defines one or more external variables, labels, or symbols called *name* whose t
 
 ## Remarks
 
+The *language-type* argument is valid in 32-bit MASM only.
+
 If *name* is defined in the module, it is treated as [PUBLIC](../../assembler/masm/public-masm.md). If *name* is referenced in the module, it is treated as [EXTERN](../../assembler/masm/extern-masm.md). If *name* is not referenced, it is ignored. The *type* can be [ABS](../../assembler/masm/operator-abs.md), which imports *name* as a constant. Normally used in include files.
 
 ## See also

docs/assembler/masm/popcontext.md

@@ -1,13 +1,13 @@
 ---
 title: "POPCONTEXT"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["POPCONTEXT"]
 helpviewer_keywords: ["POPCONTEXT directive"]
 ms.assetid: 19f59290-a54d-477d-88d8-97d3f63ed417
 ---
 # POPCONTEXT
 
-Restores part or all of the current *context* (saved by the [PUSHCONTEXT](../../assembler/masm/pushcontext.md) directive). The *context* can be **ASSUMES**, **RADIX**, **LISTING**, **CPU**, or **ALL**.
+Restores part or all of the current *context* (saved by the [PUSHCONTEXT](../../assembler/masm/pushcontext.md) directive). The *context* can be **ASSUMES** (32-bit MASSM only), **RADIX**, **LISTING**, **CPU** (32-bit MASSM only), or **ALL**.
 
 ## Syntax
 

docs/assembler/masm/proc.md

@@ -1,6 +1,6 @@
 ---
 title: "PROC"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["PROC"]
 helpviewer_keywords: ["PROC directive"]
 ms.assetid: ee5bb6b6-fa15-4d73-b0cf-e650178539a9
@@ -18,6 +18,8 @@ Marks start and end of a procedure block called *label*. The statements in the b
 
 ## Remarks
 
+The ⟦*distance*⟧ and ⟦*language-type*⟧ arguments are valid only in 32-bit MASM.
+
 ⟦**FRAME** ⟦__:__*ehandler-address*⟧ ⟧ is only valid with ml64.exe, and causes MASM to generate a function table entry in .pdata and unwind information in .xdata for a function's structured exception handling unwind behavior.
 
 When the **FRAME** attribute is used, it must be followed by an [.ENDPROLOG](../../assembler/masm/dot-endprolog.md) directive.

docs/assembler/masm/proto.md

@@ -1,6 +1,6 @@
 ---
 title: "PROTO"
-ms.date: "10/22/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["PROTO"]
 helpviewer_keywords: ["PROTO directive"]
 ms.assetid: 0487ee16-9dc7-43d1-9445-cd1601f5a080
@@ -18,10 +18,10 @@ Prototypes a function or procedure. You can call the function prototyped by the
 *label*\
 The name of the prototyped function.
 
-*distance*\
+*distance* (32-bit MASM only.)\
 (Optional) Used in 16-bit memory models to override the default and indicate **NEAR** or **FAR** calls.
 
-*language-type*\
+*language-type* (32-bit MASM only.)\
 (Optional) Sets the calling and naming convention for procedures and public symbols. Supported conventions are:
 
 - 32-bit **FLAT** model: **C**, **STDCALL**

docs/assembler/masm/public-masm.md

@@ -1,6 +1,6 @@
 ---
 title: "PUBLIC (MASM)"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["public"]
 helpviewer_keywords: ["PUBLIC directive"]
 ms.assetid: 56e15a68-8a35-4bdd-b1ec-a38cbbf1c582
@@ -11,7 +11,11 @@ Makes each variable, label, or absolute symbol specified as *name* available to
 
 ## Syntax
 
-> **PUBLIC** ⟦language-type⟧ *name* ⟦__,__ ⟦language-type⟧ *name* ...⟧
+> **PUBLIC** ⟦*language-type*⟧ *name* ⟦__,__ ⟦*language-type*⟧ *name* ...⟧
+
+## Remarks
+
+The *language-type* argument is valid in 32-bit MASM only.
 
 ## See also
 

docs/assembler/masm/pushcontext.md

@@ -1,13 +1,13 @@
 ---
 title: "PUSHCONTEXT"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["PUSHCONTEXT"]
 helpviewer_keywords: ["PUSHCONTEXT directive"]
 ms.assetid: 18e528ee-df6c-4ce6-8823-b35b40f757fd
 ---
 # PUSHCONTEXT
 
-Saves part or all of the current *context*: segment register assumes, radix value, listing and cref flags, or processor/coprocessor values. The *context* can be **ASSUMES**, **RADIX**, **LISTING**, **CPU**, or **ALL**.
+Saves part or all of the current *context*: segment register assumes, radix value, listing and cref flags, or processor/coprocessor values. The *context* can be **ASSUMES** (32-bit MASM only), **RADIX**, **LISTING**, **CPU** (32-bit MASM only), or **ALL**.
 
 ## Syntax
 

docs/assembler/masm/segment.md

@@ -1,6 +1,6 @@
 ---
 title: "SEGMENT"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["SEGMENT"]
 helpviewer_keywords: ["SEGMENT directive"]
 ms.assetid: e6f68367-6714-4f06-a79c-edfa88014430
@@ -31,10 +31,10 @@ The range of memory addresses from which a starting address for the segment can
 
 If this parameter is not specified, **PARA** is used by default.
 
-*combine*\
+*combine* (32-bit MASM only)\
 **PUBLIC**, **STACK**, **COMMON**, **MEMORY**, **AT**<em>address</em>, **PRIVATE**
 
-*use*\
+*use* (32-bit MASM only)\
 **USE16**, **USE32**, **FLAT**
 
 *characteristics*\

docs/assembler/masm/struct-masm.md

@@ -1,6 +1,6 @@
 ---
 title: "STRUCT (MASM)"
-ms.date: "08/30/2018"
+ms.date: "12/06/2019"
 f1_keywords: ["struct"]
 helpviewer_keywords: ["STRUCT directive"]
 ms.assetid: 70c3ba6b-00db-461e-8dd9-eafd3ae5b3c8
@@ -15,6 +15,10 @@ Declares a structure type having the specified *field-declarations*. Each field
 > *field-declarations*\
 > *name* **ENDS**
 
+## Remarks
+
+The *name* argument must be the same in the opening and closing statement. 
+
 ## See also
 
 [Directives reference](../../assembler/masm/directives-reference.md)

docs/build/reference/c-preserve-comments-during-preprocessing.md

@@ -21,7 +21,7 @@ This compiler option requires the **/E**, **/P**, or **/EP** option.
 
 The following code sample will display the source code comment.
 
-```
+```cpp
 // C_compiler_option.cpp
 // compile with: /E /C /c
 int i;   // a variable

docs/build/reference/clrsupportlasterror-preserve-last-error-code-for-pinvoke-calls.md

@@ -75,7 +75,7 @@ You can minimize the performance impact by linking with **/CLRSUPPORTLASTERROR:S
 
 The following sample defines a native DLL with one exported function that modifies last error.
 
-```
+```cpp
 // CLRSUPPORTLASTERROR_dll.cpp
 // compile with: /LD
 #include <windows.h>
@@ -92,7 +92,7 @@ __declspec(dllexport) double MySqrt(__int64 n) {
 
 The following sample consumes the DLL, demonstrating how to use **/CLRSUPPORTLASTERROR**.
 
-```
+```cpp
 // CLRSUPPORTLASTERROR_client.cpp
 // compile with: /clr CLRSUPPORTLASTERROR_dll.lib /link /clrsupportlasterror:systemdll
 // processor: x86

docs/build/reference/common-macros-for-build-commands-and-properties.md

@@ -51,7 +51,7 @@ This table describes a commonly used subset of the available macros; there are m
 |**$(TargetPath)**|The absolute path name of the primary output file for the build (defined as drive + path + base name + file extension).|
 |**$(VCInstallDir)**|The directory that contains the C++ content of your Visual Studio installation. This property contains the version of the targeted Microsoft C++ (MSVC) toolset, which might be different that the host Visual Studio. For example, when building with `$(PlatformToolset) = v140`, **$(VCInstallDir)** contains the path to the Visual Studio 2015 installation.|
 |**$(VSInstallDir)**|The directory into which you installed Visual Studio. This property contains the version of the targeted Visual Studio toolset, which might be different that the host Visual Studio. For example, when building with `$(PlatformToolset) = v110`, **$(VSInstallDir)** contains the path to the Visual Studio 2012 installation.|
-|**$(WebDeployPath)**|The relative path from the web deployment root to where the project outputs belong. Returns the same value as <xref:Microsoft.VisualStudio.VCProjectEngine.VCWebDeploymentTool.RelativePath%2A>.|
+|**$(WebDeployPath)**|The relative path from the web deployment root to where the project outputs belong.|
 |**$(WebDeployRoot)**|The absolute path to the location of **\<localhost>**. For example, c:\inetpub\wwwroot.|
 
 ## Obsolete macros

docs/build/reference/example-visual-cpp.md

@@ -26,7 +26,7 @@ Compile with [/doc](doc-process-documentation-comments-c-cpp.md) to process docu
 
 ## Example
 
-```
+```cpp
 // xml_example_tag.cpp
 // compile with: /clr /doc /LD
 // post-build command: xdcmake xml_example_tag.dll

docs/build/reference/exception-visual-cpp.md

@@ -35,7 +35,7 @@ The MSVC compiler will attempt to resolve cref references in one pass through th
 
 ## Example
 
-```
+```cpp
 // xml_exception_tag.cpp
 // compile with: /clr /doc /LD
 // post-build command: xdcmake xml_exception_tag.dll

docs/build/reference/paramref-visual-cpp.md

@@ -26,7 +26,7 @@ Compile with [/doc](doc-process-documentation-comments-c-cpp.md) to process docu
 
 ## Example
 
-```
+```cpp
 // xml_paramref_tag.cpp
 // compile with: /clr /doc /LD
 // post-build command: xdcmake xml_paramref_tag.dll

docs/build/reference/permission-visual-cpp.md

@@ -35,7 +35,7 @@ The MSVC compiler will attempt to resolve cref references in one pass through th
 
 ## Example
 
-```
+```cpp
 // xml_permission_tag.cpp
 // compile with: /clr /doc /LD
 // post-build command: xdcmake xml_permission_tag.dll

docs/build/reference/remarks-visual-cpp.md

@@ -26,7 +26,7 @@ Compile with [/doc](doc-process-documentation-comments-c-cpp.md) to process docu
 
 ## Example
 
-```
+```cpp
 // xml_remarks_tag.cpp
 // compile with: /LD /clr /doc
 // post-build command: xdcmake xml_remarks_tag.dll

docs/build/reference/returns-visual-cpp.md

@@ -26,7 +26,7 @@ Compile with [/doc](doc-process-documentation-comments-c-cpp.md) to process docu
 
 ## Example
 
-```
+```cpp
 // xml_returns_tag.cpp
 // compile with: /LD /clr /doc
 // post-build command: xdcmake xml_returns_tag.dll

docs/build/reference/see-visual-cpp.md

@@ -34,7 +34,7 @@ The MSVC compiler will attempt to resolve cref references in one pass through th
 
 The following sample shows how you can make cref reference to a generic type, such that, the compiler will resolve the reference.
 
-```
+```cpp
 // xml_see_cref_example.cpp
 // compile with: /LD /clr /doc
 // the following cref shows how to specify the reference, such that,

docs/build/reference/seealso-visual-cpp.md

@@ -36,7 +36,7 @@ The MSVC compiler will attempt to resolve cref references in one pass through th
 
 In the following sample, an unresolved symbol is referenced in a cref. The XML comment for the cref to B::Test will be `<seealso cref="!:B::Test" />`, whereas the reference to A::Test is well-formed `<seealso cref="M:A.Test" />`.
 
-```
+```cpp
 // xml_seealso_tag.cpp
 // compile with: /LD /clr /doc
 // post-build command: xdcmake xml_seealso_tag.dll

docs/build/reference/summary-visual-cpp.md

@@ -28,7 +28,7 @@ Compile with [/doc](doc-process-documentation-comments-c-cpp.md) to process docu
 
 ## Example
 
-```
+```cpp
 // xml_summary_tag.cpp
 // compile with: /LD /clr /doc
 // post-build command: xdcmake xml_summary_tag.dll