Draft of changes for Ox name

Author: Colin Robertson

docs/build/reference/TOC.md

@@ -90,7 +90,7 @@
 ##### [-Og (Global Optimizations)](og-global-optimizations.md)
 ##### [-Oi (Generate Intrinsic Functions)](oi-generate-intrinsic-functions.md)
 ##### [-Os, -Ot (Favor Small Code, Favor Fast Code)](os-ot-favor-small-code-favor-fast-code.md)
-##### [-Ox (Full Optimization)](ox-full-optimization.md)
+##### [-Ox (Enable Most Speed Optimizations)](ox-full-optimization.md)
 ##### [-Oy (Frame-Pointer Omission)](oy-frame-pointer-omission.md)
 #### [-openmp (Enable OpenMP 2.0 Support)](openmp-enable-openmp-2-0-support.md)
 #### [-P (Preprocess to a File)](p-preprocess-to-a-file.md)

docs/build/reference/o1-o2-minimize-size-maximize-speed.md

@@ -1,7 +1,7 @@
 ---
 title: "-O1, -O2 (Minimize Size, Maximize Speed) | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "09/22/2017"
 ms.reviewer: ""
 ms.suite: ""
 ms.technology:  
@@ -29,82 +29,50 @@ caps.latest.revision: 16
 author: "corob-msft"
 ms.author: "corob"
 manager: "ghogen"
-translation.priority.ht: 
-  - "cs-cz"
-  - "de-de"
-  - "es-es"
-  - "fr-fr"
-  - "it-it"
-  - "ja-jp"
-  - "ko-kr"
-  - "pl-pl"
-  - "pt-br"
-  - "ru-ru"
-  - "tr-tr"
-  - "zh-cn"
-  - "zh-tw"
 ---
 # /O1, /O2 (Minimize Size, Maximize Speed)
-Selects a predefined set of options that affect the size and speed of files.  
-  
-## Syntax  
-  
-```  
-/O1  
-/O2  
-```  
-  
-## Remarks  
- The following table describes **/O1** and **/O2**.  
-  
-|Option|Equivalent to|Comment|  
+
+Selects a predefined set of options that affect the size and speed of generated code.
+
+## Syntax
+
+> /O1
+> /O2
+
+## Remarks
+
+The following table describes **/O1** and **/O2**.
+
+|Option|Equivalent to|Comment|
 |------------|-------------------|-------------|  
-|**/O1** (Minimize Size)|**/Og /Os /Oy /Ob2 /Gs /GF /Gy**|Creates the smallest code in the majority of cases.|  
-|**/O2** (Maximize Speed)|**/Og /Oi /Ot /Oy /Ob2 /Gs /GF /Gy**|Creates the fastest code in the majority of cases. (default setting for release builds)|  
-  
- **/O1** and **/O2** also enable the Named Return Value optimization, which eliminates the copy constructor and destructor of a stack based return value. Consider the following sample.  The `Test` function will not create the copy constructor or destructor. Add output statements to the constructor, destructor and copy constructor to see the effect of Named Return Value Optimization when you run the program. For more information, see [Named Return Value Optimization in Visual C++ 2005](http://go.microsoft.com/fwlink/?linkid=131571).  
-  
-```  
-// O1_O2_NRVO.cpp  
-// compile with: /O1  
-struct A {  
-   A() {}  
-   ~A() {}  
-   A(const A& aa) {}  
-};  
-  
-A Test() {  
-   A a;  
-   return a;  
-}  
-int main() {  
-   A aa;  
-   aa = Test();  
-}  
-```  
-  
- **x86 Specific**  
-  
- These options imply the use of the Frame-Pointer Omission ([/Oy](../../build/reference/oy-frame-pointer-omission.md)) option.  
-  
- **END x86 Specific**  
-  
-### To set this compiler option in the Visual Studio development environment  
-  
-1.  Open the project's **Property Pages** dialog box. For details, see [Working with Project Properties](../../ide/working-with-project-properties.md).  
-  
-2.  Click the **C/C++** folder.  
-  
-3.  Click the **Optimization** property page.  
-  
-4.  Modify the **Optimization** property.  
-  
-### To set this compiler option programmatically  
-  
--   See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.Optimization%2A>.  
-  
-## See Also  
- [/O Options (Optimize Code)](../../build/reference/o-options-optimize-code.md)   
- [Compiler Options](../../build/reference/compiler-options.md)   
- [Setting Compiler Options](../../build/reference/setting-compiler-options.md)   
- [/EH (Exception Handling Model)](../../build/reference/eh-exception-handling-model.md)
+|**/O1** (Minimize Size)|**/Og /Os /Oy /Ob2 /Gs /GF /Gy**|Creates the smallest code in the majority of cases.|
+|**/O2** (Maximize Speed)|**/Og /Oi /Ot /Oy /Ob2 /Gs /GF /Gy**|Creates the fastest code in the majority of cases. (default setting for release builds)|
+
+**/O1** and **/O2** are mutually exclusive.
+
+> [!NOTE] **x86 Specific**  
+> These options imply the use of the Frame-Pointer Omission ([/Oy](../../build/reference/oy-frame-pointer-omission.md)) option.
+
+### To set this compiler option in the Visual Studio development environment
+
+1. Open the project's **Property Pages** dialog box. For details, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Click the **C/C++** folder.
+
+1. Click the **Optimization** property page.
+
+1. Modify the **Optimization** property.
+
+### To set this compiler option programmatically
+
+- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.Optimization%2A>.
+
+## See Also
+
+[/O Options (Optimize Code)](../../build/reference/o-options-optimize-code.md)
+
+[Compiler Options](../../build/reference/compiler-options.md)
+
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)
+
+[/EH (Exception Handling Model)](../../build/reference/eh-exception-handling-model.md)

docs/build/reference/ob-inline-function-expansion.md

@@ -1,7 +1,7 @@
 ---
 title: "-Ob (Inline Function Expansion) | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "09/22/2017"
 ms.reviewer: ""
 ms.suite: ""
 ms.technology:  
@@ -37,65 +37,55 @@ caps.latest.revision: 13
 author: "corob-msft"
 ms.author: "corob"
 manager: "ghogen"
-translation.priority.ht: 
-  - "cs-cz"
-  - "de-de"
-  - "es-es"
-  - "fr-fr"
-  - "it-it"
-  - "ja-jp"
-  - "ko-kr"
-  - "pl-pl"
-  - "pt-br"
-  - "ru-ru"
-  - "tr-tr"
-  - "zh-cn"
-  - "zh-tw"
 ---
 # /Ob (Inline Function Expansion)
-Controls inline expansion of functions.  
-  
-## Syntax  
-  
-```  
-/Ob{0|1|2}  
-```  
-  
-## Arguments  
- **0**  
- Disables inline expansions. By default, expansion occurs at the compiler's discretion on all functions, often referred to as *auto-inlining*.  
-  
- **1**  
- Allows expansion only of functions marked [inline](../../cpp/inline-functions-cpp.md), `__inline`, or `__forceinline`, or in a C++ member function defined in a class declaration.  
-  
- **2**  
- The default value. Allows expansion of functions marked as `inline`, `__inline`, or `__forceinline`, and any other function that the compiler chooses.  
-  
- **/Ob2** is in effect when [/O1, /O2 (Minimize Size, Maximize Speed)](../../build/reference/o1-o2-minimize-size-maximize-speed.md) or [/Ox (Full Optimization)](../../build/reference/ox-full-optimization.md) is used.  
-  
- This option requires that you enable optimizations using **/O1**, **/O2**, **/Ox**, or **/Og**.  
-  
-## Remarks  
- The compiler treats the inline expansion options and keywords as suggestions. There is no guarantee that any function will be expanded inline. You can disable inline expansions, but you cannot force the compiler to inline a particular function, even when using the `__forceinline` keyword.  
-  
- You can use the `#pragma`[auto_inline](../../preprocessor/auto-inline.md) directive to exclude functions from consideration as candidates for inline expansion. Also see the `#pragma`[intrinsic](../../preprocessor/intrinsic.md) directive.  
-  
+
+Controls inline expansion of functions.
+
+## Syntax
+
+> /Ob{0|1|2}
+
+## Arguments
+
+**0**  
+Disables inline expansions. By default, expansion occurs at the compiler's discretion on all functions, often referred to as *auto-inlining*.
+
+**1**  
+Allows expansion only of functions marked [inline](../../cpp/inline-functions-cpp.md), `__inline`, or `__forceinline`, or in a C++ member function defined in a class declaration.
+
+**2**  
+The default value. Allows expansion of functions marked as `inline`, `__inline`, or `__forceinline`, and any other function that the compiler chooses.
+
+**/Ob2** is in effect when [/O1, /O2 (Minimize Size, Maximize Speed)](../../build/reference/o1-o2-minimize-size-maximize-speed.md) or [/Ox (Enable Most Speed Optimizations)](../../build/reference/ox-full-optimization.md) is used.
+
+This option requires that you enable optimizations using **/O1**, **/O2**, **/Ox**, or **/Og**.  
+
+## Remarks
+
+The compiler treats the inline expansion options and keywords as suggestions. There is no guarantee that any function will be expanded inline. You can disable inline expansions, but you cannot force the compiler to inline a particular function, even when using the `__forceinline` keyword.
+
+You can use the `#pragma`[auto_inline](../../preprocessor/auto-inline.md) directive to exclude functions from consideration as candidates for inline expansion. Also see the `#pragma`[intrinsic](../../preprocessor/intrinsic.md) directive.
+
 > [!NOTE]
->  Information that is gathered from profiling test runs overrides optimizations that would otherwise be in effect if you specify **/Ob**, **/Os**, or **/Ot**. For more information, see [Profile-Guided Optimizations](../../build/reference/profile-guided-optimizations.md).  
-  
-### To set this compiler option in the Visual Studio development environment  
-  
-1.  Open the project's **Property Pages** dialog box. For details, see [Working with Project Properties](../../ide/working-with-project-properties.md).  
-  
-2.  Expand **Configuration Properties**, **C/C++**, and select **Optimization**.  
-  
-3.  Modify the **Inline Function Expansion** property.  
-  
-### To set this compiler option programmatically  
-  
--   See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.InlineFunctionExpansion%2A>.  
-  
-## See Also  
- [/O Options (Optimize Code)](../../build/reference/o-options-optimize-code.md)   
- [Compiler Options](../../build/reference/compiler-options.md)   
- [Setting Compiler Options](../../build/reference/setting-compiler-options.md)
+> Information that is gathered from profiling test runs overrides optimizations that would otherwise be in effect if you specify **/Ob**, **/Os**, or **/Ot**. For more information, see [Profile-Guided Optimizations](../../build/reference/profile-guided-optimizations.md).
+
+### To set this compiler option in the Visual Studio development environment
+
+1. Open the project's **Property Pages** dialog box. For details, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Expand **Configuration Properties**, **C/C++**, and select **Optimization**.
+
+1. Modify the **Inline Function Expansion** property.
+
+### To set this compiler option programmatically
+
+- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.InlineFunctionExpansion%2A>.
+
+## See Also
+
+[/O Options (Optimize Code)](../../build/reference/o-options-optimize-code.md)
+
+[Compiler Options](../../build/reference/compiler-options.md)
+
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)