************
Installation
************

.. highlight:: bash


License
=======

Para is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.

Para is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
:doc:`GNU General Public License <licence>` for more details.


Requirements
============

Para should work on almost every Unix-like system. More precisely, it
should work on every system that complies with POSIX.1-2008_, including
the X/Open System Interface and Spawn extensions. It has been tested
on Alpine Linux, Debian, Darwin, FreeBSD, NetBSD, and OpenBSD.

Compiling Para requires:

* A C compiler that supports C99_
  (e.g., GCC_ ≥ v4.3, Clang_ ≥ v1.0, or TinyCC_ ≥ v0.9)
* An assembler and a linker
  (e.g., from `GNU Binutils`_ or a BSD system)
* Make (`GNU Make`_ and BSD makes are known to work)
* The header files of your system's standard library

Para comes with a script that installs
these dependencies if needed.


Preparation
===========

Import my `PGP key`_, so that you can check whether
the tarball has been tampered with::

    gpg --keyserver keys.openpgp.org --recv-keys 6B06A2E03BE31BE9


Download
========

Download the tarball:

.. code-block:: bash
    :substitutions:

    curl -O https://codeberg.org/odkr/para/releases/download/v|release|/para-|release|.tgz

Check whether the tarball has been tampered with:

.. code-block:: bash
    :substitutions:

    curl -O https://codeberg.org/odkr/para/releases/download/v|release|/para-|release|.tgz.asc
    gpg --verify para-|release|.tgz.asc

Unpack the tarball:

.. code-block:: bash
    :substitutions:

    tar xzf para-|release|.tgz

Go to the package directory to proceed:

.. code-block:: bash
    :substitutions:

    cd para-|release|

.. tip::
    Subscribe to https://codeberg.org/odkr/para/releases.rss
    to be notified about new releases.


.. include:: ../INSTALL.rst