NEWS: first editing pass

NEWS.rst

@@ -7,43 +7,53 @@ User-Visible Changes in Tahoe-LAFS
 Release 1.10.1 (XXXX-XX-XX)
 '''''''''''''''''''''''''''
 
-Unedited list of all changes after 1.10.0 and up-to cf9b3828 07-Jun-2015. This
-list is not yet limited to user-visible ones. It (hopefully) includes all
-tickets closed during this time, even minor non-user-visible ones.
+Partially-edited list of all changes after 1.10.0 and up-to cf9b3828
+07-Jun-2015. This list is not yet limited to user-visible ones. It
+(hopefully) includes all tickets closed during this time, even minor
+non-user-visible ones.
 
-Significant user-visible:
-- py2.6 is now unsupported on windows
-- 'tahoe cp -r' copies the top-level directory into new dir #712
-- improve welcome page CSS for narrow windows #1931
-- redesign WUI directory pages #1966
-- use "AUTO" in tahoe.cfg/node/tub.location to mean autodetect IP addresses.
-  Can be combined with static addresses, or turned off entirely. #754
-- 'tahoe cp -r': fix exception #2329
+UI / Configuration Changes
+--------------------------
 
-not-so significant user-visible:
-- show git branch in version output #1953
-- improve user feedback when filing an Incident Report #1974
-- add page-rendering timestamp to WUI #1972
+The "tahoe cp" CLI command's "--recursive" option is now more predictable,
+but behaves slightly differently than before. See below for details. #712
+#2329
+
+The SFTP server can now use public-key authentication (instead of only
+password-based auth). Public keys are configured through an "account file",
+just like passwords are. See docs/frontends/FTP-and-SFTP for examples of the
+format. #1411
+
+The Tahoe node can now be configured to disable automatic IP-address
+detection. Using "AUTO" in tahoe.cfg [node]tub.location= (which is now the
+default) triggers autodetection. Simply edit the value to omit "AUTO" to
+disable autodetection. "AUTO" can be combined with static addresses to e.g.
+use both a stable UPnP-configured tunneled address with a DHCP-assigned
+dynamic (local-subnet-only) address. See configuration.rst for details. #754
+
+The web-based user interface ("WUI") Directory and Welcome pages have been
+redesigned, with improved CSS for narrow windows and more-accessible icons
+(using distinctive shapes instead of just colors). #1931 #1961 #1966 #1972
+#1901
+
+Minor Changes
+-------------
+
+- Welcome page: add per-server "(space) Available" column #648
 - check/deep-check learned to accept multiple location args #740
-- various docs cleanups/improvements
-- checker reports: remove needs-rebalancing, add count-happiness #1784 #2105
-- improve packaging under pip #2209
-- hush warnings during dep-checking, stop complaining about missing
-  "service_identity" dep #2248
-- fix "Download" button on welcome page #1901
+- Checker reports: remove needs-rebalancing, add count-happiness #1784 #2105
+- Fix handling of long paths on windows #2235 #1674 #2027
+- CLI --help: cite (but don't list) global options on each command #2233
+- Add OpenSSL version to 'tahoe --version' #2215
+- Show git branch in version output #1953
+- Improve version-number reporting #2340
+- Improve user feedback when filing an Incident Report #1974
+- Various docs cleanups/improvements
 - WAPI: do not report 'size' metadata when unknown #1634
-- new OS-X packaging #182
-- stop using contents of .tac files #1159
-- improve version-number reporting #2340
-- add per-server "(space) Available" column to welcome page #648
-- add public-key auth to SFTP server #1411
-- `tahoe cp -r` changes w.r.t. unnamed directories #2329
-- replace WUI icons with distinct shapes for accessibility #1961
-- fix handling of long paths on windows #2235 #1674 #2027
-- depend on foolscap >= 0.8.0, which makes better keys #2400
-- initial Docker support PR#165
-- CLI --help rendering: cite (but do not list) global options on each command. #2233
-- add OpenSSL version to 'tahoe --version' #2215
+- Improve packaging under pip #2209
+- Hush warnings during dep-checking, stop complaining about missing
+  "service_identity" dep #2248
+- Stop using contents of .tac files #1159
 
 not user-visible:
 - remove unused 'human encoding' URI methods #1807
@@ -62,7 +72,6 @@ not user-visible:
 - dedup license info in about.rst/README.txt #2067
 - log roothash in base32 not binary #1800
 - improve upload tests #2008
-- remove obsolete debian packaging tools #2282
 - add --coverage to setup.py test #1698, remove old coverage uploaders
 - remove trialcoverage plugin #2281
 - tolerate disk-space-used=0 for travis boxes #2290
@@ -74,7 +83,6 @@ not user-visible:
 - hush DeprecationWarning with twisted.web #2312
 - fix race condition during mutable upload
 - fix MANIFEST.in warnings #2380
-- put version string into name of OS-X package: #2393
 - improve unicode handling of arguments to (S)FTPServer #2388
 - improve tests of test_mutable #2034
 - fix ftp 'ls' to work with Twisted-15.0.0 #2394
@@ -82,7 +90,6 @@ not user-visible:
 - remove named-path upload/download from control-port #1737
 - unicode handling on windows something #2398
 - zetuptoolz: tolerate single-string requirespec #2242
-- add icon for OS-X/windows #2323
 - accept newer Twisted (>=13) on windows if pywin32 is manually installed #2416
 - windows: find home directory on multiple versions of windows #2417
 - improve fileutil something #1531
@@ -94,21 +101,19 @@ unknown / needs-more-research:
 - improve what-is-my-ipv4 on windows/cygwin #1381
 
 
-all tickets noted as closed: 1953 1960 1974 1972 1717 1381 898 1707 1918 1807
-740 1842 1992 2165 1847 2086 2208 2048 2128 2245 1336 2248 2067 712 1800 1966
-2008 2282 2281 2290 2023 2121? 2305 1901 2249 2193 1634 1159 2340 1146 648
-1411 2354 1961 2380 754 2393 2394 1737 2398 2400 2242 2416 2415 2417 1969
-1988 1784 2105 2209 2280 623 2249 1698 2028 2005 2312 2235 1674 2027 2034
-2323 2433 2233
+Roughly 75 tickets were closed in this release: 1953 1960 1974 1972 1717 1381
+898 1707 1918 1807 740 1842 1992 2165 1847 2086 2208 2048 2128 2245 1336 2248
+2067 712 1800 1966 2008 2282 2281 2290 2023 2121? 2305 1901 2249 2193 1634
+1159 2340 1146 648 1411 2354 1961 2380 754 2393 2394 1737 2398 2400 2242 2416
+2415 2417 1969 1988 1784 2105 2209 2280 623 2249 1698 2028 2005 2312 2235
+1674 2027 2034 2323 2433 2233. Another dozen were referenced but not closed:
+1834 1742 982 1064 1536 1935 666 1931 1258 182 2286 1531. Roughly 40 GitHub
+pull-requests were closed: 62 48 57 61 62 63 64 69 73 81 82 84 85 87 91 94 95
+96 103 56 32 50 107 109 114 112 120 122 125 126 133 135 136 137 142 146 149
+152 165.
 
-tickets referenced but not closed: 1834 1742 982 1064 1536 1935 666 1931 1258
-182 2286 1531
-
-PRs noted as closed: 62 48 57 61 62 63 64 69 73 81 82 84 85 87 91 94 95 96
-103 56 32 50 107 109 114 112 120 122 125 126 133 135 136 137 142 146 149 152
-165
-
-- "tahoe cp" changes:
+"tahoe cp" changes
+------------------
 
 There are many "cp"-like tools in the unix world (POSIX /bin/cp, the "scp"
 provided by SSH, rsync). They each behave slightly differently in unusual
@@ -156,10 +161,27 @@ of the 1.10.0 release:
   In 1.10.1, following the new rule of "a named directory source refers to
   the directory itself", the tool creates "./local/missing/dir/file.txt".
 
+Packaging
+---------
+
+Preliminary OS-X and Windows packages are now being generated. The OS-X
+installer is named "tahoe-lafs-VERSION-osx.pkg" and is a standard
+double-clickable installer, which installs an /Applications/tahoe.app that
+embeds a complete runtime tree. However launching the .app only brings up
+docs on how to run tahoe from the command line. A future release will turn
+this into a fully-fledged application launcher. The Windows package is even
+more preliminary. #182 #2393 #2323
+
+Preliminary Docker support was added. Tahoe container images may be available
+on DockerHub. PR#165
+
+Old/obsolete debian packaging tools have been removed. #2282
 
 Compatibility and Dependency Updates
 ------------------------------------
 
+Windows now requires python2.7 . Unix platforms can use either 2.6 or 2.7.
+
 - Twisted >= 13.0.0
 - Nevow >= 0.11.1
 - foolscap >= 0.8.0
@@ -194,6 +216,10 @@ as well as libffi (for Debian/Ubuntu, the name of the needed OS package is
 Tahoe-LAFS is now compatible with setuptools version 8 and pip version 6
 or later.
 
+Tahoe-LAFS now depends upon foolscap-0.8.0, which creates better private keys
+and certificates than previous versions (2048-bit RSA keys and SHA256-based
+certificates). To benefit from the improved keys, you must re-generate your
+Tahoe nodes (which changes their TubIDs and FURLs). #2400
 
 Release 1.10.0 (2013-05-01)
 '''''''''''''''''''''''''''