From 3dd480fd82c29f5b98c6a66d21d676b8dfdfc285 Mon Sep 17 00:00:00 2001
From: meejah <meejah@meejah.ca>
Date: Fri, 17 Jan 2020 01:55:21 -0700
Subject: [PATCH 1/3] tweak release HOWTO

---
 docs/how_to_make_a_tahoe-lafs_release.org | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/how_to_make_a_tahoe-lafs_release.org b/docs/how_to_make_a_tahoe-lafs_release.org
index 79438c85d..44b9e3dd1 100644
--- a/docs/how_to_make_a_tahoe-lafs_release.org
+++ b/docs/how_to_make_a_tahoe-lafs_release.org
@@ -17,13 +17,14 @@ people are Release Maintainers:
   - [ ] all appveyor checks pass
   - [ ] all buildbot workers pass their checks
 
-* freeze master branch [0/]
+* freeze master branch [0/1]
   - [ ] announced the freeze of the master branch on IRC (i.e. non-release PRs won't be merged until after release)
 
 * sync documentation [0/7]
-  - [ ] NEWS.rst: summarize user-visible changes, aim for one page of text
+
+  - [ ] NEWS.rst: (run "tox -e news")
   - [ ] added final release name and date to top-most item in NEWS.rst
-  - [ ] updated relnotes.txt
+  - [ ] updated relnotes.txt (change next, last versions; summarize NEWS)
   - [ ] updated CREDITS
   - [ ] updated docs/known_issues.rst
   - [ ] docs/INSTALL.rst only points to current tahoe-lafs-X.Y.Z.tar.gz source code file

From 602c6d1811c74edc970ee30cdb1d6f73b2d060c9 Mon Sep 17 00:00:00 2001
From: meejah <meejah@meejah.ca>
Date: Fri, 17 Jan 2020 01:56:02 -0700
Subject: [PATCH 2/3] news

---
 newsfragments/3275.minor | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 newsfragments/3275.minor

diff --git a/newsfragments/3275.minor b/newsfragments/3275.minor
new file mode 100644
index 000000000..dc25bc1a9
--- /dev/null
+++ b/newsfragments/3275.minor
@@ -0,0 +1 @@
+Updates to release process/docs
\ No newline at end of file

From 241b5a3d364e13d9c9c03f1571bc5d889c786ffc Mon Sep 17 00:00:00 2001
From: meejah <meejah@meejah.ca>
Date: Wed, 11 Mar 2020 10:52:26 -0600
Subject: [PATCH 3/3] use Tox to build NEWS

---
 tox.ini | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/tox.ini b/tox.ini
index 44016c891..7948e897a 100644
--- a/tox.ini
+++ b/tox.ini
@@ -115,6 +115,37 @@ commands =
          # put it back
          mv pyproject.toml towncrier.pyproject.toml
 
+[testenv:news]
+passenv = TAHOE_LAFS_* PIP_* SUBUNITREPORTER_* USERPROFILE HOMEDRIVE HOMEPATH
+# see comment in [testenv] about "certifi"
+whitelist_externals = mv
+deps =
+     certifi
+     towncrier >= 19.2
+commands =
+         # With pip >= 10 the existence of pyproject.toml (which we are
+         # required to have to configure towncrier) triggers a "build
+         # isolation" mode which prevents anything from working.  Avoid
+         # triggering that pip behavior by keeping the towncrier configuration
+         # somewhere else and only bringing it in when it's actually needed
+         # (after pip is done).
+         #
+         # Some discussion is available at
+         # https://github.com/pypa/pip/issues/5696
+	 #
+	 # towncrier post 19.2 (unreleased as of this writing) adds a --config
+	 # option that can be used instead of this file shuffling.
+         mv towncrier.pyproject.toml pyproject.toml
+
+         # towncrier 19.2 + works with python2.7
+         python -m towncrier --yes
+
+         # put it back
+         mv pyproject.toml towncrier.pyproject.toml
+
+         # commit the changes
+         git commit -m "update NEWS.txt for release"
+
 [testenv:deprecations]
 setenv =
          PYTHONWARNINGS=default::DeprecationWarning