5/20/2022 AM Publish (#4297)

* 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)

* Linker option updates 1 of N

* Acrolinx pass

* 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

* Fix another typo

* Consistency check

* 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

* I thought I'd fix one thing in valarray.

* Update formatting

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4290)

* Clarify master and single directives.

A customer reported that the Remarks section for the master and single directives was confusing. Updated to make it clear that the reference to single in the remarks for master and the reference to master in the remarks for single are suggesting alternatives.

Have to use 'master' instead of 'main' here because that it is an OpenMP keyword.

* Fixed __vmx_on parameter being incorrect

according to the intel manual Vol. 3C 30-27, "The operand of this instruction is a 4KB-aligned physical address (the VMXON pointer) that references the VMXON region, which the logical processor may use to support VMX operation. This operand is always 64 bits and is always in memory.".
this was already correctly explained in the "Parameters" section, but also wrongly named.

* 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]>

* Update date, formatting

* Use 'main' instead of 'master' where possible.

* Use 'main' instead of 'master' in all documentation where possible.

* 5/17/2022 AM Publish (#4291)

* 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

* I thought I'd fix one thing in valarray.

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]>

Co-authored-by: branh <[email protected]>
Co-authored-by: sariaki <[email protected]>
Co-authored-by: Taojunshen <[email protected]>
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]>
Co-authored-by: Jeff Borsecnik <[email protected]>

* Fix cpp-docs 3815 3898 3901 3902

* fix date

* Updates to address cpp-docs 3909 and 3910

* Updates per review

* Update links

* Fix pipe entities in standard-library articles

* Fix typo

* Fix review issues

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]>
Co-authored-by: Feng Xu <[email protected]>
Co-authored-by: branh <[email protected]>
Co-authored-by: sariaki <[email protected]>
Co-authored-by: Jeff Borsecnik <[email protected]>
Co-authored-by: Haig MacGregor <[email protected]>
Co-authored-by: PRMerger13 <[email protected]>

Author: 32 people

docs/build/reference/scandependencies.md

@@ -1,7 +1,7 @@
 ---
 title: "/scanDependencies (List module and header unit dependencies per Standard)"
 description: "Reference guide to the /scanDependencies compiler option in Microsoft C++."
-ms.date: 02/01/2022
+ms.date: 05/19/2022
 author: "corob-msft"
 ms.author: "corob"
 f1_keywords: ["/scanDependencies"]
@@ -13,9 +13,9 @@ This compiler option generates a JSON file that lists module and header-unit dep
 
 The **`/scanDependencies`** compiler option identifies which modules and header units need to be compiled before you can compile the project that uses them. For instance, it lists `import <library>;` or `import "library";` as a header unit dependency, and `import name;` as a module dependency. The intent is to provide this information in a common format consumable by build tools such as CMake.
 
-This command-line option is similar to [`/sourceDependencies-directives`](sourcedependencies-directives.md) and [`/sourceDependencies`](sourcedependencies.md), but differs in the following ways:
+This command-line option is similar to [`/sourceDependencies:directives`](sourcedependencies-directives.md) and [`/sourceDependencies`](sourcedependencies.md), but differs in the following ways:
 
-- The output uses the [`P1689R4`](https://wg21.link/P1689r4) schema, instead of the Microsoft-specific schema generated by **`/sourceDependencies-directives`**.
+- The output uses the [`P1689R4`](https://wg21.link/P1689r4) schema, instead of the Microsoft-specific schema generated by **`/sourceDependencies:directives`**.
 - Unlike **`/sourceDependencies`**, the compiler doesn't produce compiled output. Instead, the files are scanned for module directives. No compiled code, modules, or header units are produced.
 - The output JSON file doesn't list imported modules and imported header units (*`.ifc`* files) because this option only scans the project files. There are no built modules or header units to list.
 - Only directly imported modules or header units are listed. It doesn't list the dependencies of the imported modules or header units themselves.
@@ -24,26 +24,26 @@ This command-line option is similar to [`/sourceDependencies-directives`](source
 
 ## Syntax
 
-> **`/scanDependencies`** -\
+> **`/scanDependencies-`**\
 > **`/scanDependencies`** *`filename`*\
-> **`/scanDependencies`** *`directory`*\
+> **`/scanDependencies`** *`directory`*
 
 ## Arguments
 
 *`-`*\
 If the single dash is provided, then the compiler emits the source dependencies JSON to `stdout`, or to where compiler output is redirected.
 
 *`filename`*\
-The compiler writes the source dependency output to the specified filename, which may include a relative or absolute path.
+The compiler writes the source dependency output to the specified filename, which may include a relative or absolute path. The file is created if it doesn't exist.
 
 *`directory`*\
-If the argument is a directory, the compiler generates source dependency files in the specified directory. The output file name is based on the full name of the input file, with an appended *`.module.json`* extension. For example, if the file provided to the compiler is *`main.cpp`*, the generated output filename is *`main.cpp.module.json`*.
+If the argument is a directory, the compiler generates source dependency files in the specified directory. The directory must exist, or the argument is treated as a *`filename`*. The output file name is based on the full name of the input file, with an appended *`.module.json`* extension. For example, if the file provided to the compiler is *`main.cpp`*, the generated output filename is *`main.cpp.module.json`*.
 
 ## Remarks
 
 **`/scanDependencies`** is available starting in Visual Studio 2022 version 17.2 preview 1. It's not enabled by default.
 
-When you specify the **`/MP`** compiler option, we recommend you use **`/scanDependencies`** with a directory argument. If you provide a single filename argument, two instances of the compiler may attempt to open the output file simultaneously and cause an error. For more information on **`/MP`**, see [`/MP` (Build with multiple processes)](mp-build-with-multiple-processes.md).
+When you specify the [`/MP` (Build with multiple processes)](mp-build-with-multiple-processes.md) compiler option, we recommend you use **`/scanDependencies`** with a directory argument. If you provide a single filename argument, two instances of the compiler may attempt to open the output file simultaneously and cause an error. Use of **`/MP`** with **`/scanDependencies-`** to send output to `stdout` could cause interleaved results.
 
 When a non-fatal compiler error occurs, the dependency information still gets written to the output file.
 
@@ -132,6 +132,6 @@ You normally shouldn't set this option yourself in the Visual Studio development
 
 [MSVC compiler options](compiler-options.md)\
 [MSVC compiler command-line syntax](compiler-command-line-syntax.md)\
-[`/sourceDependencies-directives`](sourcedependencies-directives.md)\
+[`/sourceDependencies:directives`](sourcedependencies-directives.md)\
 [`/sourceDependencies`](sourcedependencies.md)\
 [`/translateInclude`](translateinclude.md)

docs/build/reference/sourcedependencies-directives.md

@@ -1,7 +1,7 @@
 ---
 title: "/sourceDependencies:directives (List module and header unit dependencies)"
 description: "Reference guide to the /sourceDependencies:directives compiler option in Microsoft C++."
-ms.date: 02/02/2022
+ms.date: 05/19/2022
 author: "tylermsft"
 ms.author: "twhitney"
 f1_keywords: ["/sourceDependencies:directives"]
@@ -23,26 +23,26 @@ This option differs from [`/sourceDependencies`](sourcedependencies.md) in the f
 
 ## Syntax
 
-> **`/sourceDependencies:directives`** -\
+> **`/sourceDependencies:directives-`**\
 > **`/sourceDependencies:directives`** *filename*\
-> **`/sourceDependencies:directives`** *directory*\
+> **`/sourceDependencies:directives`** *directory*
 
 ## Arguments
 
 *`-`*\
-If the single dash is provided, then the compiler will emit the source dependencies JSON to `stdout`, or to where compiler output is redirected to.
+If the single dash is provided, then the compiler will emit the source dependencies JSON to `stdout`, or to where compiler output is redirected.
 
 *`filename`*\
-The compiler writes the source dependency output to the specified filename, which may include a relative or absolute path.
+The compiler writes the source dependency output to the specified filename, which may include a relative or absolute path. The file is created if it doesn't exist.
 
 *`directory`*\
-If the argument is a directory, the compiler generates source dependency files in the specified directory. The output file name is based on the full name of the input file, with an appended *`.json`* extension. For example, if the file provided to the compiler is *`main.cpp`*, the generated output filename is *`main.cpp.json`*.
+If the argument is a directory, the compiler generates source dependency files in the specified directory. The directory must exist, or the argument is treated as a *`filename`*. The output file name is based on the full name of the input file, with an appended *`.json`* extension. For example, if the file provided to the compiler is *`main.cpp`*, the generated output filename is *`main.cpp.json`*.
 
 ## Remarks
 
 **`/sourceDependencies:directives`** is available starting in Visual Studio 2019 version 16.10.
 
-When you specify the [`/MP` (Build with multiple processes)](mp-build-with-multiple-processes.md) compiler option, we recommend you use **`/sourceDependencies:directives`** with a directory argument. This option makes the compiler output a separate *`*.module.json`* file for each source file. If you provide a single filename argument, two instances of the compiler may attempt to open the output file simultaneously and cause an error.
+When you specify the [`/MP` (Build with multiple processes)](mp-build-with-multiple-processes.md) compiler option, we recommend that you use **`/sourceDependencies:directives`** with a directory argument. This option makes the compiler output a separate *`*.module.json`* file for each source file. If you provide a single filename argument, two instances of the compiler may attempt to open the output file simultaneously and cause an error. Use of **`/MP`** with **`/sourceDependencies:directives-`** to send output to `stdout` could cause interleaved results.
 
 When a non-fatal compiler error occurs, the dependency information still gets written to the output file.
 
@@ -100,7 +100,7 @@ No *`.ifc`* files are listed in the output because they weren't built. Unlike `/
 
 ## To set this compiler option in Visual Studio
 
-You normally shouldn't set this yourself in the Visual Studio development environment. It's set by the build system.
+You normally shouldn't set this option yourself in the Visual Studio development environment. It's set by the build system.
 
 ## See also
 

docs/build/reference/sourcedependencies.md

@@ -1,7 +1,7 @@
 ---
 title: "/sourceDependencies (Report source-level dependencies)"
 description: "Describes the /sourceDependencies compiler option in Microsoft C++."
-ms.date: 04/13/2020
+ms.date: 05/19/2022
 author: "tylermsft"
 ms.author: "twhitney"
 f1_keywords: ["/sourceDependencies"]
@@ -14,32 +14,32 @@ This command-line switch generates a JSON file that details the source-level dep
 - Header files. Both directly included and the list of headers included by those headers.
 - The PCH used (if **`/Yu`** is specified).
 - Names of imported modules
-- File paths and names of imported header units. Both directly imported and those imported by those modules and headers units.
+- File paths and names of both directly imported header units and of the modules and header units they import in turn.
 
-This provides information necessary to build modules and header units in the proper dependency order.
+This option provides information necessary to build modules and header units in the proper dependency order.
 
 ## Syntax
 
-> **`/sourceDependencies`** -\
+> **`/sourceDependencies-`**\
 > **`/sourceDependencies`** *filename*\
 > **`/sourceDependencies`** *directory*
 
 ## Arguments
 
 *`-`*\
-If the single dash is provided, then the compiler will emit the source dependencies JSON to `stdout`, or to where compiler output is redirected to.
+If the single dash is provided, then the compiler will emit the source dependencies JSON to `stdout`, or to where compiler output is redirected.
 
 *`filename`*\
-The compiler writes the source dependency output to the specified filename, which may include a relative or absolute path.
+The compiler writes the source dependency output to the specified filename, which may include a relative or absolute path. The file is created if it doesn't exist.
 
 *`directory`*\
-If the argument is a directory, the compiler generates source dependency files in the specified directory. The output file name is based on the full name of the input file, with an appended *`.json`* extension. For example, if the file provided to the compiler is *`main.cpp`*, the generated output filename is *`main.cpp.json`*.
+If the argument is a directory, the compiler generates source dependency files in the specified directory. The directory must exist, or the argument is treated as a *`filename`*. The output file name is based on the full name of the input file, with an appended *`.json`* extension. For example, if the file provided to the compiler is *`main.cpp`*, the generated output filename is *`main.cpp.json`*.
 
 ## Remarks
 
 The **`/sourceDependencies`** compiler option is available starting in Visual Studio 2019 version 16.7. It's not enabled by default.
 
-When you specify the **`/MP`** compiler option, we recommend you use **`/sourceDependencies`** with a directory argument. If you provide a single filename argument, two instances of the compiler may attempt to open the output file simultaneously and cause an error. For more information on **`/MP`**, see [`/MP` (Build with multiple processes)](mp-build-with-multiple-processes.md).
+When you specify the [`/MP` (Build with multiple processes)](mp-build-with-multiple-processes.md) compiler option, we recommend you use **`/sourceDependencies`** with a directory argument. If you provide a single filename argument, two instances of the compiler may attempt to open the output file simultaneously and cause an error. Use of **`/MP`** with **`/sourceDependencies-`** to send output to `stdout` could cause interleaved results.
 
 When a non-fatal compiler error occurs, the dependency information still gets written to the output file.
 
@@ -61,7 +61,7 @@ You can use **`/sourceDependencies`** with the rest of your compiler options:
 
 > `cl ... /sourceDependencies output.json ... main.cpp`
 
-where `...` represents your other compiler options. This command line produces a JSON file *`output.json`* with content  like:
+where `...` represents your other compiler options. This command line produces a JSON file *`output.json`* with content like:
 
 ```JSON
 {
@@ -98,16 +98,17 @@ where `...` represents your other compiler options. This command line produces a
 }
 ```
 
-We've used `...` to abbreviate the reported paths. The report will contain the absolute paths. The paths reported depend on where the compiler finds the dependencies. If the results are unexpected, you may want to check your project's include path settings.
+We've used `...` to abbreviate the reported paths. The report contains the absolute paths. The paths reported depend on where the compiler finds the dependencies. If the results are unexpected, you may want to check your project's include path settings.
 
 `ProvidedModule` lists exported module or module partition names.
 
 ### To set this compiler option in the Visual Studio development environment
 
-You normally shouldn't set this yourself in the Visual Studio development environment. It is set by the build system.
+You normally shouldn't set this option yourself in the Visual Studio development environment. It's set by the build system.
 
 ## See also
 
-[MSVC compiler options](compiler-options.md)<br/>
-[MSVC compiler command-line syntax](compiler-command-line-syntax.md)<br/>
-[`/scanDependencies` (List module dependencies in standard form)](scandependencies.md)
+[MSVC compiler options](compiler-options.md)\
+[MSVC compiler command-line syntax](compiler-command-line-syntax.md)\
+[`/scanDependencies`](scandependencies.md)\
+[`/sourceDependencies:directives`](sourcedependencies-directives.md)

docs/standard-library/basic-istringstream-class.md

@@ -101,9 +101,9 @@ An rvalue reference of a `basic_istringstream` object.
 
 ### Remarks
 
-The first constructor initializes the base class by calling [basic_istream](../standard-library/basic-istream-class.md)(`sb`), where `sb` is the stored object of class [basic_stringbuf](../standard-library/basic-stringbuf-class.md)< `Elem`, `Tr`, `Alloc`>. It also initializes `sb` by calling `basic_stringbuf`< `Elem`, `Tr`, `Alloc`>( `_Mode` &#124; `ios_base::in`).
+The first constructor initializes the base class by calling `basic_istream]( sb )`, where `sb` is the stored object of class `basic_stringbuf< Elem, Tr, Alloc>`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( _Mode | ios_base::in )`. For more information, see [`basic_istream`](../standard-library/basic-istream-class.md) and [`basic_stringbuf`](../standard-library/basic-stringbuf-class.md).
 
-The second constructor initializes the base class by calling `basic_istream(sb)`. It also initializes `sb` by calling `basic_stringbuf`< `Elem`, `Tr`, `Alloc`>( `str`, `_Mode` &#124; `ios_base::in`).
+The second constructor initializes the base class by calling `basic_istream( sb )`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::in )`.
 
 The third constructor initializes the object with the contents of *right*, treated as an rvalue reference.
 

docs/standard-library/basic-ostringstream-class.md

@@ -85,9 +85,9 @@ An object of type `basic_string`.
 
 ### Remarks
 
-The first constructor initializes the base class by calling [basic_ostream](../standard-library/basic-ostream-class.md)( **sb**), where `sb` is the stored object of class [basic_stringbuf](../standard-library/basic-stringbuf-class.md)< **Elem**, **Tr**, `Alloc`>. It also initializes **sb** by calling basic_stringbuf< **Elem**, **Tr**, `Alloc`>( `_Mode` &#124; `ios_base::out`).
+The first constructor initializes the base class by calling `basic_ostream( sb )`, where `sb` is the stored object of class `basic_stringbuf< Elem, Tr, Alloc>`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc>( _Mode | ios_base::out )`. For more information, see [`basic_ostream`](../standard-library/basic-ostream-class.md) and [`basic_stringbuf`](../standard-library/basic-stringbuf-class.md).
 
-The second constructor initializes the base class by calling basic_ostream( **sb**). It also initializes `sb` by calling basic_stringbuf< **Elem**, **Tr**, `Alloc`>(_ *Str*, `_Mode` &#124; `ios_base::out`).
+The second constructor initializes the base class by calling `basic_ostream( sb )`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::out )`.
 
 ## <a name="rdbuf"></a> basic_ostringstream::rdbuf
 

docs/standard-library/bitset-operators.md

@@ -253,9 +253,9 @@ bitset 2: 0011
 bitset 3: 0110
 ```
 
-## <a name="op_or"></a> operator&#124;
+## <a name="op_or"></a> `operator|`
 
-Performs a bitwise `OR` between two bitsets.
+Performs a bitwise OR between two `bitset` objects.
 
 ```cpp
 template <size_t size>

docs/standard-library/bitset.md

@@ -26,7 +26,7 @@ Defines the class template bitset and two supporting template functions for repr
 |[operator<\<](../standard-library/bitset-operators.md#op_lt_lt)|Inserts a text representation of the bit sequence into the standard output stream.|
 |[operator>>](../standard-library/bitset-operators.md#op_gt_gt)|Inserts a text representation of the bit sequence into the standard input stream.|
 |[operator^](../standard-library/bitset-operators.md#op_xor)|Performs a bitwise EXCLUSIVE-OR between two bitsets.|
-|[operator&#124;](../standard-library/bitset-operators.md#op_or)|Performs a bitwise OR between two bitsets.|
+|[`operator|`](../standard-library/bitset-operators.md#op_or)|Performs a bitwise OR between two bitsets.|
 
 ### Classes
 

docs/standard-library/complex-functions.md

@@ -28,7 +28,7 @@ The modulus of a complex number.
 
 ### Remarks
 
-The *modulus* of a complex number is a measure of the length of the vector representing the complex number. The modulus of a complex number                         a + bi is                         sqrt (a<sup>2</sup> + b<sup>2</sup>),  written                         &#124;a + bi&#124;. The *norm* of a complex number                         a + bi is (a<sup>2</sup> + b<sup>2</sup>), so the modulus of a complex number is the square root of its norm.
+The *modulus* of a complex number is a measure of the length of the vector representing the complex number. The modulus of a complex number *a + bi* is the square root of (*a*<sup>2</sup> + *b*<sup>2</sup>), written \|*a + bi*\|. The *norm* of a complex number *a + bi* is (*a*<sup>2</sup> + *b*<sup>2</sup>). The norm of a complex number is the square of its modulus.
 
 ### Example
 
@@ -758,8 +758,7 @@ The norm of a complex number.
 
 ### Remarks
 
-The norm of a complex number *a + bi* is *(a*<sup>2</sup> *+ b*<sup>2</sup>*).* The norm of a complex number is the square of its modulus. The modulus of a complex number is a measure of the length of the vector representing the complex number. The modulus of a complex number *a + bi* is `sqrt`*(a*<sup>2</sup> *+ b*<sup>2</sup>*),* written *&#124;a + bi&#124;.*
-
+The *norm* of a complex number *a + bi* is (*a*<sup>2</sup> + *b*<sup>2</sup>). The norm of a complex number is the square of its modulus. The *modulus* of a complex number is a measure of the length of the vector representing the complex number. The modulus of a complex number *a + bi* is the square root of (*a*<sup>2</sup> + *b*<sup>2</sup>), written \|*a + bi*\|.
 ### Example
 
 ```cpp