changelog: Categorise and tidy

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/debian/changelog b/debian/changelog
index 27a18007dd51d3f27f64d49a9ef4441cf30ceec3..3b9ca030d4dcdafab00ea1a5c23369e37724edc6 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,41 +1,44 @@
 userv (1.2.1~beta2) unstable; urgency=medium
 
-  * changelog: start 1.2.1~beta2
-  * spec.sgml: Update builtin version number
-  * Suppress some warnings about ignoring stderr write errors
-  * overlord: Explicitly ignore unwanted value from write
-  * regenerate lexer.c using flex 2.6.4-6.2
-  * overview.ps: Regenerate (fig2dev from transfig 1:3.2.6a-2+deb9u3)
-  * autoconf: Add autogen.sh
-  * autoconf: Add some missing quoting
-  * autoconf: Add a missing gitignore entry
-  * autoconf: Rerun autogen.sh to update to modern autoconf
-  * make install: Ship manpages to /usr/share, not /usr, by default
-  * make install: Ship docs to /usr/share/doc/userv, not /usr/userv (!)
-  * Makefile: Installation refactoring (1)
-  * Makefile: Installation refactoring (2)
-  * Makefile: Installation refactoring (3)
-  * Installation: Honour DESTDIR
-  * make install: Create bindir and sbindir if needed
-  * Makefile: Installation refactoring (4)
-  * gitignore: Move debian/ entries to debian/.gitignore
-  * Makefile: Provide [un]install-docs
-  * make install: Do not pass -m to install -d; introduce INSTALL_DIR
-  * Makefile: Installation refactoring (5)
-  * make install: Install default config files as examples too
-  * debian: Switch to dh auto sequencer
-  * debian: Build everything from actual sources
-  * copyright: Simplify notices (automatic part)
-  * copyright: Simplify notices (maqnual part)
-  * copyright: Update my date from 2017 to 2021
-  * copyright: Fix information in usage output
-  * copyright: Add Matthew Vernon
-  * copyright etc.: Fix my own email address
-  * spec: Generate printable file as pdf via docbook
-  * spec: Correct information about userv's authorship
-  * overview diagram: Manually strip date from fig2dev output
+  Documentation generation changes:
+  * spec: Generate printable file as pdf via docbook.
+  * spec: Correct information about userv's authorship.
+  * spec: Update builtin version number.
+  * overview diagram: Build as pdf, with a sensible page layout.
+
+  Debian packaging changes:
+  * Switch to dh auto sequencer.  Many consequences:
+     - Upstream README is /usr/share/doc/userv/README, not README.upstream.
+     * Control file md5sums are provided.
+     * New changelog symlink for changelog.Debian.gz.
+     * We use the proper Debian debug information scheme.
+     * We use different compiler flags, which will hopefully produce
+       better hardening and better reproducibility.
+  * Build everything from actual sources; don't reuse committed files.
+
+  Fixes to upstream "make install-docs" target:
+  * Ship docs to /usr/share/doc/userv, not /usr/userv (!)
+  * Ship manpages to /usr/share, not /usr, by default
+  * Install default config files as examples too.
+  * Provide "[un]install-docs" target (not just anomalous "install-doc").
+
+  Inconsequential code changes:
+  * Suppress some warnings about ignoring stderr write errors.
+  * overlord: Explicitly ignore unwanted value from write.
+
+  Upstream build system and packaging tidying:
+  * regenerate lexer.c using flex 2.6.4-6.2.
+  * regenerate rautoconf outputs with auatoconf 2.69-11.
+  * Add autogen.sh.
+  * Add some missing configure.in quoting (needed by modern autoconf).
+  * "make install": Honour DESTDIR; create bindir and sbindir if needed
+  * "make install": Do not pass -m to install -d; introduce INSTALL_DIR
+  * overview diagram: Override non-reproducible date inserted by fig2dev.
+  * copyright: Add missing dates and names.  Simplify notices.
+  * Update my own email address
+  * gitignore: add missing entries, move debian stuff to debian/.
+  * Makefile: Refactoring of installation targets
   * Makefile: Remove obsolete dist target
-  * overview diagram: Build as pdf, with a sensible page layout, rather than ps
 
  --