r291783 - UsersManual.rst: Update clang-cl options list
Hans Wennborg via cfe-commits
cfe-commits at lists.llvm.org
Thu Jan 12 11:38:17 PST 2017
Addressing this in r291798.
On Thu, Jan 12, 2017 at 11:18 AM, Nico Weber via cfe-commits
<cfe-commits at lists.llvm.org> wrote:
> Also, it looks like the main change is that this now lists
> /execution-charset: and /source-charset:. It doesn't list /utf-8 though
> (since that's just a CLIgnoredFlag behind the scenes I guess). It's a bit
> weird to list the two -charset flags (which just check that their arg is
> utf-8 and error out if not) but not /utf-8. Is there some way to either list
> all 3 or none of them?
>
> On Thu, Jan 12, 2017 at 2:13 PM, Nico Weber <thakis at chromium.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