Ticket #978: debian-tldr-second-try.txt

Wed Mar  3 15:33:47 PST 2010  jacob@appelbaum.net
  * debian docs, the too long; didn't read version

Wed Mar  3 17:20:04 PST 2010  jacob@appelbaum.net
  * Full desert island build instructions

New patches:

[debian docs, the too long; didn't read version
jacob@appelbaum.net**20100303233347] hunk ./docs/debian.txt 6
+== TL;DR package building instructions ==
+
+If you want to build your own Debian packages from the darcs tree or from 
+a source release, do the following:
+
+    apt-get install -y build-essential debhelper cdbs python-central \
+                    python-setuptools python python-dev python-twisted-core \
+                    fakeroot darcs
+    cd ~/
+    mkdir src && cd src/
+    darcs get --lazy http://allmydata.org/source/tahoe-lafs/trunk tahoe-lafs
+    cd tahoe-lafs
+    # set this for your Debian release name (lenny, sid, etc)
+    make deb-lenny
+    # You must have your dependency issues worked out by hand for this to work
+    sudo dpkg -i ../allmydata-tahoe_0.0.1_all.deb
+

[Full desert island build instructions
jacob@appelbaum.net**20100304012004] {
hunk ./docs/debian.txt 6
-== TL;DR package building instructions ==
+== TL;DR supporting package building instructions ==
hunk ./docs/debian.txt 13
-                    fakeroot darcs
+                    fakeroot darcs python-twisted python-nevow \
+                    python-simplejson  python-pycryptopp
+
+
+To create packages for Lenny, we'll also install stdeb:    
+
+    apt-get install python-all-dev
+    STDEB_VERSION="0.3.2"
+    http://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
+    tar xzf stdeb-$STDEB_VERSION.tar.gz
+    cd stdeb-$STDEB_VERSION
+    python setup.py --command-packages=stdeb.command bdist_deb
+    sudo dpkg -i deb_dist/python-stdeb_$STDEB_VERSION-1_all.deb
+
+Now we're ready to build and install the zfec Debian package:
+
+    darcs get http://allmydata.org/source/zfec/trunk zfac
+    cd zfac/zfec/
+    python setup.py sdist_dsc
+    cd `find deb_dist -mindepth 1 -maxdepth 1 -type d` && \
+    dpkg-buildpackage -rfakeroot -uc -us
+    sudo dpkg -i ../python-zfec_1.4.6-r333-1_amd64.deb
+
+Finally, we'll fetch, unpack, build and install foolscap:
+
+   # 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 
+
+== TL;DR package building instructions for Tahoe ==
+
+If you want to build your own Debian packages from the darcs tree or from 
+a source release, do the following:
+
hunk ./docs/debian.txt 64
+You should now have a functional desert island build of Tahoe with all of the
+supported libraries as .deb packages.
+
}

Context:

[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:
7c17024478a906c4b5f62059a3fc7778974f82d5