add: man page for discspan

diff --git a/docs/discspan.1 b/docs/discspan.1
new file mode 100644 (file)
index 0000000..889092c
--- /dev/null
+++ b/docs/discspan.1
@@ -0,0 +1,55 @@
+.TH "DISCSPAN" "1" 2021-09-05 "discspan 1.0.0" "man for discspan"
+
+.SH SYNOPSIS
+.B discspan
+\fIoption \fB-i \fIsource \fB-o \fIprefix
+
+.SH DESCRIPTION
+Tool split data optimized on media (e.g. DVD). It uses a text file of file
+pathes split into multiple text files. Output text files contains the file
+pathes for each media.
+
+.SH OPTIONS
+.TP
+.BR -i " \fIsource"
+path to source text file, this file contains all file pathes
+.TP
+.BR -o " \fIprefix"
+prefix for output files
+.TP
+.BR -b
+size of Bluray: 25.000.000.000 bytes
+.TP
+.BR -9
+size of double layer DVD 8.500.000.000 bytes
+.TP
+.BR -5
+size of sigle layer DVD: 4.700.000.000 bytes
+.TP
+.BR -c
+size of CD: 734.003.200 bytes
+.TP
+.BR -f " \fIsize"
+size in bytes
+.TP
+.BR -v
+show version
+.TP
+.BR -h
+show help
+
+.SH EXAMPLES
+.SS 1. Create a data file list:
+find /pfad/zur/den/Dateien -type f > testfile
+.SS 2. Execute discspan to split files on single layer DVD
+discspan -i testfile -o medium -5
+.SS 3. Copy files from text file into seperated folder
+.TP
+rsync -av --files-from=medium / /pfad/zum/wegkopieren/
+.TP
+or
+.TP
+cat medium | xargs -i cp -rl --parents {} /pfad/zum/wegkopieren
+
+.SH AUTHOR
+Bastian Dehn <hhaalo@arcor.de>