r291783 - UsersManual.rst: Update clang-cl options list

Nico Weber via cfe-commits cfe-commits at lists.llvm.org
Thu Jan 12 11:13:07 PST 2017


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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20170112/51c28b04/attachment-0001.html>


More information about the cfe-commits mailing list