Procházet zdrojové kódy

[docs] Regenerate command line reference

This will correctly sort some manually added entries which should
generally be avoided!

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@330430 91177308-0d34-0410-b5e6-96231b3b80d8
Jonas Hahnfeld před 7 roky
rodič
revize
fffb8f31fd
1 změnil soubory, kde provedl 77 přidání a 19 odebrání
  1. 77 19
      docs/ClangCommandLineReference.rst

+ 77 - 19
docs/ClangCommandLineReference.rst

@@ -144,14 +144,14 @@ Compile CUDA code for device only
 
 
 CUDA GPU architecture (e.g. sm\_35).  May be specified more than once.
 CUDA GPU architecture (e.g. sm\_35).  May be specified more than once.
 
 
-.. option:: --cuda-include-ptx=<arg>, --no-cuda-include-ptx=<arg>
-
-Include (or not) PTX along with CUDA GPU binary for the given architecture (e.g. sm\_35). Argument may be 'all'. The option may be specified more than once. Default: --cuda-include-ptx=all
-
 .. option:: --cuda-host-only
 .. option:: --cuda-host-only
 
 
 Compile CUDA code for host only.  Has no effect on non-CUDA compilations.
 Compile CUDA code for host only.  Has no effect on non-CUDA compilations.
 
 
+.. option:: --cuda-include-ptx=<arg>, --no-cuda-include-ptx=<arg>
+
+Include PTX for the follwing GPU architecture (e.g. sm\_35) or 'all'. May be specified more than once.
+
 .. option:: --cuda-noopt-device-debug, --no-cuda-noopt-device-debug
 .. option:: --cuda-noopt-device-debug, --no-cuda-noopt-device-debug
 
 
 Enable device-side debug info generation. Disables ptxas optimizations.
 Enable device-side debug info generation. Disables ptxas optimizations.
@@ -202,6 +202,10 @@ Use approximate transcendental functions
 
 
 Flush denormal floating point values to zero in CUDA device mode.
 Flush denormal floating point values to zero in CUDA device mode.
 
 
+.. option:: -ffixed-r19
+
+Reserve the r19 register (Hexagon only)
+
 .. option:: -fheinous-gnu-extensions
 .. option:: -fheinous-gnu-extensions
 
 
 .. option:: -flat\_namespace
 .. option:: -flat\_namespace
@@ -242,6 +246,8 @@ Display available options
 
 
 .. option:: --help-hidden
 .. option:: --help-hidden
 
 
+Display help for hidden options
+
 .. option:: -image\_base <arg>
 .. option:: -image\_base <arg>
 
 
 .. option:: -index-header-map
 .. option:: -index-header-map
@@ -940,7 +946,7 @@ Specify the module user build path
 
 
 Don't verify input files for the modules if the module has been successfully validated or loaded during this build session
 Don't verify input files for the modules if the module has been successfully validated or loaded during this build session
 
 
-.. option:: -fmodules-validate-system-headers
+.. option:: -fmodules-validate-system-headers, -fno-modules-validate-system-headers
 
 
 Validate the system headers that a module depends on when loading the module
 Validate the system headers that a module depends on when loading the module
 
 
@@ -948,8 +954,6 @@ Validate the system headers that a module depends on when loading the module
 
 
 Specify the prebuilt module path
 Specify the prebuilt module path
 
 
-.. option:: -i<arg>
-
 .. option:: -idirafter<arg>, --include-directory-after <arg>, --include-directory-after=<arg>
 .. option:: -idirafter<arg>, --include-directory-after <arg>, --include-directory-after=<arg>
 
 
 Add directory to AFTER include search path
 Add directory to AFTER include search path
@@ -1135,6 +1139,12 @@ Target-independent compilation options
 
 
 .. option:: -faccess-control, -fno-access-control
 .. option:: -faccess-control, -fno-access-control
 
 
+.. option:: -falign-functions, -fno-align-functions
+
+.. program:: clang1
+.. option:: -falign-functions=<arg>
+.. program:: clang
+
 .. program:: clang1
 .. program:: clang1
 .. option:: -faligned-allocation, -faligned-new, -fno-aligned-allocation
 .. option:: -faligned-allocation, -faligned-new, -fno-aligned-allocation
 .. program:: clang
 .. program:: clang
@@ -1337,6 +1347,8 @@ Use emutls functions to access thread\_local variables
 
 
 .. option:: -ferror-limit=<arg>
 .. option:: -ferror-limit=<arg>
 
 
+.. option:: -fescaping-block-tail-calls, -fno-escaping-block-tail-calls
+
 .. option:: -fexceptions, -fno-exceptions
 .. option:: -fexceptions, -fno-exceptions
 
 
 Enable support for exception handling
 Enable support for exception handling
@@ -1353,6 +1365,10 @@ Allow aggressive, lossy floating-point optimizations
 
 
 .. option:: -ffor-scope, -fno-for-scope
 .. option:: -ffor-scope, -fno-for-scope
 
 
+.. option:: -fforce-enable-int128, -fno-force-enable-int128
+
+Enable support for int128\_t type
+
 .. option:: -ffp-contract=<arg>
 .. option:: -ffp-contract=<arg>
 
 
 Form fused FP ops (e.g. FMAs): fast (everywhere) \| on (according to FP\_CONTRACT pragma, default) \| off (never fuse)
 Form fused FP ops (e.g. FMAs): fast (everywhere) \| on (according to FP\_CONTRACT pragma, default) \| off (never fuse)
@@ -1441,6 +1457,8 @@ Specify the maximum alignment to enforce on pointers lacking an explicit alignme
 
 
 .. option:: -fmerge-all-constants, -fno-merge-all-constants
 .. option:: -fmerge-all-constants, -fno-merge-all-constants
 
 
+Allow merging of constants
+
 .. option:: -fmessage-length=<arg>
 .. option:: -fmessage-length=<arg>
 
 
 .. option:: -fmodule-file-deps, -fno-module-file-deps
 .. option:: -fmodule-file-deps, -fno-module-file-deps
@@ -1523,10 +1541,16 @@ Do not elide types when printing diagnostics
 
 
 Do not treat C++ operator name keywords as synonyms for operators
 Do not treat C++ operator name keywords as synonyms for operators
 
 
+.. option:: -fno-rtti-data
+
+Control emission of RTTI data
+
 .. option:: -fno-strict-modules-decluse
 .. option:: -fno-strict-modules-decluse
 
 
 .. option:: -fno-working-directory
 .. option:: -fno-working-directory
 
 
+.. option:: -fnoxray-link-deps
+
 .. option:: -fobjc-abi-version=<arg>
 .. option:: -fobjc-abi-version=<arg>
 
 
 .. option:: -fobjc-arc, -fno-objc-arc
 .. option:: -fobjc-arc, -fno-objc-arc
@@ -1680,6 +1704,10 @@ Allow division operations to be reassociated
 
 
 Override the default ABI to return small structs in registers
 Override the default ABI to return small structs in registers
 
 
+.. option:: -fregister-global-dtors-with-atexit, -fno-register-global-dtors-with-atexit
+
+Use atexit or \_\_cxa\_atexit to register global destructors
+
 .. option:: -frelaxed-template-template-args, -fno-relaxed-template-template-args
 .. option:: -frelaxed-template-template-args, -fno-relaxed-template-template-args
 
 
 Enable C++17 relaxed template template argument matching
 Enable C++17 relaxed template template argument matching
@@ -1906,9 +1934,17 @@ Store string literals as writable data
 
 
 Determine whether to always emit \_\_xray\_customevent(...) calls even if the function it appears in is not always instrumented.
 Determine whether to always emit \_\_xray\_customevent(...) calls even if the function it appears in is not always instrumented.
 
 
+.. option:: -fxray-always-emit-typedevents, -fno-xray-always-emit-typedevents
+
+Determine whether to always emit \_\_xray\_typedevent(...) calls even if the function it appears in is not always instrumented.
+
 .. option:: -fxray-always-instrument=<arg>
 .. option:: -fxray-always-instrument=<arg>
 
 
-Filename defining the whitelist for imbuing the 'always instrument' XRay attribute.
+DEPRECATED: Filename defining the whitelist for imbuing the 'always instrument' XRay attribute.
+
+.. option:: -fxray-attr-list=<arg>
+
+Filename defining the list of functions/types for imbuing XRay attributes.
 
 
 .. option:: -fxray-instruction-threshold<arg>
 .. option:: -fxray-instruction-threshold<arg>
 
 
@@ -1922,9 +1958,21 @@ Sets the minimum function size to instrument with XRay
 
 
 Generate XRay instrumentation sleds on function entry and exit
 Generate XRay instrumentation sleds on function entry and exit
 
 
+.. option:: -fxray-instrumentation-bundle=<arg>
+
+Select which XRay instrumentation points to emit. Options: all, none, function, custom. Default is 'all'.
+
+.. option:: -fxray-link-deps
+
+Tells clang to add the link dependencies for XRay.
+
+.. option:: -fxray-modes=<arg>
+
+List of modes to link in by default into XRay instrumented binaries.
+
 .. option:: -fxray-never-instrument=<arg>
 .. option:: -fxray-never-instrument=<arg>
 
 
-Filename defining the whitelist for imbuing the 'never instrument' XRay attribute.
+DEPRECATED: Filename defining the whitelist for imbuing the 'never instrument' XRay attribute.
 
 
 .. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss
 .. option:: -fzero-initialized-in-bss, -fno-zero-initialized-in-bss
 
 
@@ -2192,13 +2240,13 @@ Use software floating point
 
 
 Set the stack alignment
 Set the stack alignment
 
 
-.. option:: -mstack-probe-size=<arg>
+.. option:: -mstack-arg-probe, -mno-stack-arg-probe
 
 
-Set the stack probe size
+Enable stack probes
 
 
-.. option:: -mstack-arg-probe, -mno-stack-arg-probe
+.. option:: -mstack-probe-size=<arg>
 
 
-Disable stack probes
+Set the stack probe size
 
 
 .. option:: -mstackrealign, -mno-stackrealign
 .. option:: -mstackrealign, -mno-stackrealign
 
 
@@ -2292,6 +2340,10 @@ Hexagon
 -------
 -------
 .. option:: -mieee-rnd-near
 .. option:: -mieee-rnd-near
 
 
+.. option:: -mpackets, -mno-packets
+
+Enable generation of instruction packets
+
 Hexagon
 Hexagon
 -------
 -------
 .. option:: -mhvx, -mno-hvx
 .. option:: -mhvx, -mno-hvx
@@ -2342,18 +2394,20 @@ PowerPC
 
 
 .. option:: -mqpx, -mno-qpx
 .. option:: -mqpx, -mno-qpx
 
 
+.. option:: -msecure-plt
+
 .. option:: -mvsx, -mno-vsx
 .. option:: -mvsx, -mno-vsx
 
 
 WebAssembly
 WebAssembly
 -----------
 -----------
+.. option:: -mexception-handling, -mno-exception-handling
+
 .. option:: -mnontrapping-fptoint, -mno-nontrapping-fptoint
 .. option:: -mnontrapping-fptoint, -mno-nontrapping-fptoint
 
 
 .. option:: -msign-ext, -mno-sign-ext
 .. option:: -msign-ext, -mno-sign-ext
 
 
 .. option:: -msimd128, -mno-simd128
 .. option:: -msimd128, -mno-simd128
 
 
-.. option:: -mexception-handling, -mno-exception-handling
-
 X86
 X86
 ---
 ---
 .. option:: -m3dnow, -mno-3dnow
 .. option:: -m3dnow, -mno-3dnow
@@ -2398,6 +2452,8 @@ X86
 
 
 .. option:: -mbmi2, -mno-bmi2
 .. option:: -mbmi2, -mno-bmi2
 
 
+.. option:: -mcldemote, -mno-cldemote
+
 .. option:: -mclflushopt, -mno-clflushopt
 .. option:: -mclflushopt, -mno-clflushopt
 
 
 .. option:: -mclwb, -mno-clwb
 .. option:: -mclwb, -mno-clwb
@@ -2577,9 +2633,9 @@ Debug information flags
 
 
 .. option:: -gdwarf-aranges
 .. option:: -gdwarf-aranges
 
 
-.. option:: -gembed-source
+.. option:: -gembed-source, -gno-embed-source
 
 
-.. option:: -gno-embed-source
+Embed source text in DWARF debug sections
 
 
 .. option:: -ggnu-pubnames
 .. option:: -ggnu-pubnames
 
 
@@ -2746,6 +2802,8 @@ a Fortran input.
 
 
 .. option:: -fwhole-file, -fno-whole-file
 .. option:: -fwhole-file, -fno-whole-file
 
 
+.. option:: -imultilib <arg>
+
 .. option:: -nocpp
 .. option:: -nocpp
 
 
 .. option:: -static-libgfortran
 .. option:: -static-libgfortran
@@ -2770,11 +2828,11 @@ Set starting address of BSS to <addr>
 
 
 .. option:: -Tdata<addr>
 .. option:: -Tdata<addr>
 
 
-Set starting address of BSS to <addr>
+Set starting address of DATA to <addr>
 
 
 .. option:: -Ttext<addr>
 .. option:: -Ttext<addr>
 
 
-Set starting address of BSS to <addr>
+Set starting address of TEXT to <addr>
 
 
 .. option:: -Wl,<arg>,<arg2>...
 .. option:: -Wl,<arg>,<arg2>...