diff options
Diffstat (limited to 'doc/building/llvm')
-rw-r--r-- | doc/building/llvm/GNULinux-GNAT.rst | 23 | ||||
-rw-r--r-- | doc/building/llvm/Windows-MinGW-GNAT.rst | 26 | ||||
-rw-r--r-- | doc/building/llvm/index.rst | 22 |
3 files changed, 0 insertions, 71 deletions
diff --git a/doc/building/llvm/GNULinux-GNAT.rst b/doc/building/llvm/GNULinux-GNAT.rst deleted file mode 100644 index 5bb1fcad7..000000000 --- a/doc/building/llvm/GNULinux-GNAT.rst +++ /dev/null @@ -1,23 +0,0 @@ -.. _BUILD:llvm:GNULinux-GNAT: - -LLVM Backend on GNU/Linux with GCC/GNAT -####################################### - -.. HINT:: You need to install LLVM (usually depends on ``libedit``, see :ghdlsharp:`29`). Debugging is only supported with LLVM 3.5. - -* First configure GHDL with the proper arg ``./configure --with-llvm-config``. If ``llvm-config`` is not in your path, you can specify it: ``./configure --with-llvm-config=LLVM_INSTALL/bin/llvm-config``. - -* Then, build with ``make`` and install with ``make install``. - -.. rubric:: Example: - -.. code-block:: Bash - - $ cd <ghdl> - $ mkdir build - $ cd build - $ ../configure --with-llvm-config --prefix=PREFIX - $ make - $ make install - -.. HINT:: If you want to have stack backtraces on errors (like assert failure or index of out bounds), you need to configure and build ``libbacktrace`` from GCC (you don't need to configure GCC). Then add the following arg to configure: ``--with-backtrace-lib=/path-to-gcc-build/libbacktrace/.libs/libbacktrace.a`` diff --git a/doc/building/llvm/Windows-MinGW-GNAT.rst b/doc/building/llvm/Windows-MinGW-GNAT.rst deleted file mode 100644 index 59d70023f..000000000 --- a/doc/building/llvm/Windows-MinGW-GNAT.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _BUILD:llvm:Windows-MinGW-GNAT: - -LLVM Backend on Windows with GCC/GNAT (MinGW) -############################################# - -On Windows with MinGW, GHDL is configured by ``configure`` and built by ``make``. - -* First, GHDL needs to be configured. It is common to specify a ``PREFIX`` - (installation directory like ``/usr/local`` or ``/opt/ghdl``). Without any - other option, ``configure`` selects `mcode` as the backend. - -* Next, ``make`` starts the compilation process. - -* Finally, ``make install`` installs GHDL into the installation directory - specified by ``PREFIX``. - -.. rubric:: Example: - -.. code-block:: Bash - - $ cd <ghdl> - $ mkdir build - $ cd build - $ ../configure --prefix=PREFIX - $ make - $ make install diff --git a/doc/building/llvm/index.rst b/doc/building/llvm/index.rst deleted file mode 100644 index 72c2c50c1..000000000 --- a/doc/building/llvm/index.rst +++ /dev/null @@ -1,22 +0,0 @@ -.. _BUILD:llvm: - -LLVM Backend -############ - -.. rubric:: Requirements - -* GCC (Gnu Compiler Collection) -* GNAT (Ada compiler for GCC) -* LLVM (Low-Level-Virtual Machine) and CLANG (Compiler front-end for LLVM): 3.5, 3.8, 3.9, 4.0, 5.0, 6.0, 7.0 or 8.0 - -.. rubric:: Supported platforms - -* :doc:`GNULinux-GNAT` -* :doc:`Windows-MinGW-GNAT` -* Mac OS - -.. toctree:: - :hidden: - - GNU/Linux with GCC/GNAT <GNULinux-GNAT> - Windows with GCC/GNAT (MinGW) <Windows-MinGW-GNAT> |