From 607e627a6c086fb4827568b21fd74d72d27b8978 Mon Sep 17 00:00:00 2001 From: Taojunshen Date: Sat, 21 May 2022 01:34:27 +0800 Subject: [PATCH] 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 Co-authored-by: Shannon Leavitt * 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 | ('|') HTML entities in docs (#4038) * Remove some | ('|') 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 Co-authored-by: Shannon Leavitt * 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 | ('|') HTML entities in docs (#4038) * Remove some | ('|') HTML entities in docs * Another group of files * Fixes after testing * Tweaks per review Co-authored-by: 3836425+corob-msft@users.noreply.github.com Co-authored-by: Steve Wishnousky Co-authored-by: opbld17 Co-authored-by: Pritam Ovhal <31490724+pritamso@users.noreply.github.com> Co-authored-by: Lauren Prinn Co-authored-by: PRMerger16 Co-authored-by: TylerMSFT Co-authored-by: PRMerger4 Co-authored-by: Tamara K <93546702+tamarakhader@users.noreply.github.com> Co-authored-by: Matin Sasanpour Co-authored-by: Courtney Wales <62625502+Court72@users.noreply.github.com> Co-authored-by: opbld15 Co-authored-by: Dennis Rea Co-authored-by: Colin Cooper <72402153+v-ccolin@users.noreply.github.com> Co-authored-by: Carolyn McSharry Co-authored-by: PRMerger12 Co-authored-by: Tyler Whitney Co-authored-by: Shannon Leavitt Co-authored-by: Anna Huff <92125952+AnnaMHuff@users.noreply.github.com> Co-authored-by: Brandon Co-authored-by: PRMerger3 Co-authored-by: opbld16 Co-authored-by: PRMerger14 Co-authored-by: PRMerger5 Co-authored-by: PRMerger8 * 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 Co-authored-by: Shannon Leavitt * 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 | ('|') HTML entities in docs (#4038) * Remove some | ('|') 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: 3836425+corob-msft@users.noreply.github.com Co-authored-by: Steve Wishnousky Co-authored-by: opbld17 Co-authored-by: Pritam Ovhal <31490724+pritamso@users.noreply.github.com> Co-authored-by: Lauren Prinn Co-authored-by: PRMerger16 Co-authored-by: TylerMSFT Co-authored-by: PRMerger4 Co-authored-by: Tamara K <93546702+tamarakhader@users.noreply.github.com> Co-authored-by: Matin Sasanpour Co-authored-by: Courtney Wales <62625502+Court72@users.noreply.github.com> Co-authored-by: opbld15 Co-authored-by: Dennis Rea Co-authored-by: Colin Cooper <72402153+v-ccolin@users.noreply.github.com> Co-authored-by: Carolyn McSharry Co-authored-by: PRMerger12 Co-authored-by: Tyler Whitney Co-authored-by: Shannon Leavitt Co-authored-by: Anna Huff <92125952+AnnaMHuff@users.noreply.github.com> Co-authored-by: Brandon Co-authored-by: PRMerger3 Co-authored-by: opbld16 Co-authored-by: PRMerger14 Co-authored-by: PRMerger5 Co-authored-by: PRMerger8 Co-authored-by: branh Co-authored-by: sariaki <69108436+sariaki@users.noreply.github.com> Co-authored-by: Taojunshen Co-authored-by: 3836425+corob-msft@users.noreply.github.com Co-authored-by: Steve Wishnousky Co-authored-by: opbld17 Co-authored-by: Pritam Ovhal <31490724+pritamso@users.noreply.github.com> Co-authored-by: Lauren Prinn Co-authored-by: PRMerger16 Co-authored-by: TylerMSFT Co-authored-by: PRMerger4 Co-authored-by: Tamara K <93546702+tamarakhader@users.noreply.github.com> Co-authored-by: Matin Sasanpour Co-authored-by: Courtney Wales <62625502+Court72@users.noreply.github.com> Co-authored-by: opbld15 Co-authored-by: Dennis Rea Co-authored-by: Colin Cooper <72402153+v-ccolin@users.noreply.github.com> Co-authored-by: Carolyn McSharry Co-authored-by: PRMerger12 Co-authored-by: Tyler Whitney Co-authored-by: Shannon Leavitt Co-authored-by: Anna Huff <92125952+AnnaMHuff@users.noreply.github.com> Co-authored-by: Brandon Co-authored-by: PRMerger3 Co-authored-by: opbld16 Co-authored-by: PRMerger14 Co-authored-by: PRMerger5 Co-authored-by: PRMerger8 Co-authored-by: Jeff Borsecnik <36546697+jborsecnik@users.noreply.github.com> * 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: 3836425+corob-msft@users.noreply.github.com Co-authored-by: Steve Wishnousky Co-authored-by: opbld17 Co-authored-by: Pritam Ovhal <31490724+pritamso@users.noreply.github.com> Co-authored-by: Lauren Prinn Co-authored-by: PRMerger16 Co-authored-by: TylerMSFT Co-authored-by: PRMerger4 Co-authored-by: Tamara K <93546702+tamarakhader@users.noreply.github.com> Co-authored-by: Matin Sasanpour Co-authored-by: Courtney Wales <62625502+Court72@users.noreply.github.com> Co-authored-by: opbld15 Co-authored-by: Dennis Rea Co-authored-by: Colin Cooper <72402153+v-ccolin@users.noreply.github.com> Co-authored-by: Carolyn McSharry Co-authored-by: PRMerger12 Co-authored-by: Tyler Whitney Co-authored-by: Shannon Leavitt Co-authored-by: Anna Huff <92125952+AnnaMHuff@users.noreply.github.com> Co-authored-by: Brandon Co-authored-by: PRMerger3 Co-authored-by: opbld16 Co-authored-by: PRMerger14 Co-authored-by: PRMerger5 Co-authored-by: PRMerger8 Co-authored-by: Feng Xu Co-authored-by: branh Co-authored-by: sariaki <69108436+sariaki@users.noreply.github.com> Co-authored-by: Jeff Borsecnik <36546697+jborsecnik@users.noreply.github.com> Co-authored-by: Haig MacGregor <92189915+hmacgregor1@users.noreply.github.com> Co-authored-by: PRMerger13 --- docs/build/reference/scandependencies.md | 18 ++++++------ .../sourcedependencies-directives.md | 16 +++++----- docs/build/reference/sourcedependencies.md | 29 ++++++++++--------- .../basic-istringstream-class.md | 4 +-- .../basic-ostringstream-class.md | 4 +-- docs/standard-library/bitset-operators.md | 4 +-- docs/standard-library/bitset.md | 2 +- docs/standard-library/complex-functions.md | 5 ++-- docs/standard-library/ctype-base-class.md | 2 +- docs/standard-library/ctype-class.md | 4 +-- docs/standard-library/functional.md | 8 ++--- docs/standard-library/locale-class.md | 2 +- 12 files changed, 49 insertions(+), 49 deletions(-) diff --git a/docs/build/reference/scandependencies.md b/docs/build/reference/scandependencies.md index 8a33f40c827..8fd8012a8d4 100644 --- a/docs/build/reference/scandependencies.md +++ b/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 ;` 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,9 +24,9 @@ This command-line option is similar to [`/sourceDependencies-directives`](source ## Syntax -> **`/scanDependencies`** -\ +> **`/scanDependencies-`**\ > **`/scanDependencies`** *`filename`*\ -> **`/scanDependencies`** *`directory`*\ +> **`/scanDependencies`** *`directory`* ## Arguments @@ -34,16 +34,16 @@ This command-line option is similar to [`/sourceDependencies-directives`](source 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) diff --git a/docs/build/reference/sourcedependencies-directives.md b/docs/build/reference/sourcedependencies-directives.md index 509af5d844f..7f1e9efe388 100644 --- a/docs/build/reference/sourcedependencies-directives.md +++ b/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 diff --git a/docs/build/reference/sourcedependencies.md b/docs/build/reference/sourcedependencies.md index 5bb0e792c58..c0ae01daa1a 100644 --- a/docs/build/reference/sourcedependencies.md +++ b/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)
-[MSVC compiler command-line syntax](compiler-command-line-syntax.md)
-[`/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) diff --git a/docs/standard-library/basic-istringstream-class.md b/docs/standard-library/basic-istringstream-class.md index 170980afac6..fcde0c67990 100644 --- a/docs/standard-library/basic-istringstream-class.md +++ b/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` | `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` | `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. diff --git a/docs/standard-library/basic-ostringstream-class.md b/docs/standard-library/basic-ostringstream-class.md index 78e7b21fb5e..408145a58a9 100644 --- a/docs/standard-library/basic-ostringstream-class.md +++ b/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` | `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` | `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 )`. ## basic_ostringstream::rdbuf diff --git a/docs/standard-library/bitset-operators.md b/docs/standard-library/bitset-operators.md index bc525ab7163..bab7cc6b244 100644 --- a/docs/standard-library/bitset-operators.md +++ b/docs/standard-library/bitset-operators.md @@ -253,9 +253,9 @@ bitset 2: 0011 bitset 3: 0110 ``` -## operator| +## `operator|` -Performs a bitwise `OR` between two bitsets. +Performs a bitwise OR between two `bitset` objects. ```cpp template diff --git a/docs/standard-library/bitset.md b/docs/standard-library/bitset.md index c984cbdb343..4a0138a9a54 100644 --- a/docs/standard-library/bitset.md +++ b/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|](../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 diff --git a/docs/standard-library/complex-functions.md b/docs/standard-library/complex-functions.md index 657cd555970..82bd7074273 100644 --- a/docs/standard-library/complex-functions.md +++ b/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 (a2 + b2), written |a + bi|. The *norm* of a complex number a + bi is (a2 + b2), 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*2 + *b*2), written \|*a + bi*\|. The *norm* of a complex number *a + bi* is (*a*2 + *b*2). 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*2 *+ b*2*).* 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*2 *+ b*2*),* written *|a + bi|.* - +The *norm* of a complex number *a + bi* is (*a*2 + *b*2). 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*2 + *b*2), written \|*a + bi*\|. ### Example ```cpp diff --git a/docs/standard-library/ctype-base-class.md b/docs/standard-library/ctype-base-class.md index e09adff985c..f42c4ab52c6 100644 --- a/docs/standard-library/ctype-base-class.md +++ b/docs/standard-library/ctype-base-class.md @@ -62,7 +62,7 @@ It defines an enumeration mask. Each enumeration constant characterizes a differ - **graph** (function [isgraph](../standard-library/locale-functions.md#isgraph)) -You can characterize a combination of classifications by ORing these constants. In particular, it is always true that **alnum** == ( **alpha** | **digit**\) and **graph** \=\= \( **alnum** | **punct**). +You can characterize a combination of classifications by a bitwise OR of these constants. In particular, it's always true that **alnum** == ( **alpha** \| **digit** ) and **graph** == ( **alnum** \| **punct** ). ## Requirements diff --git a/docs/standard-library/ctype-class.md b/docs/standard-library/ctype-class.md index 3d1e8a56ab9..3a43c74acff 100644 --- a/docs/standard-library/ctype-class.md +++ b/docs/standard-library/ctype-class.md @@ -160,7 +160,7 @@ The second member function returns an array containing the mask values character ### Remarks -The mask values classifying the attributes of the characters are provided by the class [ctype_base](../standard-library/ctype-base-class.md), from which ctype derives. The first member function can accept expressions for its first parameter referred to as bitmasks and formed from the combination of mask values by the logical bitwise operators (| , & , ^ , ~). +The mask values classifying the attributes of the characters are provided by the class [ctype_base](../standard-library/ctype-base-class.md), from which ctype derives. The first member function can accept expressions for its first parameter referred to as bitmasks and formed from the combination of mask values by the bitwise operators (`|`, `&`, `^`, `~`). ### Example @@ -430,7 +430,7 @@ The second member function returns a pointer to the last character in the range ### Remarks -The mask values classifying the attributes of the characters are provided by the class [ctype_base Class](../standard-library/ctype-base-class.md), from which ctype derives. The first member function can accept expressions for its first parameter referred to as bitmasks and formed from the combination of mask values by the logical bitwise operators (| , & , ^ , ~). +The mask values classifying the attributes of the characters are provided by the class [ctype_base Class](../standard-library/ctype-base-class.md), from which ctype derives. The first member function can accept expressions for its first parameter referred to as bitmasks and formed from the combination of mask values by the bitwise operators (`|`, `&`, `^`, `~`). ### Example diff --git a/docs/standard-library/functional.md b/docs/standard-library/functional.md index 19e84df8d1d..c1ac8dd5bcd 100644 --- a/docs/standard-library/functional.md +++ b/docs/standard-library/functional.md @@ -99,10 +99,10 @@ Every call wrapper has a move constructor and a copy constructor. A *simple call |[bind](../standard-library/functional-functions.md#bind)|Binds arguments to a callable object.| |[bind1st](../standard-library/functional-functions.md#bind1st)|A helper template function that creates an adaptor to convert a binary function object into a unary function object by binding the first argument of the binary function to a specified value.
(Deprecated in C++11, removed in C++17.) | |[bind2nd](../standard-library/functional-functions.md#bind2nd)|A helper template function that creates an adaptor to convert a binary function object into a unary function object by binding the second argument of the binary function to a specified value.
(Deprecated in C++11, removed in C++17.) | -|[bit_and](../standard-library/functional-functions.md#bit_and)|Returns the bitwise logical AND (binary operator&) of the two parameters.| -|[bit_not](../standard-library/functional-functions.md#bit_not)|Returns the bitwise logical complement (operator~) of the parameter.
(Added in C++14.) | -|[bit_or](../standard-library/functional-functions.md#bit_or)|Returns the bitwise logical OR (operator|) of the two parameters.| -|[bit_xor](../standard-library/functional-functions.md#bit_xor)|Returns the bitwise logical XOR (operator^) of the two parameters.| +|[bit_and](../standard-library/functional-functions.md#bit_and)|Returns the bitwise AND (binary `operator&`) of the two parameters.| +|[bit_not](../standard-library/functional-functions.md#bit_not)|Returns the bitwise complement (`operator~`) of the parameter.
(Added in C++14.) | +|[bit_or](../standard-library/functional-functions.md#bit_or)|Returns the bitwise OR (`operator|`) of the two parameters.| +|[bit_xor](../standard-library/functional-functions.md#bit_xor)|Returns the bitwise XOR (`operator^`) of the two parameters.| |[cref](../standard-library/functional-functions.md#cref)|Constructs a const `reference_wrapper` from an argument.| |[invoke](../standard-library/functional-functions.md#invoke)|| |[mem_fn](../standard-library/functional-functions.md#mem_fn)|Generates a simple call wrapper.| diff --git a/docs/standard-library/locale-class.md b/docs/standard-library/locale-class.md index 79d509ca849..dfe25590920 100644 --- a/docs/standard-library/locale-class.md +++ b/docs/standard-library/locale-class.md @@ -202,7 +202,7 @@ Two more useful values are: - `all`, corresponding to the C union of all categories LC_ALL -You can represent an arbitrary group of categories by using `OR` with these constants, as in `monetary` | `time`. +You can represent an arbitrary group of categories by using a bitwise-OR with these constants, as in `monetary | time`. ## locale::classic