Merge pull request #2724 from MicrosoftDocs/FromPublicMasterBranch

Colin Robertson · web-flow · commit af4b75cd18fa · 2020-03-15T01:39:21.000-07:00
Resolve syncing conflicts from FromPublicMasterBranch to master
diff --git a/docs/build/cppproperties-schema-reference.md b/docs/build/cppproperties-schema-reference.md
@@ -22,7 +22,7 @@ A configuration may have any of the following properties:
 |`forcedInclude`|Header to be automatically included in every compilation unit (maps to /FI for MSVC or -include for clang)|
 |`undefines`|The list of macros to be undefined (maps to /U for MSVC)|
 |`intelliSenseMode`|The IntelliSense engine to be used. You can specify one of the predefined architecture-specific variants for MSVC, gcc, or Clang.|
-|`environments`|User-defined sets of variables that behave like environment variables in a command prompt and are accessed with the ${env.<VARIABLE>} macro.|
+|`environments`|User-defined sets of variables that behave like environment variables in a command prompt and are accessed with the ${env.\<VARIABLE>} macro.|
 
 ### intelliSenseMode values
 
diff --git a/docs/cppcx/platform-collections-backinsertiterator-class.md b/docs/cppcx/platform-collections-backinsertiterator-class.md
@@ -52,15 +52,14 @@ The BackInsertIterator class implements the rules required by the [back_insert_i
 **Header:** collection.h
 
 **Namespace:** Platform::Collections
----
+
 ## <a name="ctor"></a>  BackInsertIterator::BackInsertIterator Constructor
 
 Initializes a new instance of the `BackInsertIterator` class.
 
 ## Syntax
 
 ```
-
 explicit BackInsertIterator(
    Windows::Foundation::Collections::IVector<T>^ v);
 ```
@@ -118,7 +117,6 @@ Returns a reference to the current BackInsertIterator. The iterator is unmodifie
 ## Syntax
 
 ```
-
 BackInsertIterator& operator++();
 
 BackInsertIterator operator++(int);
diff --git a/docs/data/odbc/data-source-programmatically-configuring-an-odbc-data-source.md b/docs/data/odbc/data-source-programmatically-configuring-an-odbc-data-source.md
@@ -83,7 +83,7 @@ One way to find the keynames and values for the *lpszAttributes* parameter is to
 
    - For 32 bit, find the key **HKEY_CURRENT_USER\Software\ODBC\ODBC.INI\ODBC Data Sources** in the left pane.
 
-      The right pane lists entries of the form: "pub: REG_SZ:*<data source name>*", where *<data source name>* is a data source that has already been configured with the desired settings for the driver you intend to use. Select the data source you want, for example, SQL Server. The items following the string "pub:" are, in order, the keyname and value to use in your *lpszAttributes* parameter.
+      The right pane lists entries of the form: "pub: REG_SZ:*\<data source name>*", where *\<data source name>* is a data source that has already been configured with the desired settings for the driver you intend to use. Select the data source you want, for example, SQL Server. The items following the string "pub:" are, in order, the keyname and value to use in your *lpszAttributes* parameter.
 
    - For 16 bit, find the section in the Odbc.ini file marked by [*\<data source name>*].
 
diff --git a/docs/dotnet/how-to-wrap-native-class-for-use-by-csharp.md b/docs/dotnet/how-to-wrap-native-class-for-use-by-csharp.md
@@ -5,7 +5,7 @@ ms.date: "11/04/2016"
 helpviewer_keywords: ["native code [C++], Visual C# and", "classes [C++], Visual C# and"]
 ms.assetid: 988819ae-cc6a-4453-8ff5-be369210d962
 ---
-# How to: Wrap Native Class for Use by C#
+# How to: Wrap Native Class for Use by C\#
 
 This sample shows how to wrap a native C++ class so it can be consumed by code authored in C#, or other .NET language.
 
diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3500-through-c3999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3500-through-c3999.md
@@ -466,10 +466,10 @@ The articles in this section of the documentation explain a subset of the error
 |Compiler error C3949|a pack expansion, '...', cannot appear in a parenthesized abstract declarator|
 |Compiler error C3950|Obsolete.|
 |Compiler error C3951|Cannot use pointer-to-member in projected WinRT type '*type*'. Use a delegate instead.|
-|Compiler error C3952|'*type*': WinRT does not support 'in/out' arrays. Use 'const Array<T>^' for 'in' and 'WriteOnlyArray<T>' or 'Array<T>^*' for 'out' on public APIs|
+|Compiler error C3952|'*type*': WinRT does not support 'in/out' arrays. Use 'const Array\<T>^' for 'in' and 'WriteOnlyArray\<T>' or 'Array\<T>^*' for 'out' on public APIs|
 |Compiler error C3953|Cannot use managed class '*type*' in WinRT module.|
-|Compiler error C3954|'*type*': An array returned from a published method on a WinRT type must use the form 'Array<T>^'|
-|Compiler error C3955|'*type*': A public constructor cannot contain an 'out' parameter or 'WriteOnlyArray<T>'|
+|Compiler error C3954|'*type*': An array returned from a published method on a WinRT type must use the form 'Array\<T>^'|
+|Compiler error C3955|'*type*': A public constructor cannot contain an 'out' parameter or 'WriteOnlyArray\<T>'|
 |Compiler error C3956|'*type*': Type is marked as Exclusive To '*type*' and cannot be used as a base of '*derived_type*'|
 |Compiler error C3957|'*type*': cannot use 'new' on a WinRT type; use 'ref new' instead|
 |Compiler error C3958|'*type*': cannot use 'gcnew' on a WinRT type; use 'ref new' instead|
diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md
@@ -297,7 +297,7 @@ These warnings and all warnings in later versions are suppressed by using the co
 | C4703 | `potentially uninitialized local pointer variable 'name' used` |
 | C4728 | `/Yl- option ignored because PCH reference is required` |
 | C4745 | `volatile access of 'name' cannot be honored due to its size` |
-| C4746|volatile access of 'name' is subject to /volatile:<iso | ms> setting; consider using __iso_volatile_load/store intrinsic functions |
+| C4746| `volatile access of 'name' is subject to /volatile:<iso | ms> setting; consider using __iso_volatile_load/store intrinsic functions` |
 | C4872 | `floating point division by zero detected when compiling the call graph for the concurrency::parallel_for_each at: 'description'` |
 | C4880 | `casting from 'type' to 'type': casting away constness from a pointer or reference may result in undefined behavior in an amp restricted function` |
 | C4881 | `the constructor and/or the destructor will not be invoked for tile_static variable 'type'` |
diff --git a/docs/ide/writing-and-refactoring-code-cpp.md b/docs/ide/writing-and-refactoring-code-cpp.md
@@ -15,9 +15,9 @@ IntelliSense is a powerful code completion tool that suggests symbols and code s
 
 ![C&#43;&#43; member list drop down](../ide/media/cpp-statement-completion.png)
 
-Some symbols are omitted automatically to help narrow down the results. For example, when accessing a class object’s members from outside the class, you will not be able to see private members by default, or protected members (if you are not in the context of a child class). You can adjust the filtering by using the buttons at the bottom.
+Some symbols are omitted automatically to help narrow down the results. For example, when accessing a class object's members from outside the class, you will not be able to see private members by default, or protected members (if you are not in the context of a child class). You can adjust the filtering by using the buttons at the bottom.
 
-After you choose the symbol from the drop-down list, you can autocomplete it with **Tab**, **Enter**, or one of the other commit characters (by default: {}[]().,:;+-*/%&|^!=?@#\). To add or remove characters from this list, 
+After you choose the symbol from the drop-down list, you can autocomplete it with **Tab**, **Enter**, or one of the other commit characters (by default: `{ } [ ] ( ) . , : ; + - * / % & | ^ ! = ? @ # \`). To add or remove characters from this list, 
 search for "IntelliSense" in **Quick Launch** (Ctrl + Q) and choose the **Text Editor > C/C++ > Advanced** option. The **Member List Commit Characters** option enables you to customize the list with the changes you want.
 
 The **Member List Filter Mode** option controls what kinds of IntelliSense autocomplete suggestions you see. By default, it is set to **Fuzzy**. In a fuzzy search, if you have a symbol called *MyAwesomeClass*, you can type "MAC" and find the class in your autocomplete suggestions. The fuzzy algorithm sets a minimum threshold that symbols must meet to show up in the list. **Smart** filtering displays all symbols containing substrings that match what you typed. **Prefix** filtering searches for strings that begin with what you typed.
@@ -69,7 +69,7 @@ When the caret is inside a template definition, a **Template Bar** appears, whic
 
 ![C&#43;&#43; Template IntelliSense Show Existing Instantiations](../ide/media/template-intellisense-cpp-1.png "Template IntelliSense Show Existing Instantiations")
 
-Click the **<T>** icon to expand/collapse the **Template Bar**. Click the pencil icon or double-click the **Template Bar** to open the **Edit** window. 
+Click the **\<T>** icon to expand/collapse the **Template Bar**. Click the pencil icon or double-click the **Template Bar** to open the **Edit** window. 
 
 ![C&#43;&#43; Template IntelliSense](../ide/media/template-intellisense-cpp-3.png "Template IntelliSense")
 
@@ -182,4 +182,4 @@ Experimental features, which may or may not be included in a future version of V
 
 [Read and understand C++ code](read-and-understand-code-cpp.md)</br>
 [Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)</br>
-[Collaborate with Live Share for C++](live-share-cpp.md)
+[Collaborate with Live Share for C++](live-share-cpp.md)
diff --git a/docs/index.md b/docs/index.md
@@ -4,6 +4,9 @@ title: Visual C++ Documentation
 description: Learn how to use C++ to develop applications, services, and tools for your platforms and devices.
 ms.topic: hub-page
 ---
+
+<!-- markdownlint-disable MD033 -->
+
 <div id="main" class="v2">
     <div class="container">
         <ul class="cardsY panelContent featuredContent">
@@ -54,7 +57,7 @@ ms.topic: hub-page
                                     </div>
                                 </div>
                                 <div class="cardText">
-                                    <h3>What’s new for C++ in Visual Studio</h3>
+                                    <h3>What's new for C++ in Visual Studio</h3>
                                 </div>
                             </div>
                         </div>
diff --git a/docs/linux/index.md b/docs/linux/index.md
@@ -9,6 +9,8 @@ ms.topic: "landing-page"
 
 Use Visual Studio 2017 and later to create and debug applications running on Linux remote machines or Windows Subsystem for Linux.
 
+<!-- markdownlint-disable MD033 -->
+
 <ul class="panelContent cardsF">
     <li>
         <a href="/cpp/linux/download-install-and-setup-the-linux-development-workload">
diff --git a/docs/overview/cpp-conformance-improvements.md b/docs/overview/cpp-conformance-improvements.md
@@ -913,7 +913,7 @@ The iterator debugging feature has been taught to properly unwrap `std::move_ite
 
 ### Fixes for \<xkeycheck.h> keyword enforcement
 
-The standard library’s macro replacing a keyword enforcement \<xkeycheck.h> was fixed to emit the actual problem keyword detected rather than a generic message. It also supports C++20 keywords, and avoids tricking IntelliSense into saying random keywords are macros.
+The standard library's macro replacing a keyword enforcement \<xkeycheck.h> was fixed to emit the actual problem keyword detected rather than a generic message. It also supports C++20 keywords, and avoids tricking IntelliSense into saying random keywords are macros.
 
 ### Allocator types no longer deprecated
 
@@ -925,7 +925,7 @@ A spurious `static_cast` not called for by the standard that accidentally suppre
 
 ### Various \<filesystem> correctness fixes
 
-- Fixed `std::filesystem::last_write_time` failing when attempting to change a directory’s last write time.
+- Fixed `std::filesystem::last_write_time` failing when attempting to change a directory's last write time.
 - The `std::filesystem::directory_entry` constructor now stores a failed result, rather than throwing an exception, when supplied a nonexistent target path.
 - The `std::filesystem::create_directory` 2-parameter version was changed to call the 1-parameter version, as the underlying `CreateDirectoryExW` function would use `copy_symlink` when the `existing_p` was a symlink.
 - `std::filesystem::directory_iterator` no longer fails when a broken symlink is found.
@@ -963,7 +963,7 @@ The unordered container `reserve` function now actually reserves for N elements,
 
 - Many standard library internal container functions have been made private for an improved IntelliSense experience. Additional fixes to mark members as private are expected in later releases of MSVC.
 
-- Exception safety correctness problems wherein the node-based containers like `list`, `map`, and `unordered_map` would become corrupted were fixed. During a `propagate_on_container_copy_assignment` or `propagate_on_container_move_assignment` reassignment operation, we would free the container’s sentinel node with the old allocator, do the POCCA/POCMA assignment over the old allocator, and then try to acquire the sentinel node from the new allocator. If this allocation failed, the container was corrupted and couldn’t even be destroyed, as owning a sentinel node is a hard data structure invariant. This code was fixed to allocate the new sentinel node from the source container’s allocator before destroying the existing sentinel node.
+- Exception safety correctness problems wherein the node-based containers like `list`, `map`, and `unordered_map` would become corrupted were fixed. During a `propagate_on_container_copy_assignment` or `propagate_on_container_move_assignment` reassignment operation, we would free the container's sentinel node with the old allocator, do the POCCA/POCMA assignment over the old allocator, and then try to acquire the sentinel node from the new allocator. If this allocation failed, the container was corrupted and couldn't even be destroyed, as owning a sentinel node is a hard data structure invariant. This code was fixed to allocate the new sentinel node from the source container's allocator before destroying the existing sentinel node.
 
 - The containers were fixed to always copy/move/swap allocators according to `propagate_on_container_copy_assignment`, `propagate_on_container_move_assignment`, and `propagate_on_container_swap`, even for allocators declared `is_always_equal`.
 
@@ -2841,7 +2841,7 @@ int main()
 
 In [/permissive-](../build/reference/permissive-standards-conformance.md) mode, the compiler now requires the **template** keyword to precede a template-name when it comes after a dependent nested-name-specifier.
 
-The following code in [/permissive-](../build/reference/permissive-standards-conformance.md) mode now raises C7510: *'example': use of dependent template name must be prefixed with 'template'. note: see reference to class template instantiation 'X<T>' being compiled*:
+The following code in [/permissive-](../build/reference/permissive-standards-conformance.md) mode now raises C7510: *'example': use of dependent template name must be prefixed with 'template'. note: see reference to class template instantiation 'X\<T>' being compiled*:
 
 ```cpp
 template<typename T> struct Base
diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md
diff --git a/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md b/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md
diff --git a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md
diff --git a/docs/standard-library/hash-map-class.md b/docs/standard-library/hash-map-class.md
diff --git a/docs/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md b/docs/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md
