Author: Fangrui Song Date: 2022-06-18T11:01:54-07:00 New Revision: af6d2a0b6825e71965f3e2701a63c239fa0ad70f
URL: https://github.com/llvm/llvm-project/commit/af6d2a0b6825e71965f3e2701a63c239fa0ad70f DIFF: https://github.com/llvm/llvm-project/commit/af6d2a0b6825e71965f3e2701a63c239fa0ad70f.diff LOG: [docs] Re-generate ClangCommandLineReference.rst Added: Modified: clang/docs/ClangCommandLineReference.rst Removed: ################################################################################ diff --git a/clang/docs/ClangCommandLineReference.rst b/clang/docs/ClangCommandLineReference.rst index 73dccf6a9a04e..7e53f45c59689 100644 --- a/clang/docs/ClangCommandLineReference.rst +++ b/clang/docs/ClangCommandLineReference.rst @@ -281,6 +281,10 @@ Generate CodeView debug information Emit type record hashes in a .debug$H section +.. option:: -gen-reproducer=<arg>, -fno-crash-diagnostics (equivalent to -gen-reproducer=off) + +Emit reproducer on (option: off, crash (default), error, always) + .. option:: --gpu-instrument-lib=<arg> Instrument device library for HIP, which is a LLVM bitcode containing \_\_cyg\_profile\_func\_enter and \_\_cyg\_profile\_func\_exit @@ -339,7 +343,7 @@ Allow unsafe floating-point math optimizations which may decrease precision .. option:: -mharden-sls=<arg> -Select straight-line speculation hardening scope +Select straight-line speculation hardening scope (ARM/AArch64/X86 only). <arg> must be: all, none, retbr(ARM/AArch64), blr(ARM/AArch64), comdat(ARM/AArch64), nocomdat(ARM/AArch64), return(X86), indirect-jmp(X86) .. option:: --migrate @@ -551,6 +555,10 @@ Use pipes between commands, when possible .. option:: --print-diagnostic-categories +.. option:: -print-diagnostic-options, --print-diagnostic-options + +Print all of Clang's warning options + .. option:: -print-effective-triple, --print-effective-triple Print the effective target triple @@ -817,6 +825,10 @@ Generate Interface Stub Files, emit merged text not binary. Extract API information +.. option:: -fdriver-only + +Only run the driver. + .. option:: -fsyntax-only .. option:: -module-file-info @@ -929,10 +941,6 @@ Inline suitable functions Inline functions which are (explicitly or implicitly) marked inline -.. option:: -fno-crash-diagnostics - -Disable auto-generation of preprocessed source files and a script for reproduction during a clang crash - .. option:: -fno-legacy-pass-manager, -fexperimental-new-pass-manager .. option:: -fno-sanitize-ignorelist, -fno-sanitize-blacklist @@ -1106,7 +1114,9 @@ Include comments in preprocessed output Include comments from within macros in preprocessed output -.. option:: -D<macro>=<value>, --define-macro <arg>, --define-macro=<arg> +.. program:: clang2 +.. option:: -D<macro>=<value>, --D<arg>, /D<arg>, -D<arg>, --define-macro <arg>, --define-macro=<arg> +.. program:: clang Define <macro> to <value> (or 1 if <value> omitted) @@ -1727,6 +1737,10 @@ Embed Offloading device-side binary into host object file as a section. Emit all declarations, even if unused +.. option:: -femit-dwarf-unwind=<arg> + +When to emit DWARF unwind (EH frame) info. <arg> must be 'always', 'no-compact-unwind' or 'default'. + .. option:: -femulated-tls, -fno-emulated-tls Use emutls functions to access thread\_local variables @@ -1903,6 +1917,10 @@ Enable the integrated assembler Run cc1 in-process +.. option:: -fintegrated-objemitter, -fno-integrated-objemitter + +Use internal machine object code emitter. + .. option:: -fjmc, -fno-jmc Enable just-my-code debugging @@ -2767,7 +2785,7 @@ When using -fxray-function-groups, select which group of functions to instrument .. option:: -fzero-call-used-regs=<arg> -Clear call-used registers upon function return. <arg> must be 'skip', 'used-gpr-arg', 'used-gpr', 'used-arg', 'used', 'all-gpr-arg', 'all-gpr', 'all-arg' or 'all'. +Clear call-used registers upon function return (AArch64/x86 only). <arg> must be 'skip', 'used-gpr-arg', 'used-gpr', 'used-arg', 'used', 'all-gpr-arg', 'all-gpr', 'all-arg' or 'all'. .. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss @@ -2795,6 +2813,10 @@ OpenCL flags OpenCL only. Allow denormals to be flushed to zero. +.. option:: -cl-ext=<arg1>,<arg2>... + +OpenCL only. Enable or disable OpenCL extensions/optional features. The argument is a comma-separated sequence of one or more extension names, each prefixed by '+' or '-'. + .. option:: -cl-fast-relaxed-math OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines \_\_FAST\_RELAXED\_MATH\_\_. @@ -3073,6 +3095,10 @@ Allow use of CRC instructions (ARM/Mips only) .. option:: -mdefault-build-attributes<arg>, -mno-default-build-attributes<arg> +.. option:: -mdefault-visibility-export-mapping=<arg> + +Mapping between default visibility and export. <arg> must be 'none', 'explicit' or 'all'. + .. option:: -mdll<arg> .. option:: -mdouble=<n @@ -4209,19 +4235,15 @@ Set starting address of TEXT to <addr> Pass the comma separated arguments in <arg> to the linker -.. option:: --offload-link - -Use the linker supporting offloading device linking. - .. option:: -X .. option:: -Xlinker <arg>, --for-linker <arg>, --for-linker=<arg> Pass <arg> to the linker -.. option:: -Xoffload-linker <arg>, -Xoffload-linker-<triple> <arg> +.. option:: -Xoffload-linker<triple> <arg> -Pass <arg> to all the device linking jobs, or for only <triple> if specified. +Pass <arg> to the offload linkers or the ones idenfied by -<triple> .. program:: clang1 .. option:: -Z @@ -4255,6 +4277,10 @@ path to a pass plugin for HIP to SPIR-V passes. .. option:: -nostdlib, --no-standard-libraries .. program:: clang +.. option:: --offload-link + +Use the new offloading linker to perform the link job. + .. option:: -pie .. option:: -r @@ -4295,15 +4321,21 @@ Pass -z <arg> to the linker =================== dxc compatibility options -.. program:: clang2 +.. program:: clang3 .. option:: /T<profile>, -T<profile> .. program:: clang Set target profile. <profile> must be 'ps_6_0', ' ps_6_1', ' ps_6_2', ' ps_6_3', ' ps_6_4', ' ps_6_5', ' ps_6_6', ' ps_6_7', 'vs_6_0', ' vs_6_1', ' vs_6_2', ' vs_6_3', ' vs_6_4', ' vs_6_5', ' vs_6_6', ' vs_6_7', 'gs_6_0', ' gs_6_1', ' gs_6_2', ' gs_6_3', ' gs_6_4', ' gs_6_5', ' gs_6_6', ' gs_6_7', 'hs_6_0', ' hs_6_1', ' hs_6_2', ' hs_6_3', ' hs_6_4', ' hs_6_5', ' hs_6_6', ' hs_6_7', 'ds_6_0', ' ds_6_1', ' ds_6_2', ' ds_6_3', ' ds_6_4', ' ds_6_5', ' ds_6_6', ' ds_6_7', 'cs_6_0', ' cs_6_1', ' cs_6_2', ' cs_6_3', ' cs_6_4', ' cs_6_5', ' cs_6_6', ' cs_6_7', 'lib_6_3', ' lib_6_4', ' lib_6_5', ' lib_6_6', ' lib_6_7', ' lib_6_x', 'ms_6_5', ' ms_6_6', ' ms_6_7', 'as_6_5', ' as_6_6' or ' as_6_7'. -.. program:: clang3 +.. program:: clang4 .. option:: /emit-pristine-llvm, -emit-pristine-llvm, /fcgl, -fcgl .. program:: clang Emit pristine LLVM IR from the frontend by not running any LLVM passes at all.Same as -S + -emit-llvm + -disable-llvm-passes. +.. program:: clang5 +.. option:: /hlsl-no-stdinc, -hlsl-no-stdinc +.. program:: clang + +HLSL only. Disables all standard includes containing non-native compiler types and functions. + _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
