5/16/2022 AM Publish (#4289)

* Fix issues in valarray content

* Acrolinx pass

* Update scanf %c to mention field width

As part of UCRT refactoring, we introduced an undocumented breaking change that follows the C standard that changed out %c specifier from following the usual rules for field width to using the standardized exception for the %c specifier. We should document it.

* Broken link fixed

* Broken link fixed

* Update dynamicbase.md

arm32 and arm64 is not supported for this linker switch as ASLR cannot be disabled for these architectures.

* update code examples

* offer an alternative project type

* fix for github #3859

* acrolinx

* Clarify per Russ' comments

Also update date and add formatting to current standard.

* Work in progress for 17.2 release

* Followup cpp-docs 3871 in linker opts

* Fix grammar and formatting issues

* Update latest-supported-vc-redist.md

In the line 35, at the very end removed an extra dot.

* Fix alarming bidi description

* text tweaks

* bug fix: 1536384 note implicit compiler flag that is set when using header units. Also, update how null is specified.

* fix flag casing

* Address cpp-docs 3857 3865 3877 3882

* simplify code example-related to github #3847 (#4272)

* simplify code example-related to github #3847

* right justify output

* Update docs/c-runtime-library/reference/getdiskfree.md

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Shannon Leavitt <[email protected]>

* address feedback

* Recreate Lauren's /TIME update

* fix for github 3787

* Fix formatting.

* acrolinx pass

* more acrolinx

* Added example program outputs + fixed `equal_range` example compile errors (#3892)

* Added a space to maintain style consistency (#3892)

* Added new line to output section of max (#3892)

* Adding another new line to output section of max (#3892)

* tech feedback

* Tweak issue templates

* Add two new templates for new doc work

Templates for doc work for new standards conformance in the compiler and tools.

* Fix merge issues

* Fix typo

* Updated per comments

* Clean up more html escaped pipe chars

* Remove more pipe html entities

* Bulk fix continued of pipe html entities

* Bulk fix of pipe html entities 5 of N

* Bulk fix pipe html entities 6 of N

* Slight Acrolinx pass

* Remove some &#124; ('|') HTML entities in docs (#4038)

* Remove some &#124; ('|') HTML entities in docs

* Another group of files

* Fixes after testing

* Tweaks per review

Co-authored-by: [email protected] <[email protected]>
Co-authored-by: Steve Wishnousky <[email protected]>
Co-authored-by: opbld17 <[email protected]>
Co-authored-by: Pritam Ovhal <[email protected]>
Co-authored-by: Lauren Prinn <[email protected]>
Co-authored-by: PRMerger16 <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: PRMerger4 <[email protected]>
Co-authored-by: Tamara K <[email protected]>
Co-authored-by: Matin Sasanpour <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: opbld15 <[email protected]>
Co-authored-by: Dennis Rea <[email protected]>
Co-authored-by: Colin Cooper <[email protected]>
Co-authored-by: Carolyn McSharry <[email protected]>
Co-authored-by: PRMerger12 <[email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Shannon Leavitt <[email protected]>
Co-authored-by: Anna Huff <[email protected]>
Co-authored-by: Brandon <[email protected]>
Co-authored-by: PRMerger3 <[email protected]>
Co-authored-by: opbld16 <[email protected]>
Co-authored-by: PRMerger14 <[email protected]>
Co-authored-by: PRMerger5 <[email protected]>
Co-authored-by: PRMerger8 <[email protected]>

Author: 26 people

docs/atl-mfc-shared/reference/cimage-class.md

@@ -691,7 +691,7 @@ Set of bit flags specifying which file types to exclude from the list. Allowable
 
 - `excludeDefaultLoad` = 0   For load, all file types are included by default
 
-- `excludeDefaultSave` = `excludeIcon | excludeEMF | excludeWMF` For saving, these files are excluded by default because they usually have special requirements.
+- `excludeDefaultSave` = `excludeIcon | excludeEMF | excludeWMF` For saving, these files are excluded by default because they usually have special requirements.
 
 *`chSeparator`*<br/>
 The separator used between the image formats. See **Remarks** for more information.
@@ -706,13 +706,13 @@ You can pass the resulting format string to your MFC [`CFileDialog`](../../mfc/r
 
 The parameter *`strExporter`* has the format:
 
-file description0&#124;\*.ext0&#124;filedescription1&#124;\*.ext1&#124;...file description *n*&#124;\*.ext *n*&#124;&#124;
+`file description 0|*.ext0|file description 1|*.ext1|...file description N|*.extN||`
 
-where '&#124;' is the separator character specified by `chSeparator`. For example:
+where `|` is the separator character specified by `chSeparator`. For example:
 
 `"Bitmap format|*.bmp|JPEG format|*.jpg|GIF format|*.gif|PNG format|*.png||"`
 
-Use the default separator '&#124;' if you pass this string to an MFC `CFileDialog` object. Use the null separator '\0' if you pass this string to a common File Save dialog box.
+Use the default separator `|` if you pass this string to an MFC `CFileDialog` object. Use the null separator `'\0'` if you pass this string to a common File Save dialog box.
 
 ## <a name="getheight"></a> `CImage::GetHeight`
 
@@ -786,7 +786,7 @@ Set of bit flags specifying which file types to exclude from the list. Allowable
 
 - `excludeDefaultLoad` = 0   For load, all file types are included by default
 
-- `excludeDefaultSave` = `excludeIcon &#124; excludeEMF &#124; excludeWMF` For saving, these files are excluded by default because they usually have special requirements.
+- `excludeDefaultSave` = `excludeIcon | excludeEMF | excludeWMF` For saving, these files are excluded by default because they usually have special requirements.
 
 *`chSeparator`*<br/>
 The separator used between the image formats. See **Remarks** for more information.
@@ -797,13 +797,13 @@ You can pass the resulting format string to your MFC [`CFileDialog`](../../mfc/r
 
 The parameter *`strImporter`* has the format:
 
-file description0&#124;\*.ext0&#124;filedescription1&#124;\*.ext1&#124;...file description *n*&#124;\*.ext *n*&#124;&#124;
+`file description 0|*.ext0|file description 1|*.ext1|...file description N|*.extN||
 
-where '&#124;' is the separator character specified by *`chSeparator`*. For example:
+where `|` is the separator character specified by *`chSeparator`*. For example:
 
 `"Bitmap format|*.bmp|JPEG format|*.jpg|GIF format|*.gif|PNG format|*.png||"`
 
-Use the default separator '&#124;' if you pass this string to an MFC `CFileDialog` object. Use the null separator '\0' if you pass this string to a common **File Open** dialog box.
+Use the default separator `|` if you pass this string to an MFC `CFileDialog` object. Use the null separator `'\0'` if you pass this string to a common **File Open** dialog box.
 
 ## <a name="getmaxcolortableentries"></a> `CImage::GetMaxColorTableEntries`
 

docs/atl/adding-a-control-atl-tutorial-part-2.md

@@ -109,7 +109,7 @@ Now you can build the control to see it in action.
 
 Next, you'll add a custom property to the control.
 
-[Back to Step 1](../atl/creating-the-project-atl-tutorial-part-1.md) | [On to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md)
+[Back to Step 1](../atl/creating-the-project-atl-tutorial-part-1.md) \| [On to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md)
 
 ## See also
 

docs/atl/adding-a-property-page-atl-tutorial-part-6.md

@@ -142,7 +142,7 @@ The **Apply** button is initially disabled. Start typing a value in the **Sides*
 
 Next, you will put your control on a Web page.
 
-[Back to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md) | [On to Step 7](../atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md)
+[Back to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md) \| [On to Step 7](../atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md)
 
 ## See also
 

docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md

@@ -57,7 +57,7 @@ The `get_Sides` method returns the current value of the `Sides` property through
 
 You now have a property called `Sides`. In the next step, you will change the drawing code to use it.
 
-[Back to Step 2](../atl/adding-a-control-atl-tutorial-part-2.md) | [On to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md)
+[Back to Step 2](../atl/adding-a-control-atl-tutorial-part-2.md) \| [On to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md)
 
 ## See also
 

docs/atl/adding-an-event-atl-tutorial-part-5.md

@@ -149,7 +149,7 @@ Now try out your events. Build the control and start the ActiveX Control Test Co
 
 Next, you will add a property page.
 
-[Back to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md) | [On to Step 6](../atl/adding-a-property-page-atl-tutorial-part-6.md)
+[Back to Step 4](../atl/changing-the-drawing-code-atl-tutorial-part-4.md) \| [On to Step 6](../atl/adding-a-property-page-atl-tutorial-part-6.md)
 
 ## See also
 

docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md

@@ -151,7 +151,7 @@ After adding `FireViewChange`, rebuild and try the control again in the ActiveX
 
 In the next step, you will add an event.
 
-[Back to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md) | [On to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md)
+[Back to Step 3](../atl/adding-a-property-to-the-control-atl-tutorial-part-3.md) \| [On to Step 5](../atl/adding-an-event-atl-tutorial-part-5.md)
 
 ## See also
 

docs/atl/reference/catltransactionmanager-class.md

@@ -165,7 +165,7 @@ inline HANDLE CreateFile(
 The name of an object to be created or opened.
 
 *dwDesiredAccess*<br/>
-The access to the object, which can be summarized as read, write, both, or neither (zero). The most commonly used values are GENERIC_READ, GENERIC_WRITE, or both: GENERIC_READ &#124; GENERIC_WRITE.
+The access to the object, which can be summarized as read, write, both, or neither (zero). The most commonly used values are `GENERIC_READ`, `GENERIC_WRITE`, or both: `GENERIC_READ | GENERIC_WRITE`.
 
 *dwShareMode*<br/>
 The sharing mode of an object, which can be read, write, both, delete, all of these, or none: 0, FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE.

docs/atl/reference/ccontainedwindowt-class.md

@@ -197,7 +197,7 @@ HWND Create(
 [in] Specifies the name of the window. The default value is NULL.
 
 *dwStyle*<br/>
-[in] The style of the window. The default value is WS_CHILD &#124; WS_VISIBLE. For a list of possible values, see [CreateWindow](/windows/win32/api/winuser/nf-winuser-createwindoww) in the Windows SDK.
+[in] The style of the window. The default value is `WS_CHILD | WS_VISIBLE`. For a list of possible values, see [CreateWindow](/windows/win32/api/winuser/nf-winuser-createwindoww) in the Windows SDK.
 
 *dwExStyle*<br/>
 [in] The extended window style. The default value is 0, meaning no extended style. For a list of possible values, see [CreateWindowEx](/windows/win32/api/winuser/nf-winuser-createwindowexw) in the Windows SDK.

docs/c-runtime-library/byte-classification.md

@@ -8,36 +8,36 @@ ms.assetid: 1cb52d71-fb0c-46ca-aad7-6472c1103370
 ---
 # Byte classification
 
-Each of these routines tests a specified byte of a multibyte character for satisfaction of a condition. Except where specified otherwise, the output value is affected by the setting of the **LC_CTYPE** category setting of the locale; see [setlocale](../c-runtime-library/reference/setlocale-wsetlocale.md) for more information. The versions of these functions without the **_l** suffix use the current locale for this locale-dependent behavior; the versions with the **_l** suffix are identical except that they use the locale parameter passed in instead.
+Each of these routines tests a specified byte of a multibyte character for satisfaction of a condition. Except where specified otherwise, the output value is affected by the setting of the `LC_CTYPE` category setting of the locale. For more information, see [`setlocale`](../c-runtime-library/reference/setlocale-wsetlocale.md). The versions of these functions without the **`_l`** suffix use the current locale for this locale-dependent behavior; the versions with the **`_l`** suffix are identical except that they use the locale parameter passed in instead.
 
 > [!NOTE]
 > By definition, the ASCII characters between 0 and 127 are a subset of all multibyte-character sets. For example, the Japanese katakana character set includes ASCII as well as non-ASCII characters.
 
-The predefined constants in the following table are defined in \<ctype.h>.
+The predefined constants in the following table are defined in `<ctype.h>`.
 
 ## Multibyte-character byte-classification routines
 
-|Routine|Byte Test Condition|
-|-------------|-------------------------|
-|[isleadbyte, _isleadbyte_l](../c-runtime-library/reference/isleadbyte-isleadbyte-l.md)|Lead byte; test result depends on **LC_CTYPE** category setting of current locale|
-|[_ismbbalnum, _ismbbalnum_l](../c-runtime-library/reference/ismbbalnum-ismbbalnum-l.md)|**isalnum** &#124;&#124; **_ismbbkalnum**|
-|[_ismbbalpha, _ismbbalpha_l](../c-runtime-library/reference/ismbbalpha-ismbbalpha-l.md)|**isalpha** &#124;&#124; **_ismbbkalnum**|
-|[_ismbbgraph, _ismbbgraph_l](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md)|Same as **_ismbbprint**, but **_ismbbgraph** does not include the space character (0x20)|
-|[_ismbbkalnum, _ismbbkalnum_l](../c-runtime-library/reference/ismbbkalnum-ismbbkalnum-l.md)|Non-ASCII text symbol other than punctuation. For example, in code page 932 only, **_ismbbkalnum** tests for katakana alphanumeric|
-|[_ismbbkana, _ismbbkana_l](../c-runtime-library/reference/ismbbkana-ismbbkana-l.md)|Katakana (0xA1 - 0xDF), code page 932 only|
-|[_ismbbkprint, _ismbbkprint_l](../c-runtime-library/reference/ismbbkprint-ismbbkprint-l.md)|Non-ASCII text or non-ASCII punctuation symbol. For example, in code page 932 only, **_ismbbkprint** tests for katakana alphanumeric or katakana punctuation (range: 0xA1 - 0xDF).|
-|[_ismbbkpunct, _ismbbkpunct_l](../c-runtime-library/reference/ismbbkpunct-ismbbkpunct-l.md)|Non-ASCII punctuation. For example, in code page 932 only, **_ismbbkpunct** tests for katakana punctuation.|
-|[_ismbblead, _ismbblead_l](../c-runtime-library/reference/ismbblead-ismbblead-l.md)|First byte of multibyte character. For example, in code page 932 only, valid ranges are 0x81 - 0x9F, 0xE0 - 0xFC.|
-|[_ismbbprint, _ismbbprint_l](../c-runtime-library/reference/ismbbprint-ismbbprint-l.md)|**isprint** &#124;&#124; **_ismbbkprint**. **ismbbprint** includes the space character (0x20)|
-|[_ismbbpunct, _ismbbpunct_l](../c-runtime-library/reference/ismbbpunct-ismbbpunct-l.md)|**ispunct** &#124;&#124; **_ismbbkpunct**|
-|[_ismbbtrail, _ismbbtrail_l](../c-runtime-library/reference/ismbbtrail-ismbbtrail-l.md)|Second byte of multibyte character. For example, in code page 932 only, valid ranges are 0x40 - 0x7E, 0x80 - 0xEC.|
-|[_ismbslead, _ismbslead_l](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md)|Lead byte (in string context)|
-|[ismbstrail, _ismbstrail_l](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md)|Trail byte (in string context)|
-|[_mbbtype, _mbbtype_l](../c-runtime-library/reference/mbbtype-mbbtype-l.md)|Return byte type based on previous byte|
-|[_mbsbtype, _mbsbtype_l](../c-runtime-library/reference/mbsbtype-mbsbtype-l.md)|Return type of byte within string|
-|[mbsinit](../c-runtime-library/reference/mbsinit.md)|Tracks the state of a multibyte character conversion.|
-
-The **MB_LEN_MAX** macro, defined in \<limits.h>, expands to the maximum length in bytes that any multibyte character can have. **MB_CUR_MAX**, defined in \<stdlib.h>, expands to the maximum length in bytes of any multibyte character in the current locale.
+| Routine | Byte Test Condition |
+|--|--|
+| [`isleadbyte`, `_isleadbyte_l`](../c-runtime-library/reference/isleadbyte-isleadbyte-l.md) | Lead byte; test result depends on `LC_CTYPE` category setting of current locale |
+| [`_ismbbalnum`, `_ismbbalnum_l`](../c-runtime-library/reference/ismbbalnum-ismbbalnum-l.md) | `isalnum || _ismbbkalnum` |
+| [`_ismbbalpha`, `_ismbbalpha_l`](../c-runtime-library/reference/ismbbalpha-ismbbalpha-l.md) | `isalpha || _ismbbkalpha` |
+| [`_ismbbgraph`, `_ismbbgraph_l`](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md) | Same as `_ismbbprint`, but `_ismbbgraph` does not include the space character (0x20) |
+| [`_ismbbkalnum`, `_ismbbkalnum_l`](../c-runtime-library/reference/ismbbkalnum-ismbbkalnum-l.md) | Non-ASCII text symbol other than punctuation. For example, in code page 932 only, `_ismbbkalnum` tests for katakana alphanumeric |
+| [`_ismbbkana`, `_ismbbkana_l`](../c-runtime-library/reference/ismbbkana-ismbbkana-l.md) | Katakana (0xA1 - 0xDF), code page 932 only |
+| [`_ismbbkprint`, `_ismbbkprint_l`](../c-runtime-library/reference/ismbbkprint-ismbbkprint-l.md) | Non-ASCII text or non-ASCII punctuation symbol. For example, in code page 932 only, `_ismbbkprint` tests for katakana alphanumeric or katakana punctuation (range: 0xA1 - 0xDF). |
+| [`_ismbbkpunct`, `_ismbbkpunct_l`](../c-runtime-library/reference/ismbbkpunct-ismbbkpunct-l.md) | Non-ASCII punctuation. For example, in code page 932 only, `_ismbbkpunct` tests for katakana punctuation. |
+| [`_ismbblead`, `_ismbblead_l`](../c-runtime-library/reference/ismbblead-ismbblead-l.md) | First byte of multibyte character. For example, in code page 932 only, valid ranges are 0x81 - 0x9F, 0xE0 - 0xFC. |
+| [`_ismbbprint`, `_ismbbprint_l`](../c-runtime-library/reference/ismbbprint-ismbbprint-l.md) | `isprint || _ismbbkprint`. `ismbbprint` includes the space character (0x20) |
+| [`_ismbbpunct`, `_ismbbpunct_l`](../c-runtime-library/reference/ismbbpunct-ismbbpunct-l.md) | `ispunct || _ismbbkpunct` |
+| [`_ismbbtrail`, `_ismbbtrail_l`](../c-runtime-library/reference/ismbbtrail-ismbbtrail-l.md) | Second byte of multibyte character. For example, in code page 932 only, valid ranges are 0x40 - 0x7E, 0x80 - 0xEC. |
+| [`_ismbslead`, `_ismbslead_l`](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md) | Lead byte (in string context) |
+| [`ismbstrail`, `_ismbstrail_l`](../c-runtime-library/reference/ismbslead-ismbstrail-ismbslead-l-ismbstrail-l.md) | Trail byte (in string context) |
+| [`_mbbtype`, `_mbbtype_l`](../c-runtime-library/reference/mbbtype-mbbtype-l.md) | Return byte type based on previous byte |
+| [`_mbsbtype`, `_mbsbtype_l`](../c-runtime-library/reference/mbsbtype-mbsbtype-l.md) | Return type of byte within string |
+| [`mbsinit`](../c-runtime-library/reference/mbsinit.md) | Tracks the state of a multibyte character conversion. |
+
+The `MB_LEN_MAX` macro, defined in `<limits.h>`, expands to the maximum length in bytes that any multibyte character can have. `MB_CUR_MAX`, defined in `<stdlib.h>`, expands to the maximum length in bytes of any multibyte character in the current locale.
 
 ## See also
 

docs/c-runtime-library/file-attribute-constants.md

@@ -29,7 +29,7 @@ The attributes are represented by the following manifest constants:
 |`_A_SUBDIR`| Subdirectory. Value: 0x10|
 |`_A_SYSTEM`| System file. Not normally seen with the DIR command, unless the /AS option is used. Value: 0x04|
 
-Multiple constants can be combined with the OR operator (|).
+Multiple constants can be combined with the OR operator (`|`).
 
 ## See also
 

docs/c-runtime-library/file-permission-constants.md

@@ -23,15 +23,15 @@ The `pmode` argument specifies the file's permission settings as follows.
 |--------------|-------------|
 |`_S_IREAD`|Reading permitted|
 |`_S_IWRITE`|Writing permitted|
-|`_S_IREAD` | `_S_IWRITE`|Reading and writing permitted|
+|`_S_IREAD | _S_IWRITE`|Reading and writing permitted|
 
 When used as the `pmode` argument for `_umask`, the manifest constant sets the permission setting, as follows.
 
 |Constant|Meaning|
 |--------------|-------------|
 |`_S_IREAD`|Writing not permitted (file is read-only)|
 |`_S_IWRITE`|Reading not permitted (file is write-only)|
-|`_S_IREAD` | `_S_IWRITE`|Neither reading nor writing permitted|
+|`_S_IREAD | _S_IWRITE`|Neither reading nor writing permitted|
 
 ## See also