Installing PyAFS
================
-To install PyAFS, you will first need to install Cython_, which you
-can do by running::
+To install PyAFS, you will first need to install Cython_. It's always
+a good idea to install Cython through your package manager, if
+possible. Your system's Cython package may be named ``cython`` or
+``cython-py25``. If your package manager doesn't have a package for
+Cython, or if you wish to install Cython by hand anyway, you can do so
+by running::
$ easy_install Cython
allowing you to import the various modules, so long as your current
working directory is the root of the PyAFS source tree.
+Alternatively, PyAFS has been packaged for Debian and Ubuntu. To build
+the Debian package of the latest release, run::
+
+ $ git checkout debian
+ $ git buildpackage
+ $ sudo debi
+
+You will need the devscripts and git-buildpackage packages installed,
+as well as this package's build dependencies (cdbs, debhelper,
+python-all-dev, python-support, python-pyrex, python-setuptools,
+libopenafs-dev).
+
.. _Cython: http://cython.org/