Merge pull request #317 from MicrosoftDocs/master

merge to live

Author: ghogen

docs/build/reference/TOC.md

@@ -19,12 +19,14 @@
 ##### [-arch (x86)](arch-x86.md)
 ##### [-arch (x64)](arch-x64.md)
 ##### [-arch (ARM)](arch-arm.md)
+#### [-await (Enable coroutine support)](await-enable-coroutine-support.md)
 #### [-bigobj (Increase Number of Sections in .Obj file)](bigobj-increase-number-of-sections-in-dot-obj-file.md)
 #### [-C (Preserve Comments During Preprocessing)](c-preserve-comments-during-preprocessing.md)
 #### [-c (Compile Without Linking)](c-compile-without-linking.md)
 #### [-cgthreads (Code Generation Threads)](cgthreads-code-generation-threads.md)
 #### [-clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md)
 ##### [-clr Restrictions](clr-restrictions.md)
+#### [-constexpr (Control constexpr evaluation)](constexpr-control-constexpr-evaluation.md)
 #### [-D (Preprocessor Definitions)](d-preprocessor-definitions.md)
 #### [-diagnostics (Compiler diagnostics options)](diagnostics-compiler-diagnostic-options.md)
 #### [-doc (Process Documentation Comments) (C/C++)](doc-process-documentation-comments-c-cpp.md)

docs/build/reference/await-enable-coroutine-support.md

@@ -0,0 +1,54 @@
+---
+title: "-await (Enable coroutine support) | Microsoft Docs"
+ms.custom: ""
+ms.date: "08/15/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology:  
+  - "cpp-tools"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "/await"
+  - "-await"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "/await enable coroutine support [C++]"
+  - "-await enable coroutine support [C++]"
+  - "await enable coroutine support [C++]"
+ms.assetid: 302c8e69-09b6-4c58-bcdd-0a6a8713a8df
+author: "corob-msft"
+ms.author: "corob"
+manager: "ghogen"
+---
+# /await (Enable coroutine support)  
+  
+Use the **/await** compiler option to enable compiler support for coroutines.  
+  
+## Syntax  
+  
+> /await  
+  
+## Remarks  
+  
+The **/await** compiler option enables compiler support for C++ coroutines and the keywords **co_await**, **co_yield**, and **co_return**. This option is off by default. For information about support for coroutines in Visual Studio, see the [Visual Studio Team Blog](https://blogs.msdn.microsoft.com/vcblog/category/coroutine/). For more information about the coroutines standard proposal, see [N4628 Working Draft, Technical Specification for C++ Extensions for Coroutines](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/n4628.pdf).  
+
+The **/await** option is available beginning in Visual Studio 2015.  
+  
+### To set this compiler option in the Visual Studio development environment  
+  
+1. Open your project's **Property Pages** dialog box.   
+  
+2. Under **Configuration Properties**, expand the **C/C++** folder and choose the **Command Line** property page.  
+  
+3. Enter the **/await** compiler option in the **Additional Options** box. Choose **OK** or **Apply** to save your changes.  
+  
+### To set this compiler option programmatically  
+  
+-   See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AdditionalOptions%2A>.  
+  
+## See Also  
+  
+[Compiler Options](../../build/reference/compiler-options.md)   
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)

docs/build/reference/compiler-options-listed-alphabetically.md

@@ -43,17 +43,21 @@ The following is a comprehensive alphabetical list of compiler options. For a ca
 |[/AI](../../build/reference/ai-specify-metadata-directories.md)|Specifies a directory to search to resolve file references passed to the [#using](../../preprocessor/hash-using-directive-cpp.md) directive.|  
 |[/analyze](../../build/reference/analyze-code-analysis.md)|Enable code analysis.|  
 |[/arch](../../build/reference/arch-minimum-cpu-architecture.md)|Specifies the architecture for code generation.|  
+|[/await](await-enable-coroutine-support.md)|Enable coroutines (resumable functions) extensions.|  
 |[/bigobj](../../build/reference/bigobj-increase-number-of-sections-in-dot-obj-file.md)|Increases the number of addressable sections in an .obj file.|  
 |[/C](../../build/reference/c-preserve-comments-during-preprocessing.md)|Preserves comments during preprocessing.|  
 |[/c](../../build/reference/c-compile-without-linking.md)|Compiles without linking.|  
 |[/cgthreads](../../build/reference/cgthreads-code-generation-threads.md)|Specifies number of cl.exe threads to use for optimization and code generation.|  
 |[/clr](../../build/reference/clr-common-language-runtime-compilation.md)|Produces an output file to run on the common language runtime.|  
+|[/constexpr](constexpr-control-constexpr-evaluation.md)|Control constexpr evaluation at compile-time.|  
 |[/D](../../build/reference/d-preprocessor-definitions.md)|Defines constants and macros.|  
+|[/diagnostics](diagnostics-compiler-diagnostic-options.md)|Controls the format of diagnostic messages.|  
 |[/doc](../../build/reference/doc-process-documentation-comments-c-cpp.md)|Process documentation comments to an XML file.|  
 |[/E](../../build/reference/e-preprocess-to-stdout.md)|Copies preprocessor output to standard output.|  
 |[/EH](../../build/reference/eh-exception-handling-model.md)|Specifies the model of exception handling.|  
 |[/EP](../../build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md)|Copies preprocessor output to standard output.|  
 |[/errorReport](../../build/reference/errorreport-report-internal-compiler-errors.md)|Allows you to provide internal compiler error (ICE) information directly to the Visual C++ team.|  
+|[/execution-charset](execution-charset-set-execution-character-set.md)|Set execution character set.|  
 |[/F](../../build/reference/f-set-stack-size.md)|Sets stack size.|  
 |[/favor](../../build/reference/favor-optimize-for-architecture-specifics.md)|Produces code that is optimized for a specific [!INCLUDE[vcprx64](../../assembler/inline/includes/vcprx64_md.md)] architecture or for the specifics of micro-architectures in both the AMD64 and Extended Memory 64 Technology (EM64T) architectures.|  
 |[/FA](../../build/reference/fa-fa-listing-file.md)|Creates a listing file.|  
@@ -120,6 +124,7 @@ The following is a comprehensive alphabetical list of compiler options. For a ca
 |[/Ox](../../build/reference/ox-full-optimization.md)|Uses maximum optimization (/Ob2gity /Gs).|  
 |[/Oy](../../build/reference/oy-frame-pointer-omission.md)|Omits frame pointer (x86 only).|  
 |[/P](../../build/reference/p-preprocess-to-a-file.md)|Writes preprocessor output to a file.|  
+|[/permissive-](permissive-standards-conformance.md)|Set standard-conformance mode.|  
 |[/Qfast_transcendentals](../../build/reference/qfast-transcendentals-force-fast-transcendentals.md)|Generates fast transcendentals.|  
 |[/QIfist](../../build/reference/qifist-suppress-ftol.md)|Deprecated. Suppresses `_ftol` when a conversion from a floating-point type to an integral type is required (x86 only).|  
 |[/Qimprecise_fwaits](../../build/reference/qimprecise-fwaits-remove-fwaits-inside-try-blocks.md)|Removes `fwait` commands inside `try` blocks.|  
@@ -129,11 +134,17 @@ The following is a comprehensive alphabetical list of compiler options. For a ca
 |[/RTC](../../build/reference/rtc-run-time-error-checks.md)|Enables run-time error checking.|  
 |[/sdl](../../build/reference/sdl-enable-additional-security-checks.md)|Enables additional security features and warnings.|  
 |[/showIncludes](../../build/reference/showincludes-list-include-files.md)|Displays a list of include files during compilation.|  
-|[/Tc](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)<br /><br /> [/TC](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C source file.|  
-|[/Tp](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)<br /><br /> [/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C++ source file.|  
+|[/source-charset](source-charset-set-source-character-set.md)|Set source character set.|  
+|[/std](std-specify-language-standard-version.md)|C++ standard version compatibility selector.|  
+|[/Tc](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C source file.|  
+|[/TC](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies all source files are C.|  
+|[/Tp](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C++ source file.|  
+|[/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies all source files are C++.|  
 |[/U](../../build/reference/u-u-undefine-symbols.md)|Removes a predefined macro.|  
 |[/u](../../build/reference/u-u-undefine-symbols.md)|Removes all predefined macros.|  
+|[/utf-8](utf-8-set-source-and-executable-character-sets-to-utf-8.md)|Set source and execution character sets to UTF-8.|  
 |[/V](../../build/reference/v-version-number.md)|Deprecated. Sets the .obj file version string.|  
+|[/validate-charset](validate-charset-validate-for-compatible-characters.md)|Validate UTF-8 files for only compatible characters.|  
 |[/vd](../../build/reference/vd-disable-construction-displacements.md)|Suppresses or enables hidden vtordisp class members.|  
 |[/vmb](../../build/reference/vmb-vmg-representation-method.md)|Uses best base for pointers to members.|  
 |[/vmg](../../build/reference/vmb-vmg-representation-method.md)|Uses full generality for pointers to members.|  

docs/build/reference/compiler-options-listed-by-category.md

@@ -129,6 +129,7 @@ This article contains a categorical list of compiler options. For an alphabetica
 
 |Option|Purpose|  
 |------------|-------------|  
+|[/constexpr](constexpr-control-constexpr-evaluation.md)|Control constexpr evaluation at compile-time.|  
 |[/openmp](../../build/reference/openmp-enable-openmp-2-0-support.md)|Enables [#pragma omp](../../preprocessor/omp.md) in source code.|  
 |[/vd](../../build/reference/vd-disable-construction-displacements.md)|Suppresses or enables hidden `vtordisp` class members.|  
 |[/vmb](../../build/reference/vmb-vmg-representation-method.md)|Uses best base for pointers to members.|  
@@ -161,15 +162,6 @@ This article contains a categorical list of compiler options. For an alphabetica
 |[/MT](../../build/reference/md-mt-ld-use-run-time-library.md)|Compiles to create a multithreaded executable file, by using LIBCMT.lib.|  
 |[/MTd](../../build/reference/md-mt-ld-use-run-time-library.md)|Compiles to create a debug multithreaded executable file, by using LIBCMTD.lib.|  
 
-### Precompiled Header  
-  
-|Option|Purpose|  
-|------------|-------------|  
-|[/Y-](../../build/reference/y-ignore-precompiled-header-options.md)|Ignores all other precompiled-header compiler options in the current build.|  
-|[/Yc](../../build/reference/yc-create-precompiled-header-file.md)|Creates a precompiled header file.|  
-|[/Yd](../../build/reference/yd-place-debug-information-in-object-file.md)|Places complete debugging information in all object files.|  
-|[/Yu](../../build/reference/yu-use-precompiled-header-file.md)|Uses a precompiled header file during build.|  
-  
 ### Miscellaneous  
 
 |Option|Purpose|  
@@ -191,8 +183,10 @@ This article contains a categorical list of compiler options. For an alphabetica
 |[/nologo](../../build/reference/nologo-suppress-startup-banner-c-cpp.md)|Suppresses display of sign-on banner.|  
 |[/sdl](../../build/reference/sdl-enable-additional-security-checks.md)|Enables additional security features and warnings.|  
 |[/showIncludes](../../build/reference/showincludes-list-include-files.md)|Displays a list of all include files during compilation.|  
-|[/Tc](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) [/TC](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C source file.|  
-|[/Tp](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) [/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C++ source file.|  
+|[/Tc](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C source file.|  
+|[/TC](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies all source files are C.|  
+|[/Tp](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies a C++ source file.|  
+|[/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md)|Specifies all source files are C++.|  
 |[/V](../../build/reference/v-version-number.md)|Deprecated. Sets the version string.|  
 |[/w](../../build/reference/compiler-option-warning-level.md)|Disables all warnings.|  
 |[/W0, /W1, /W2, /W3, /W4](../../build/reference/compiler-option-warning-level.md)|Sets output warning level.|  
@@ -202,12 +196,22 @@ This article contains a categorical list of compiler options. For an alphabetica
 |[/we](../../build/reference/compiler-option-warning-level.md)|Treats the specified warning as an error.|  
 |[/WL](../../build/reference/wl-enable-one-line-diagnostics.md)|Enables one-line diagnostics for error and warning messages when compiling C++ source code from the command line.|  
 |[/wo](../../build/reference/compiler-option-warning-level.md)|Displays the specified warning only once.|  
-|[/Wp64](../../build/reference/wp64-detect-64-bit-portability-issues.md)|Obsolete. Detects 64-bit portability problems.|  
 |[/Wv](../../build/reference/compiler-option-warning-level.md)|Disables warnings introduced by later versions of the compiler.|  
 |[/WX](../../build/reference/compiler-option-warning-level.md)|Treats warnings as errors.|  
+|[/Yc](../../build/reference/yc-create-precompiled-header-file.md)|Create .PCH file.|  
 |[/Yd](../../build/reference/yd-place-debug-information-in-object-file.md)|Deprecated. Places complete debugging information in all object files. Use [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) instead.|  
 |[/Yl](../../build/reference/yl-inject-pch-reference-for-debug-library.md)|Injects a PCH reference when creating a debug library.|  
+|[/Yu](../../build/reference/yu-use-precompiled-header-file.md)|Uses a precompiled header file during build.|  
+|[/Y-](../../build/reference/y-ignore-precompiled-header-options.md)|Ignores all other precompiled-header compiler options in the current build.|  
 |[/Zm](../../build/reference/zm-specify-precompiled-header-memory-allocation-limit.md)|Specifies the precompiled header memory allocation limit.|  
+|[/await](await-enable-coroutine-support.md)|Enable coroutines (resumable functions) extensions.|  
+|[/source-charset](source-charset-set-source-character-set.md)|Set source character set.|
+|[/execution-charset](execution-charset-set-execution-character-set.md)|Set execution character set.|
+|[/utf-8](utf-8-set-source-and-executable-character-sets-to-utf-8.md)|Set source and execution character sets to UTF-8.|
+|[/validate-charset](validate-charset-validate-for-compatible-characters.md)|Validate UTF-8 files for only compatible characters.|
+|[/diagnostics](diagnostics-compiler-diagnostic-options.md)|Controls the format of diagnostic messages.|
+|[/permissive-](permissive-standards-conformance.md)|Set standard-conformance mode.|
+|[/std](std-specify-language-standard-version.md)|C++ standard version compatibility selector.|
 
 ### Deprecated and Removed Compiler Options  
 
@@ -222,6 +226,7 @@ This article contains a categorical list of compiler options. For an alphabetica
 |[/Og](../../build/reference/og-global-optimizations.md)|Deprecated. Uses global optimizations.|  
 |[QIfist](../../build/reference/qifist-suppress-ftol.md)|Deprecated. Once used to specify how to convert from a floating-point type to an integral type.|  
 |[/V](../../build/reference/v-version-number.md)|Deprecated. Sets the .obj file version string.|  
+|[/Wp64](../../build/reference/wp64-detect-64-bit-portability-issues.md)|Obsolete. Detects 64-bit portability problems.|  
 |[/Yd](../../build/reference/yd-place-debug-information-in-object-file.md)|Deprecated. Places complete debugging information in all object files. Use [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) instead.|  
 |[/Zc:forScope-](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md)|Deprecated. Disables conformance in for loop scope.|  
 |[/Ze](../../build/reference/za-ze-disable-language-extensions.md)|Deprecated. Enables language extensions.|  

docs/build/reference/constexpr-control-constexpr-evaluation.md

@@ -0,0 +1,67 @@
+---
+title: "-constexpr (Control constexpr evaluation) | Microsoft Docs"
+ms.custom: ""
+ms.date: "08/15/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology:  
+  - "cpp-tools"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "/constexpr"
+  - "-constexpr"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "/constexpr control constexpr evaluation [C++]"
+  - "-constexpr control constexpr evaluation [C++]"
+  - "constexpr control constexpr evaluation [C++]"
+ms.assetid: 76d56784-f5ad-401d-841d-09d1059e8b8c
+author: "corob-msft"
+ms.author: "corob"
+manager: "ghogen"
+---
+# /constexpr (Control constexpr evaluation)  
+  
+Use the **/constexpr** compiler options to control parameters for `constexpr` evaluation at compile time.  
+  
+## Syntax  
+  
+> /constexpr:depth*N*  
+> /constexpr:backtrace*N*  
+> /constexpr:steps*N*  
+  
+## Arguments  
+  
+**depth***N*  
+Limit the depth of recursive `constexpr` function invocation to *N* levels. The default is 512.  
+  
+**backtrace***N*  
+Show up to *N* `constexpr` evaluations in diagnostics. The default is 10.  
+  
+**steps***N*  
+Terminate `constexpr` evaluation after *N* steps. The default is 100,000.  
+  
+## Remarks  
+  
+The **/constexpr** compiler options control compile-time evaluation of `constexpr` expressions. Evaluation steps, recursion levels, and backtrace depth are controlled to prevent the compiler from spending too much time on `constexpr` evaluation. For more information on the `constexpr` language element, see [constexpr (C++)](../../cpp/constexpr-cpp.md).  
+
+The **/constexpr** options are available beginning in Visual Studio 2015.  
+  
+### To set this compiler option in the Visual Studio development environment  
+  
+1. Open your project's **Property Pages** dialog box.   
+  
+2. Under **Configuration Properties**, expand the **C/C++** folder and choose the **Command Line** property page.  
+  
+3. Enter any **/constexpr** compiler options in the **Additional Options** box. Choose **OK** or **Apply** to save your changes.  
+  
+### To set this compiler option programmatically  
+  
+-   See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AdditionalOptions%2A>.  
+  
+## See Also  
+  
+[Compiler Options](../../build/reference/compiler-options.md)   
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)