From 91bf00df6205c43048d8e9d309d5b8029a57b2fd Mon Sep 17 00:00:00 2001 From: eine Date: Wed, 27 May 2020 08:13:45 +0200 Subject: doc: move --file-to-xml to 'Misc commands' --- doc/using/CommandReference.rst | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) (limited to 'doc/using') diff --git a/doc/using/CommandReference.rst b/doc/using/CommandReference.rst index 6284db18b..8b9209093 100644 --- a/doc/using/CommandReference.rst +++ b/doc/using/CommandReference.rst @@ -113,6 +113,19 @@ Lines [``--lines``] Display on the standard output lines of files preceded by line number. +.. index:: cmd XML generation + +XML tree generation [``--file-to-xml``] +--------------------------------------- + +.. option:: --file-to-xml + + Outputs an XML representation of the decorated syntax tree for the input file and its dependencies. It can be used for VHDL tooling using semantic information, like style checkers, documentation extraction, complexity estimation, etc. + +.. WARNING:: + * The AST slightly changes from time to time (particularly when new nodes are added for new language features), so be liberal in what is allowed by your tool. Also, the XML can be quite large so consider it only during prototyping. + * Note that at this time there is no XML dump of the elaborated design. + .. _gccllvm-only-programs: GCC/LLVM only commands @@ -154,19 +167,6 @@ This command may be used only after a bind command. GHDL displays all the files * Filter the output of ``--list-link`` with e.g. ``sed``. * Provide an additional non-anonymous version script: ``-Wl,-Wl,--version-script=file.ver``. -.. index:: cmd XML generation - -XML tree generation [``--file-to-xml``] ---------------------------------------- - -.. option:: --file-to-xml - - Outputs an XML representation of the decorated syntax tree for the input file and its dependencies. It can be used for VHDL tooling using semantic information, like style checkers, documentation extraction, complexity estimation, etc. - -.. WARNING:: - * The AST slightly changes from time to time (particularly when new nodes are added for new language features), so be liberal in what is allowed by your tool. Also, the XML can be quite large so consider it only during prototyping. - * Note that at this time there is no XML dump of the elaborated design. - Options ======= -- cgit v1.2.3