Warn about ambiguities on "client" and "gateway" terms

Merge pull request #69 from zooko/1948-fix-warnings-from-make-doc-checks-3

1948 fix warnings from make doc checks 3

change more links to footnote-style

update link to Maildir tips (thanks MK_FG)

fix warnings from rst2html

Apparently the in-line link syntax with "<>" in them causes these warnings. I
don't know why. I changed them all to a slightly more verbose syntax.

Thanks to Mike Kazantzsev's review comment
(https://github.com/tahoe-lafs/tahoe-lafs/pull/67#commitcomment-4561370), I
moved the links to the end of each section.

magic first line tells emacs to use utf8+bom

Add ".. -*- coding: utf-8-with-signature -*-" to the first line of each .rst
file. This tells emacs to treat the file contents as utf-8, and also to prepend
a so-called utf-8 "bom" marker at the beginning of the file. This patch also
prepends those markers to each of those files.

Fix typo pointed out by CptPlastic.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

Makefile: update comment for 'make clean'.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

Merge pull request #64 from daira/2092-distclean

Add 'make distclean'.

Add 'make distclean'.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

Merge pull request #63 from zooko/2092-make-clean-shouldnt-remove-allmydata-tahoe-egg-info

remove tahoe egg-info dir from the "clean" rule

remove tahoe egg-info dir from the "clean" rule

fixes #2092

Add quotes around command lines in quickstart.rst.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

Merge pull request #62 from zooko/master

fix a couple more "file:" links

Merge pull request #61 from zooko/fix-small-formatting-issues-in-docs

fix small issues in formatting

fix a couple more "file:" links

Making them be just links to "$FILENAME" instead of to "file:$FILENAME" causes
them to be working links on trac and on github. Yay!

fix small issues in formatting

* fix warning from "rst2html --verbose" by not using the in-line hyperlink
  syntax. The warning said::

    known_issues.rst:261: (INFO/1) Hyperlink target "google chart api" is not referenced.

* remove dead code (no-longer-referenced link), thus fixing another warning

* change links to relative files to be just $FILENAME instead of
  file:$FILENAME, which I think will fix the problem of broken links on the
  trac and github, e.g. the link in
  https://tahoe-lafs.org/trac/tahoe-lafs/browser/trunk/docs/known_issues.rst ,
  which ought to go to
  https://tahoe-lafs.org/trac/tahoe-lafs/browser/trunk/docs/cautions.rst , but
  instead goes to file:///cautions.rst

misc/build_helpers/gen-package-table.py: show Python 2.6 as unsupported on Windows.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

Tweak Travis IRC notification settings.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Customize Travis notifications.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Add Travis configuration.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

tahoe debug trial: print a warning message if testing uncommitted code. fixes #1992

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Merge pull request #57 from markberger/1842-lease-tradeoff.svg-overlapping

Fixes the overlapping text in docs/lease-tradeoffs.svg

Merge pull request #48 from markberger/740-cli-accept-multiple-aliases

740 cli accept multiple aliases

Fixes the overlapping text in docs/lease-tradeoffs.svg

This fixes ticket #1842. Patch courtesy of PRabahy.

Added test_check_with_multiple_aliases in test_cli

Allows check and deep-check to take multiple arguments (ticket #740)

Fix a pyflakes import warning.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

src/allmydata/uri.py: Remove unused 'human encoding' methods, and associated tests. fixes #1807

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Ignore .*.kate-swp and /*.patch files.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

Ignore .DS_Store files

Add a link in accounting-overview.txt to ticket #666.

test_iputil.py: fix and improve tests on Windows.
Test all platform variants (Unix, Windows, Cygwin) on each platform.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

test_iputil.py: repair a test for cygwin (which is intended to behave differently).

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

iputil.py: simplify address finding code on cygwin.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

test_iputil.py: use more realistic error for 'command not found' in mock.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

test_iputil.py: repair a test by mocking 'get_local_ip_for'.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

iputil.py: add tests for recent changes. refs #1381, #1988, #982, #1064, #1536, #1935, #898, #1707, #1918

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

iputil.py: fix an error handling bug. refs #1381

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

iputil.py: minor cleanup to avoid dropping a Deferred.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

iputil.py: refactor address-finding code to treat all Unices the same.
refs #1988, #982, #1064, #1536, #1935
fixes #898, #1707, #1918

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

iputil.py: retry address queries on EINTR. fixes #1381

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Makefile: remove 'install' target. fixes #1717

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

WUI: add time page was rendered to client and introducer welcome pages. closes #1972

Author: Leif Ryge <leif@synthesize.us>
Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

properly describe saving incident reports. closes #1974

Improvements to test refs #1742

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Add a test for raising NotEnoughSharesError when a Retrieve object is created with an insufficient servermap. refs #1742

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Include the number of remaining shares of the right version in NotEnoughSharesError messages.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

mutable/retrieve.py: improve comments. refs #1742

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Raise NotEnoughSharesError if there are initially not enough shares for a mutable retrieve. refs #1742

We also change the order of setting up attributes in Retrieve so that _raise_notenoughshareserror() can be called from _setup_download.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

mutable/retrieve.py: inline the single-use function _remove_reader.

A simple refactoring. Doesn't even require a new or updated unit test.

Author: Zooko O'Whielacronx <zooko@zooko.com>
Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Add dummy __init__.py files for directories containing data. fixes #1960

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

setup.py: add allmydata/web/static/img/*.png to package_data. refs #1969

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

minor changes to hush newer pyflakes

apparently it can now detect aliasing from inside list comprehensions

update release how-to to be closer to current reality

Update terminology in RAIC design doc.

Signed-off-by: Daira Hopwood <daira@jacaranda.org>

docs/proposed/leasedb.rst: Add design doc for leasedb.
This version refs #1834.

Signed-off-by: David-Sarah Hopwood <david-sarah@jacaranda.org>

Show git branch in version output. fixes #1953
Also make sure strings in _version.py are correctly escaped, and repair a test.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

update docs for 1.10 release

.gitignore: ignore the generated zope.interface egg too

Some dependencies are installed in the top-level directory, maybe
because they're required by the build process itself? I'm not sure.
Twisted is one of these, if the system version is not new enough, and
our .gitignore has a clause to ignore the resulting .egg directory. Now
that we've bumped our zope.interface dependency, it sometimes builds a
z.i egg too (even if it doesn't build a Twisted one). So ignore both.

NEWS: caution about secret introducer.furl in world-readable tahoe.cfg

Update version requirement for zope.interface.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

known_issues, quickstart: add version and anticipated release date

NEWS: edits, formatting, consolidation, set a date for 1.10.0

NEWS: fix a formatting typo

NEWS: improve highlighting

It looks like github's ReST renderer shows ''' with more emphasis than
---, so use ''' for release names, and --- for groups of changes within
a given release.

Makefile: oops, fix tahoe-deps/tahoe-lafs-deps mismatch

which broke fetch-and-unpack-deps

update deps URLs to use "tahoe-lafs" instead of bare "tahoe"

update some copyright dates

known_issues.rst: get closer to real date

known_issues: update chart-API text, with suggestions from Leif. refs #1942

Add "[global-opts]" to help synopsis for tahoe ls. refs #166

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

NEWS: add entry for ref #166

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

docs/nodekeys.rst: explain what node keys are for, with compatibility notes

Add comments and a caveat in webapi.rst indicating that
the needs-rebalancing field may be computed incorrectly. refs #1115, #1784, #1477

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Minor improvements to webapi.rst.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

docs: fixed typos

whitespace change to trigger buildbot for 1.10-b1

client.py: create node key even when storage is disabled. Closes #1945.

Thanks to Leif for the catch!

docs/quickstart.rst: update Python 2.7 download URL.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

docs/quickstart.rst: update recommended Python version.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

Improve a test for ref #1643, and make sure that unexpected URIs actually raise AssertionError.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>

known_issues: document the google-chart-API privacy leak. Refs #1942.

welcome page: display new nodeid (ed25519-based) instead of old tubid

The old tubid is displayed in a tooltip. Also cleaned up the regexps in
the relevant tests.

client.py: remove the old "server.privkey" fallback

For a brief while (in between releases 1.9 and 1.10, specifically from
revision bc21726 on 12-Mar-2012, until bf416af on 10-Jun-2012), the new
introducer code stored its node key in NODEDIR/private/server.privkey .
After that point, it was updated to store this key in
NODEDIR/private/node.privkey instead. Fallback code was added to read
from the old location if present (so that folks using development
versions could keep their node keys after the bf416af change).

This patch removes the fallback code. If you have a node which was run
under a version of Tahoe within this range, you need to manually update
your node by running:

 mv NODEDIR/private/server.privkey NODEDIR/private/node.privkey

and then restart the node. If you accidentally start an older node with
code after this patch, it will create a new key (and other peers will
think a new server has appeared). You can either stick with the new key,
or use the command above to switch back to the old key.

See docs/nodekeys.rst (not yet written) for details about the node key
and how it is used.

client.py: internal renaming, _server_key -> _node_key

test_sftp.py: minor cosmetic changes

CLI: tolerate caps-from-future in unused aliases. Closes #1643.

docs: replace emdash characters with plain ASCII

test_cli: probably remove the unix-ism that broke tests on windows

Remove the whitespace reported by find-trailing-spaces. No code changes.

CLI: put "[global-opts]" in all command synopses

rename VDriveOptions to FilesystemOptions

bin/tahoe: clean up global-vs-subcommand arguments like --node-directory

The new rules for "bin/tahoe ARG1.. SUBCOMMAND ARG2.." arg:

* --node-directory is only accepted in ARG1, not ARG2
* create-*/start/stop/restart accept --basedir in ARG2, or an explicit
  basedir argument
* only one of --node-directory/--basedir/explicit-basedir is accepted
* --quiet/--version is only accepted in ARG1, not ARG2

Closes #166

s/node/client; mention restart is needed

convergence secret doc by CtB, marlowe, zooko

attempt to clarify move-vs-relink

ServerMap.copy(): deepcopy .update_data too. Closes #1785.

This was apparently unused, but good to copy for completeness. Tests
pass with and without the change.

webapi.rst: small edits to the t=relink section

docs/frontends/webapi.rst: cosmetics.

Signed-off-by: Daira Hopwood <david-sarah@jacaranda.org>