diff options
| author | Patrick Lehmann <Patrick.Lehmann@plc2.de> | 2021-01-04 15:24:40 +0100 |
|---|---|---|
| committer | tgingold <tgingold@users.noreply.github.com> | 2021-01-05 18:50:44 +0100 |
| commit | c10e2ac30645dc6685ea1004c35adff99d3280dc (patch) | |
| tree | f320aa55bf379dd1fcb823748ce83810e2de51e3 /doc | |
| parent | ef5f93a9d726c7c68899beb276c0b7f3f446c196 (diff) | |
| download | ghdl-c10e2ac30645dc6685ea1004c35adff99d3280dc.tar.gz ghdl-c10e2ac30645dc6685ea1004c35adff99d3280dc.tar.bz2 ghdl-c10e2ac30645dc6685ea1004c35adff99d3280dc.zip | |
Added link to auto generated doc.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/using/pyGHDL/index.rst | 28 |
1 files changed, 16 insertions, 12 deletions
diff --git a/doc/using/pyGHDL/index.rst b/doc/using/pyGHDL/index.rst index d732430da..837f228fa 100644 --- a/doc/using/pyGHDL/index.rst +++ b/doc/using/pyGHDL/index.rst @@ -6,38 +6,42 @@ 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: +GHDL offers two Python interfaces and a language server protocol service. All +this is provided from a ``pyGHDL`` packages with four sub-packages: -* ``pyGHDL.libghdl`` - low-level API to ``libghdl`` -* ``pyGHDL.dom`` - high-level API as document object model (DOM) -* ``pyGHDL.lsp`` - language server protocol (LSP) implementation and service +* ``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 -.. rubric:: ``pyGHDL.libghdl`` - ``pyGHDL.libghdl`` is a low-level API directly interacting with the shared +.. 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. -.. rubric:: ``pyGHDL.dom`` +.. topic:: pyGHDL.dom - ``pyGHDL.dom`` is a high-level API offering a document object model (DOM). + *pyGHDL.dom* is a high-level API offering a document object model (DOM). The underlying abstract VHDL language model is provided by `pyVHDLModel <https://github.com/VHDL/pyVHDLModel>`__. The DOM is using ``libghdl`` for file analysis and parsing. -.. rubric:: ``pyGHDL.dom`` +.. topic:: pyGHDL.dom - ``pyGHDL.dom`` is language server protocol (LSP) written in Python. The + *pyGHDL.dom* 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/index + ../../pyGHDL/pyGHDL + .. toctree:: :hidden: |