about summary refs log tree commit homepage
path: root/Documentation
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/.gitignore2
-rw-r--r--Documentation/GNUmakefile2
-rw-r--r--Documentation/dtas-archive.pod13
-rw-r--r--Documentation/dtas-console.pod4
-rw-r--r--Documentation/dtas-ctl.pod4
-rw-r--r--Documentation/dtas-cueedit.pod4
-rw-r--r--Documentation/dtas-enq.pod4
-rw-r--r--Documentation/dtas-env.pod6
-rw-r--r--Documentation/dtas-msinkctl.pod4
-rw-r--r--Documentation/dtas-player.pod12
-rw-r--r--Documentation/dtas-player_effects.pod4
-rw-r--r--Documentation/dtas-player_protocol.pod8
-rw-r--r--Documentation/dtas-player_sink_examples.pod4
-rw-r--r--Documentation/dtas-sinkedit.pod8
-rw-r--r--Documentation/dtas-sourceedit.pod14
-rw-r--r--Documentation/dtas-splitfx.pod72
-rw-r--r--Documentation/dtas-tl.pod10
-rw-r--r--Documentation/dtas-xdelay.pod4
-rwxr-xr-xDocumentation/update-footer.rb4
19 files changed, 122 insertions, 61 deletions
diff --git a/Documentation/.gitignore b/Documentation/.gitignore
index 29953eb..b212ef7 100644
--- a/Documentation/.gitignore
+++ b/Documentation/.gitignore
@@ -1,4 +1,4 @@
-# Copyright (C) 2013-2016 all contributors <dtas-all@nongnu.org>
+# Copyright (C) 2013-2020 all contributors <dtas-all@nongnu.org>
 # License: GPL-3.0+ <https://www.gnu.org/licenses/gpl-3.0.txt>
 *.1
 *.5
diff --git a/Documentation/GNUmakefile b/Documentation/GNUmakefile
index d3834f9..9bad54f 100644
--- a/Documentation/GNUmakefile
+++ b/Documentation/GNUmakefile
@@ -1,4 +1,4 @@
-# Copyright (C) 2013-2016 all contributors <dtas-all@nongnu.org>
+# Copyright (C) 2013-2020 all contributors <dtas-all@nongnu.org>
 # License: GPL-3.0+ <https://www.gnu.org/licenses/gpl-3.0.txt>
 all::
 
diff --git a/Documentation/dtas-archive.pod b/Documentation/dtas-archive.pod
index 4d7f4e8..50237e8 100644
--- a/Documentation/dtas-archive.pod
+++ b/Documentation/dtas-archive.pod
@@ -52,11 +52,20 @@ Continue after error
 
 Number of times to repeat the L<sndfile-cmp(1)> check.  Default: 1
 
+=item -m, --match REGEX
+
+Only archive files matching a given Ruby (or Perl-compatible) regular
+expression.  The regular expression is implementation-dependent and
+using the Perl-compatible subset of Ruby regexps is recommended as dtas
+will be moving away from Ruby at some point.
+
+Added for dtas v0.22.0
+
 =back
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
@@ -65,7 +74,7 @@ License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
diff --git a/Documentation/dtas-console.pod b/Documentation/dtas-console.pod
index 1aa5acc..3bf11af 100644
--- a/Documentation/dtas-console.pod
+++ b/Documentation/dtas-console.pod
@@ -78,13 +78,13 @@ a problem.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-ctl.pod b/Documentation/dtas-ctl.pod
index 699a723..25a8b3f 100644
--- a/Documentation/dtas-ctl.pod
+++ b/Documentation/dtas-ctl.pod
@@ -62,13 +62,13 @@ This defaults to ~/.dtas/player.sock
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-cueedit.pod b/Documentation/dtas-cueedit.pod
index 4452afe..9ee4797 100644
--- a/Documentation/dtas-cueedit.pod
+++ b/Documentation/dtas-cueedit.pod
@@ -23,13 +23,13 @@ VISUAL / EDITOR - your favorite *nix text editor, defaults to 'vi' if unset.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-enq.pod b/Documentation/dtas-enq.pod
index 9992f73..dceea88 100644
--- a/Documentation/dtas-enq.pod
+++ b/Documentation/dtas-enq.pod
@@ -28,13 +28,13 @@ This defaults to ~/.dtas/player.sock
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-env.pod b/Documentation/dtas-env.pod
index d0ea2e8..a460700 100644
--- a/Documentation/dtas-env.pod
+++ b/Documentation/dtas-env.pod
@@ -10,7 +10,7 @@ As dtas uses Bourne shell and exposes it to users, dtas should have
 a cohesive set of common environment variables across its audio
 production and playback environments.  This attempts to document
 them.  Most of these environments are set and managed by dtas
-itself, but users editing commands (e.g. via L<dtas-sourcedit(1)>
+itself, but users editing commands (e.g. via L<dtas-sourcedit(1)>)
 should be aware of them.
 
 =head1 ENVIRONMENT
@@ -64,12 +64,12 @@ temporary files are placed for most programs.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
diff --git a/Documentation/dtas-msinkctl.pod b/Documentation/dtas-msinkctl.pod
index 2cb4187..bee2af0 100644
--- a/Documentation/dtas-msinkctl.pod
+++ b/Documentation/dtas-msinkctl.pod
@@ -45,13 +45,13 @@ This defaults to ~/.dtas/player.sock
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-player.pod b/Documentation/dtas-player.pod
index c4eb696..4cfdd12 100644
--- a/Documentation/dtas-player.pod
+++ b/Documentation/dtas-player.pod
@@ -70,10 +70,10 @@ To play audio on my favorite USB DAC directly to ALSA, I use:
 =head2 Seeking/playing audio from large video containers (e.g. VOB) fails
 
 This is a problem with large VOBs.  We recommend breaking up the
-VOB into smaller files or using L<avconv(1)> or L<ffmpeg(1)> to extract
-the desired audio stream.
+VOB into smaller files or using L<ffmpeg(1)> to extract
+the desired audio stream at C<$STREAM_NR>.
 
-      avconv -analyzeduration 2G -probesize 2G \
+      ffmpeg -analyzeduration 2G -probesize 2G \
         -i input.vob -vn -sn -c:a copy -map 0:$STREAM_NR output.ext
 
 =head1 ADVANCED EXAMPLES
@@ -109,13 +109,13 @@ state across restarts of dtas-player.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
@@ -123,4 +123,4 @@ License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
 L<dtas-player_protocol(7)>, L<dtas-ctl(1)>, L<dtas-enq(1)>,
 L<dtas-sourceedit(1)>, L<dtas-sinkedit(1)>, L<sox(1)>, L<play(1)>,
-L<avconv(1)>, L<ffmpeg(1)>, L<screen(1)>, L<tmux(1)>
+L<ffmpeg(1)>, L<screen(1)>, L<tmux(1)>
diff --git a/Documentation/dtas-player_effects.pod b/Documentation/dtas-player_effects.pod
index c0861f5..6c20934 100644
--- a/Documentation/dtas-player_effects.pod
+++ b/Documentation/dtas-player_effects.pod
@@ -92,12 +92,12 @@ playback hardware are applied at the sink:
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
diff --git a/Documentation/dtas-player_protocol.pod b/Documentation/dtas-player_protocol.pod
index f709e96..e98197d 100644
--- a/Documentation/dtas-player_protocol.pod
+++ b/Documentation/dtas-player_protocol.pod
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-dtas-player_protocol - protocol for controling dtas-player
+dtas-player_protocol - protocol for controlling dtas-player
 
 =head1 DESCRIPTION
 
@@ -382,7 +382,7 @@ Clear current tracklist
 
 Show/or change consume status of the tracklist.  Enabling this causes
 tracks to be deleted from the tracklist after they are played or skipped.
-With no args, this will show "true" or "false
+With no args, this will show "true" or "false"
 
 =item tl current
 
@@ -464,12 +464,12 @@ another client socket to issue non-watch commands.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
diff --git a/Documentation/dtas-player_sink_examples.pod b/Documentation/dtas-player_sink_examples.pod
index f40707e..a4cc623 100644
--- a/Documentation/dtas-player_sink_examples.pod
+++ b/Documentation/dtas-player_sink_examples.pod
@@ -71,13 +71,13 @@ See L<dtas-xdelay(1)>.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-sinkedit.pod b/Documentation/dtas-sinkedit.pod
index d6af071..f30d29a 100644
--- a/Documentation/dtas-sinkedit.pod
+++ b/Documentation/dtas-sinkedit.pod
@@ -13,8 +13,8 @@ dtas-sinkedit SINKNAME
 dtas-sinkedit spawns an editor to allow editing of a sink as a YAML file.
 See L<dtas-player_protocol(7)> for details on SINKARGS.
 
-On Linux machines with the sleepy_penguin RubyGem installed, L<inotify(7)>
-is used to monitor the file for changes while the text exitor is running.
+On Linux machines,  L<inotify(7)>
+is used to monitor the file for changes while the text editor is running.
 Each time a user finishes saving a file, changes are committed immediately.
 This behavior may be disabled by using the -N or --no-watch command-line
 switch.
@@ -64,13 +64,13 @@ This defaults to ~/.dtas/player.sock
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-sourceedit.pod b/Documentation/dtas-sourceedit.pod
index 169f08b..593bcf5 100644
--- a/Documentation/dtas-sourceedit.pod
+++ b/Documentation/dtas-sourceedit.pod
@@ -16,8 +16,8 @@ a pipe or file, it is parsed as YAML and fed to the L<dtas-player(1)> instance
 non-interactively.  This is useful for loading various profiles from the
 filesystem.
 
-On Linux machines with the sleepy_penguin RubyGem installed, L<inotify(7)>
-is used to monitor the file for changes while the text exitor is running.
+On Linux machines, L<inotify(7)>
+is used to monitor the file for changes while the text editor is running.
 Each time a user finishes saving a file, changes are committed immediately.
 This behavior may be disabled by using the -N or --no-watch command-line
 switch.
@@ -51,11 +51,7 @@ of a previous "dtas-ctl source cat sox" invocation:
 
         $ dtas-sourceedit sox < saved.yml
 
-To change the way dtas-player calls avconv (part of libav):
-
-        $ dtas-sourceedit av
-
-To change the way dtas-player calls ffmpeg (lightly-tested):
+To change the way dtas-player calls ffmpeg:
 
         $ dtas-sourceedit ff
 
@@ -71,13 +67,13 @@ This defaults to ~/.dtas/player.sock
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-splitfx.pod b/Documentation/dtas-splitfx.pod
index b5dadfd..88179d7 100644
--- a/Documentation/dtas-splitfx.pod
+++ b/Documentation/dtas-splitfx.pod
@@ -26,7 +26,8 @@ to use L<ecasound(1)>, too.
 =item -j, --jobs [JOBS]
 
 Number of jobs to run in parallel.  If no number is specified, all
-jobs are run in parallel.
+jobs are run in parallel.  Default: number of CPUS (dtas 0.20.0+),
+previous versions of dtas defaulted to 1.
 
 =item -n, --dry-run
 
@@ -36,11 +37,24 @@ Print, but do not run the commands to be executed
 
 Silent operation, commands are not printed as executed
 
+=item -S, --stats
+
+Add the sox "stats" effect to the end of the effects chain,
+use this with L</--err-suffix> to get a C<.stats> file with
+every track output
+
 =item -D, --no-dither
 
 Disable automatic setting of the DITHERFX env.  This also passes
 the option to L<sox(1)> via SOX_OPTS.
 
+=item -E, --err-suffix SUFFIX
+
+Write the contents of C<stderr>.  This is useful for capturing
+the per-track output of the L<sox(1)> C<stats> effect when
+combined with parallel C<--jobs>.  Recommended for use with the
+L</--stats> switch.
+
 =item -O, --outdir OUTDIR
 
 Set output directory instead of current directory.
@@ -70,6 +84,16 @@ outputs the result as a single file with the TRACKNUMBER
 of "000".  For ease-of-typing, commas in this command-line
 argument are automatically expanded to spaces when passed to sox.
 
+This switch may not be combined with L</--filter>
+
+=item -f, --filter [FIELD=]VALUE
+
+Only process tracks matching a given comment FIELD and VALUE.
+If no C<=> is exists, then all comment fields are matched
+against the specified VALUE.
+
+This switch may not be combined with L</--trim>
+
 =item -p, --sox-pipe
 
 Used in place of an output target to specify outputting audio data in
@@ -84,9 +108,9 @@ moves printing of output to stderr and disables parallel job invocation.
 
 =item infile - string, the pathname of the original audio file
 
-=item env - ordered hash of environment variables to set for all commands
+=item env - hash of environment variables to set for all commands
 
-    env: !omap
+    env:
       FX: gain 3 stats
 
 =item comments - hash of common tags for all audio (e.g. ARTIST, ALBUM, YEAR)
@@ -115,7 +139,12 @@ highest-numbered track.  Default: true
 
 =item targets - hash, see "TARGETS" section
 
-=item command - used only by L<dtas-player(1)>
+=item command - override the default sox invocation
+
+This command may be used to specify an alternate command to process each
+track.
+
+Default: sox "$INFILE" $COMMENTS $OUTFMT $OUTDST $TRIMFX $FX $RATEFX $DITHERFX
 
 =back
 
@@ -127,11 +156,36 @@ segment.
 
 =over
 
-=item t TIME TITLE [fade_in/fade_out=FADE_ARGS]
+=item t TIME TITLE [fade_in/fade_out=FADE_ARGS] [.FIELD=VALUE] [env.X=Y]
+
+The start of a new track at TIME with TITLE.
+An optional L</fade_in> and L</fade_out> may be specified for any tracks.
+Per-track comments may be specified in the form of C<.FIELD=VALUE>.
+Using per-track C<.ARTIST=FOO> allows proper tagging of multi-artist
+compilations.
+
+Per-track environment variables may be specified in the form
+of C<env.K=V> where C<K> is the environment variable name and
+C<V> is its value.  Per-track environment variables do not affect
+playback of YAML files via L<dtas-player(1)> nor use of the L</--trim>
+command-line option.  However, per-track environment variables do affect
+any tracks written to the filesystem, including those using the L</--filter>
+switch.   These environment variables are intended to affect the specified
+L</command> or default L<sox(1)> invocation.
+
+=item tshift TIME
+
+Increment subsequent time stamps for L</t>, L</skip>, and L</stop>
+directives by the specified TIME offset.  TIME can be prefixed by
+C<+=> or C<-=> to adjust the existing C<tshift> value.  Negative
+values can be specified by prefixing with C<-> for a backwards
+time shift.
+
+This directive is useful for working with multiple recordings of the
+same source and cutting a section from the middle of a recording after
+initial tracking is done.
 
-The start of a new track
-at TIME with TITLE.  An optional fade_in and fade_out may be specified
-for the first/last tracks.
+Default: 0
 
 =item skip TIME - skip a segment starting at TIME
 
@@ -262,7 +316,7 @@ imbalance in a live concert recording from the audience:
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-tl.pod b/Documentation/dtas-tl.pod
index 6ca88d0..b5a4b31 100644
--- a/Documentation/dtas-tl.pod
+++ b/Documentation/dtas-tl.pod
@@ -29,7 +29,7 @@ client).
 =item consume [BOOLEAN] - show, enable, or disable consume mode
 
 Enabling "consume" mode causes tracks to be removed when they are
-done playing (or skipped.
+done playing (or skipped).
 
 =item current - display the current track, "NONE" if not playing
 
@@ -60,6 +60,8 @@ optionally seek to POS.  POS should be a timestamp in HH:MM:SS.FRAC format.
 
 =item prev - play the previous track in the tracklist
 
+=item prune - cull non-existent pathnames from the tracklist
+
 =item repeat 1 - repeat the current track
 
 =item repeat false - disable repeat
@@ -78,7 +80,7 @@ display the current tracklist
 
         $ dtas-tl cat
 
-to add an an entire directory of FLAC files
+to add an entire directory of FLAC files
 
         $ dtas-tl addtail /path/to/directory/*.flac
 
@@ -114,13 +116,13 @@ This defaults to ~/.dtas/player.sock
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/dtas-xdelay.pod b/Documentation/dtas-xdelay.pod
index b05b093..358a31d 100644
--- a/Documentation/dtas-xdelay.pod
+++ b/Documentation/dtas-xdelay.pod
@@ -80,13 +80,13 @@ are greatly appreciated.
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 
 =head1 COPYRIGHT
 
-Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>
+Copyright 2013-2020 all contributors L<mailto:dtas-all@nongnu.org>
 
 License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>
 
diff --git a/Documentation/update-footer.rb b/Documentation/update-footer.rb
index ea7d7cd..e26e3e3 100755
--- a/Documentation/update-footer.rb
+++ b/Documentation/update-footer.rb
@@ -1,12 +1,12 @@
 #!/usr/bin/env ruby
-# Copyright 2015-2016 all contributors <dtas-all@nongnu.org>
+# Copyright 2015-2020 all contributors <dtas-all@nongnu.org>
 # License: GPL-3.0+ <https://www.gnu.org/licenses/gpl-3.0.txt>
 # frozen_string_literal: true
 contact = %q{
 All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>
 
 Mailing list archives available at L<https://80x24.org/dtas-all/>
-and L<ftp://lists.gnu.org/dtas-all/>
+and L<https://lists.gnu.org/archive/html/dtas-all/>
 
 No subscription is necessary to post to the mailing list.
 }