Ticket #961: debian-docs-patch-final.txt

Thu Mar  4 00:59:55 PST 2010  jacob@appelbaum.net
  * debian-docs-patch-final

Thu Mar  4 16:30:04 PST 2010  jacob@appelbaum.net
  * Debian documentation update

New patches:

[debian-docs-patch-final
jacob@appelbaum.net**20100304085955] {
hunk ./docs/debian.txt 38
+We need to build a pyutil package:
+
+    wget http://pypi.python.org/packages/source/p/pyutil/pyutil-1.6.1.tar.gz
+    tar -xvzf pyutil-1.6.1.tar.gz 
+    cd pyutil-1.6.1/
+    python setup.py --command-packages=stdeb.command sdist_dsc
+    cd deb_dist/pyutil-1.6.1/
+    dpkg-buildpackage -rfakeroot -uc -us
+    sudo dpkg -i ../python-pyutil_1.6.1-1_all.deb
+
+We also need to install argparse and zbase32:
+
+    easy_install argparse
+    easy_install zbase32
+
hunk ./docs/debian.txt 55
-   # You may not already have Brian's key:
-   # gpg --recv-key 0x1514A7BD
-   wget http://foolscap.lothar.com/releases/foolscap-0.5.0.tar.gz.asc
-   wget http://foolscap.lothar.com/releases/foolscap-0.5.0.tar.gz
-   gpg --verify foolscap-0.5.0.tar.gz.asc
-   tar -xvzf foolscap-0.5.0.tar.gz 
-   cd foolscap-0.5.0/
-   python setup.py --command-packages=stdeb.command sdist_dsc
-   cd deb_dist/foolscap-0.5.0/
-   dpkg-buildpackage -rfakeroot -uc -us
-   sudo dpkg -i ../python-foolscap_0.5.0-1_all.deb 
+    # You may not already have Brian's key:
+    # gpg --recv-key 0x1514A7BD
+    wget http://foolscap.lothar.com/releases/foolscap-0.5.0.tar.gz.asc
+    wget http://foolscap.lothar.com/releases/foolscap-0.5.0.tar.gz
+    gpg --verify foolscap-0.5.0.tar.gz.asc
+    tar -xvzf foolscap-0.5.0.tar.gz 
+    cd foolscap-0.5.0/
+    python setup.py --command-packages=stdeb.command sdist_dsc
+    cd deb_dist/foolscap-0.5.0/
+    dpkg-buildpackage -rfakeroot -uc -us
+    sudo dpkg -i ../python-foolscap_0.5.0-1_all.deb 
}

[Debian documentation update
jacob@appelbaum.net**20100305003004] {
hunk ./docs/debian.txt 5
+This document attempts to explain how to complete a desert island build for
+people in a hurry. It also attempts to explain more about our Debian packaging
+for those willing to read beyond the simple pragmatic packaging exercises.
hunk ./docs/debian.txt 11
-There are only two supporting packages that are currently not available from
-the debian apt repositories in Debian Lenny: python-foolscap python-zfec
+There are only four supporting packages that are currently not available from
+the debian apt repositories in Debian Lenny:
+
+    python-foolscap python-zfec argparse zbase32
hunk ./docs/debian.txt 18
-    apt-get install -y build-essential debhelper cdbs python-central \
+    sudo apt-get install -y build-essential debhelper cdbs python-central \
hunk ./docs/debian.txt 21
-                    python-simplejson  python-pycryptopp devscripts
+                    python-simplejson  python-pycryptopp devscripts \
+                    apt-file
+    sudo apt-file update
hunk ./docs/debian.txt 28
-    apt-get install python-all-dev
-    STDEB_VERSION="0.3.2"
-    http://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
+    sudo apt-get install python-all-dev
+    STDEB_VERSION="0.5.1"
+    wget http://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
hunk ./docs/debian.txt 57
-    easy_install argparse
-    easy_install zbase32
+    sudo easy_install argparse # argparse won't install with stdeb (!) :-(
+    sudo easy_install zbase32 # XXX TODO: package with stdeb
hunk ./docs/debian.txt 89
-supported libraries as .deb packages.
+supported libraries as .deb packages. You'll need to edit the Debian specific
+/etc/defaults/allmydata-tahoe file to get Tahoe started. Data is by default
+stored in /var/lib/tahoelafsd/ and Tahoe runs as the 'tahoelafsd' user.
}

Context:

[CREDITS to Jacob Appelbaum
zooko@zooko.com**20100304015616
 Ignore-this: 70db493abbc23968fcc8db93f386ea54
] 
[desert-island-build-with-proper-versions
jacob@appelbaum.net**20100304013858] 
[docs: a few small edits to try to guide newcomers through the docs
zooko@zooko.com**20100303231902
 Ignore-this: a6aab44f5bf5ad97ea73e6976bc4042d
 These edits were suggested by my watching over Jake Appelbaum's shoulder as he completely ignored/skipped/missed install.html and also as he decided that debian.txt wouldn't help him with basic installation. Then I threw in a few docs edits that have been sitting around in my sandbox asking to be committed for months.
] 
[TAG allmydata-tahoe-1.6.1
david-sarah@jacaranda.org**20100228062314
 Ignore-this: eb5f03ada8ea953ee7780e7fe068539
] 
Patch bundle hash:
a7352d344f8781868b88cd0e60a3ab6e90456d05