add README file

1 files changed, 46 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..b725cf8
--- /dev/null
+++ b/README
@@ -0,0 +1,46 @@
+This repository is used for building the python-gnutls version 1.1.9 .deb package for debian and ubuntu.
+
+We are maintaining this outdated version because there is a bug with the newer ubuntu package,
+and an application (leap-client-springbok package) that we are developing has this version as a dependency.
+
+Building the package
+-------------------------
+
+1. set up environment variables, making sure the full name and email exactly match the GPG key used to sign:
+$ export DEBFULLNAME="Your Name"
+$ export DEBEMAIL="Your.Email@address.here"
+
+2. Download the tarball from http://pypi.python.org/pypi/python-gnutls/1.1.9 
+
+3. Unpack the tarball
+
+4. cd into the source directory
+
+5. run dh_make:
+$ dh_make -s -f ../python-gnutls-1.1.9.tar.gz -e <Your.Email@address.here> -p python-gnutls -c gpl3 
+
+6. edit the debian/control file using the following fields:
+
+    Source: python-gnutls
+    Section: python 
+    Priority: optional 
+    Maintainer: Your Name <Your.Email@address.here>
+    Build-Depends: cdbs (>= 0.4.47), debhelper (>= 5.0.42), python-all-dev (>= 2.5), python-support, libgnutls-dev (>= 2.4.1) 
+    Standards-Version: 3.8.4
+    Homepage: http://pypi.python.org/pypi/python-gnutls/1.1.9 
+    
+    Package: python-gnutls
+    Architecture: any
+    Depends: ${python:Depends}, ${misc:Depends}, ${shlibs:Depends}, libgnutls26 (>= 2.4.1)
+    Provides: ${python:Provides}
+    Description: Python wrapper for the GNUTLS library
+
+7. edit the debian/copyright file
+
+8. specify supported python versions:
+$ echo "2.6-" > debian/pyversions
+
+9. [TODO] edit the debian/changelog file
+
+10. run debuild
+$ debuild