From 072bfb7557da49d84a5709656af93e464359a994 Mon Sep 17 00:00:00 2001 From: Patrick Lehmann Date: Tue, 5 Jan 2021 01:11:21 +0100 Subject: Reordered navigation bar items. --- doc/index.rst | 4 +-- doc/pyGHDL/index.rst | 79 ++++++++++++++++++++++++++++++++++++++++++++++ doc/using/pyGHDL/index.rst | 79 ---------------------------------------------- 3 files changed, 81 insertions(+), 81 deletions(-) create mode 100644 doc/pyGHDL/index.rst delete mode 100644 doc/using/pyGHDL/index.rst (limited to 'doc') diff --git a/doc/index.rst b/doc/index.rst index cb36240f8..a4d5e21db 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -140,7 +140,6 @@ GHDL using/Foreign using/ImplementationOfVHDL using/ImplementationOfVITAL - using/pyGHDL/index .. raw:: latex @@ -152,6 +151,8 @@ GHDL development/Debugging development/CodingStyle + gnatdoc/index + pyGHDL/index .. raw:: latex @@ -165,7 +166,6 @@ GHDL internals/Frontend internals/AST internals/RTI - gnatdoc/index .. raw:: latex diff --git a/doc/pyGHDL/index.rst b/doc/pyGHDL/index.rst new file mode 100644 index 000000000..e22822ce6 --- /dev/null +++ b/doc/pyGHDL/index.rst @@ -0,0 +1,79 @@ +.. _python_interface: + +Python Interfaces +################# + +.. # + we have 2 interfaces (libghdl, dom) and a service (LSP) as well as CLI entry points. + +GHDL offers two Python interfaces and a language server protocol service. All +this is provided from a ``pyGHDL`` packages with four sub-packages: + +* ``pyGHDL.cli`` - Command line interface (CLI) applications. +* ``pyGHDL.dom`` - High-level API as document object model (DOM). +* ``pyGHDL.libghdl`` - Low-level API to ``libghdl`` +* ``pyGHDL.lsp`` - Language server protocol (LSP) implementation and service + + +.. topic:: pyGHDL.libghdl + + *pyGHDL.libghdl* is a low-level API directly interacting with the shared + library ``libghdl....so``/``libghdl....dll``. This is a procedural and C-like + interface. + + It comes with some Python generators for easier iterating linked lists. + + +.. topic:: pyGHDL.dom + + *pyGHDL.dom* is a high-level API offering a document object model (DOM). + The underlying abstract VHDL language model is provided by `pyVHDLModel `__. + The DOM is using ``libghdl`` for file analysis and parsing. + + +.. topic:: pyGHDL.lsp + + *pyGHDL.lsp* is `language server protocol `__ + (LSP) written in Python. The implementation offers an HTTPS service that can + be used e.g. by editors and IDEs supporting LSP. + + +.. toctree:: + :hidden: + + ../../pyGHDL/pyGHDL.cli + ../../pyGHDL/pyGHDL.dom + ../../pyGHDL/pyGHDL.libghdl + ../../pyGHDL/pyGHDL.lsp + + +.. _CMDREF: + +Scripts and Applications +######################## + +The pyVHDLParser package comes with an executables registered by pip in the +search path. + +* ``VHDLParser`` is a wrapper for ``pyVHDLParser.CLI.VHDLParser:main``. + + +.. # + This files requires a Python module called 'Frontend-AutoProgram' to be + located in the 'doc' root folder. It expects a variable 'parser' of type + ArgumentParser. + +.. _CMDREF-ghdlls: + +.. autoprogram:: AutoProgram:lsp_parser + :prog: ghdl-ls + :groups: + :label: CmdRef:ghdlls: + +.. _CMDREF-pnodes: + +.. # + autoprogram:: AutoProgram:pnodes_parser + :prog: ghdl-ls + :groups: + :label: CmdRef:ghdlls: diff --git a/doc/using/pyGHDL/index.rst b/doc/using/pyGHDL/index.rst deleted file mode 100644 index e22822ce6..000000000 --- a/doc/using/pyGHDL/index.rst +++ /dev/null @@ -1,79 +0,0 @@ -.. _python_interface: - -Python Interfaces -################# - -.. # - we have 2 interfaces (libghdl, dom) and a service (LSP) as well as CLI entry points. - -GHDL offers two Python interfaces and a language server protocol service. All -this is provided from a ``pyGHDL`` packages with four sub-packages: - -* ``pyGHDL.cli`` - Command line interface (CLI) applications. -* ``pyGHDL.dom`` - High-level API as document object model (DOM). -* ``pyGHDL.libghdl`` - Low-level API to ``libghdl`` -* ``pyGHDL.lsp`` - Language server protocol (LSP) implementation and service - - -.. topic:: pyGHDL.libghdl - - *pyGHDL.libghdl* is a low-level API directly interacting with the shared - library ``libghdl....so``/``libghdl....dll``. This is a procedural and C-like - interface. - - It comes with some Python generators for easier iterating linked lists. - - -.. topic:: pyGHDL.dom - - *pyGHDL.dom* is a high-level API offering a document object model (DOM). - The underlying abstract VHDL language model is provided by `pyVHDLModel `__. - The DOM is using ``libghdl`` for file analysis and parsing. - - -.. topic:: pyGHDL.lsp - - *pyGHDL.lsp* is `language server protocol `__ - (LSP) written in Python. The implementation offers an HTTPS service that can - be used e.g. by editors and IDEs supporting LSP. - - -.. toctree:: - :hidden: - - ../../pyGHDL/pyGHDL.cli - ../../pyGHDL/pyGHDL.dom - ../../pyGHDL/pyGHDL.libghdl - ../../pyGHDL/pyGHDL.lsp - - -.. _CMDREF: - -Scripts and Applications -######################## - -The pyVHDLParser package comes with an executables registered by pip in the -search path. - -* ``VHDLParser`` is a wrapper for ``pyVHDLParser.CLI.VHDLParser:main``. - - -.. # - This files requires a Python module called 'Frontend-AutoProgram' to be - located in the 'doc' root folder. It expects a variable 'parser' of type - ArgumentParser. - -.. _CMDREF-ghdlls: - -.. autoprogram:: AutoProgram:lsp_parser - :prog: ghdl-ls - :groups: - :label: CmdRef:ghdlls: - -.. _CMDREF-pnodes: - -.. # - autoprogram:: AutoProgram:pnodes_parser - :prog: ghdl-ls - :groups: - :label: CmdRef:ghdlls: -- cgit v1.2.3