Debianize PyAFS.
[invirt/packages/python-afs.git] / README
diff --git a/README b/README
index b88ab17..dc1dbd9 100644 (file)
--- a/README
+++ b/README
@@ -2,17 +2,21 @@
 Installing PyAFS
 ================
 
 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
 
 
   $ easy_install Cython
 
-Once you've done that, to install PyAFS globally, run
+Once you've done that, to install PyAFS globally, run::
 
   $ python setup.py install
 
 If you want to build PyAFS without installing it globally, you may
 
   $ python setup.py install
 
 If you want to build PyAFS without installing it globally, you may
-want to run:
+want to run::
 
   $ python setup.py build_ext --inplace
 
 
   $ python setup.py build_ext --inplace
 
@@ -20,4 +24,16 @@ which will build the C extensions in place next to their source,
 allowing you to import the various modules, so long as your current
 working directory is the root of the PyAFS source tree.
 
 allowing you to import the various modules, so long as your current
 working directory is the root of the PyAFS source tree.
 
+Alternatively, PyHesiod 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/
 .. _Cython: http://cython.org/