Merge pull request #2744 from MicrosoftDocs/FromPublicMasterBranch

Colin Robertson · web-flow · commit 4b5a2d752aa6 · 2020-03-20T13:25:02.000-07:00
Confirm merge from FromPublicMasterBranch to master to sync with https://github.com/MicrosoftDocs/cpp-docs (branch master)
diff --git a/docs/build/reference/fp-specify-floating-point-behavior.md b/docs/build/reference/fp-specify-floating-point-behavior.md
@@ -258,4 +258,3 @@ Under `/O2` `/fp:fast` the generated code is simplified, because all type casts
 
 [MSVC Compiler Options](compiler-options.md)<br/>
 [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)<br/>
- 
diff --git a/docs/build/reference/gd-gr-gv-gz-calling-convention.md b/docs/build/reference/gd-gr-gv-gz-calling-convention.md
@@ -90,4 +90,3 @@ For C, the `__vectorcall` naming convention uses the function name followed by t
 
 - [MSVC Compiler Options](compiler-options.md)
 - [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)
- 
diff --git a/docs/c-runtime-library/reference/open-wopen.md b/docs/c-runtime-library/reference/open-wopen.md
@@ -72,7 +72,7 @@ The **_open** function opens the file specified by *filename* and prepares it fo
 | **_O_CREAT** | Creates a file and opens it for writing. Has no effect if the file specified by *filename* exists. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_SHORT_LIVED** | Creates a file as temporary and if possible does not flush to disk. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_TEMPORARY** | Creates a file as temporary; the file is deleted when the last file descriptor is closed. The *pmode* argument is required when **_O_CREAT** is specified. |
-| **_O_CREAT** &#124; ` _O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
+| **_O_CREAT** &#124; `_O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
 | **_O_NOINHERIT** | Prevents creation of a shared file descriptor. |
 | **_O_RANDOM** | Specifies that caching is optimized for, but not restricted to, random access from disk. |
 | **_O_RDONLY** | Opens a file for reading only. Cannot be specified with **_O_RDWR** or **_O_WRONLY**. |
diff --git a/docs/c-runtime-library/reference/sopen-s-wsopen-s.md b/docs/c-runtime-library/reference/sopen-s-wsopen-s.md
@@ -86,7 +86,7 @@ The integer expression *oflag* is formed by combining one or more manifest const
 | **_O_CREAT** | Creates a file and opens it for writing. Has no effect if the file specified by *filename* exists. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_SHORT_LIVED** | Creates a file as temporary and if possible does not flush to disk. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_TEMPORARY** | Creates a file as temporary; the file is deleted when the last file descriptor is closed. The *pmode* argument is required when **_O_CREAT** is specified. |
-| **_O_CREAT** &#124; ` _O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
+| **_O_CREAT** &#124; `_O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
 | **_O_NOINHERIT** | Prevents creation of a shared file descriptor. |
 | **_O_RANDOM** | Specifies that caching is optimized for, but not restricted to, random access from disk. |
 | **_O_RDONLY** | Opens a file for reading only. Cannot be specified with **_O_RDWR** or **_O_WRONLY**. |
diff --git a/docs/c-runtime-library/reference/sopen-wsopen.md b/docs/c-runtime-library/reference/sopen-wsopen.md
@@ -79,7 +79,7 @@ The integer expression *oflag* is formed by combining one or more of the followi
 | **_O_CREAT** | Creates a file and opens it for writing. Has no effect if the file specified by *filename* exists. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_SHORT_LIVED** | Creates a file as temporary and if possible does not flush to disk. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_TEMPORARY** | Creates a file as temporary; the file is deleted when the last file descriptor is closed. The *pmode* argument is required when **_O_CREAT** is specified. |
-| **_O_CREAT** &#124; ` _O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
+| **_O_CREAT** &#124; `_O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
 | **_O_NOINHERIT** | Prevents creation of a shared file descriptor. |
 | **_O_RANDOM** | Specifies that caching is optimized for, but not restricted to, random access from disk. |
 | **_O_RDONLY** | Opens a file for reading only. Cannot be specified with **_O_RDWR** or **_O_WRONLY**. |
diff --git a/docs/cpp/pointers-to-members.md b/docs/cpp/pointers-to-members.md
@@ -71,7 +71,7 @@ int main()
 }
 ```
 
-In the preceding example, `pwCaption` is a pointer to any member of class `Window` that has type `char*`. The type of `pwCaption` is `char * Window::* `. The next code fragment declares pointers to the `SetCaption` and `GetCaption` member functions.
+In the preceding example, `pwCaption` is a pointer to any member of class `Window` that has type `char*`. The type of `pwCaption` is `char * Window::*`. The next code fragment declares pointers to the `SetCaption` and `GetCaption` member functions.
 
 ```cpp
 const char * (Window::*pfnwGC)() = &Window::GetCaption;
diff --git a/docs/data/data-access-in-cpp.md b/docs/data/data-access-in-cpp.md
@@ -41,7 +41,7 @@ Azure makes it easy to build C++ applications with increased flexibility, scalab
 [How to use Blob Storage from C++](https://docs.microsoft.com/azure/storage/storage-c-plus-plus-how-to-use-blobs)<br/>
 Azure Blob storage is a service that stores unstructured data in the cloud as objects/blobs. Blob storage can store any type of text or binary data, such as a document, media file, or application installer. Blob storage is also referred to as object storage.
 
-[ ODBC Programmer's Reference](https://docs.microsoft.com/sql/odbc/reference/odbc-programmer-s-reference)<br/>
+[ODBC Programmer's Reference](https://docs.microsoft.com/sql/odbc/reference/odbc-programmer-s-reference)<br/>
 The ODBC interface is designed for use with the C programming language. Use of the ODBC interface spans three areas: SQL statements, ODBC function calls, and C programming.
 
 ## See also
diff --git a/docs/linux/configure-a-linux-project.md b/docs/linux/configure-a-linux-project.md
@@ -11,7 +11,7 @@ Linux support is available in Visual Studio 2017 and later.
 
 ::: moniker-end
 
-This topic describes how to configure a C++ Linux project as described in [Create a new C++ Linux project in Visual Studio](create-a-new-linux-project.md). For CMake Linux projects, see [Configure a Linux CMake Project ](cmake-linux-project.md).
+This topic describes how to configure a C++ Linux project as described in [Create a new C++ Linux project in Visual Studio](create-a-new-linux-project.md). For CMake Linux projects, see [Configure a Linux CMake Project](cmake-linux-project.md).
 
 You can configure a Linux project to target a physical Linux machine, a virtual machine, or the [Windows Subsystem for Linux](/windows/wsl/about) (WSL).
 
diff --git a/docs/mfc/reference/colecurrency-class.md b/docs/mfc/reference/colecurrency-class.md
@@ -111,7 +111,7 @@ All of these constructors create new `COleCurrency` objects initialized to the s
 
 - COleCurrency(`varSrc`) Constructs a `COleCurrency` object. Attempts to convert a [VARIANT](/windows/win32/api/oaidl/ns-oaidl-variant) structure or `COleVariant` object to a currency (VT_CY) value. If this conversion is successful, the converted value is copied into the new `COleCurrency` object. If it is not, the value of the `COleCurrency` object is set to zero (0) and its status to invalid.
 
-- `COleCurrency(`nUnits`, `nFractionalUnits`) Constructs a `COleCurrency` object from the specified numerical components. If the absolute value of the fractional part is greater than 10,000, the appropriate adjustment is made to the units. Note that the units and fractional part are specified by signed long values.
+- COleCurrency(`nUnits`, `nFractionalUnits`) Constructs a `COleCurrency` object from the specified numerical components. If the absolute value of the fractional part is greater than 10,000, the appropriate adjustment is made to the units. Note that the units and fractional part are specified by signed long values.
 
 For more information, see the [CURRENCY](/windows/win32/api/wtypes/ns-wtypes-cy~r1) and [VARIANT](/windows/win32/api/oaidl/ns-oaidl-variant) entries in the Windows SDK.
 
diff --git a/docs/mfc/reference/cwnd-class.md b/docs/mfc/reference/cwnd-class.md
@@ -1553,7 +1553,7 @@ If the window is the parent of any windows, these child windows are automaticall
 
 The `DestroyWindow` member function also destroys modeless dialog boxes created by [CDialog::Create](../../mfc/reference/cdialog-class.md#create).
 
-If the `CWnd` being destroyed is a child window and does not have the [WS_EX_NOPARENTNOTIFY](../../mfc/reference/styles-used-by-mfc.md#extended-window-styles) style set, then the [WM_PARENTNOTIFY ](/previous-versions/windows/desktop/inputmsg/wm-parentnotify)       message is sent to the parent.
+If the `CWnd` being destroyed is a child window and does not have the [WS_EX_NOPARENTNOTIFY](../../mfc/reference/styles-used-by-mfc.md#extended-window-styles) style set, then the [WM_PARENTNOTIFY](/previous-versions/windows/desktop/inputmsg/wm-parentnotify)       message is sent to the parent.
 
 ### Example
 
diff --git a/docs/porting/visual-cpp-change-history-2003-2015.md b/docs/porting/visual-cpp-change-history-2003-2015.md
@@ -3033,7 +3033,7 @@ The `SchedulerType` enumeration of `UmsThreadDefault` is deprecated. Specificati
 
 ### Standard Library
 
-- Following a breaking change between the C++98/03 and C++11 standards, using explicit template arguments to call `make_pair()` — as in `make_pair<int, int>(x, y)` — typically doesn't compile in Visual C++ in Visual Studio 2012. The solution is to always call `make_pair() `without explicit template arguments — as in `make_pair(x, y)`. Providing explicit template arguments defeats the purpose of the function. If you require precise control over the resulting type, use `pair` instead of `make_pair` — as in `pair<short, short>(int1, int2)`.
+- Following a breaking change between the C++98/03 and C++11 standards, using explicit template arguments to call `make_pair()` — as in `make_pair<int, int>(x, y)` — typically doesn't compile in Visual C++ in Visual Studio 2012. The solution is to always call `make_pair()` without explicit template arguments — as in `make_pair(x, y)`. Providing explicit template arguments defeats the purpose of the function. If you require precise control over the resulting type, use `pair` instead of `make_pair` — as in `pair<short, short>(int1, int2)`.
 
 - Another breaking change between the C++98/03 and C++11 standards: When A is implicitly convertible to B and B is implicitly convertible to C, but A isn't implicitly convertible to C, C++98/03 and Visual Studio 2010 permitted `pair<A, X>` to be converted (implicitly or explicitly) to `pair<C, X>`. (The other type, X, isn't of interest here, and isn't specific to the first type in the pair.) The C++ compiler in Visual Studio 2012 detects that A isn't implicitly convertible to C, and removes the pair conversion from overload resolution. This change is a positive for many scenarios. For example, overloading `func(const pair<int, int>&)` and `func(const pair<string, string>&)`, and calling `func()` with `pair<const char *, const char *>` will compile with this change. However, this change breaks code that relied on aggressive pair conversions. Such code can typically be fixed by performing one part of the conversion explicitly—for example, by passing `make_pair(static_cast<B>(a), x)` to a function that expects `pair<C, X>`.
 
diff --git a/docs/standard-library/basic-filebuf-class.md b/docs/standard-library/basic-filebuf-class.md
@@ -375,7 +375,7 @@ If the buffer is already open, or if the file pointer is a null pointer, the fun
 
 ### Remarks
 
-The member function opens the file with name *filename*, by calling [`fopen`](../c-runtime-library/reference/fopen-wfopen.md)`(filename, strmode)`. `strmode` is determined from `mode & ~(`[`ate`](../standard-library/ios-base-class.md#openmode)` | `[`binary`](../standard-library/ios-base-class.md#openmode)`)`:
+The member function opens the file with name *filename*, by calling [`fopen`](../c-runtime-library/reference/fopen-wfopen.md)`(filename, strmode)`. `strmode` is determined from `mode & ~(`[`ate`](../standard-library/ios-base-class.md#openmode) `|` [`binary`](../standard-library/ios-base-class.md#openmode)`)`:
 
 - `ios_base::in` becomes `"r"` (open existing file for reading).
 
diff --git a/docs/standard-library/basic-istream-class.md b/docs/standard-library/basic-istream-class.md
@@ -802,7 +802,7 @@ The first member function performs an absolute seek, the second member function
 > [!NOTE]
 > Do not use the second member function with text files, because Standard C++ does not support relative seeks in text files.
 
-If [`fail`](../standard-library/basic-ios-class.md#fail) is false, the first member function calls `newpos = `[`rdbuf`](../standard-library/basic-ios-class.md#rdbuf)`->`[`pubseekpos`](../standard-library/basic-streambuf-class.md#pubseekpos)`(pos)`, for some `pos_type` temporary object `newpos`. If `fail` is false, the second function calls `newpos = rdbuf->`[`pubseekoff`](../standard-library/basic-streambuf-class.md#pubseekoff)`( off, way)`. In either case, if `(off_type)newpos == (off_type)(-1)` (the positioning operation fails), the function calls `istr.`[`setstate`](../standard-library/basic-ios-class.md#setstate)`(failbit)`. Both functions return __*this__.
+If [`fail`](../standard-library/basic-ios-class.md#fail) is false, the first member function calls `newpos =` [`rdbuf`](../standard-library/basic-ios-class.md#rdbuf)`->`[`pubseekpos`](../standard-library/basic-streambuf-class.md#pubseekpos)`(pos)`, for some `pos_type` temporary object `newpos`. If `fail` is false, the second function calls `newpos = rdbuf->`[`pubseekoff`](../standard-library/basic-streambuf-class.md#pubseekoff)`( off, way)`. In either case, if `(off_type)newpos == (off_type)(-1)` (the positioning operation fails), the function calls `istr.`[`setstate`](../standard-library/basic-ios-class.md#setstate)`(failbit)`. Both functions return __*this__.
 
 If [`fail`](../standard-library/basic-ios-class.md#fail) is true, the member functions do nothing.
 
@@ -847,7 +847,7 @@ If `_Istr.`[`good`](../standard-library/basic-ios-class.md#good) is true, the co
 
 - Calls `_Istr.`[`tie`](../standard-library/basic-ios-class.md#tie)`->`[`flush`](../standard-library/basic-ostream-class.md#flush) if `_Istr.tie` is not a null pointer.
 
-- Effectively calls [`ws`](../standard-library/istream-functions.md#ws)`(_Istr)` if `_Istr.`[`flags`](../standard-library/ios-base-class.md#flags)` & `[`skipws`](../standard-library/ios-functions.md#skipws) is nonzero.
+- Effectively calls [`ws`](../standard-library/istream-functions.md#ws)`(_Istr)` if `_Istr.`[`flags`](../standard-library/ios-base-class.md#flags) `&` [`skipws`](../standard-library/ios-functions.md#skipws) is nonzero.
 
 If after any such preparation, `_Istr.good` is false, the constructor calls `_Istr.`[`setstate`](../standard-library/basic-ios-class.md#setstate)`(failbit)`. In any case, the constructor stores the value returned by `_Istr.good` in `status`. A later call to `operator bool` delivers this stored value.
 
diff --git a/docs/standard-library/forward-list-class.md b/docs/standard-library/forward-list-class.md
@@ -456,7 +456,7 @@ The initializer_list to copy.
 
 ### Remarks
 
-All constructors store an [allocator](../standard-library/allocator-class.md) and initialize the controlled sequence. The allocator object is the argument *Al*, if present. For the copy constructor, it is ` right.get_allocator()`. Otherwise, it is `Allocator()`.
+All constructors store an [allocator](../standard-library/allocator-class.md) and initialize the controlled sequence. The allocator object is the argument *Al*, if present. For the copy constructor, it is `right.get_allocator()`. Otherwise, it is `Allocator()`.
 
 The first two constructors specify an empty initial controlled sequence.
 
@@ -713,7 +713,7 @@ The unary predicate which, if satisfied by an element, results in the deletion o
 
 ### Remarks
 
-The member function removes from the controlled sequence all elements, designated by the iterator `P`, for which ` pred(*P)` is true.
+The member function removes from the controlled sequence all elements, designated by the iterator `P`, for which `pred(*P)` is true.
 
 An exception occurs only if *pred* throws an exception. In that case, the controlled sequence is left in an unspecified state and the exception is rethrown.
 
@@ -948,7 +948,7 @@ Keeps the first of each unique element, and removes the rest. The elements must
 
 The first member function removes from the controlled sequence every element that compares equal to its preceding element. For the iterators `Pi` and `Pj` designating elements at positions `i` and `j`, the second member function removes every element for which `i + 1 == j &&  comp(*Pi, *Pj)`.
 
-For a controlled sequence of length `N` (> 0), the predicate ` comp(*Pi, *Pj)` is evaluated `N - 1` times.
+For a controlled sequence of length `N` (> 0), the predicate `comp(*Pi, *Pj)` is evaluated `N - 1` times.
 
 An exception occurs only if `comp` throws an exception. In that case, the controlled sequence is left in an unspecified state and the exception is rethrown.
 
diff --git a/docs/standard-library/functional-functions.md b/docs/standard-library/functional-functions.md
@@ -50,7 +50,7 @@ The Nth call argument.
 
 The types `FT, T1, T2, ..., TN` must be copy-constructible, and `INVOKE(fn, t1, ..., tN)` must be a valid expression for some values `w1, w2, ..., wN`.
 
-The first template function returns a forwarding call wrapper `g` with a weak result type. The effect of `g(u1, u2, ..., uM)` is `INVOKE(f, v1, v2, ..., vN, `[invoke_result](../standard-library/invoke-result-class.md)`<FT cv (V1, V2, ..., VN)>::type)`, where `cv` is the cv-qualifiers of `g` and the values and types of the bound arguments `v1, v2, ..., vN` are determined as specified below. You use it to bind arguments to a callable object to make a callable object with a tailored argument list.
+The first template function returns a forwarding call wrapper `g` with a weak result type. The effect of `g(u1, u2, ..., uM)` is `INVOKE(f, v1, v2, ..., vN,` [invoke_result](../standard-library/invoke-result-class.md)`<FT cv (V1, V2, ..., VN)>::type)`, where `cv` is the cv-qualifiers of `g` and the values and types of the bound arguments `v1, v2, ..., vN` are determined as specified below. You use it to bind arguments to a callable object to make a callable object with a tailored argument list.
 
 The second template function returns a forwarding call wrapper `g` with a nested type `result_type` that is a synonym for `RTy`. The effect of `g(u1, u2, ..., uM)` is `INVOKE(f, v1, v2, ..., vN, RTy)`, where `cv` is the cv-qualifiers of `g` and the values and types of the bound arguments `v1, v2, ..., vN` are determined as specified below. You use it to bind arguments to a callable object to make a callable object with a tailored argument list and with a specified return type.
 
diff --git a/docs/standard-library/hash-map-operators.md b/docs/standard-library/hash-map-operators.md
@@ -38,7 +38,7 @@ An object of type `hash_map`.
 
 The comparison between hash_map objects is based on a pairwise comparison of their elements. Two hash_maps are equal if they have the same number of elements and their respective elements have the same values. Otherwise, they are unequal.
 
-Members of the [<hash_map>](hash-map.md) and [<hash_set>](hash-set.md) header files in the [ stdext Namespace](stdext-namespace.md).
+Members of the [<hash_map>](hash-map.md) and [<hash_set>](hash-set.md) header files in the [stdext Namespace](stdext-namespace.md).
 
 ### Example
 
diff --git a/docs/standard-library/iomanip-functions.md b/docs/standard-library/iomanip-functions.md
@@ -309,7 +309,7 @@ The number base.
 
 ### Return Value
 
-The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.setf(mask, `[ios_base::basefield](../standard-library/ios-base-class.md#fmtflags)`)`, and then returns `str`. Here, `mask` is determined as follows:
+The manipulator returns an object that, when extracted from or inserted into the stream `str`, calls `str.setf(mask,` [ios_base::basefield](../standard-library/ios-base-class.md#fmtflags)`)`, and then returns `str`. Here, `mask` is determined as follows:
 
 - If *base* is 8, then `mask` is `ios_base::`[oct](../standard-library/ios-functions.md#oct).
 
diff --git a/docs/standard-library/ios-functions.md b/docs/standard-library/ios-functions.md
@@ -239,7 +239,7 @@ A reference to the object from which *str* is derived.
 
 [showpos](../standard-library/ios-functions.md#showpos) causes the sign to display for positive numbers.
 
-The manipulator effectively calls `str.`[setf](../standard-library/ios-base-class.md#setf)`(`[ios_base::internal](../standard-library/ios-base-class.md#fmtflags)`, `[ios_base::adjustfield](../standard-library/ios-base-class.md#fmtflags)`)`, and then returns *str*.
+The manipulator effectively calls `str.`[setf](../standard-library/ios-base-class.md#setf)`(`[ios_base::internal](../standard-library/ios-base-class.md#fmtflags)`,` [ios_base::adjustfield](../standard-library/ios-base-class.md#fmtflags)`)`, and then returns *str*.
 
 ### Example
 
diff --git a/docs/standard-library/num-get-class.md b/docs/standard-library/num-get-class.md
diff --git a/docs/standard-library/operator-equality-sample-container.md b/docs/standard-library/operator-equality-sample-container.md
diff --git a/docs/standard-library/string-functions.md b/docs/standard-library/string-functions.md

Original file line number	Diff line number	Diff line change
@@ -258,4 +258,3 @@ Under `/O2` `/fp:fast` the generated code is simplified, because all type casts
`258`	`258`
`259`	`259`	`[MSVC Compiler Options](compiler-options.md)<br/>`
`260`	`260`	`[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)<br/>`
`261`		`-`
Original file line number	Diff line number	Diff line change
@@ -90,4 +90,3 @@ For C, the `__vectorcall` naming convention uses the function name followed by t
`90`	`90`
`91`	`91`	`- [MSVC Compiler Options](compiler-options.md)`
`92`	`92`	`- [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)`
`93`		`-`
Original file line number	Diff line number	Diff line change
`@@ -71,7 +71,7 @@ int main()`
`71`	`71`	`}`
`72`	`72`	```
`73`	`73`
`74`		-In the preceding example, `pwCaption` is a pointer to any member of class `Window` that has type `char`. The type of `pwCaption` is `char Window::* `. The next code fragment declares pointers to the `SetCaption` and `GetCaption` member functions.
	`74`	+In the preceding example, `pwCaption` is a pointer to any member of class `Window` that has type `char`. The type of `pwCaption` is `char Window::*`. The next code fragment declares pointers to the `SetCaption` and `GetCaption` member functions.
`75`	`75`
`76`	`76`	```cpp
`77`	`77`	`const char * (Window::*pfnwGC)() = &Window::GetCaption;`