Merge pull request MicrosoftDocs#116 from Microsoft/cr-build-error

Add missing /Zc option topics

Author: ghogen

docs/build/reference/fa-fa-listing-file.md

@@ -1,5 +1,5 @@
 ---
-title: "-FA, -Fa (Listing File) | Microsoft Docs"
+title: "/FA, /Fa (Listing File) | Microsoft Docs"
 ms.custom: ""
 ms.date: "11/04/2016"
 ms.reviewer: ""
@@ -45,54 +45,68 @@ translation.priority.ht:
   - "zh-tw"
 ---
 # /FA, /Fa (Listing File)
-Creates a listing file containing assembly code.  
+Creates a listing file containing assembler code.  
 
 ## Syntax  
 
-```  
-/FA[c|s|u]  
-/Fapathname  
-```  
+`/FA`[`c`\][`s`\][`u`]  
+`/Fa`_pathname_  
 
 ## Remarks  
- The arguments control the generation of source code and machine code and the extension of the listing file.  
+The `/FA` compiler option generates an assembler listing file for each translation unit in the compilation, which generally corresponds to a C or C++ source file. By default, only assembler is included in the listing file, which is encoded as ANSI. The optional `c`, `s`, and `u` arguments to `/FA` control whether machine code or source code are output together with the assembler listing, and whether the listing is encoded as UTF-8.  
+  
+By default, each listing file gets the same base name as the source file, and has a .asm extension. When machine code is included by using the `c` option, the listing file has a .cod extension. You can change the name and extension of the listing file and the directory where it is created by using the `/Fa` option.  
+
+### /FA arguments  
+none  
+Only assembler language is included in the listing.  
+  
+`c`  
+Optional. Includes machine code in the listing.  
+  
+`s`  
+Optional. Includes source code in the listing.  
+  
+`u`
+Optional. Encodes the listing file in UTF-8 format, and includes a byte order marker. By default, the file is encoded as ANSI. Use `u` to create a listing file that displays correctly on any system, or if you are using Unicode source code files as input to the compiler.  
+  
+If both `s` and `u` are specified, and if a source code file uses a Unicode encoding other than UTF-8, then the code lines in the .asm file may not display correctly.  
+  
+### /Fa argument  
+none  
+One *source*.asm file is created for each source code file in the compilation.  
+  
+*filename*
+A listing file named *filename*.asm is placed in the current directory. This is only valid when compiling a single source code file.  
 
- The following table describes the various values to **/FA**. It is possible to specify more than one value to **/FA**. For example, you can specify **/FAsu**.  
+*filename.extension*  
+A listing file named *filename.extension* is placed in the current directory. This is only valid when compiling a single source code file.  
 
-|Option|Listing contents and file extension|  
-|------------|-----------------------------------------|  
-|**/FA**|Assembly code; .asm|  
-|**/FAc**|Machine and assembly code; .cod|  
-|**/FAs**|Source and assembly code; .asm<br /><br /> If **/FAcs** is specified, the file extension will be .cod|  
-|**/FAu**|Causes the output file to be created in UTF-8 format, with a byte order marker. By default, the file encoding is ANSI, but use **/FAu** if you want a listing file that displays correctly on any system, or if you are using Unicode source code files as input to the compiler.<br /><br /> If **/FAsu** is specified, and if a source code file uses Unicode encoding other than UTF-8, then the code lines in the .asm file may not display correctly.|  
+*directory*\  
+One *source_file*.asm file is created and placed in the specified *directory* for each source code file in the compilation. Note the required trailing backslash. Only paths on the current disk are allowed.  
 
- By default, the listing file gets the same base name as the source file. You can change the name of the listing file and the directory where it is created using the **/Fa** option.  
+*directory*\\*filename*
+A listing file named *filename*.asm is placed in the specified *directory*. This is only valid when compiling a single source code file.  
 
-|/Fa usage|Result|  
-|----------------|------------|  
-|**/Fa**|One *source_file*.asm is created for each source code file in the compilation.|  
-|**/Fa** *filename*|*filename*.asm is placed in the current directory. Only valid when compiling a single source code file.|  
-|**/Fa** *filename.extension*|*filename.extension* is placed in the current directory. Only valid when compiling a single source code file.|  
-|**/Fa** *directory*\|One *source_file*.asm is created and placed in the specified *directory* for each source code file in the compilation. Note the required trailing backslash. Only paths on the current disk are allowed.|  
-|**/Fa** *directory*\\*filename*|*filename*.asm is placed in the specified `directory`. Only valid when compiling a single source code file.|  
-|**/Fa** *directory*\\*filename.extension*|*filename.extension* is placed in the specified `directory`. Only valid when compiling a single source code file.|  
+*directory*\\*filename.extension*  
+A listing file named *filename.extension* is placed in the specified *directory*. This is only valid when compiling a single source code file.  
 
 ### To set this compiler option in the Visual Studio development environment  
 
-1.  Open the project's **Property Pages** dialog box. For details, see [Setting Visual C++ Project Properties](../../ide/working-with-project-properties.md).  
+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.  
+2.  Open the **C/C++** folder and select the **Output Files** property page.  
 
-3.  Click the **Output Files** property page.  
+3.  Modify the **Assembler Output** property to set the `/FAc` and `/FAs` options for assembler, machine, and source code. Modify the **Use Unicode For Assembler Listing** property to set the `/FAu` option for ANSI or UTF-8 output. Modify the **ASM List Location** to set the `/Fa` option for listing file name and location.  
 
-4.  Modify the **ASM List Location** (**/Fa**) or **Assembler Output** (**/FA**) property (**/FAu** must be specified in the **Command Line** property page, **Additional Options** box..  
+Note that setting both **Assembler Output** and **Use Unicode For Assembler Listing** properties can cause [Command-Line Warning D9025](../../error-messages/tool-errors/command-line-warning-d9025.md). To combine these options in the IDE, use the **Additional Options** field in the **Command Line** property page instead.  
 
 ### To set this compiler option programmatically  
 
--   See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AssemblerListingLocation%2A> or <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AssemblerOutput%2A>. To specify **/FAu**, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AdditionalOptions%2A>.  
+-   See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AssemblerListingLocation%2A> or <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AssemblerOutput%2A>. To specify `/FAu`, see <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AdditionalOptions%2A>.  
 
 ## Example  
- The following command line produces a combined source and machine-code listing called HELLO.cod:  
+The following command line produces a combined source and machine-code listing called HELLO.cod:  
 
 ```  
 CL /FAcs HELLO.CPP  

docs/build/reference/zc-conformance.md

@@ -38,26 +38,35 @@ translation.priority.ht:
   - "zh-tw"
 ---
 # /Zc (Conformance)
-You can use the **/Zc** compiler option to specify standard or Microsoft-specific compiler behavior. Here are the **/Zc** compiler options:  
+You can use the **/Zc** compiler options to specify standard or Microsoft-specific compiler behavior.  
 
--   [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md)  
+## Syntax  
 
--   [/Zc:wchar_t](../../build/reference/zc-wchar-t-wchar-t-is-native-type.md)  
+`/Zc:`_option_{,_option_}  
 
--   [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md)  
+## Remarks  
 
--   [/Zc:trigraphs](../../build/reference/zc-trigraphs-trigraphs-substitution.md)  
+When Visual Studio has implemented an extension to C or C++ that is not compatible with the standard, you can use a `/Zc` conformance option to specify standard-conforming or Microsoft-specific behavior. For some options, the Microsoft-specific behavior is the default, to prevent large-scale breaking changes to existing code. In other cases, the default is the standard behavior, where improvements in security, performance, or compatibility outweigh the costs of breaking changes. The default setting of each conformance option may change in newer versions of Visual Studio. For more information about each conformance option, see the topic for the specific option.  
 
--   [/Zc:rvalueCast](../../build/reference/zc-rvaluecast-enforce-type-conversion-rules.md)  
+These are the `/Zc` compiler options:  
 
--   [/Zc:strictStrings](../../build/reference/zc-strictstrings-disable-string-literal-type-conversion.md)  
+|Option|Behavior|
+|---|---|
+|[auto\[-\]](zc-auto-deduce-variable-type.md)|Enforce the new Standard C++ meaning for `auto` (on by default).|  
+|[forScope\[-\]](zc-forscope-force-conformance-in-for-loop-scope.md)|Enforce Standard C++ `for` scoping rules (on by default).|  
+|[implicitNoexcept\[-\]](zc-implicitnoexcept-implicit-exception-specifiers.md)|Enable implicit `noexcept` on required functions (on by default).|  
+|[inline\[-\]](zc-inline-remove-unreferenced-comdat.md)|Remove unreferenced function or data if it is COMDAT or has internal linkage only (off by default).|
+|[referenceBinding\[-\]](zc-referencebinding-enforce-reference-binding-rules.md)|A UDT temporary will not bind to an non-const lvalue reference (off by default).|
+|[rvalueCast\[-\]](zc-rvaluecast-enforce-type-conversion-rules.md)|Enforce Standard C++ explicit type conversion rules (on by default).|  
+|[sizedDealloc\[-\]](zc-sizeddealloc-enable-global-sized-dealloc-functions.md)|Enable C++14 global sized deallocation functions (on by default).|
+|[strictStrings\[-\]](zc-strictstrings-disable-string-literal-type-conversion.md)|Disable string-literal to `char*` or `wchar_t*` conversion (off by default).|  
+|[threadSafeInit\[-\]](zc-threadsafeinit-thread-safe-local-static-initialization.md)|Enable thread-safe local static initialization (on by default).|
+|[throwingNew\[-\]](zc-throwingnew-assume-operator-new-throws.md)|Assume `operator new` throws on failure (off by default).|
+|[trigraphs\[-\]](zc-trigraphs-trigraphs-substitution.md)|Enable trigraphs (obsolete, off by default).|  
+|[wchar_t\[-\]](zc-wchar-t-wchar-t-is-native-type.md)|`wchar_t` is a native type, not a typedef (on by default).|  
 
--   [/Zc:inline](../../build/reference/zc-inline-remove-unreferenced-comdat.md)  
-  
--   [/Zc:implicitNoexcept](../../build/reference/zc-implicitnoexcept-implicit-exception-specifiers.md)  
-  
- For more information about conformance issues in Visual C++, see [Nonstandard Behavior](../../cpp/nonstandard-behavior.md).  
+For more information about conformance issues in Visual C++, see [Nonstandard Behavior](../../cpp/nonstandard-behavior.md).  
 
 ## See Also  
- [Compiler Options](../../build/reference/compiler-options.md)   
- [Setting Compiler Options](../../build/reference/setting-compiler-options.md)
+ [Compiler Options](compiler-options.md)   
+ [Setting Compiler Options](setting-compiler-options.md)

docs/build/reference/zc-referencebinding-enforce-reference-binding-rules.md

@@ -0,0 +1,91 @@
+---
+title: "/Zc:referenceBinding (Enforce reference binding rules) | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/13/2016"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "devlang-cpp"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "referenceBinding"
+  - "/Zc:referenceBinding"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "-Zc compiler options (C++)"
+  - "referenceBinding"
+  - "Enforce reference binding rules"
+  - "/Zc compiler options (C++)"
+  - "Zc compiler options (C++)"
+ms.assetid: 0c6cfaac-9c2a-41a3-aa94-64ca8ef261fc
+caps.latest.revision: 1
+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"
+---
+# /Zc:referenceBinding (Enforce reference binding rules)
+When the **/Zc:referenceBinding** option is specified, the compiler does not allow a non-const lvalue reference to bind to a temporary.  
+  
+## Syntax  
+  
+```  
+/Zc:referenceBinding[-]  
+```  
+  
+## Remarks  
+If **/Zc:referenceBinding** is specified, the compiler follows section 8.5.3 of the C++11 standard and does not allow expressions that bind a user-defined type temporary to a non-const lvalue reference. By default, or if **/Zc:referenceBinding-** is specified, the compiler allows such expressions as a Microsoft extension, but a level 4 warning is issued. For code security, portability and conformance, we recommend that you use **/Zc:referenceBinding**. The [/permissive-](permissive-standards-conformance.md) compiler option implicitly sets this option, but it can be overridden by using **/Zc:referenceBinding-**.  
+  
+## Example  
+  
+This sample shows the Microsoft extension that allows a temporary of a user-defined type to be bound to a non-const lvalue reference.
+```cpp  
+// zcreferencebinding.cpp
+struct S {
+};
+
+void f(S&) {
+}
+
+S g() {
+    return S{};
+}
+
+void main() {
+    S& s = g();         // warning C4239 at /W4
+    const S& cs = g();  // okay, bound to const ref
+    f(g());             // Extension: error C2664 only if /Zc:referenceBinding
+}
+```  
+  
+For more information about conformance issues in Visual C++, see [Nonstandard Behavior](../../cpp/nonstandard-behavior.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.  Select the **C/C++** folder.  
+  
+3.  Select the **Command Line** property page.  
+  
+4.  Modify the **Additional Options** property to include **/Zc:referenceBinding** and then choose **OK**.  
+  
+## See Also  
+[Compiler Options](../../build/reference/compiler-options.md)   
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)   
+[/Zc (Conformance)](../../build/reference/zc-conformance.md)

docs/build/reference/zc-sizeddealloc-enable-global-sized-dealloc-functions.md

@@ -0,0 +1,67 @@
+---
+title: "/Zc:sizedDealloc (Enable Global Sized Deallocation Functions) | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/13/2016"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "devlang-cpp"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "sizedDealloc"
+  - "/Zc:sizedDealloc"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "-Zc compiler options (C++)"
+  - "sizedDealloc"
+  - "Enable Global Sized Deallocation Functions"
+  - "/Zc compiler options (C++)"
+  - "Zc compiler options (C++)"
+ms.assetid: 3a73ace0-4d36-420a-b699-0ca6fc0dd134
+caps.latest.revision: 1
+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"
+---
+# /Zc:sizedDealloc (Enable Global Sized Deallocation Functions)  
+The `/Zc:sizedDealloc` compiler option tells the compiler to preferentially call global `operator delete` or `operator delete[]` functions that have a second parameter of type `size_t` when the size of the object is available. These functions may use the `size_t` parameter to optimize deallocator performance.   
+  
+## Syntax  
+`/Zc:sizedDealloc`[`-`\]  
+  
+## Remarks  
+  
+In the C++11 standard, you may define static member functions `operator delete` and `operator delete[]` that take a second, `size_t` parameter. Typically these are used in combination with [operator new](../../cpp/new-operator-cpp.md) functions to implement more efficient allocators and deallocators for the object. However, C++11 did not define an equivalent set of deallocation functions at global scope. In C++11, global deallocation functions that have a second parameter of type `size_t` are considered placement delete functions. They must be explicitly called by passing a size argument.  
+  
+The C++14 standard changes the behavior of the compiler. When you define global `operator delete` and `operator delete[]` that take a second parameter of type `size_t`, the compiler prefers to call these functions when member scope versions are not invoked and the size of the object is available. The compiler passes the size argument implicitly. The single argument versions are called when the compiler can't determine the size of the object being deallocated. Otherwise, the usual rules for choosing the version of the deallocation function to invoke still apply. Calls to the global functions may be explicitly specified by prepending the scope resolution operator (`::`) to the deallocation function call.  
+  
+By default, Visual C++ starting in Visual Studio 2015 implements this C++14 standard behavior. You may explicitly specify this by setting the `/Zc:sizedDealloc` compiler option. This represents a potentially breaking change. Use the `/Zc:sizedDealloc-` option to preserve the old behavior, for example, when your code defines placement delete operators that use a second parameter of type `size_t`. The default Visual Studio library implementations of the global deallocation functions that have the second parameter of type `size_t` invoke the single parameter versions. If your code supplies only single-parameter global operator delete and operator delete[], the default library implementations of the global sized deallocation functions invoke your global functions.  
+  
+For more information about conformance issues in Visual C++, see [Nonstandard Behavior](../../cpp/nonstandard-behavior.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.	From the **Configurations** drop down menu, choose **All Configurations**.  
+3.	Select the **Configuration Properties**, **C/C++**, **Command Line** property page.  
+4.	Modify the **Additional Options** property to include `/Zc:sizedDealloc` or `/Zc:sizedDealloc-` and then choose **OK**.  
+  
+## See Also  
+[Compiler Options](../../build/reference/compiler-options.md)  
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)  
+[/Zc (Conformance)](../../build/reference/zc-conformance.md)