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