[tahoe-dev] wiki gardening needed Re: darcs patch: modified quickstart.html to note dependency on python-...

[Zooko O'Whielacronx]

Folks:

My intended design for the build scripts and install docs is not
really written down anywhere, so people like Josh and David-Sarah
don't realize that there are multiple ways to fix a bug like this one
and that adding this information to quickstart.html is not the way I
had preferred.

So, I decided to write down these details on the wiki so that people
would be able to find it, and when I looked at the wiki I found that
there are several different pages describing build/install/etc. which
give inconsistent stories:

http://tahoe-lafs.org/trac/tahoe-lafs/wiki/AdvancedInstall
http://tahoe-lafs.org/trac/tahoe-lafs/wiki/WindowsBuild
http://tahoe-lafs.org/trac/tahoe-lafs/wiki/DownloadDebianPackages
http://tahoe-lafs.org/trac/tahoe-lafs/wiki/Tutorial
http://tahoe-lafs.org/trac/tahoe-lafs/wiki/UbuntuPackaging
http://tahoe-lafs.org/trac/tahoe-lafs/wiki/Packaging

I'm going to try to do a bit of organizing and tidying these up right
now, but I'm about to crash and sleep for awhile, so if someone else
wants to take on the task of editing these wiki pages that would be
great! The sooner the better, since we're going to announce Tahoe-LAFS
v1.8.0-final tomorrow (2010-09-18) and our install docs on our wiki
will hopefully get a lot more readers. :-)

Regards,

Zooko

P.S. My strongest desire with regard to Josh's bug--that the build
failed when he ran "python setup.py build" on his system--is that we
get a deterministic, reproducible example of this bug hooked up to our
buildbot. This could be done with a tool like chroot or a tool like
pbuilder (which I believe is built on top of chroot) to make it so
that the "python setup.py build" command will fail (due to the lack of
python.h) even on a system which has the python-dev .deb package
installed, because the python-dev .deb package will not be installed
in the chroot. Then we would have a red test on our buildbot which
could be made green only by fixing this bug in the way that I want
quickstart.html to fix it--i.e. the way that works even if the user
does not install the python-dev debian package.