Acrolinx and content updates

colin-home · colin-home · commit 2dacb22f49f6 · 2022-11-17T15:05:59.000-08:00
diff --git a/docs/build/reference/headername.md b/docs/build/reference/headername.md
@@ -23,30 +23,32 @@ The name of a header file that the compiler should compile into a header unit (*
 
 ## Remarks
 
-The **`/headerName`** compiler option is available starting in Visual Studio 2019 version 16.10.
+The **`/headerName:quote`** and **`/headerName:angle`** compiler options are available starting in Visual Studio 2019 version 16.10.
 
-The **`/headerName`** compiler option, in all its forms, requires the [`/std:c++20`](std-specify-language-standard-version.md) or later compiler option (such as **`/std:c++latest`**).\
-If you specify **`/headerName:{quote,angle}`**, you must also specify [`/exportHeader`](module-exportheader.md).
+The **`/headerName`** compiler options, in all their forms, require the [`/std:c++20`](std-specify-language-standard-version.md) or later compiler option (such as **`/std:c++latest`**).\
+If you specify a **`/headerName`** option, you must also specify [`/exportHeader`](module-exportheader.md).
 
-**`/headerName:quote`** looks up *`header-filename`* using the same rules as `#include "header-name"` and builds it as a header unit (*`.ifc`* file).\
-**`/headerName:angle`** looks up *`header-filename`* using the same rules as `#include <header-name>` and builds it as a header unit (*`.ifc`* file).
+- **`/headerName:quote`** looks up *`header-filename`* using the same rules as `#include "header-filename"` and builds it as a header unit (*`.ifc`* file).
+- **`/headerName:angle`** looks up *`header-filename`* using the same rules as `#include <header-filename>` and builds it as a header unit (*`.ifc`* file).
+
+For more information about the path searching rules for included files in quotes or angle brackets, see [`#include` directive](../../preprocessor/hash-include-directive-c-cpp.md).
 
 ### Examples
 
-Given a project that references a header file it defines called `m.h`, the compiler option to compile it into a header unit looks similar to this:
+Given a project that references a header file it defines called *`m.h`*, the compiler option to compile it into a header unit looks similar to this example:
 
-```Bash
+```bash
 cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj
 ```
 
-The `/headerName:{quote,angle}` option acts like a flag and doesn't need an argument. The following examples are valid:
+The **`/headerName:quote`** and **`/headerName:angle`** options act like a flag and don't need an argument. The following examples are valid:
 
-```Bash
+```bash
 cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
 cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h
 ```
 
-You can specify multiple `/headerName` options on the same command line, and every argument after that option will be processed with the specified *`header-filename`* lookup rules. The following example processes all the headers as the previous two command line examples in the same way. It looks up the headers using the lookup rules applied as if they had been specified as: `#include <vector>`, `#include "my-utilties.h"`, and `#include "a/b/my-core.h"`:
+You can specify multiple **`/headerName`** options on the same command line. Every argument after a **`/headerName`** option is processed with the specified include file lookup rules for quotes or angle brackets until the next **`/headerName`** option. The following example processes all the headers as the previous two command line examples in the same way as before. It looks up the headers using the lookup rules applied as if they had been specified as: `#include <vector>`, `#include <iostream>`, `#include <algorithm>`, `#include "my-utilties.h"`, and `#include "a/b/my-core.h"`:
 
 ```bash
 cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h
@@ -55,15 +57,15 @@ cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algo
 ### To set this compiler option in the Visual Studio development environment
 
 > [!NOTE]
-> Users don't typically set this command line option. It's set by the build system.
+> You normally shouldn't set this option in the Visual Studio development environment. It's set by the build system.
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
 
 1. Set the **Configuration** drop-down to **All Configurations**. Set the **Platform** drop-down to **All Platforms**.
 
 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page.
 
-1. Modify the **Additional Options** property to add the *`/headerName`* options and arguments. Then, choose **OK** or **Apply** to save your changes.
+1. Modify the **Additional Options** property to add the *`/headerName:quote`* or *`/headerName:angle`* options and the header filenames the options apply to. Then, choose **OK** or **Apply** to save your changes.
 
 ## See also
 
diff --git a/docs/build/reference/interface.md b/docs/build/reference/interface.md
@@ -34,7 +34,7 @@ This switch must be used in with the [`/TP` (Specify source file type)](tc-tp-tc
 
 ### To set this compiler option in the Visual Studio development environment
 
-You normally shouldn't set this in the Visual Studio development environment unless you use a different extension for your module interface files. By default, the build system applies this option to files that have a *`.ixx`** extension.
+You normally shouldn't set this option in the Visual Studio development environment unless you use a different extension for your module interface files. By default, the build system applies this option to files that have a *`.ixx`** extension.
 
 1. To apply the **`/interface`** option to a file explicitly in the IDE, select the file in **Solution Explorer**. Right-click to open the context menu and select **Properties** to open the Property Pages dialog.
 
diff --git a/docs/build/reference/internal-partition.md b/docs/build/reference/internal-partition.md
@@ -52,7 +52,7 @@ This option can't be used with the [`/interface`](interface.md) compiler option.
 
 ### To set this compiler option in the Visual Studio development environment
 
-You normally shouldn't set this in the Visual Studio development environment unless you use a different extension for your partition files. By default, the build system applies this option to files that have a *`.ixx`** extension.
+You normally shouldn't set this option in the Visual Studio development environment unless you use a different extension for your partition files. By default, the build system applies this option to files that have a *`.ixx`** extension.
 
 1. To apply the **`/internalPartition`** option to a file explicitly in the IDE, select the file in **Solution Explorer**. Right-click to open the context menu and select **Properties** to open the Property Pages dialog.
 
diff --git a/docs/build/reference/module-exportheader.md b/docs/build/reference/module-exportheader.md
@@ -53,7 +53,7 @@ cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h
 
 ### To set this compiler option in the Visual Studio development environment
 
-You normally shouldn't set this in the Visual Studio development environment. It is set by the build system.
+You normally shouldn't set this option in the Visual Studio development environment unless you use a different extension for your header files. By default, the build system applies this option to compiled files that have a *`.h`* extension, or no extension.
 
 1. To apply the **`/exportHeader`** option to a file explicitly in the IDE, select the file in **Solution Explorer**. Right-click to open the context menu and select **Properties** to open the Property Pages dialog.
 
@@ -65,7 +65,7 @@ You normally shouldn't set this in the Visual Studio development environment. It
 
 ## See also
 
-[`/headerName (Build a header unit from the specified header)`](headername.md)\
+[`/headerName` (Build a header unit from the specified header)](headername.md)\
 [`/headerUnit` (Use header unit IFC)](headerunit.md)\
 [`/reference` (Use named module IFC)](module-reference.md)\
 [`/translateInclude` (Translate include directives into import directives)](translateinclude.md)
