.TH DDSTOOL 1 "9 Januar 1997"
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
ddstool \- simple shell script to manage dds tapes
.SH SYNOPSIS
.B ddstool
.I "<command> <options>"
.SH "DESCRIPTION"
This manual page documents briefly the
.BR ddstool
command.
This manual page was written for the Debian GNU/Linux distribution
(but may be used by others), because the original program does not
have a manual page.
.PP
Since the version of tar now shipping in Debian does not contain the
patch necessary to support the \-\-record-file option, this program 
will do nothing useful unless you're running a locally patched version
of tar.
.PP
First label a tape:
.RS
.sp
ddstool create-label 'unique-string and more'
.sp
.RE
To archive something:
.RS
.sp
ddstool append pathnames...
.sp
.RE
To delete the old index-files and make a new label:
.RS
.sp
ddstool new-label 'unique-string and more strings'
.sp
.RE
Each index is stored by the pathnames:
.RS
.sp
$A/$unique-string.$file-number         (soft link)

$A/$timestamp-of-the-tapelabel.$file-number (file)
.sp
.RE
.SH AUTHOR
This manual page was written by Christian Schwarz
for the Debian GNU/Linux system.