2023-10-13 10:14:00 +03:00
|
|
|
======================
|
|
|
|
BUILD AND INSTALLATION
|
|
|
|
======================
|
|
|
|
|
|
|
|
This document describes how to build, install, and test the GHCiTUI program.
|
|
|
|
|
2023-10-16 04:31:13 +03:00
|
|
|
GHCiTUI is configured, built, and installed through `Cabal`_. Cabal can be
|
|
|
|
installed through the ``ghcup`` command line tool. Familiarity with Cabal
|
|
|
|
is not necessary to build GHCiTUI.
|
2023-10-13 10:14:00 +03:00
|
|
|
|
|
|
|
------------------
|
|
|
|
Getting the source
|
|
|
|
------------------
|
|
|
|
|
|
|
|
Currently the source code is hosted on https://github.com. You can check out
|
|
|
|
the source code using ``git`` with SSH:
|
|
|
|
|
2023-12-10 05:11:02 +03:00
|
|
|
.. code-block:: shell
|
2023-10-13 10:14:00 +03:00
|
|
|
|
|
|
|
# SSH (for contributors, requires SSH set up)
|
|
|
|
git clone git@github.com:CrystalSplitter/ghcitui.git
|
|
|
|
|
|
|
|
Or HTTPS:
|
|
|
|
|
2023-12-10 05:11:02 +03:00
|
|
|
.. code-block:: shell
|
2023-10-13 10:14:00 +03:00
|
|
|
|
|
|
|
# HTTPS
|
|
|
|
git clone https://github.com/CrystalSplitter/ghcitui.git
|
|
|
|
|
|
|
|
--------
|
|
|
|
Building
|
|
|
|
--------
|
|
|
|
|
2023-10-16 04:31:13 +03:00
|
|
|
The GHCiTUI cabal configurations defaults to release builds in the
|
|
|
|
`cabal.project`_. Therefore, we can just run...
|
2023-10-15 08:05:11 +03:00
|
|
|
|
2023-12-10 05:11:02 +03:00
|
|
|
.. code-block:: shell
|
2023-10-15 08:05:11 +03:00
|
|
|
|
2023-10-28 11:09:16 +03:00
|
|
|
cabal build # Build library and executable (release mode)
|
|
|
|
cabal test # Run tests (optional)
|
|
|
|
cabal install # Per-user install (Nix-Style)
|
2023-10-16 04:31:13 +03:00
|
|
|
|
|
|
|
By default, this will place the ``ghcitui`` executable in
|
|
|
|
``$HOME/.cabal/bin``.
|
|
|
|
|
2023-10-28 11:09:16 +03:00
|
|
|
Contributors may find it useful to make their own
|
|
|
|
``cabal.project.local`` with ``cabal configure`` while debugging.
|
|
|
|
|
2023-10-16 04:31:13 +03:00
|
|
|
.. _Cabal: https://www.haskell.org/cabal/
|
|
|
|
.. _cabal.project: ./cabal.project
|