[PATCH] D128116: [clang][docs] Sync generated command line doc with td files.

[Pavel Iliin via Phabricator via cfe-commits]

ilinpv closed this revision.
ilinpv added a comment.

Commited in af6d2a0b6825e71965f3e2701a63c239fa0ad70f 



Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D128116/new/

https://reviews.llvm.org/D128116

___
cfe-commits mailing list
cfe-commits@lists.llvm.org
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

[PATCH] D128116: [clang][docs] Sync generated command line doc with td files.

[Pavel Iliin via Phabricator via cfe-commits]

ilinpv created this revision.
ilinpv added a reviewer: MaskRay.
Herald added a subscriber: StephenFan.
Herald added a project: All.
ilinpv requested review of this revision.
Herald added a project: clang.
Herald added a subscriber: cfe-commits.

It seems auto-generated ClangCommandLineReference.rst is out of sync with 
options td files.


Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D128116

Files:
  clang/docs/ClangCommandLineReference.rst

Index: clang/docs/ClangCommandLineReference.rst
===
--- clang/docs/ClangCommandLineReference.rst
+++ clang/docs/ClangCommandLineReference.rst
@@ -281,6 +281,10 @@
 
 Emit type record hashes in a .debug$H section
 
+.. option:: -gen-reproducer=, -fno-crash-diagnostics (equivalent to -gen-reproducer=off)
+
+Emit reproducer on (option: off, crash (default), error, always)
+
 .. option:: --gpu-instrument-lib=
 
 Instrument device library for HIP, which is a LLVM bitcode containing \_\_cyg\_profile\_func\_enter and \_\_cyg\_profile\_func\_exit
@@ -339,7 +343,7 @@
 
 .. option:: -mharden-sls=
 
-Select straight-line speculation hardening scope
+Select straight-line speculation hardening scope (ARM/AArch64/X86 only).  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 @@
 
 .. 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 @@
 
 Extract API information
 
+.. option:: -fdriver-only
+
+Only run the driver.
+
 .. option:: -fsyntax-only
 
 .. option:: -module-file-info
@@ -929,10 +941,6 @@
 
 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 from within macros in preprocessed output
 
-.. option:: -D=, --define-macro , --define-macro=
+.. program:: clang2
+.. option:: -D=, --D, /D, -D, --define-macro , --define-macro=
+.. program:: clang
 
 Define  to  (or 1 if  omitted)
 
@@ -1727,6 +1737,10 @@
 
 Emit all declarations, even if unused
 
+.. option:: -femit-dwarf-unwind=
+
+When to emit DWARF unwind (EH frame) info.  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 @@
 
 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 @@
 
 .. option:: -fzero-call-used-regs=
 
-Clear call-used registers upon function return.  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).  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 only. Allow denormals to be flushed to zero.
 
+.. option:: -cl-ext=,...
+
+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 @@
 
 .. option:: -mdefault-build-attributes, -mno-default-build-attributes
 
+.. option:: -mdefault-visibility-export-mapping=
+
+Mapping between default visibility and export.  must be 'none', 'explicit' or 'all'.
+
 .. option:: -mdll
 
 .. option:: -mdouble= to the linker
 
-.. option:: --offload-link
-
-Use the linker supporting offloading device linking.
-
 .. option:: -X
 
 .. option:: -Xlinker , --for-linker , --for-linker=
 
 Pass  to the linker
 
-.. option:: -Xoffload-linker , -Xoffload-linker- 
+.. option:: -Xoffload-linker 
 
-Pass  to all the device linking jobs, or for only  if specified.
+Pass  to the offload linkers or the ones idenfied by -
 
 .. program:: clang1
 .. option:: -Z
@@ -4255,6 +4277,10 @@
 .. 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 @@
 ===
 dxc compatibility options
 
-.. program:: clang2
+.. program:: clang3