Documentation commit.

Broke-up the README; most of its content went into a new
user manual in Texinfo format. The process of documenting
filter quoting exposed multiple bugs-- fixed.

.github/workflows/ci.yml

@@ -7,6 +7,7 @@ on:
   push:
     branches:
       - master
+      - filters
   schedule:
     - cron: '00 01 * * *'
 jobs:

.github/workflows/release.yml

@@ -157,7 +157,8 @@ jobs:
         mkdir -p "$staging"/{bin,doc}
         cp -v {README.org,AUTHORS,ChangeLog,COPYING,NEWS,THANKS} "$staging/doc/"
         cp -v mpdpopm/mppopmd.{conf,service} "$staging/doc/"
-        cp -v mpdpopm/target/release/mppopm{,d} "$staging/bin"
+        cp -v doc/mpdpopm.info "$staging/doc/"
+        cp -v mpdpopm/target/release/mppopm{,d} "$staging/bin/"
         tar czf "$staging.tar.gz" "$staging"
         echo "ASSET=$staging.tar.gz" >> $GITHUB_ENV
 

ChangeLog

@@ -1,4 +1,11 @@
-2021-03-20  Michael Herstine  <[email protected]>
+2021-03-27  Michael Herstine  <[email protected]>
+
+	Documentation commit.
+	Broke-up the README; most of its content went into a new
+	user manual in Texinfo format. The process of documenting
+	filter quoting exposed multiple bugs-- fixed.
+
+2021-03-21  Michael Herstine  <[email protected]>
 
 	First true filter implementation.
 	This commit:

Makefile.am

@@ -1 +1 @@
-SUBDIRS = mpdpopm
+SUBDIRS = mpdpopm doc

NEWS

@@ -1,5 +1,19 @@
 mpdpopm News -- history of user-visible changes           -*- outline -*-
 
+* 0.2.3 build
+
+** User-visible changes
+
+*** broke-up the README
+
+Broke-up README.org into a much shorter version focused on installing mpdpopm and a full-fledged user-manual.
+
+** Bug-fixes
+
+*** quoting
+
+Fixed a number of bugs relating to quoting filters.
+
 * 0.2.2 build
 
 ** User-visible changes

THANKS

@@ -1,5 +1,5 @@
-Thanks to tanshoku <https://github.com/tanshoku> for contributing
-the systemd unit.
+Thanks to tanshoku <https://github.com/tanshoku> for his suggested
+systemd unit file.
 
 Thanks to m040601 <https://github.com/m040601> for his detailed
 feedback on the initial mpdpopm docs.

configure.ac

@@ -1,4 +1,4 @@
-AC_INIT([mpdpopm], [0.2.2], [[email protected]], [mpdpopm], [https://github.com/sp1ff/mpdpopm])
+AC_INIT([mpdpopm], [0.2.3], [[email protected]], [mpdpopm], [https://github.com/sp1ff/mpdpopm])
 AC_CONFIG_AUX_DIR([build-aux])
 AC_CONFIG_SRCDIR([mpdpopm/Cargo.toml.in])
 AM_INIT_AUTOMAKE([-Wall -Werror -Wno-portability -Wno-override gnits std-options dist-bzip2 dist-xz])
@@ -27,6 +27,7 @@ AC_CONFIG_FILES([mpdpopm/mppopmd.conf.am:etc/mppopmd.conf.am.in])
 AC_CONFIG_FILES([mpdpopm/mppopmd.service.am:etc/mppopmd.service.am.in])
 AC_CONFIG_FILES([PKGBUILD:admin/PKGBUILD.in])
 AC_CONFIG_FILES([Makefile mpdpopm/Makefile mpdpopm/Cargo.toml])
+AC_CONFIG_FILES([doc/Makefile])
 
 dnl Specify --enable-debug to make a development release.  By default,
 dnl we build in public release mode.

doc/Makefile.am

@@ -0,0 +1 @@
+info_TEXINFOS = mpdpopm.texi