diff options
| author | Patrick Lehmann <Patrick.Lehmann@tu-dresden.de> | 2017-03-04 22:24:19 +0100 |
|---|---|---|
| committer | tgingold <tgingold@users.noreply.github.com> | 2017-12-10 12:02:05 +0100 |
| commit | 5f22989f027c2a60c10527dcd0aaee0505adaad3 (patch) | |
| tree | 705134740afe860f0e50b5c8bc3f0aba3f96d4b4 /doc/building | |
| parent | ba8efb1df06cbdac73c8e1b3baa9486b6a29e804 (diff) | |
| download | ghdl-5f22989f027c2a60c10527dcd0aaee0505adaad3.tar.gz ghdl-5f22989f027c2a60c10527dcd0aaee0505adaad3.tar.bz2 ghdl-5f22989f027c2a60c10527dcd0aaee0505adaad3.zip | |
Added how to download GHDL sources.
Diffstat (limited to 'doc/building')
| -rw-r--r-- | doc/building/Building.rst | 22 |
1 files changed, 12 insertions, 10 deletions
diff --git a/doc/building/Building.rst b/doc/building/Building.rst index 16d087342..a8d0e6908 100644 --- a/doc/building/Building.rst +++ b/doc/building/Building.rst @@ -21,26 +21,28 @@ page for further details. The installation directory is referred to as ``GHDLRoo .. rubric:: Available back-ends GHDL currently supports three supported different back-ends (code generators): -* `mcode` (built-in), -* `GCC <http://gcc.gnu.org/>`_, and -* `LLVM <http://llvm.org/>`_ . + +* mcode - built-in x86(or x86_64) code generator, +* `GCC - Gnu Compiler Collection <http://gcc.gnu.org/>`_, and +* `LLVM - Low-Level Virtual Machine <http://llvm.org/>`_ . Here is a short comparison, so that you can choose the one you want to use: +----------------------------+----------------------------------------------------------------------------+---------------------------------------------------------+ | Back-end | Pros | Cons | +============================+============================================================================+=========================================================+ -| :ref:`mcode <BUILD:mcode>` | * Very easy to build | * ``x86_64``/``i386`` only | -| | * Very quick analysis | * Simulation is slower | +| :ref:`mcode <BUILD:mcode>` | * Very easy to build | * Simulation is slower | +| | * Very quick analysis | * x86_64/i386 only | | | * Can handle very large designs | | +----------------------------+----------------------------------------------------------------------------+---------------------------------------------------------+ -| :ref:`GCC <BUILD:gcc>` | * Generated code is faster (particularly with ``-O`` or ``-O2``) | * Analysis can take time (particularly for large units) | -| | * Generated code can be debugged (with ``-g``) | * Build is more complex | -| | * Ported to many platforms (``x86``, ``x86_64``, ``powerpc``, ``sparc``) | * Code coverage collection (``gcov``) is unique to GCC | -+----------------------------+----------------------------------------------------------------------------+---------------------------------------------------------+ -| :ref:`LLVM <BUILD:llvm>` | * Same as GCC | | +| :ref:`LLVM <BUILD:llvm>` | * Generated code is faster | * Build is more complex | +| | * Generated code can be debugged (with ``-g``) | | | | * Easier to build than GCC | | +----------------------------+----------------------------------------------------------------------------+---------------------------------------------------------+ +| :ref:`GCC <BUILD:gcc>` | * Generated code is faster (particularly with ``-O`` or ``-O2``) | * Build is even more complex | +| | * Generated code can be debugged (with ``-g``) | * Analysis can take time (particularly for large units) | +| | * Ported to many platforms (x86, x86_64, PowerPC, SPARC) | * Code coverage collection (``gcov``) is unique to GCC | ++----------------------------+----------------------------------------------------------------------------+---------------------------------------------------------+ .. toctree:: :hidden: |