<div dir="ltr">Why do we list fdelayed-template-parsing in /? output now? That's on by default with clang-cl.</div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jan 12, 2017 at 1:15 PM, Hans Wennborg via cfe-commits <span dir="ltr"><<a href="mailto:cfe-commits@lists.llvm.org" target="_blank">cfe-commits@lists.llvm.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Author: hans<br>
Date: Thu Jan 12 12:15:06 2017<br>
New Revision: 291783<br>
<br>
URL: <a href="http://llvm.org/viewvc/llvm-project?rev=291783&view=rev" rel="noreferrer" target="_blank">http://llvm.org/viewvc/llvm-<wbr>project?rev=291783&view=rev</a><br>
Log:<br>
UsersManual.rst: Update clang-cl options list<br>
<br>
Modified:<br>
cfe/trunk/docs/UsersManual.rst<br>
<br>
Modified: cfe/trunk/docs/UsersManual.rst<br>
URL: <a href="http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/UsersManual.rst?rev=291783&r1=291782&r2=291783&view=diff" rel="noreferrer" target="_blank">http://llvm.org/viewvc/llvm-<wbr>project/cfe/trunk/docs/<wbr>UsersManual.rst?rev=291783&r1=<wbr>291782&r2=291783&view=diff</a><br>
==============================<wbr>==============================<wbr>==================<br>
--- cfe/trunk/docs/UsersManual.rst (original)<br>
+++ cfe/trunk/docs/UsersManual.rst Thu Jan 12 12:15:06 2017<br>
@@ -2462,7 +2462,7 @@ Clang expects the GCC executable "gcc.ex<br>
clang-cl<br>
========<br>
<br>
-clang-cl is an alternative command-line interface to Clang driver, designed for<br>
+clang-cl is an alternative command-line interface to Clang, designed for<br>
compatibility with the Visual C++ compiler, cl.exe.<br>
<br>
To enable clang-cl to find system headers, libraries, and the linker when run<br>
@@ -2470,7 +2470,7 @@ from the command-line, it should be exec<br>
Command Prompt or a regular Command Prompt where the environment has been set<br>
up using e.g. `vcvars32.bat <<a href="http://msdn.microsoft.com/en-us/library/f2ccy3wt.aspx" rel="noreferrer" target="_blank">http://msdn.microsoft.com/en-<wbr>us/library/f2ccy3wt.aspx</a>>`_.<br>
<br>
-clang-cl can also be used from inside Visual Studio by using an LLVM Platform<br>
+clang-cl can also be used from inside Visual Studio by using an LLVM Platform<br>
Toolset.<br>
<br>
Command-Line Options<br>
@@ -2505,116 +2505,124 @@ Execute ``clang-cl /?`` to see a list of<br>
::<br>
<br>
CL.EXE COMPATIBILITY OPTIONS:<br>
- /? Display available options<br>
- /arch:<value> Set architecture for code generation<br>
- /Brepro- Emit an object file which cannot be reproduced over time<br>
- /Brepro Emit an object file which can be reproduced over time<br>
- /C Don't discard comments when preprocessing<br>
- /c Compile only<br>
- /D <macro[=value]> Define macro<br>
- /EH<value> Exception handling model<br>
- /EP Disable linemarker output and preprocess to stdout<br>
- /E Preprocess to stdout<br>
- /fallback Fall back to cl.exe if clang-cl fails to compile<br>
- /FA Output assembly code file during compilation<br>
- /Fa<file or directory> Output assembly code to this file during compilation (with /FA)<br>
- /Fe<file or directory> Set output executable file or directory (ends in / or \)<br>
- /FI <value> Include file before parsing<br>
- /Fi<file> Set preprocess output file name (with /P)<br>
- /Fo<file or directory> Set output object file, or directory (ends in / or \) (with /c)<br>
+ /? Display available options<br>
+ /arch:<value> Set architecture for code generation<br>
+ /Brepro- Emit an object file which cannot be reproduced over time<br>
+ /Brepro Emit an object file which can be reproduced over time<br>
+ /C Don't discard comments when preprocessing<br>
+ /c Compile only<br>
+ /D <macro[=value]> Define macro<br>
+ /EH<value> Exception handling model<br>
+ /EP Disable linemarker output and preprocess to stdout<br>
+ /execution-charset:<value><br>
+ Runtime encoding, supports only UTF-8<br>
+ /E Preprocess to stdout<br>
+ /fallback Fall back to cl.exe if clang-cl fails to compile<br>
+ /FA Output assembly code file during compilation<br>
+ /Fa<file or directory> Output assembly code to this file during compilation (with /FA)<br>
+ /Fe<file or directory> Set output executable file or directory (ends in / or \)<br>
+ /FI <value> Include file before parsing<br>
+ /Fi<file> Set preprocess output file name (with /P)<br>
+ /Fo<file or directory> Set output object file, or directory (ends in / or \) (with /c)<br>
/fp:except-<br>
/fp:except<br>
/fp:fast<br>
/fp:precise<br>
/fp:strict<br>
- /Fp<filename> Set pch filename (with /Yc and /Yu)<br>
- /GA Assume thread-local variables are defined in the executable<br>
- /Gd Set __cdecl as a default calling convention<br>
- /GF- Disable string pooling<br>
- /GR- Disable emission of RTTI data<br>
- /GR Enable emission of RTTI data<br>
- /Gr Set __fastcall as a default calling convention<br>
- /GS- Disable buffer security check<br>
- /GS Enable buffer security check<br>
- /Gs<value> Set stack probe size<br>
- /Gv Set __vectorcall as a default calling convention<br>
- /Gw- Don't put each data item in its own section<br>
- /Gw Put each data item in its own section<br>
- /GX- Enable exception handling<br>
- /GX Enable exception handling<br>
- /Gy- Don't put each function in its own section<br>
- /Gy Put each function in its own section<br>
- /Gz Set __stdcall as a default calling convention<br>
- /help Display available options<br>
- /imsvc <dir> Add directory to system include search path, as if part of %INCLUDE%<br>
- /I <dir> Add directory to include search path<br>
- /J Make char type unsigned<br>
- /LDd Create debug DLL<br>
- /LD Create DLL<br>
- /link <options> Forward options to the linker<br>
- /MDd Use DLL debug run-time<br>
- /MD Use DLL run-time<br>
- /MTd Use static debug run-time<br>
- /MT Use static run-time<br>
- /Od Disable optimization<br>
- /Oi- Disable use of builtin functions<br>
- /Oi Enable use of builtin functions<br>
- /Os Optimize for size<br>
- /Ot Optimize for speed<br>
- /O<value> Optimization level<br>
- /o <file or directory> Set output file or directory (ends in / or \)<br>
- /P Preprocess to file<br>
- /Qvec- Disable the loop vectorization passes<br>
- /Qvec Enable the loop vectorization passes<br>
- /showIncludes Print info about included files to stderr<br>
- /std:<value> Language standard to compile for<br>
- /TC Treat all source files as C<br>
- /Tc <filename> Specify a C source file<br>
- /TP Treat all source files as C++<br>
- /Tp <filename> Specify a C++ source file<br>
- /U <macro> Undefine macro<br>
- /vd<value> Control vtordisp placement<br>
- /vmb Use a best-case representation method for member pointers<br>
- /vmg Use a most-general representation for member pointers<br>
- /vmm Set the default most-general representation to multiple inheritance<br>
- /vms Set the default most-general representation to single inheritance<br>
- /vmv Set the default most-general representation to virtual inheritance<br>
- /volatile:iso Volatile loads and stores have standard semantics<br>
- /volatile:ms Volatile loads and stores have acquire and release semantics<br>
- /W0 Disable all warnings<br>
- /W1 Enable -Wall<br>
- /W2 Enable -Wall<br>
- /W3 Enable -Wall<br>
- /W4 Enable -Wall and -Wextra<br>
- /Wall Enable -Wall and -Wextra<br>
- /WX- Do not treat warnings as errors<br>
- /WX Treat warnings as errors<br>
- /w Disable all warnings<br>
- /Y- Disable precompiled headers, overrides /Yc and /Yu<br>
- /Yc<filename> Generate a pch file for all code up to and including <filename><br>
- /Yu<filename> Load a pch file and use it instead of all code up to and including <filename><br>
- /Z7 Enable CodeView debug information in object files<br>
- /Zc:sizedDealloc- Disable C++14 sized global deallocation functions<br>
- /Zc:sizedDealloc Enable C++14 sized global deallocation functions<br>
- /Zc:strictStrings Treat string literals as const<br>
- /Zc:threadSafeInit- Disable thread-safe initialization of static variables<br>
- /Zc:threadSafeInit Enable thread-safe initialization of static variables<br>
- /Zc:trigraphs- Disable trigraphs (default)<br>
- /Zc:trigraphs Enable trigraphs<br>
- /Zd Emit debug line number tables only<br>
- /Zi Alias for /Z7. Does not produce PDBs.<br>
- /Zl Don't mention any default libraries in the object file<br>
- /Zp Set the default maximum struct packing alignment to 1<br>
- /Zp<value> Specify the default maximum struct packing alignment<br>
- /Zs Syntax-check only<br>
+ /Fp<filename> Set pch filename (with /Yc and /Yu)<br>
+ /GA Assume thread-local variables are defined in the executable<br>
+ /Gd Set __cdecl as a default calling convention<br>
+ /GF- Disable string pooling<br>
+ /GR- Disable emission of RTTI data<br>
+ /GR Enable emission of RTTI data<br>
+ /Gr Set __fastcall as a default calling convention<br>
+ /GS- Disable buffer security check<br>
+ /GS Enable buffer security check<br>
+ /Gs<value> Set stack probe size<br>
+ /Gv Set __vectorcall as a default calling convention<br>
+ /Gw- Don't put each data item in its own section<br>
+ /Gw Put each data item in its own section<br>
+ /GX- Enable exception handling<br>
+ /GX Enable exception handling<br>
+ /Gy- Don't put each function in its own section<br>
+ /Gy Put each function in its own section<br>
+ /Gz Set __stdcall as a default calling convention<br>
+ /help Display available options<br>
+ /imsvc <dir> Add directory to system include search path, as if part of %INCLUDE%<br>
+ /I <dir> Add directory to include search path<br>
+ /J Make char type unsigned<br>
+ /LDd Create debug DLL<br>
+ /LD Create DLL<br>
+ /link <options> Forward options to the linker<br>
+ /MDd Use DLL debug run-time<br>
+ /MD Use DLL run-time<br>
+ /MTd Use static debug run-time<br>
+ /MT Use static run-time<br>
+ /Od Disable optimization<br>
+ /Oi- Disable use of builtin functions<br>
+ /Oi Enable use of builtin functions<br>
+ /Os Optimize for size<br>
+ /Ot Optimize for speed<br>
+ /O<value> Optimization level<br>
+ /o <file or directory> Set output file or directory (ends in / or \)<br>
+ /P Preprocess to file<br>
+ /Qvec- Disable the loop vectorization passes<br>
+ /Qvec Enable the loop vectorization passes<br>
+ /showIncludes Print info about included files to stderr<br>
+ /source-charset:<value> Source encoding, supports only UTF-8<br>
+ /std:<value> Language standard to compile for<br>
+ /TC Treat all source files as C<br>
+ /Tc <filename> Specify a C source file<br>
+ /TP Treat all source files as C++<br>
+ /Tp <filename> Specify a C++ source file<br>
+ /U <macro> Undefine macro<br>
+ /vd<value> Control vtordisp placement<br>
+ /vmb Use a best-case representation method for member pointers<br>
+ /vmg Use a most-general representation for member pointers<br>
+ /vmm Set the default most-general representation to multiple inheritance<br>
+ /vms Set the default most-general representation to single inheritance<br>
+ /vmv Set the default most-general representation to virtual inheritance<br>
+ /volatile:iso Volatile loads and stores have standard semantics<br>
+ /volatile:ms Volatile loads and stores have acquire and release semantics<br>
+ /W0 Disable all warnings<br>
+ /W1 Enable -Wall<br>
+ /W2 Enable -Wall<br>
+ /W3 Enable -Wall<br>
+ /W4 Enable -Wall and -Wextra<br>
+ /Wall Enable -Wall and -Wextra<br>
+ /WX- Do not treat warnings as errors<br>
+ /WX Treat warnings as errors<br>
+ /w Disable all warnings<br>
+ /Y- Disable precompiled headers, overrides /Yc and /Yu<br>
+ /Yc<filename> Generate a pch file for all code up to and including <filename><br>
+ /Yu<filename> Load a pch file and use it instead of all code up to and including <filename><br>
+ /Z7 Enable CodeView debug information in object files<br>
+ /Zc:sizedDealloc- Disable C++14 sized global deallocation functions<br>
+ /Zc:sizedDealloc Enable C++14 sized global deallocation functions<br>
+ /Zc:strictStrings Treat string literals as const<br>
+ /Zc:threadSafeInit- Disable thread-safe initialization of static variables<br>
+ /Zc:threadSafeInit Enable thread-safe initialization of static variables<br>
+ /Zc:trigraphs- Disable trigraphs (default)<br>
+ /Zc:trigraphs Enable trigraphs<br>
+ /Zd Emit debug line number tables only<br>
+ /Zi Alias for /Z7. Does not produce PDBs.<br>
+ /Zl Don't mention any default libraries in the object file<br>
+ /Zp Set the default maximum struct packing alignment to 1<br>
+ /Zp<value> Specify the default maximum struct packing alignment<br>
+ /Zs Syntax-check only<br>
<br>
OPTIONS:<br>
-### Print (but do not run) the commands to run for this compilation<br>
--analyze Run the static analyzer<br>
-fansi-escape-codes Use ANSI escape codes for diagnostics<br>
-fcolor-diagnostics Use colors in diagnostics<br>
+ -fdelayed-template-parsing<br>
+ Parse templated function definitions at the end of the translation unit<br>
+ -fdiagnostics-absolute-paths<br>
+ Print absolute paths in diagnostics<br>
-fdiagnostics-parseable-fixits<br>
Print fix-its in machine parseable form<br>
+ -flto Enable LTO in 'full' mode<br>
-fms-compatibility-version=<<wbr>value><br>
Dot-separated value representing the Microsoft compiler version<br>
number to report in _MSC_VER (0 = don't define it (default))<br>
@@ -2628,6 +2636,15 @@ Execute ``clang-cl /?`` to see a list of<br>
Disable recovery for specified sanitizers<br>
-fno-sanitize-trap=<value><br>
Disable trapping for specified sanitizers<br>
+ -fno-standalone-debug Limit debug information produced to reduce size of debug binary<br>
+ -fprofile-instr-generate=<<wbr>file><br>
+ Generate instrumented code to collect execution counts into <file><br>
+ (overridden by LLVM_PROFILE_FILE env var)<br>
+ -fprofile-instr-generate<br>
+ Generate instrumented code to collect execution counts into default.profraw file<br>
+ (overriden by '=' form of option or LLVM_PROFILE_FILE env var)<br>
+ -fprofile-instr-use=<value><br>
+ Use instrumentation data for profile-guided optimization<br>
-fsanitize-blacklist=<value><br>
Path to blacklist file for sanitizers<br>
-fsanitize-coverage=<value><br>
@@ -2637,6 +2654,7 @@ Execute ``clang-cl /?`` to see a list of<br>
-fsanitize-trap=<value> Enable trapping for specified sanitizers<br>
-fsanitize=<check> Turn on runtime checks for various forms of undefined or suspicious<br>
behavior. See user manual for available checks<br>
+ -fstandalone-debug Emit full debug info for all types used by the program<br>
-gcodeview Generate CodeView debug information<br>
-gline-tables-only Emit debug line number tables only<br>
-miamcu Use Intel MCU ABI<br>
<br>
<br>
______________________________<wbr>_________________<br>
cfe-commits mailing list<br>
<a href="mailto:cfe-commits@lists.llvm.org">cfe-commits@lists.llvm.org</a><br>
<a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/<wbr>mailman/listinfo/cfe-commits</a><br>
</blockquote></div><br></div>