From 0d08062b7bafb5368cffefbb606b314e67fe87e8 Mon Sep 17 00:00:00 2001 From: Hans Wennborg Date: Wed, 12 Aug 2015 19:35:01 +0000 Subject: [PATCH] Docs: update clang-cl command-line documentation llvm-svn: 244794 --- clang/docs/UsersManual.rst | 81 +++++++++++++++++++++++++++++++++------------- 1 file changed, 59 insertions(+), 22 deletions(-) diff --git a/clang/docs/UsersManual.rst b/clang/docs/UsersManual.rst index 9a70d63..2229e19 100644 --- a/clang/docs/UsersManual.rst +++ b/clang/docs/UsersManual.rst @@ -2005,7 +2005,7 @@ with a warning. For example: :: - clang-cl.exe: warning: argument unused during compilation: '/Zi' + clang-cl.exe: warning: argument unused during compilation: '/AI' To suppress warnings about unused arguments, use the ``-Qunused-arguments`` option. @@ -2034,14 +2034,21 @@ Execute ``clang-cl /?`` to see a list of supported options: /E Preprocess to stdout /fallback Fall back to cl.exe if clang-cl fails to compile /FA Output assembly code file during compilation - /Fa Output assembly code to this file during compilation + /Fa Output assembly code to this file during compilation (with /FA) /Fe Set output executable file or directory (ends in / or \) /FI Include file before parsing - /Fi Set preprocess output file name - /Fo Set output object file, or directory (ends in / or \) + /Fi Set preprocess output file name (with /P) + /Fo Set output object file, or directory (ends in / or \) (with /c) + /fp:except- + /fp:except + /fp:fast + /fp:precise + /fp:strict + /GA Assume thread-local variables are defined in the executable /GF- Disable string pooling /GR- Disable emission of RTTI data /GR Enable emission of RTTI data + /Gs Set stack probe size /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 @@ -2062,11 +2069,13 @@ Execute ``clang-cl /?`` to see a list of supported options: /Oi Enable use of builtin functions /Os Optimize for size /Ot Optimize for speed - /Ox Maximum optimization /Oy- Disable frame pointer omission /Oy Enable frame pointer omission - /O Optimization level + /O Optimization level + /o 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 /TC Treat all source files as C /Tc Specify a C source file @@ -2079,6 +2088,8 @@ Execute ``clang-cl /?`` to see a list of supported options: /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 @@ -2088,29 +2099,55 @@ 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 + /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 + /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 Specify the default maximum struct packing alignment /Zs Syntax-check only OPTIONS: - -### Print (but do not run) the commands to run for this compilation + -### 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 + -fdiagnostics-parseable-fixits + Print fix-its in machine parseable form -fms-compatibility-version= - Dot-separated value representing the Microsoft compiler version - number to report in _MSC_VER (0 = don't define it (default)) - -fmsc-version= Microsoft compiler version number to report in _MSC_VER (0 = don't - define it (default)) + Dot-separated value representing the Microsoft compiler version + number to report in _MSC_VER (0 = don't define it (default)) + -fmsc-version= Microsoft compiler version number to report in _MSC_VER (0 = don't + define it (default)) + -fno-sanitize-coverage= + Disable specified features of coverage instrumentation for Sanitizers + -fno-sanitize-recover= + Disable recovery for specified sanitizers + -fno-sanitize-trap= + Disable trapping for specified sanitizers -fsanitize-blacklist= - Path to blacklist file for sanitizers - -fsanitize= Enable runtime instrumentation for bug detection: address (memory - errors) | thread (race detection) | undefined (miscellaneous - undefined behavior) - -mllvm Additional arguments to forward to LLVM's option processing - -Qunused-arguments Don't emit warning for unused driver arguments - --target= Generate code for the given target - -v Show commands to run and use verbose output - -W Enable the specified warning - -Xclang Pass to the clang compiler + Path to blacklist file for sanitizers + -fsanitize-coverage= + Specify the type of coverage instrumentation for Sanitizers + -fsanitize-recover= + Enable recovery for specified sanitizers + -fsanitize-trap= Enable trapping for specified sanitizers + -fsanitize= Turn on runtime checks for various forms of undefined or suspicious + behavior. See user manual for available checks + -gcodeview Generate CodeView debug information + -mllvm Additional arguments to forward to LLVM's option processing + -Qunused-arguments Don't emit warning for unused driver arguments + -R Enable the specified remark + --target= Generate code for the given target + -v Show commands to run and use verbose output + -W Enable the specified warning + -Xclang Pass to the clang compiler The /fallback Option ^^^^^^^^^^^^^^^^^^^^ -- 2.7.4