Commit 9b748911 authored by Hans Wennborg's avatar Hans Wennborg
Browse files

Merging r214777: 

Excluding the /Zp option, because that was added after the 3.5 branch.

------------------------------------------------------------------------
r214777 | hans | 2014-08-04 14:07:58 -0700 (Mon, 04 Aug 2014) | 1 line

UsersManual: update clang-cl options
------------------------------------------------------------------------

llvm-svn: 214778
parent 5f262c81

clang/docs/UsersManual.rst

+86 −49
Original line number Diff line number Diff line
@@ -1806,18 +1806,29 @@ Execute ``clang-cl /?`` to see a list of supported options: 


  ::



    CL.EXE COMPATIBILITY OPTIONS:

      /?                     Display available options

      /arch:<value>          Set architecture for code generation

      /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

      /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

      /Fo<file or directory> Set output object file, or directory (ends in / or \)

      /GF-                   Disable string pooling

    /GR-                   Disable RTTI

    /GR                    Enable RTTI

      /GR-                   Disable emission of RTTI data

      /GR                    Enable emission of RTTI data

      /Gw-                   Don't put each data item in its own section

      /Gw                    Put each data item in its own section

      /Gy-                   Don't put each function in its own section

      /Gy                    Put each function in its own section

      /help                  Display available options

      /I <dir>               Add directory to include search path

      /J                     Make char type unsigned
@@ -1838,13 +1849,19 @@ Execute ``clang-cl /?`` to see a list of supported options: 
      /Oy-                   Disable frame pointer omission

      /Oy                    Enable frame pointer omission

      /O<n>                  Optimization level

    /P                     Only run the preprocessor

      /P                     Preprocess to file

      /showIncludes          Print info about included files to stderr

      /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

      /W0                    Disable all warnings

      /W1                    Enable -Wall

      /W2                    Enable -Wall
@@ -1854,8 +1871,28 @@ Execute ``clang-cl /?`` to see a list of supported options: 
      /WX-                   Do not treat warnings as errors

      /WX                    Treat warnings as errors

      /w                     Disable all warnings

      /Zi                    Enable debug information

      /Zs                    Syntax-check only



    OPTIONS:

      -###                  Print (but do not run) the commands to run for this compilation

      -fms-compatibility-version=<value>

                            Dot-separated value representing the Microsoft compiler version

                            number to report in _MSC_VER (0 = don't define it (default))

      -fmsc-version=<value> Microsoft compiler version number to report in _MSC_VER (0 = don't

                            define it (default))

      -fsanitize-blacklist=<value>

                            Path to blacklist file for sanitizers

      -fsanitize=<check>    Enable runtime instrumentation for bug detection: address (memory

                            errors) | thread (race detection) | undefined (miscellaneous

                            undefined behavior)

      -mllvm <value>        Additional arguments to forward to LLVM's option processing

      -Qunused-arguments    Don't emit warning for unused driver arguments

      --target=<value>      Generate code for the given target

      -v                    Show commands to run and use verbose output

      -W<warning>           Enable the specified warning

      -Xclang <arg>         Pass <arg> to the clang compiler



The /fallback Option

^^^^^^^^^^^^^^^^^^^^