[llvm] 7f7f5e2 - [TableGen] [Docs] Add lldb-tblgen to command guide; add 4 guide stubs

Paul C. Anagnostopoulos via llvm-commits llvm-commits at lists.llvm.org
Fri Apr 2 06:52:43 PDT 2021


Author: Paul C. Anagnostopoulos
Date: 2021-04-02T09:52:16-04:00
New Revision: 7f7f5e2543f4f5576604bef0d4aa3e74a5b3a05b

URL: https://github.com/llvm/llvm-project/commit/7f7f5e2543f4f5576604bef0d4aa3e74a5b3a05b
DIFF: https://github.com/llvm/llvm-project/commit/7f7f5e2543f4f5576604bef0d4aa3e74a5b3a05b.diff

LOG: [TableGen] [Docs] Add lldb-tblgen to command guide; add 4 guide stubs

Differential Revision: https://reviews.llvm.org/D99605

Added: 
    llvm/docs/CommandGuide/clang-tblgen.rst
    llvm/docs/CommandGuide/lldb-tblgen.rst
    llvm/docs/CommandGuide/llvm-tblgen.rst
    llvm/docs/CommandGuide/mlir-tblgen.rst

Modified: 
    llvm/docs/CommandGuide/index.rst
    llvm/docs/CommandGuide/tblgen.rst

Removed: 
    


################################################################################
diff  --git a/llvm/docs/CommandGuide/clang-tblgen.rst b/llvm/docs/CommandGuide/clang-tblgen.rst
new file mode 100644
index 0000000000000..e763409412ff3
--- /dev/null
+++ b/llvm/docs/CommandGuide/clang-tblgen.rst
@@ -0,0 +1,22 @@
+clang-tblgen - Description to C++ Code for Clang
+================================================
+
+.. program:: clang-tblgen
+
+SYNOPSIS
+--------
+
+:program:`clang-tblgen` [*options*] [*filename*]
+
+
+DESCRIPTION
+-----------
+
+:program:`clang-tblgen` is a program that translates compiler-related target
+description (``.td``) files into C++ code and other output formats. Most
+users of LLVM will not need to use this program. It is used only for writing
+parts of the compiler.
+
+Please see :doc:`tblgen Family - Target Description to C++ Code<./tblgen>`
+for a description of the *filename* argument and options, including the
+options common to all :program:`*-tblgen` programs.

diff  --git a/llvm/docs/CommandGuide/index.rst b/llvm/docs/CommandGuide/index.rst
index f6a1fa970642b..19ec9cf700cac 100644
--- a/llvm/docs/CommandGuide/index.rst
+++ b/llvm/docs/CommandGuide/index.rst
@@ -72,6 +72,10 @@ Developer Tools
 
    FileCheck
    tblgen
+   clang-tblgen
+   lldb-tblgen
+   llvm-tblgen
+   mlir-tblgen
    lit
    llvm-exegesis
    llvm-locstats

diff  --git a/llvm/docs/CommandGuide/lldb-tblgen.rst b/llvm/docs/CommandGuide/lldb-tblgen.rst
new file mode 100644
index 0000000000000..b97275f0ce4ca
--- /dev/null
+++ b/llvm/docs/CommandGuide/lldb-tblgen.rst
@@ -0,0 +1,22 @@
+lldb-tblgen - Description to C++ Code for LLDB
+==============================================
+
+.. program:: lldb-tblgen
+
+SYNOPSIS
+--------
+
+:program:`lldb-tblgen` [*options*] [*filename*]
+
+
+DESCRIPTION
+-----------
+
+:program:`lldb-tblgen` is a program that translates compiler-related target
+description (``.td``) files into C++ code and other output formats. Most
+users of LLVM will not need to use this program. It is used only for writing
+parts of the compiler.
+
+Please see :doc:`tblgen Family - Target Description to C++ Code<./tblgen>`
+for a description of the *filename* argument and options, including the
+options common to all :program:`*-tblgen` programs.

diff  --git a/llvm/docs/CommandGuide/llvm-tblgen.rst b/llvm/docs/CommandGuide/llvm-tblgen.rst
new file mode 100644
index 0000000000000..cd7a2573f70ee
--- /dev/null
+++ b/llvm/docs/CommandGuide/llvm-tblgen.rst
@@ -0,0 +1,22 @@
+llvm-tblgen - Target Description to C++ Code for LLVM
+=====================================================
+
+.. program:: llvm-tblgen
+
+SYNOPSIS
+--------
+
+:program:`llvm-tblgen` [*options*] [*filename*]
+
+
+DESCRIPTION
+-----------
+
+:program:`llvm-tblgen` is a program that translates compiler-related target
+description (``.td``) files into C++ code and other output formats. Most
+users of LLVM will not need to use this program. It is used only for writing
+parts of the compiler.
+
+Please see :doc:`tblgen Family - Target Description to C++ Code<./tblgen>`
+for a description of the *filename* argument and options, including the
+options common to all :program:`*-tblgen` programs.

diff  --git a/llvm/docs/CommandGuide/mlir-tblgen.rst b/llvm/docs/CommandGuide/mlir-tblgen.rst
new file mode 100644
index 0000000000000..6eab7a8f547f6
--- /dev/null
+++ b/llvm/docs/CommandGuide/mlir-tblgen.rst
@@ -0,0 +1,22 @@
+mlir-tblgen - Description to C++ Code for MLIR
+==============================================
+
+.. program:: mlir-tblgen
+
+SYNOPSIS
+--------
+
+:program:`mlir-tblgen` [*options*] [*filename*]
+
+
+DESCRIPTION
+-----------
+
+:program:`mlir-tblgen` is a program that translates compiler-related target
+description (``.td``) files into C++ code and other output formats. Most
+users of LLVM will not need to use this program. It is used only for writing
+parts of the compiler.
+
+Please see :doc:`tblgen Family - Target Description to C++ Code<./tblgen>`
+for a description of the *filename* argument and options, including the
+options common to all :program:`*-tblgen` programs.

diff  --git a/llvm/docs/CommandGuide/tblgen.rst b/llvm/docs/CommandGuide/tblgen.rst
index d279029f5e45a..416c422de31ca 100644
--- a/llvm/docs/CommandGuide/tblgen.rst
+++ b/llvm/docs/CommandGuide/tblgen.rst
@@ -1,22 +1,28 @@
-xxx-tblgen - Target Description to C++ Code
-===========================================
+tblgen Family - Description to C++ Code
+=======================================
 
 .. program:: tblgen
 
 SYNOPSIS
 --------
 
-:program:`xxx-tblgen` [*options*] [*filename*]
+:program:`clang-tblgen` [*options*] [*filename*]
+
+:program:`lldb-tblgen` [*options*] [*filename*]
+
+:program:`llvm-tblgen` [*options*] [*filename*]
+
+:program:`mlir-tblgen` [*options*] [*filename*]
 
 DESCRIPTION
 -----------
 
-:program:`xxx-tblgen` is a family of programs that translates target
+:program:`*-tblgen` is a family of programs that translates target
 description (``.td``) files into C++ code and other output formats. Most
 users of LLVM will not need to use this program. It is used only for
-writing parts of the compiler or LLVM target backends.
+writing parts of the compiler, debugger, and LLVM target backends.
 
-The details of the input and output of :program:`xxx-tblgen` is beyond the
+The details of the input and output of :program:`*-tblgen` is beyond the
 scope of this short introduction; please see the :doc:`TableGen Overview
 <../TableGen/index>` for an introduction and for references to additional
 TableGen documents.
@@ -70,7 +76,7 @@ General Options
 .. option:: -o filename
 
  Specify the output file name.  If ``filename`` is ``-``, then
- :program:`xxx-tblgen` sends its output to standard output.
+ :program:`*-tblgen` sends its output to standard output.
 
 .. option:: -print-records
 
@@ -97,217 +103,6 @@ General Options
 
   Write the output file only if it is new or has changed.
 
-llvm-tblgen Options
-~~~~~~~~~~~~~~~~~~~
-
-.. option:: -gen-asm-matcher
-
- Generate assembly instruction matcher.
-
-.. option:: -match-prefix=prefix
-
-  Make -gen-asm-matcher match only instructions with the given *prefix*.
-
-.. option:: -gen-asm-parser
-
- Generate assembly instruction parser.
-
-.. option:: -asmparsernum=n
-
- Make -gen-asm-parser emit assembly parser number *n*.
-
-.. option:: -gen-asm-writer
-
- Generate assembly writer.
-
-.. option:: -asmwriternum=n
-
- Make -gen-asm-writer emit assembly writer number *n*.
-
-.. option:: -gen-attrs
-
-  Generate attributes.
-
-.. option:: -gen-automata
-
-  Generate generic automata.
-
-.. option:: -gen-callingconv
-
-  Generate calling convention descriptions.
-
-.. option:: -gen-compress-inst-emitter
-
-  Generate RISC-V compressed instructions.
-
-.. option:: -gen-ctags
-
-  Generate ctags-compatible index.
-
-.. option:: -gen-dag-isel
-
- Generate a DAG (directed acyclic graph) instruction selector.
-
-.. option:: -instrument-coverage
-
-  Make -gen-dag-isel generate tables to help identify the patterns matched.
-
-.. option:: -omit-comments
-
-  Make -gen-dag-isel omit comments. The default is false.
-
-.. option:: -gen-dfa-packetizer
-
- Generate DFA Packetizer for VLIW targets.
-
-.. option:: -gen-directive-decl
-
-  Generate directive related declaration code (header file).
-
-.. option:: -gen-directive-gen
-
-  Generate directive related implementation code part.
-
-.. option:: -gen-directive-impl
-
-  Generate directive related implementation code.
-
-.. option:: -gen-disassembler
-
-  Generate disassembler.
-
-.. option:: -gen-emitter
-
- Generate machine code emitter.
-
-.. option:: -gen-exegesis
-
-  Generate llvm-exegesis tables.
-
-.. option:: -gen-fast-isel
-
-  Generate a "fast" instruction selector.
-
-.. option:: -gen-global-isel
-
-  Generate GlobalISel selector.
-
-.. option:: -gisel-coverage-file=filename
-
-  Specify the file from which to retrieve coverage information.
-
-.. option:: -instrument-gisel-coverage
-
-  Make -gen-global-isel generate coverage instrumentation.
-
-.. option:: -optimize-match-table
-
-  Make -gen-global-isel generate an optimized version of the match table.
-
-.. option:: -warn-on-skipped-patterns
-
-  Make -gen-global-isel explain why a pattern was skipped for inclusion.
-
-.. option:: -gen-global-isel-combiner
-
-  Generate GlobalISel combiner.
-
-.. option:: -combiners=list
-
-  Make -gen-global-isel-combiner emit the specified combiners.
-
-.. option:: -gicombiner-show-expansions
-
-  Make -gen-global-isel-combiner use C++ comments to indicate occurrences
-  of code expansion.
-
-.. option:: -gicombiner-stop-after-build
-
-  Make -gen-global-isel-combiner stop processing after building the match tree.
-
-.. option:: -gicombiner-stop-after-parse
-
-  Make -gen-global-isel-combiner stop processing after parsing rules
-  and dump state.
-
-.. option:: -gen-instr-info
-
- Generate instruction descriptions.
-
-.. option:: -gen-instr-docs
-
- Generate instruction documentation.
-
-.. option:: -gen-intrinsic-enums
-
- Generate intrinsic enums.
-
-.. option:: -intrinsic-prefix=prefix
-
-  Make -gen-intrinsic-enums generate intrinsics with this target *prefix*.
-
-.. option:: -gen-intrinsic-impl
-
- Generate intrinsic information.
-
-.. option:: -gen-opt-parser-defs
-
-  Generate options definitions.
-
-.. option:: -gen-opt-rst
-
-  Generate option RST.
-
-.. option:: -gen-pseudo-lowering
-
- Generate pseudo instruction lowering.
-
-.. option:: -gen-register-bank
-
-  Generate register bank descriptions.
-
-.. option:: -gen-register-info
-
-  Generate registers and register classes info.
-
-.. option:: -register-info-debug
-
-  Make -gen-register-info dump register information for debugging.
-
-.. option:: -gen-searchable-tables
-
-  Generate generic searchable tables. See :doc:`TableGen BackEnds <../TableGen/BackEnds>`
-  for a detailed description.
-
-.. option:: -gen-subtarget
-
- Generate subtarget enumerations.
-
-.. option:: -gen-x86-EVEX2VEX-tables
-
-  Generate X86 EVEX to VEX compress tables.
-
-.. option:: -gen-x86-fold-tables
-
-  Generate X86 fold tables.
-
-.. option:: -long-string-literals
-
-  When emitting large string tables, prefer string literals over
-  comma-separated char literals. This can be a readability and
-  compile-time performance win, but upsets some compilers.
-
-.. option:: -print-enums
-
- Print enumeration values for a class.
-
-.. option:: -class=classname
-
- Make -print-enums print the enumeration list for the specified class.
-
-.. option:: -print-sets
-
- Print expanded sets for testing DAG exprs.
 
 clang-tblgen Options
 ~~~~~~~~~~~~~~~~~~~~
@@ -575,6 +370,234 @@ clang-tblgen Options
   testing purposes.
 
 
+lldb-tblgen Options
+~~~~~~~~~~~~~~~~~~~
+
+.. option:: gen-lldb-option-defs
+
+  Generate lldb OptionDefinition values.
+
+.. option:: gen-lldb-property-defs
+
+  Generate lldb PropertyDefinition values.
+
+.. option:: gen-lldb-property-enum-defs
+
+  Generate lldb PropertyDefinition enum values.
+
+
+llvm-tblgen Options
+~~~~~~~~~~~~~~~~~~~
+
+.. option:: -gen-asm-matcher
+
+ Generate assembly instruction matcher.
+
+.. option:: -match-prefix=prefix
+
+  Make -gen-asm-matcher match only instructions with the given *prefix*.
+
+.. option:: -gen-asm-parser
+
+ Generate assembly instruction parser.
+
+.. option:: -asmparsernum=n
+
+ Make -gen-asm-parser emit assembly parser number *n*.
+
+.. option:: -gen-asm-writer
+
+ Generate assembly writer.
+
+.. option:: -asmwriternum=n
+
+ Make -gen-asm-writer emit assembly writer number *n*.
+
+.. option:: -gen-attrs
+
+  Generate attributes.
+
+.. option:: -gen-automata
+
+  Generate generic automata.
+
+.. option:: -gen-callingconv
+
+  Generate calling convention descriptions.
+
+.. option:: -gen-compress-inst-emitter
+
+  Generate RISC-V compressed instructions.
+
+.. option:: -gen-ctags
+
+  Generate ctags-compatible index.
+
+.. option:: -gen-dag-isel
+
+ Generate a DAG (directed acyclic graph) instruction selector.
+
+.. option:: -instrument-coverage
+
+  Make -gen-dag-isel generate tables to help identify the patterns matched.
+
+.. option:: -omit-comments
+
+  Make -gen-dag-isel omit comments. The default is false.
+
+.. option:: -gen-dfa-packetizer
+
+ Generate DFA Packetizer for VLIW targets.
+
+.. option:: -gen-directive-decl
+
+  Generate directive related declaration code (header file).
+
+.. option:: -gen-directive-gen
+
+  Generate directive related implementation code part.
+
+.. option:: -gen-directive-impl
+
+  Generate directive related implementation code.
+
+.. option:: -gen-disassembler
+
+  Generate disassembler.
+
+.. option:: -gen-emitter
+
+ Generate machine code emitter.
+
+.. option:: -gen-exegesis
+
+  Generate llvm-exegesis tables.
+
+.. option:: -gen-fast-isel
+
+  Generate a "fast" instruction selector.
+
+.. option:: -gen-global-isel
+
+  Generate GlobalISel selector.
+
+.. option:: -gisel-coverage-file=filename
+
+  Specify the file from which to retrieve coverage information.
+
+.. option:: -instrument-gisel-coverage
+
+  Make -gen-global-isel generate coverage instrumentation.
+
+.. option:: -optimize-match-table
+
+  Make -gen-global-isel generate an optimized version of the match table.
+
+.. option:: -warn-on-skipped-patterns
+
+  Make -gen-global-isel explain why a pattern was skipped for inclusion.
+
+.. option:: -gen-global-isel-combiner
+
+  Generate GlobalISel combiner.
+
+.. option:: -combiners=list
+
+  Make -gen-global-isel-combiner emit the specified combiners.
+
+.. option:: -gicombiner-show-expansions
+
+  Make -gen-global-isel-combiner use C++ comments to indicate occurrences
+  of code expansion.
+
+.. option:: -gicombiner-stop-after-build
+
+  Make -gen-global-isel-combiner stop processing after building the match tree.
+
+.. option:: -gicombiner-stop-after-parse
+
+  Make -gen-global-isel-combiner stop processing after parsing rules
+  and dump state.
+
+.. option:: -gen-instr-info
+
+ Generate instruction descriptions.
+
+.. option:: -gen-instr-docs
+
+ Generate instruction documentation.
+
+.. option:: -gen-intrinsic-enums
+
+ Generate intrinsic enums.
+
+.. option:: -intrinsic-prefix=prefix
+
+  Make -gen-intrinsic-enums generate intrinsics with this target *prefix*.
+
+.. option:: -gen-intrinsic-impl
+
+ Generate intrinsic information.
+
+.. option:: -gen-opt-parser-defs
+
+  Generate options definitions.
+
+.. option:: -gen-opt-rst
+
+  Generate option RST.
+
+.. option:: -gen-pseudo-lowering
+
+ Generate pseudo instruction lowering.
+
+.. option:: -gen-register-bank
+
+  Generate register bank descriptions.
+
+.. option:: -gen-register-info
+
+  Generate registers and register classes info.
+
+.. option:: -register-info-debug
+
+  Make -gen-register-info dump register information for debugging.
+
+.. option:: -gen-searchable-tables
+
+  Generate generic searchable tables. See :doc:`TableGen BackEnds <../TableGen/BackEnds>`
+  for a detailed description.
+
+.. option:: -gen-subtarget
+
+ Generate subtarget enumerations.
+
+.. option:: -gen-x86-EVEX2VEX-tables
+
+  Generate X86 EVEX to VEX compress tables.
+
+.. option:: -gen-x86-fold-tables
+
+  Generate X86 fold tables.
+
+.. option:: -long-string-literals
+
+  When emitting large string tables, prefer string literals over
+  comma-separated char literals. This can be a readability and
+  compile-time performance win, but upsets some compilers.
+
+.. option:: -print-enums
+
+ Print enumeration values for a class.
+
+.. option:: -class=classname
+
+ Make -print-enums print the enumeration list for the specified class.
+
+.. option:: -print-sets
+
+ Print expanded sets for testing DAG exprs.
+
 
 mlir-tblgen Options
 ~~~~~~~~~~~~~~~~~~~
@@ -718,5 +741,5 @@ mlir-tblgen Options
 EXIT STATUS
 -----------
 
-If :program:`xxx-tblgen` succeeds, it will exit with 0.  Otherwise, if an error
+If :program:`*-tblgen` succeeds, it will exit with 0.  Otherwise, if an error
 occurs, it will exit with a non-zero value.


        


More information about the llvm-commits mailing list