merge some minor conflicts in test code from the 393-2 branch and trunk

doc: eliminate the phrase "rootcap" from doc/frontends/FTP-and-SFTP.rst
Two different people have asked me for help, saying they couldn't figure out what a "rootcap" is. Hopefully just calling it a "cap" will make it easier for them to find out from the other docs what it is.

test_web.py: fix a test failure dependent on whether simplejson.loads returns a unicode or str object.

immutable/filenode: fix pyflakes warnings

test: fix assorted tests broken by MDMF changes

uri: add MDMF and MDMF directory caps, add extension hint support

test/test_mutable: tests for MDMF

These are their own patch because they cut across a lot of the changes
I've made in implementing MDMF in such a way as to make it difficult to
split them up into the other patches.

webapi changes for MDMF

    - Learn how to create MDMF files and directories through the
      mutable-type argument.
    - Operate with the interface changes associated with MDMF and #993.
    - Learn how to do partial updates of mutable files.

mutable/servermap: Rework the servermap to work with MDMF mutable files

dirnode: teach dirnode to make MDMF directories

Fix some test failures caused by #393 patch.

docs: amend configuration, webapi documentation to talk about MDMF

cli: teach CLI how to create MDMF mutable files

Specifically, 'tahoe mkdir' and 'tahoe put' now take a --mutable-type
argument.

frontends/sftpd: Resolve incompatibilities between SFTP frontend and MDMF changes

mutable/layout: Define MDMF share format, write tools for working with MDMF share format

The changes in layout.py are mostly concerned with the MDMF share
format. In particular, we define read and write proxy objects used by
retrieval, publishing, and other code to write and read the MDMF share
format. We create equivalent proxies for SDMF objects so that these
objects can be suitably general.

immutable/filenode: implement unified filenode interface

immutable/literal.py: Implement interface changes in literal nodes.

test/common: Alter common test code to work with MDMF.

This mostly has to do with making the test code implement the new
unified filenode interfaces.

mutable: train checker and repairer to work with MDMF mutable files

nodemaker: teach nodemaker about MDMF caps

client: teach client how to create and work with MDMF files

mutable/filenode: Modify mutable filenodes for use with MDMF

In particular:
    - Break MutableFileNode and MutableFileVersion into distinct classes.
    - Implement the interface modifications made for MDMF.
    - Be aware of MDMF caps.
    - Learn how to create and work with MDMF files.

nodemaker: teach nodemaker how to create MDMF mutable files

interfaces: change interfaces to work with MDMF

A lot of this work concerns #993, in that it unifies (to an extent) the
interfaces of mutable and immutable files.

mutable/publish: teach the publisher how to publish MDMF mutable files

Like the downloader, the publisher needs some substantial changes to handle multiple segment mutable files.

mutable/retrieve: rework the mutable downloader to handle multiple-segment files

The downloader needs substantial reworking to handle multiple segment
mutable files, which it needs to handle for MDMF.

Fix repeated 'the' in license text.

Remove Non-Profit Open Software License from the set of 'added permission' licenses. Although it actually does qualify as an Open Source license (because it allows relicensing under plain OSL), its wording is unclear and could easily be misunderstood, and it contributes to incompatible license proliferation.

docs: change links that pointed to COPYING.TGPPL.html to point to COPYING.TGPPL.rst instead

docs: formatting: reflow to fill-column 77

docs: formatting: M-x whitespace-cleanup

licensing: add to the list of licenses that we grant the added permission for
Added: most of the ones listed on the FSF's "List of Free Software, GPL Incompatible Licenses", plus the Non-Profit Open Software License.

docs: reflow the added text at the top of COPYING.GPL to fill-column 77

docs: reformat COPYING.TGPPL.html to COPYING.TGPPL.rst

docs: reflow docs/logging.rst to fill-column 77

doc: fix formatting error in docs/logging.rst

Cleanups for suppression of UserWarnings. refs #1435

suppress warning emitted by newer zope.interface with Nevow 0.10
refs #1435

doc: formatting: reflow to fill-column=77

_auto_deps.py: change the requirement for zope.interface to <= 3.6.2, >= 3.6.6. fixes #1435

allmydata/__init__.py, test_version.py: make version parsing understand '<=', with test. refs #1435

Makefile and setup.py: remove setup.py commands that we no longer need, and their uses in the Makefile. Delete a stale and incorrect comment about updating _version.py. Also fix some coding style checks in the Makefile to operate on all source files.

remove misc/debian[_helpers], rely upon official packaging instead. fixes #1454

Makefile: remove targets that used misc/debian[_helpers] which no longer exist. Also change docs/debian.rst to reflect the fact that we no longer support building .debs using those targets. refs #1454

replace tabs with spaces in the #1441 'tahoe debug' synopsis

Correct the information printed by '/usr/bin/tahoe debug --help' on Debian/Ubuntu. fixes #1441

doc: edit the explanation of K-of-N tradeoffs

doc: clean up formatting of doc/configuration.rst
reflow to 77 chars line width, M-x white-space cleanup, blank link between name and definition

Add test for webopen. fixes #1149

test_client.py: relax a check in test_create_drop_uploader so that it should pass on Python 2.4.x. refs #1429

test/common_util.py: correct fix to mkdir_nonascii. refs #1472

test/common_util.py: fix a typo. refs #1472

test_client.py, test_drop_upload.py: fix pyflakes warnings.

Factor out methods dealing with non-ASCII directories and filenames from test_drop_upload.py into common_util.py. refs #1429, #1472

test_client.py: add a test that the drop-uploader is initialized correctly by client.py. Also give the DropUploader service a name, which is necessary for the test. refs #1429

drop-upload: rename 'start' method to 'startService', which is what you're supposed to use to start a Service. refs #1429

test_drop_upload.py: add comment explaining why we don't use FilePath.setContent. refs #1429

test_drop_upload.py: fix some grammatical and spelling nits. refs #1429

drop-upload: report the configured local directory being absent differently from it being a file
refs #1429

drop-upload: rename the 'upload.uri' parameter to 'upload.dircap', and a couple of cleanups to error messages. refs #1429
I rerecorded this patch, originally by David-Sarah, to use "darcs replace" instead of editing to do the renames. This uncovered one missed rename in Client.init_drop_uploader. (Which also means that code isn't exercised by the current unit tests.)
refs #1429

drop-upload test for non-existent local dir separately from test for non-directory local dir
A candidate patch for #1429 has a bug when it is using FilePath.is_dir() to detect whether the configured local dir exists and is a directory. FilePath.is_dir() raises exception, instead of returning False, if the thing doesn't exist. This test is to make sure that DropUploader.__init__ raise different exceptions for those two cases.
refs #1429

drop-upload: unit tests for the configuration options being named "cap" instead of "uri"
This is a subset of a patch that David-Sarah attached to #1429. This is just the unit-tests part of that patch, and uses darcs record instead of hunks to change the names.
refs #1429

src/allmydata/storage/server.py: use the filesystem of storage/shares/, rather than storage/, to calculate remaining space. fixes #1384

test_storage.py: test that we are using the filesystem of storage/shares/, rather than storage/, to calculate remaining space, and that the HTML status output reflects the values returned by fileutil.get_disk_stats. This version works with older versions of the mock library. refs #1384

Work around ref #1472 by having test_drop_upload delete the non-ASCII directories it creates.

Remove all trailing whitespace from .py files.

test_drop_upload.py: fix unused imports. refs #1429

Documentation for drop-upload frontend. refs #1429

Drop-upload frontend, rerecorded for 1.9 beta (and correcting a minor mistake). Includes some fixes for Windows but not the Windows inotify implementation. fixes #1429

node.py: ensure that client and introducer nodes record their port number and use that port on the next restart, fixing a regression caused by #1385. fixes #1469.

test_runner.py: fix a race condition in the test when NODE_URL_FILE is written before PORTNUM_FILE. refs #1469

test_runner.py: cleanups of HOTLINE_FILE writing and removal.

test_runner.py: remove an unused constant.

node.py: fix the error path for a missing config option so that it works for a Unicode base directory.

test_runner.py: test that client and introducer nodes record their port number and use that port on the next restart. This tests for a regression caused by ref #1385.

test_runner.py: fix a bug in CreateNode.do_create introduced in changeset [5114] when the tahoe.cfg file has been written with CRLF line endings. refs #1385

test_client.py: repair Basic.test_error_on_old_config_files. refs #1385

test_checker.py: increase timeout for TooParallel.test_immutable again. The ARM buildslave took 38 seconds, so 40 seconds is too close to the edge; make it 80.

test_runner.py: fix RunNode.test_introducer to not rely on the mtime of introducer.furl to detect when the node has restarted. Instead we detect when node.url has been written. refs #1385

Further improve error message about old config files. refs #1385

Slightly improve error message about old config files (avoid unnecessary Unicode escaping). refs #1385

test_checker.py: increase timeout for TooParallel.test_immutable (was consistently failing on ARM buildslave).

Fix the bug that prevents an introducer from starting when introducer.furl already exists. Also remove some dead code that used to read old config files, and rename 'warn_about_old_config_files' to reflect that it's not a warning. refs #1385

test_runner.py: modify RunNode.test_introducer to test that starting an introducer works when the introducer.furl file already exists. refs #1385

verifier: correct a bug introduced in changeset [5106] that caused us to only verify the first block of a file. refs #1395

test_repairer: add a deterministic test of share data corruption that always flips the bits of the last byte of the share data. refs #1395

verifier: serialize the fetching of blocks within a share so that we don't use too much RAM

Shares are still verified in parallel, but within a share, don't request a
block until the previous block has been verified and the memory we used to hold
it has been freed up.

Patch originally due to Brian. This version has a mockery-patchery-style test
which is "low tech" (it implements the patching inline in the test code instead
of using an extension of the mock.patch() function from the mock library) and
which unpatches in case of exception.

fixes #1395

add docs about timing-channel attacks

'test-coverage' now needs PYTHONPATH=. to find TOP/twisted/plugins/

remove nodeid from WriteBucketProxy classes and customers
refs #1363

remove get_serverid() from ReadBucketProxy and customers, including Checker
and debug.py dump-share commands
refs #1363

reject old-style (pre-Tahoe-LAFS-v1.3) configuration files
Check for the existence of any of them and if any are found raise exception which will abort the startup of the node.
This is a backwards-incompatible change for anyone who is still using old-style configuration files.
fixes #1385

whitespace-cleanup

tests: use fileutil.write() instead of open() to ensure timely close even without CPython-style reference counting
Some of these already had an explicit close() but I went ahead and replaced them with fileutil.write() as well for the sake of uniformity.

Address Kevan's comment in #776 about Options classes missed when adding 'self.command_name'. refs #776, #1359

docs/frontends/webapi.rst: change some more instances of 'delete' or 'remove' to 'unlink', change some section titles, and use two blank lines between all sections. refs #776, #1104

cleanup: implement rm as a synonym for unlink rather than vice-versa. refs #776

docs/webapi.rst: address Kevan's comments about use of 'delete' on ref #1104

docs: some changes of 'delete' or 'rm' to 'unlink'. refs #1104

WUI: change the label of the button to unlink a file from 'del' to 'unlink'. Also change some internal names to 'unlink', and allow 't=unlink' as a synonym for 't=delete' in the web-API interface. Incidentally, improve a test to check for the rename button as well as the unlink button. fixes #1104