Acrolinx more things.

Author: Colin Robertson

docs/build/reference/gt-support-fiber-safe-thread-local-storage.md

@@ -18,7 +18,7 @@ Supports fiber safety for data allocated using static thread-local storage, that
 
 Data declared with `__declspec(thread)` is referenced through a thread-local storage (TLS) array. The TLS array is an array of addresses that the system maintains for each thread. Each address in this array gives the location of thread-local storage data.
 
-A fiber is a lightweight object that consists of a stack and a register context and can be scheduled on various threads. A fiber can run on any thread. Because a fiber may get swapped out and restarted later on a different thread, the address of the TLS array must not be cached or optimized as a common subexpression across a function call. **`/GT`** prevents such optimizations.
+A fiber is a lightweight object that consists of a stack and a register context and can be scheduled on various threads. A fiber can run on any thread. Because a fiber may get swapped out and restarted later on a different thread, the compiler mustn't cache the address of the TLS array, or optimize it as a common subexpression across a function call. **`/GT`** prevents such optimizations.
 
 ### To set this compiler option in the Visual Studio development environment
 

docs/build/reference/ltcg-link-time-code-generation.md

@@ -21,13 +21,13 @@ These options are deprecated starting in Visual Studio 2015:
 ### Arguments
 
 **`INCREMENTAL`**<br/>
-(Optional) Specifies that the linker only applies whole program optimization or link-time code generation (LTCG) to the set of files affected by an edit, instead of the entire project. By default, this flag is not set when **`/LTCG`** is specified, and the entire project is linked by using whole program optimization.
+(Optional) Specifies that the linker only applies whole program optimization or link-time code generation (LTCG) to files affected by an edit, instead of the entire project. By default, this flag isn't set when **`/LTCG`** is specified, and the entire project is linked by using whole program optimization.
 
 **`NOSTATUS`** &#124; **`STATUS`**<br/>
-(Optional) Specifies whether the linker displays a progress indicator that shows what percentage of the link is complete. By default, this status information is not displayed.
+(Optional) Specifies whether the linker displays a progress indicator that shows what percentage of the link is complete. By default, this status information isn't displayed.
 
 **`OFF`**<br/>
-(Optional) Disables link-time code generation. This behavior is the same as when **`/LTCG`** is not specified on the command line.
+(Optional) Disables link-time code generation. This behavior is the same as when **`/LTCG`** isn't specified on the command line.
 
 **`PGINSTRUMENT`**<br/>
 (Optional) This option is deprecated starting in Visual Studio 2015. Instead, use **`/LTCG`** and `[/GENPROFILE` or `/FASTGENPROFILE`](genprofile-fastgenprofile-generate-profiling-instrumented-build.md) to generate an instrumented build for profile-guided optimization. The data that is collected from instrumented runs is used to create an optimized image. For more information, see [Profile-Guided Optimizations](../profile-guided-optimizations.md). The short form of this option is **`/LTCG:PGI`**.
@@ -42,7 +42,7 @@ These options are deprecated starting in Visual Studio 2015:
 
 The **`/LTCG`** option tells the linker to call the compiler and perform whole-program optimization. You can also do profile guided optimization. For more information, see [Profile-Guided Optimizations](../profile-guided-optimizations.md).
 
-With the following exceptions, you cannot add linker options to the PGO combination of **`/LTCG`** and **`/USEPROFILE`** that were not specified in the previous PGO initialization combination of **`/LTCG`** and **`/GENPROFILE`** options:
+With the following exceptions, you can't add linker options to the PGO combination of **`/LTCG`** and **`/USEPROFILE`** that weren't specified in the previous PGO initialization combination of **`/LTCG`** and **`/GENPROFILE`** options:
 
 - [`/BASE`](base-base-address.md)
 
@@ -68,17 +68,17 @@ With the following exceptions, you cannot add linker options to the PGO combinat
 
 - [`/VERBOSE`](verbose-print-progress-messages.md)
 
-Any linker options that are specified together with the **`/LTCG`** and **`/GENPROFILE`** options to initialize PGO do not have to be specified when you build by using **`/LTCG`** and **`/USEPROFILE`**; they are implied.
+Any linker options that are specified together with the **`/LTCG`** and **`/GENPROFILE`** options to initialize PGO don't have to be specified when you build by using **`/LTCG`** and **`/USEPROFILE`**; they're implied.
 
-The rest of this article discusses **`/LTCG`** in terms of link-time code generation.
+The rest of this article discusses the link-time code generation done by **`/LTCG`**.
 
 **`/LTCG`** is implied with [`/GL`](gl-whole-program-optimization.md).
 
-The linker invokes link-time code generation if it is passed a module that was compiled by using **`/GL`** or an MSIL module (see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md)). If you do not explicitly specify **`/LTCG`** when you pass **`/GL`** or MSIL modules to the linker, the linker eventually detects this and restarts the link by using **`/LTCG`**. Explicitly specify **`/LTCG`** when you pass **`/GL`** and MSIL modules to the linker for the fastest possible build performance.
+The linker invokes link-time code generation if it's passed a module that was compiled by using **`/GL`** or an MSIL module (see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md)). If you don't explicitly specify **`/LTCG`** when you pass **`/GL`** or MSIL modules to the linker, the linker eventually detects this situation and restarts the link by using **`/LTCG`**. Explicitly specify **`/LTCG`** when you pass **`/GL`** and MSIL modules to the linker for the fastest possible build performance.
 
-For even faster performance, use **`/LTCG:INCREMENTAL`**. This option tells the linker to only re-optimize the set of files that is affected by a source file change, instead of the entire project. This can significantly reduce the link time required. This is not the same option as incremental linking.
+For even faster performance, use **`/LTCG:INCREMENTAL`**. This option tells the linker to reoptimize only the files affected by a source file change, instead of the entire project. This option can significantly reduce the link time required. This option isn't the same option as [incremental linking](incremental-link-incrementally.md).
 
-**`/LTCG`** is not valid for use with [`/INCREMENTAL`](incremental-link-incrementally.md).
+**`/LTCG`** isn't valid for use with [`/INCREMENTAL`](incremental-link-incrementally.md).
 
 When **`/LTCG`** is used to link modules compiled by using [`/Og`](og-global-optimizations.md), [`/O1`](o1-o2-minimize-size-maximize-speed.md), [`/O2`](o1-o2-minimize-size-maximize-speed.md), or [`/Ox`](ox-full-optimization.md), the following optimizations are performed:
 
@@ -99,7 +99,7 @@ When **`/LTCG`** is used to link modules compiled by using [`/Og`](og-global-opt
 
 Using **`/LTCG`** and **`/O2`** causes double-alignment optimization.
 
-If **`/LTCG`** and **`/O1`** are specified, double alignment is not performed. If most of the functions in an application are compiled for speed, with a few functions compiled for size (for example, by using the [`optimize`](../../preprocessor/optimize.md) pragma), the compiler double-aligns the functions that are optimized for size if they call functions that require double alignment.
+If **`/LTCG`** and **`/O1`** are specified, double alignment isn't performed. If most of the functions in an application are compiled for speed, with a few functions compiled for size (for example, by using the [`optimize`](../../preprocessor/optimize.md) pragma), the compiler double-aligns the functions that are optimized for size if they call functions that require double alignment.
 
 If the compiler can identify all of the call sites of a function, the compiler ignores explicit calling-convention modifiers on a function and tries to optimize the function's calling convention:
 
@@ -109,7 +109,7 @@ If the compiler can identify all of the call sites of a function, the compiler i
 
 - remove unused parameters
 
-If a function is called through a function pointer, or if a function is called from outside a module that is compiled by using **`/GL`**, the compiler does not attempt to optimize the function's calling convention.
+If a function is called through a function pointer, or if a function is called from outside a module that is compiled by using **`/GL`**, the compiler doesn't attempt to optimize the function's calling convention.
 
 > [!NOTE]
 > If you use **`/LTCG`** and redefine `mainCRTStartup`, your application can have unpredictable behavior that relates to user code that executes before global objects are initialized. There are three ways to address this issue: do not redefine `mainCRTStartup`, do not compile the file that contains `mainCRTStartup` by using **`/LTCG`**, or initialize global variables and objects statically.
@@ -120,7 +120,7 @@ Modules that are compiled by using [`/GL`](gl-whole-program-optimization.md) and
 
 - **`/LTCG`** can accept native object files, and mixed native/managed object files (compiled by using **`/clr`**). The **`/clr:pure`** and **`/clr:safe`** compiler options are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017 and later.
 
-- **`/LTCG:PGI`** does not accept native modules compiled by using **`/GL`** and **`/clr`**
+- **`/LTCG:PGI`** doesn't accept native modules compiled by using **`/GL`** and **`/clr`**
 
 ### To set this compiler option in the Visual Studio development environment
 

docs/build/reference/o-options-optimize-code.md

@@ -1,12 +1,12 @@
 ---
-title: "/O Options (Optimize Code)"
+title: "/O options (Optimize code)"
 description: "The MSVC /O compiler options specify the compiler optimizations to use."
 ms.date: 07/08/2020
 f1_keywords: ["VC.Project.VCCLCompilerTool.Optimization", "/o", "VC.Project.VCCLWCECompilerTool.Optimization"]
 helpviewer_keywords: ["performance, cle.exe compiler", "cl.exe compiler, performance"]
 ms.assetid: 77997af9-5555-4b3d-aa57-6615b27d4d5d
 ---
-# `/O` Options (Optimize Code)
+# `/O` options (Optimize code)
 
 The **`/O`** options control various optimizations that help you create code for maximum speed or minimum size.
 
@@ -26,13 +26,13 @@ The **`/O`** options control various optimizations that help you create code for
 
 - [`/Ot`](os-ot-favor-small-code-favor-fast-code.md) (a default setting) tells the compiler to favor optimizations for speed over optimizations for size.
 
-- [`/Ox`](ox-full-optimization.md) is a combination option that selects several of the optimizations with an emphasis on speed. It is a strict subset of the **/O2** optimizations.
+- [`/Ox`](ox-full-optimization.md) is a combination option that selects several of the optimizations with an emphasis on speed. **`/Ox`** is a strict subset of the **`/O2`** optimizations.
 
 - [`/Oy`](oy-frame-pointer-omission.md) suppresses the creation of frame pointers on the call stack for quicker function calls.
 
 ## Remarks
 
-You can combine multiple **`/O`** options into a single option statement. For example, **`/Odi`** is the same as **`/Od /Oi`**. Certain options are mutually exclusive and cause a compiler error if used together. See the individual **`/O`** options for more information.
+You can combine multiple **`/O`** options into a single option statement. For example, **`/Odi`** is the same as **`/Od /Oi`**. Certain options are mutually exclusive and cause a compiler error if used together. For more information, see the individual **`/O`** options.
 
 ## See also
 

docs/build/reference/og-global-optimizations.md

@@ -16,13 +16,13 @@ Deprecated. Provides local and global optimizations, automatic-register allocati
 
 ## Remarks
 
-**`/Og`** is deprecated. These optimizations are now generally enabled by default. For more information on optimizations, see [`/O1`, `/O2` (Minimize Size, Maximize Speed)](o1-o2-minimize-size-maximize-speed.md) or [`/Ox` (Enable Most Speed Optimizations)](ox-full-optimization.md).
+**`/Og`** is deprecated. These optimizations are now enabled by default when any optimizations are enabled. For more information on optimizations, see [`/O1`, `/O2` (Minimize Size, Maximize Speed)](o1-o2-minimize-size-maximize-speed.md), or [`/Ox` (Enable Most Speed Optimizations)](ox-full-optimization.md).
 
 The following optimizations are available under **`/Og`**:
 
 - Local and global common subexpression elimination
 
-   In this optimization, the value of a common subexpression is calculated once. In the following example, if the values of `b` and `c` do not change between the three expressions, the compiler can assign the calculation of `b + c` to a temporary variable, and substitute the variable for `b + c`:
+   In this optimization, the value of a common subexpression is calculated once. In the following example, if the values of `b` and `c` don't change between the three expressions, the compiler can assign the calculation of `b + c` to a temporary variable, and use that variable for `b + c`:
 
     ```C
     a = b + c;
@@ -38,7 +38,7 @@ The following optimizations are available under **`/Og`**:
 
 - Loop optimization
 
-   This optimization removes invariant subexpressions from the body of a loop. An optimal loop contains only expressions whose values change through each execution of the loop. In the following example, the expression `x + y` does not change in the loop body:
+   This optimization removes invariant subexpressions from the body of a loop. An optimal loop contains only expressions whose values change through each execution of the loop. In the following example, the expression `x + y` doesn't change in the loop body:
 
     ```C
     i = -100;

docs/build/reference/os-ot-favor-small-code-favor-fast-code.md

@@ -19,7 +19,7 @@ Minimizes or maximizes the size of EXEs and DLLs.
 
 **`/Os`** (Favor Small Code) minimizes the size of EXEs and DLLs by instructing the compiler to favor size over speed. The compiler can reduce many C and C++ constructs to functionally similar sequences of machine code. Occasionally these differences offer tradeoffs of size versus speed. The **`/Os`** and **`/Ot`** options allow you to specify a preference for one over the other:
 
-**`/Ot`** (Favor Fast Code) maximizes the speed of EXEs and DLLs by instructing the compiler to favor speed over size. This is the default when optimizations are enabled. The compiler can reduce many C and C++ constructs to functionally similar sequences of machine code. Occasionally, these differences offer tradeoffs of size versus speed. The **`/Ot`** option is implied by the [`/O2`](o1-o2-minimize-size-maximize-speed.md) (Maximize speed) option. The **`/O2`** option combines several options to produce very fast code.
+**`/Ot`** (Favor Fast Code) maximizes the speed of EXEs and DLLs by instructing the compiler to favor speed over size. **`/Ot`** is the default when optimizations are enabled. The compiler can reduce many C and C++ constructs to functionally similar sequences of machine code. Occasionally, these differences offer tradeoffs of size versus speed. The **`/Ot`** option is implied by the [`/O2`](o1-o2-minimize-size-maximize-speed.md) (Maximize speed) option. The **`/O2`** option combines several options to produce faster code.
 
 > [!NOTE]
 > Information that's gathered from profiling test runs overrides any optimizations that would otherwise be in effect if you specify **`/Ob`**, **`/Os`**, or **`/Ot`**. For more information, see [Profile-Guided Optimizations](../profile-guided-optimizations.md).

docs/build/reference/ox-full-optimization.md

@@ -8,15 +8,15 @@ ms.assetid: 3ad7c30b-c615-428c-b1d0-2e024f81c760
 ---
 # `/Ox` (Enable Most Speed Optimizations)
 
-The **`/Ox`** compiler option enables a combination of optimizations that favor speed. In some versions of the Visual Studio IDE and the compiler help message, this is called *full optimization*, but the **`/Ox`** compiler option enables only a subset of the speed optimization options enabled by **`/O2`**.
+The **`/Ox`** compiler option enables a combination of optimizations that favor speed. In some versions of the Visual Studio IDE and the compiler help message, it's called *full optimization*, but the **`/Ox`** compiler option enables only a subset of the speed optimization options enabled by **`/O2`**.
 
 ## Syntax
 
 > **`/Ox`**
 
 ## Remarks
 
-The **`/Ox`** compiler option enables the **`/O`** compiler options that favor speed. The **`/Ox`** compiler option does not include the additional [`/GF` (Eliminate Duplicate Strings)](gf-eliminate-duplicate-strings.md) and [`/Gy` (Enable Function-Level Linking)](gy-enable-function-level-linking.md) options enabled by [`/O1` or `/O2` (Minimize Size, Maximize Speed)](o1-o2-minimize-size-maximize-speed.md). The additional options applied by **`/O1`** and **`/O2`** can cause pointers to strings or to functions to share a target address, which can affect debugging and strict language conformance. The **`/Ox`** option is an easy way to enable most optimizations without including **`/GF`** and **`/Gy`**. For more information, see the descriptions of the [`/GF`](gf-eliminate-duplicate-strings.md) and [`/Gy`](gy-enable-function-level-linking.md) options.
+The **`/Ox`** compiler option enables the **`/O`** compiler options that favor speed. The **`/Ox`** compiler option doesn't include the additional [`/GF` (Eliminate Duplicate Strings)](gf-eliminate-duplicate-strings.md) and [`/Gy` (Enable Function-Level Linking)](gy-enable-function-level-linking.md) options enabled by [`/O1` or `/O2` (Minimize Size, Maximize Speed)](o1-o2-minimize-size-maximize-speed.md). The additional options applied by **`/O1`** and **`/O2`** can cause pointers to strings or to functions to share a target address, which can affect debugging and strict language conformance. The **`/Ox`** option is an easy way to enable most optimizations without including **`/GF`** and **`/Gy`**. For more information, see the descriptions of the [`/GF`](gf-eliminate-duplicate-strings.md) and [`/Gy`](gy-enable-function-level-linking.md) options.
 
 The **`/Ox`** compiler option is the same as using the following options in combination: