docs: even further simplify and reformat install.html

docs: format install.html into HTML format

docs: a bunch of updates to simplify the process of installing from source and running Tahoe
These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files
are complete and should work (and they are delightfully concise!).  I'm pushing this just to let people see incremental progress
and to solicit feedback.  "Testing out" the install.html and running.html files and submitting patches or bug reports would be
quite welcome.

More to come.

docs: a few updates, edits, and formatting tweaks to README.win32

refactor webish.py slightly, improve the test coverage a bit. One test is marked SKIP pending improvements in webish.py

test_web.py: fix pyflakes error

webish: use get_args() everywhere, put .fields=None in MyRequest

test_web: more coverage of URIPOSTHandler error cases

test_web: test POST_upload_no_link against /uri, not /uri/

test_web.py: use /uri?t=mkdir instead of /uri/?t=mkdir, and confirm that the redirection target is correct

webish: factor out queryargs-or-formargs extraction, make /uri?t=mkdir work and redirect to a valid url

node.py: remove the provoke-logport-furlfile-creation hack now that foolscap-0.2.3 does it for us, and add bridge-twisted-logs

upgrade to foolscap-0.2.3

Makefile: put an existing PYTHONPATH in front of our generated EGGSPATH, to make it easier to test tahoe against development versions of dependent libraries

setup: allow shell built-ins "true" and "false" so that I can experiment with deb builders on an OSX box.  ;-)

setup: fix bug in bugfix to patch to include .egg's found in CWD

setup: fix bug in previous patch to include .egg's from CWD

setup: we also need to include .egg's in the CWD in our search path, because if we install a 3rd party library into support/, and *it* installs a library that *it* requires, that one will appear in CWD
It would be nice to figure out a way to force them to all appear in support/ where they belong.

setup: zope.interface bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: upgrade bundle zfec-1.1.tar.gz to zfec-1.3.4.tar

setup: simplejson bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: upgrade bundle from setuptools_darcs-1.0.6.tar.gz to setuptools_darcs-1.1.5.tar

setup: bundle pyutil-1.3.12.tar

setup: pycryptopp: bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: foolscap bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: bundle argparse-0.8.0.tar
It isn't actually needed for Tahoe, only for the command-line tools from pyutil.  Later I will make an "extras" category within pyutil to specify in a machine-readable way that argparse is not required for pyutil unless you want the command-line tools.

setup: Nevow bundle .tar instead of .tar.gz because multiple bundled .tar's compress together much more nicely than multiple bundled .tar.gz's do.  :-)

setup: update doc in __init__.py

setup: small tidy-up of Make rules

setup: refactor ez_setup.py and setup.py to satisfy the Desert Island scenario, to find and use setuptools egg in-place in misc/dependencies, and make it setup_require pyutil (for darcsver)

setup: copy in the latest version of ez_setup.py, which works even if setuptools is already imported, or can be imported, into the current Python interpreter, but can't be imported into a new Python interpreter in a subprocess
This actually happens in practice -- this fixes the Desert Island scenario.  Thanks to PJE.

setup: bundle setuptools_darcs plugin in misc/dependencies

setup: new name for setuptools_darcs plugin is also boring

setup: finish switching from Tahoe's versions of autoversioning tools to pyutil's versions

setup: remove misc/make-version.py and invoke "darcsver" from the pyutil library
misc/make-version.py has a limitation which prevents it from generating version
stamps from our current darcs history.  This limitation has been fixed in
pyutil's "darcsver".  Rather than copy the fix from there to
misc/make-version.py, I'm making it so that you have to install pyutil if you
want to automatically generate _version.py files from the current darcs
history.

setup: fix scheme ("file:") for download base for boostrapping setuptools

setup: fix typo in name of download base for bootstrapping setuptools

setup: fix the name of "misc/dependencies" for bootstrapping setuptools

setup: use os.path.join('misc', 'dependencies') instead of "misc/dependencies"
In the hopes that this will make the boostrapping of setuptools from its bundled egg work on Windows.

webish: add button to make directories and unit test of it
Unfortunately although it passes the unit tests, it doesn't work, because the unit tests and the implementation use the "encode params into URL" technique but the button uses the "encode params into request body" technique.

make the unit test of the overwrite button more general

make the wapi/wui [*] support creation of a new directory without there already being an existing directory to link the new one into

[*] WebAPI/WebUI

mutable: always include ourselves in the querylist when Publishing, because 0.7.0 usually stores our root dirnode only on ourselves, and our nodeid might not appear in the first N+epsilon peers

mutable.py: one more logging fix

mutable.py: oops, our logging wrappers can't take posargs yet

mutable.Publish: improve logging

dirnode: add set_uris() and set_nodes() (plural), to set multiple children at once. Use it to set up a new webapi test for issue #237.

node: provoke foolscap-0.2.2 into saving logport.furl, so we can attach to it with 'flogtool dump'. Also, place it in private/, since logs are considered somewhat private

fix representation of node ids in PeerTracker objects

remove some no-longer needed replacements of "/" with "!" in uris

more new-pyflakes warnings fixed

the new pyflakes is stricter, complaining about function definitions that overshadow earlier definitions or imports. Fix some of its complaints.

hush pyflakes

create_node.py: need to create private/ dir in create-client so we can touch the my_private_dir.cap file

oops, touch private/my_private_dir.cap when creating the client

check_load: add stats-gathering

add a simple load-generating tool to do random reads and writes

move my_private_dir.cap into private/

my_private_dir.cap: add newline for readability, open with mode 'w' not 'w+' since we don't need to read from this filehandle

remove the slash-to-bang conversion from CLI tools and webapi.txt

unit test that POST /uri/?t=mkdir works

remove the DirnodeURI foolscap schema and mv those regexes into uri.py
We currently do not pass dirnode uris over foolscap.

make more precise regexp for WriteableSSKFileURI and DirnodeURI and use it in unit tests
Also allow an optional leading "http://127.0.0.1:8123/uri/".
Also fix a few unit tests to generate bogus Dirnode URIs of the modern form instead of the former form.

fix unit tests to assert that we do *not* link to start.html when there is no private dir, instead of asserting that we *do*

do not put a link from the welcoXme page to the start.html if there is not a private directory

rename "my_private_dir.uri" to "my_private_dir.cap"

rename "secret" to "lease_secret" and change its size from 16 to 32 bytes

put all private state in $BASEDIR/private
fixes #219

The only part of #219 that this doesn't include is the part about
logpublisher, which has been moved out of tahoe into foolscap.

we no longer need to replace "/" with "!" in urls

tidy-up some comments and logging messages

fix the overwrite button and add unit test for it

test_system.py: oops, match change in RIControl

test_web.py: cosmetic, remove leftover trailing space

check-speed: test SSK upload/download speed too. SDMF imposes a limit on the file sizes, no 10MB or 100MB test

Makefile check-speed: force-quit any leftover client before starting a new test

remove logpublisher, use the Foolscap version now that this functionality has been moved into Foolscap-0.2.2

remove tests of logging functionality that's been subsumed by foolscap logging

move to foolscap-0.2.2

remove unimplemented and skipped test for feature that we don't plan to implement any time soon (XML-RPC interface)

remove unused import: thanks, pyflakes

refactor the feature of getting versions of packages, include the version numbers of more of the packages that we use

a few documentation and naming convention updates
Notable: the argument to make REPORTER has been renamed to TRIALARGS.

editing: change names like "MyThing" to "FakeThing" for fake objects in unit tests

fix unit test to pass forward-slashes to the CLI since it demands that the CLI emit forward-slashes

test_web.py: survive localdir/localfile= names with spaces. Should close #223

test_system: write test data in 'b' verbatim mode, since on windows the default text-mode is different. Addresses one of the failures in #223

webish: append save=true to a GET URL to save-to-disk. Closes #222.

README.win32: add note showing MikeB where this file is making false statements :-)

README.win32: clarify layout a bit

fix import error, detected thanks to "make test"

fix missing import, thanks to pyflakes

fix test_introducer to wait for the right things in order to avoid intermittent test failures

setup.py: arg, another stupid paste error, affecting cygwin

upgrade to foolscap-0.2.1, with a new logging framework

fix IntroducerClient.when_enough_peers()
add IntroducerClient.when_few_enough_peers(), fix and improve test_introducer

setup.py: fix stupid cut-and-paste error

build-deps: require setuptools 0.6c4 or later, because older ones don't allow foolscap to use os.random at import time

control.py: hush pyflakes warning

the wait_for_numpeers= argument to client.upload() is optional: make both the code and the Interface reflect this

move increase_rlimits() into iputil and make it a no-op on Windows