summaryrefslogtreecommitdiff
path: root/doc/source
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2014-02-19 00:39:51 +0100
committermathieui <mathieui@mathieui.net>2014-02-19 00:39:51 +0100
commitcd385630765a8089cc3d234ff9bbfa899e803a3f (patch)
tree640c137369e3519e9535038b4dbc88a26b082810 /doc/source
parent35f3f53334461eba1a579b69470ca1af40b446dd (diff)
downloadpoezio-cd385630765a8089cc3d234ff9bbfa899e803a3f.tar.gz
poezio-cd385630765a8089cc3d234ff9bbfa899e803a3f.tar.bz2
poezio-cd385630765a8089cc3d234ff9bbfa899e803a3f.tar.xz
poezio-cd385630765a8089cc3d234ff9bbfa899e803a3f.zip
Update install instructions and fix a typo
Diffstat (limited to 'doc/source')
-rw-r--r--doc/source/install.rst127
1 files changed, 82 insertions, 45 deletions
diff --git a/doc/source/install.rst b/doc/source/install.rst
index 870dcb8b..07211e67 100644
--- a/doc/source/install.rst
+++ b/doc/source/install.rst
@@ -1,7 +1,6 @@
Installing poezio
=================
-
.. important:: Python 3.2 or better is highly recommended, as we do not
officially support python 3.1 (although we do try to keep things running).
@@ -16,87 +15,124 @@ using one of these.
AUR wrapper to install them)
- *Gentoo*: `Sekh’s overlay`_ contains everything required to build poezio
(sleekxmpp, dnspython, and poezio)
+- *Fedora*: The poezio package was out of date for a long time in Fedora, but
+ now thanks to Casper, there is an `up-to-date package`_ in the repos since F19.
- *Debian*: Use an other distro. (or make a package, we can provide help :) )
-(If an other distribution provides a poezio package, please tell us and we will
+(If another distribution provides a poezio package, please tell us and we will
add it to the list)
Install poezio from the sources
-------------------------------
-You can download poezio's `stable sources`_, or fetch the development
-version (trunk), using git:
+.. note:: The ``make`` command is always required, because while we could provide
+ the compiled file into the archive, the ABI changes and platform variety would
+ make it sure that the list of archives is either incomplete or wrong.
-.. code-block:: bash
+ Packagers are of course welcome to compile the file and include it in their
+ architecture-specific and fixed-python packages.
- git clone git://git.poez.io/poezio
-In order for poezio to correctly work, you need the libs SleekXMPP and
-dnspython. You can install them by downloading it from the `SleekXMPP`_
-page and the `dnspython`_ page , but you'll need the development
-version of SleekXMPP. Alternatively, you can download poezio's sources
-including SleekXMPP and dnspython, that's the easier way.
+Stable version
+~~~~~~~~~~~~~~
-""""""""""""
-Dependencies
-""""""""""""
+`Stable version`_ packages are available. the ``python3-devel`` package or similar
+is required.
+
+If you take the standalone package with all the deps, you only need to run ``make``
+to have a working poezio install.
-.. note:: If your python3 version is too old because of debian (e.g. < 3.2), you
- should install the python3-argparse package if it exists, or use
- pip3/virtualenvs to install it.
+If you don’t, please scroll down to the dependencies.
-If you want to install SleekXMPP and dnspython by yourself, use the following
-instructions. Else, go to the :ref:`next section <poezio-install-label>` (recommended).
+Development version
+~~~~~~~~~~~~~~~~~~~
-Download SleekXMPP
+The stable versions of poezio are more like snapshots of states of
+development we deem acceptable. There is always an incentive to
+use the development version, like new features, bug fixes, and more
+support. Therefore, you might want to use the git version.
.. code-block:: bash
- git clone git://github.com/fritzy/SleekXMPP.git
+ git clone git://git.poez.io/poezio
+ cd poezio
+ make
-Make sure you're using the develop branch by typing
+Dependencies
+~~~~~~~~~~~~
-.. code-block:: bash
+"""""""
+General
+"""""""
- cd SleekXMPP
- git checkout develop
+Poezio is a python3-only application, so you will first need that, preferably
+in the latest available version, down to 3.2.
-Install SleekXMPP with
+.. note:: Python 3.1 is not officially supported and tested, but should
+ work (if it doesn’t, we can fix it if the fix does not require ugly
+ modifications). In this case, you will want to install the
+ python3-argparse package if it exists, or use pip3/virtualenvs to
+ install it.
-.. code-block:: bash
+You will first need python3-devel, or whatever your distribution named it, along
+with standard utilities such as make.
- python3 setup.py build
- su -c "python3 setup.py install"
+Poezio depends on two libraries:
-Install the dnspython3 package on your distribution or install it manually:
+- DNSPython_ (the python3 version, often called dnspython3)
+- SleekXMPP_
+
+If you do not want to install those libraries, you can skip directly to
+the :ref:`installation part <poezio-install-label>`
+
+
+"""""""""
+DNSPython
+"""""""""
+
+It should be available right now in most software repositories, under the name
+``python3-dnspython`` or ``python3-dnspython3``. Any stable version should fit.
+
+For a manual install:
.. code-block:: bash
- wget -O dnspython.tgz http://www.dnspython.org/kits3/1.10.0/dnspython3-1.10.0.tar.gz
- tar xvf dnspython.tgz
- cd dnspython3-1.10.0
+ wget -O dnspython.tar.gz http://www.dnspython.org/kits3/1.11.1/dnspython3-1.11.1.tar.gz
+ tar xvf dnspython.tar.gz
+ cd dnspython3-1.11.1
+ python3 setup.py build
+ python3 setup.py install --user
+
+""""""
+SleekXMPP
+""""""
-And do the same again:
+Poezio now depends on SleekXMPP 1.2. if your distribution does not provide it yet,
+you can install it this way:
.. code-block:: bash
+ wget https://github.com/fritzy/SleekXMPP/archive/1.2.0.tar.gz
+ tar xvf 1.2.0.tar.gz
+ SleekXMPP-1.2.0
python3 setup.py build
- su -c "python3 setup.py install"
+ python3 setup.py install --user
+
.. _poezio-install-label:
-"""""""""""""""""""
-poezio installation
-"""""""""""""""""""
+Installation
+~~~~~~~~~~~~
.. note::
The update.sh + launch.sh method is the recommended way of using and upgrading
- poezio.
+ the devel version of poezio. Installing should only be done with stable versions.
-If you skipped the installation of the dependencies and you only want to test
-poezio without a system-wide install, do, in the *poezio* directory:
+
+If you skipped the installation of the dependencies and you only want to run
+poezio without a system-wide install, do, in the :file:`poezio` directory:
.. code-block:: bash
@@ -106,14 +142,14 @@ If you have git installed, it will download and update locally the
libraries for you. (and if you don’t have git installed, install it)
-If you don't want to install poezio but just test it (or keep a development
-version), do:
+To run poezio directly from the directory, do:
.. code-block:: bash
./launch.sh
-To install poezio, do, as root (or sudo with ubuntu or whatever):
+
+If you really want to install it, run as root (or sudo in ubuntu or whatever):
.. code-block:: bash
@@ -128,6 +164,7 @@ And then start it with:
.. _Sekh’s overlay: https://github.com/sekh/sekh_overlay
.. _stable sources: https://dev.louiz.org/project/poezio/download
.. _SleekXMPP: https://github.com/fritzy/SleekXMPP/
-.. _dnspython: http://www.dnspython.org/
+.. _DNSPython: http://www.dnspython.org/
.. _poezio: https://aur.archlinux.org/packages/poezio/
.. _poezio-git: https://aur.archlinux.org/packages/poezio-git/
+.. _up-to-date package: https://apps.fedoraproject.org/packages/poezio