From 3083b7fbe2bc6e8dcd935b10bb7a165257c5252b Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 18 Jan 2016 05:18:09 +0000 Subject: 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. --- Documentation/dtas-archive.txt | 62 ------------------------------------------ 1 file changed, 62 deletions(-) delete mode 100644 Documentation/dtas-archive.txt (limited to 'Documentation/dtas-archive.txt') diff --git a/Documentation/dtas-archive.txt b/Documentation/dtas-archive.txt deleted file mode 100644 index fdc818d..0000000 --- a/Documentation/dtas-archive.txt +++ /dev/null @@ -1,62 +0,0 @@ -% dtas-archive(1) dtas user manual -% - -# NAME - -dtas-archive - paranoid audio file copy - -# SYNOPSYS - -dtas-archive [OPTIONS] SOURCE DESTINATION - -# DESCRIPTION - -dtas-archive is intended for archiving audio data to/from laptops, -marginal USB ports, and computers without ECC memory, attempting -to read data multiple times in an attempt to detect memory or -bus corruption. dtas-archive may only be effective on machines -running the Linux kernel where posix_fadvise(2) can be used to -drop caches for a particular file after fsync(2). - -dtas-archive spawns sox(1) to archive audio data (likely uncompressed -WAVE) to FLAC and verifies the result using sndfile-cmp(1), a tool -implemented by different than sox and less likely to share the same bugs -(if any) as sox. - -# OPTIONS - --j, \--jobs [JOBS] -: Number of jobs to run in parallel. Incrementing this may hurt - performance on slow storage devices. Default: 1 - --n, \--dry-run -: Print, but do not run the commands to be executed - --s, \--quiet, \--silent -: Silent operation, commands are not printed as executed - --S, \--stats -: Run and save the text output of the sox "stats" effect as - $DESTINATION_FILE_WITHOUT_SUFFIX.stats next to the output file - --k, \--keep-going -: Continue after error - --r, \--repeat [COUNT] -: Number of times to repeat the sndfile-cmp(1) check. Default: 1 - -# COPYRIGHT - -Copyright 2015-2016 all contributors .\ -License: GPL-3.0+ - -# CONTACT - -All feedback welcome via plain-text mail to: \ -Mailing list archives available at and -\ -No subscription is necessary to post to the mailing list. - -# SEE ALSO - -sndfile-cmp(1), sox(1) -- cgit v1.2.3-24-ge0c7