doc: convert to perlpod(1) from Markdown

perlpod(1) is already installed by default on Debian and
RedHat-based systems; and probably most modern *nixes; pandoc(1)
(and Haskell) are not.

POD also more standardized than Markdown (which flavor? :P),
especially for generating manpages.  So save any potential
documentation editors some disk space by not forcing them to install
Haskell and pandoc.

Finally, I'm a mildly proficient in Perl and do not know Haskell
at all and have a better chance at reading/hacking the source if
the document generator breaks.

1 files changed, 0 insertions, 125 deletions

diff --git a/Documentation/dtas-player.txt b/Documentation/dtas-player.txt
deleted file mode 100644
index c8a17df..0000000
--- a/Documentation/dtas-player.txt
+++ /dev/null
@@ -1,125 +0,0 @@
-% dtas-player(1) dtas user manual
-%
-
-# NAME
-
-dtas-player - playback process for dtas
-
-# SYNOPSYS
-
-dtas-player
-
-# DESCRIPTION
-
-dtas-player is intended as a music player, but implemented as Unix
-process and pipeline manager, so it may run arbitrary commands and route
-data to just about any process.
-
-dtas-player is currently only queue-based, enqueued tracks are played
-only once.  It only runs in a foreground console, so usage with
-screen(1) or tmux(1) is recommended.
-
-By default, dtas-player uses the sox(1) command to decode audio, and
-pipes the data to a play(1) process (also distributed with sox).  It may
-be configured to output to multiple/arbitrary processes, and may invoke
-arbitrary commands for outputting audio (or any other data).
-
-dtas-player is controlled by a Unix socket, see dtas-player_protocol(7)
-for details.  Given the power of dtas-player to run arbitrary commands,
-this socket is created with restricted permissions and is only
-accessible by the user who invoked dtas-player.
-
-dtas-player maintains state across restarts with a state file.
-
-# EXAMPLE
-
-Starting dtas-player is easy, it takes no arguments:
-
-    $ dtas-player
-
-In a different terminal, enqueue your favorite track for playback:
-
-    $ dtas-enq /path/to/your/favorite/music.flac
-
-In the terminal running dtas-player, some diagnostic information
-should be printed, as will any errors which occur.
-
-To see information about the currently playing track in YAML:
-
-    $ dtas-ctl current
-
-As you should be able to see, a "default" sink is automatically
-created and playing the audio.
-
-# TROUBLESHOOTING
-
-
-
-## Audio playback does not start
-
-The most common problem with dtas-player is the play(1) command
-(distributed with SoX) not using the correct audio device/driver.
-Ensuring the play(1) command works with dtas-player is important.
-Consult SoX documentation and mailing lists for getting play(1) to work,
-first.
-
-Once you find the correct AUDIODEV/AUDIODRIVER environment variables,
-you may set them via dtas-ctl(1):
-
-To play audio on my favorite USB DAC directly to ALSA, I use:
-
-    $ dtas-ctl sink ed default env.AUDIODEV=hw:DAC env.AUDIODRIVER=alsa
-
-## 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 avconv(1) or ffmpeg(1) to extract
-the desired audio stream.
-
-      avconv -analyzeduration 2G -probesize 2G \
-        -i input.vob -vn -sn -c:a copy -map 0:$STREAM_NR output.ext
-
-# ADVANCED EXAMPLES
-
-See dtas_player-sink_examples(7) for more sink examples.
-
-# ENVIRONMENT
-
-DTAS_PLAYER_SOCK - the path to the dtas-player listen socket.
-This defaults to ~/.dtas/player.sock
-
-DTAS_PLAYER_STATE - the state file of the dtas-player
-This defaults to ~/.dtas/player_state.yml
-
-dtas-player will automatically populate $SOXFMT and $ECAFMT when
-invoking sink and source commands.
-
-ReplayGain values are also exported to the source command if they
-exist in the source file:
-
-    * REPLAYGAIN_TRACK_GAIN
-    * REPLAYGAIN_ALBUM_GAIN
-    * REPLAYGAIN_ALBUM_PEAK
-    * REPLAYGAIN_TRACK_PEAK
-
-# FILES
-
-~/.dtas/player_state.yml is a human-readable YAML file used to preserve
-state across restarts of dtas-player.
-
-# CONTACT
-
-All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
-Mailing list archives available at <http://80x24.org/dtas-all/> and
-<ftp://lists.gnu.org/dtas-all/>\
-No subscription is necessary to post to the mailing list.
-
-# COPYRIGHT
-
-Copyright 2013-2016 all contributors <dtas-all@nongnu.org>.\
-License: GPL-3.0+ <http://www.gnu.org/licenses/gpl-3.0.txt>
-
-# SEE ALSO
-
-dtas-player_protocol(7), dtas-ctl(1), dtas-enq(1), dtas-sourceedit(1),
-dtas-sinkedit(1), sox(1), play(1), avconv(1), ffmpeg(1), screen(1), tmux(1)