+Release 1.10.0 (2013-05-01)
+'''''''''''''''''''''''''''
+
+New Features
+------------
+
+- The Welcome page has been redesigned. This is a preview of the design style
+ that is likely to be used in other parts of the WUI in future Tahoe-LAFS
+ versions. (`#1713`_, `#1457`_, `#1735`_)
+- A new extensible Introducer protocol has been added, as the basis for
+ future improvements such as accounting. Compatibility with older nodes is
+ not affected. When server, introducer, and client are all upgraded, the
+ welcome page will show node IDs that start with "v0-" instead of the old
+ tubid. See `<docs/nodekeys.rst>`__ for details. (`#466`_)
+- The web-API has a new ``relink`` operation that supports directly moving
+ files between directories. (`#1579`_)
+
+Security Improvements
+---------------------
+
+- The ``introducer.furl`` for new Introducers is now unguessable. In previous
+ releases, this FURL used a predictable swissnum, allowing a network
+ eavesdropper who observes any node connecting to the Introducer to access
+ the Introducer themselves, and thus use servers or offer storage service to
+ clients (i.e. "join the grid"). In the new code, the only way to join a
+ grid is to be told the ``introducer.furl`` by someone who already knew it.
+ Note that pre-existing introducers are not changed. To force an introducer
+ to generate a new FURL, delete the existing ``introducer.furl`` file and
+ restart it. After doing this, the ``[client]introducer.furl`` setting of
+ every client and server that should connect to that introducer must be
+ updated. Note that other users of a shared machine may be able to read
+ ``introducer.furl`` from your ``tahoe.cfg`` file unless you configure the
+ file permissions to prevent them. (`#1802`_)
+- Both ``introducer.furl`` and ``helper.furl`` are now censored from the
+ Welcome page, to prevent users of your gateway from learning enough to
+ create gateway nodes of their own. For existing guessable introducer
+ FURLs, the ``introducer`` swissnum is still displayed to show that a
+ guessable FURL is in use. (`#860`_)
+
+Command-line Syntax Changes
+---------------------------
+
+- Global options to ``tahoe``, such as ``-d``/``--node-directory``, must now
+ come before rather than after the command name (for example,
+ ``tahoe -d BASEDIR cp -r foo: bar:`` ). (`#166`_)
+
+Notable Bugfixes
+----------------
+
+- In earlier versions, if a connection problem caused a download failure for
+ an immutable file, subsequent attempts to download the same file could also
+ fail. This is now fixed. (`#1679`_)
+- Filenames in WUI directory pages are now displayed correctly when they
+ contain characters that require HTML escaping. (`#1143`_)
+- Non-ASCII node nicknames no longer cause WUI errors. (`#1298`_)
+- Checking a LIT file using ``tahoe check`` no longer results in an
+ exception. (`#1758`_)
+- The SFTP frontend now works with recent versions of Twisted, rather than
+ giving errors or warnings about use of ``IFinishableConsumer``. (`#1926`_,
+ `#1564`_, `#1525`_)
+- ``tahoe cp --verbose`` now counts the files being processed correctly.
+ (`#1805`_, `#1783`_)
+- Exceptions no longer trigger an unhelpful crash reporter on Ubuntu 12.04
+ ("Precise") or later. (`#1746`_)
+- The error message displayed when a CLI tool cannot connect to a gateway has
+ been improved. (`#974`_)
+- Other minor fixes: `#1781`_, `#1812`_, `#1915`_, `#1484`_, `#1525`_
+
+Compatibility and Dependencies
+------------------------------
+
+- Python >= 2.6, except Python 3 (`#1658`_)
+- Twisted >= 11.0.0 (`#1771`_)
+- mock >= 0.8 (for unit tests)
+- pycryptopp >= 0.6.0 (for Ed25519 signatures)
+- zope.interface >= 3.6.0 (except 3.6.3 or 3.6.4)
+
+Other Changes
+-------------
+
+- The flogtool utility, used to read detailed event logs, can now be accessed
+ as ``tahoe debug flogtool`` even when Foolscap is not installed
+ system-wide. (`#1693`_)
+- The provisioning/reliability pages were removed from the main client's web
+ interface, and moved into a standalone web-based tool. Use the ``run.py``
+ script in misc/operations_helpers/provisioning to access them.
+- Web clients can now cache (ETag) immutable directory pages. (`#443`_)
+- `<docs/convergence_secret.rst>`__ was added to document the adminstration
+ of convergence secrets. (`#1761`_)
+
+Precautions when Upgrading
+--------------------------
+
+- When upgrading a grid from a recent version of trunk, follow the
+ precautions from this `message to the tahoe-dev mailing list`_, to ensure
+ that announcements to the Introducer are recognized after the upgrade.
+ This is not necessary when upgrading from a previous release.
+
+.. _`#166`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/166
+.. _`#443`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/443
+.. _`#466`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/466
+.. _`#860`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/860
+.. _`#974`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/974
+.. _`#1143`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1143
+.. _`#1298`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1298
+.. _`#1457`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1457
+.. _`#1484`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1484
+.. _`#1525`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1525
+.. _`#1564`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1564
+.. _`#1579`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1579
+.. _`#1658`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1658
+.. _`#1679`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1679
+.. _`#1693`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1693
+.. _`#1713`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1713
+.. _`#1735`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1735
+.. _`#1746`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1746
+.. _`#1758`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1758
+.. _`#1761`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1761
+.. _`#1771`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1771
+.. _`#1781`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1781
+.. _`#1783`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1783
+.. _`#1802`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1802
+.. _`#1805`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1805
+.. _`#1812`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1812
+.. _`#1915`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1915
+.. _`#1926`: https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1926
+.. _`message to the tahoe-dev mailing list`:
+ https://tahoe-lafs.org/pipermail/tahoe-dev/2013-March/008096.html
+
+
+Release 1.9.2 (2012-07-03)
+''''''''''''''''''''''''''