Git-Mirrors/Reticulum
1
0
Fork 0
mirror of https://github.com/markqvist/Reticulum.git synced 2025-05-02 06:36:14 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated documentation

Browse source
This commit is contained in:
Mark Qvist 2023-05-04 23:30:27 +02:00
parent 5e5d89cc92
commit da7a4433c0
6 changed files with 13 additions and 114 deletions
Download patch file Download diff file Expand all files Collapse all files

43
docs/source/gettingstartedfast.rst
View file

@ -25,30 +25,13 @@ and install them offline using ``pip``:
.. code::
pip install ./rns-0.4.6-py3-none-any.whl
pip install ./rns-0.5.1-py3-none-any.whl
Resolving Dependency & Installation Issues
=============================================
On some platforms, there may not be binary packages available for all dependencies, and
``pip`` installation may fail with an error message. Most often, this is simply due to
the ``netifaces`` package not having a pre-compiled package available via ``pip``.
Usually, this can be resolved by simply installing ``netifaces`` via the system package
manager:
.. code::
# Debian / Ubuntu / Derivatives
sudo apt install python3-netifaces
# Arch / Manjaro / Derivatives
sudo pamac install python3-netifaces
# Fedora
sudo dnf install python3-netifaces
More rarely, other dependencies cannot be resolved. In these cases, the issue can usually
``pip`` installation may fail with an error message. In these cases, the issue can usually
be resolved by installing the development essentials packages for your platform:
.. code::
@ -308,7 +291,7 @@ For extended functionality, you can install optional dependencies:
.. code::
pip3 install pyserial netifaces
pip3 install pyserial
Further information can be found in the :ref:`API Reference<api-main>`.
@ -323,7 +306,7 @@ don't use pip, but try this recipe:
.. code::
# Install dependencies
pip3 install cryptography pyserial netifaces
pip3 install cryptography pyserial
# Clone repository
git clone https://github.com/markqvist/Reticulum.git
@ -461,24 +444,6 @@ it will require manually configuring and installing some packages, and is not
detailed in this manual.
Fedora
^^^^^^^^^^^^^^^^^^^^^^^^
On Fedora, ``pip`` installation may fail with an error message, since the ``netifaces``
package cannot be installed natively via ``pip``. This can be resolved by installing
the ``python3-netifaces`` package via ``dnf`` first:
.. code::
sudo dnf install python3-netifaces
Alternatively, you can install basic development packages, which will allow
``pip`` to install any required packages from source:
.. code::
sudo dnf groupinstall "Development Tools" "Development Libraries"
Debian Bookworm
^^^^^^^^^^^^^^^^^^^^^^^^
On versions of Debian released after April 2023, it is no longer possible