lintian doesn't like orphan packages with uploaders...

[debian/amanda] / man / tapelist.5

diff --git a/man/tapelist.5 b/man/tapelist.5
index 67a5847d41b56ad9704bb6d4a3d9b259705c2a76..a4de17354b022e892ef5a93db5f950d9cb226a7c 100644 (file)
--- a/man/tapelist.5
+++ b/man/tapelist.5
@@ -1,13 +1,22 @@
 '\" t
 .\"     Title: tapelist
 .\"    Author: James da Silva <jds@amanda.org>
-.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
-.\"      Date: 11/05/2009
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 01/10/2013
 .\"    Manual: File formats and conventions
-.\"    Source: Amanda 2.6.1p2
+.\"    Source: Amanda 3.3.3
 .\"  Language: English
 .\"
-.TH "TAPELIST" "5" "11/05/2009" "Amanda 2\&.6\&.1p2" "File formats and conventions"
+.TH "TAPELIST" "5" "01/10/2013" "Amanda 3\&.3\&.3" "File formats and conventions"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -19,16 +28,15 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
-tapelist \- The list of \fIAmanda\fR volumes in use
+tapelist \- The list of Amanda volumes in use
 .SH "DESCRIPTION"
 .PP
 The
 \fItapelist\fR
-file contains the list of tapes in active use\&. This file is not ordinarily ordinarily edited or examined manually\&. Its format may change, or it may be removed altogether, in future versions of
-\fIAmanda\fR\&. It contains lines of the form:
+file contains the list of tapes in active use\&. This file is not ordinarily ordinarily edited or examined manually\&. Its format may change, or it may be removed altogether, in future versions of Amanda\&. It contains lines of the form:
 .PP
 .nf
-YYYYMMDD label flags [#comment]
+YYYYMMDD label flags [BARCODE:barcode] [META:meta] [BLOCKSIZE:blocksize] [#comment]
 .fi
 .PP
 Where
@@ -39,14 +47,14 @@ is a label for the tape as written by
 \fBamlabel\fR
 and
 \fIflags\fR
-is one of "reuse" or "no\-reuse" and tells
-\fIAmanda\fR
-whether the tape may be reused\&. A non\-reusable tape will not be overwritten, even if it is older than
+is one of "reuse" or "no\-reuse" and tells Amanda whether the tape may be reused\&. A non\-reusable tape will not be overwritten, even if it is older than
 \fBdumpcycle\fR
 dumps\&. See the
 \fBreuse\fR
 options of
-\fBamadmin\fR(8)\&. The optional comment is prefixed with a \'#\' and continues to the end of the line\&. Amanda will maintain this comment until the tape is overwritten\&. Note that comments are not allowed on blank lines\&.
+\fBamadmin\fR(8)\&. The optional barcode is prefixed with \*(AqBARCODE\*(Aq if the volume have a barcode\&. The optional meta label is prefixed with \*(AqMETA\*(Aq if the volume is on a meta volume\&. The optional blocksize is prefixed with \*(AqBLOCKSIZE\*(Aq\&. The optional comment is prefixed with a \*(Aq#\*(Aq and continues to the end of the line\&. Amanda will maintain this comment until the tape is overwritten\&. Note that comments are not allowed on blank lines\&.
+.PP
+The file is sorted such that the most\-recently used tape appears on the first line, and the oldest tape appears on the last line\&.
 .PP
 \fBAmdump\fR
 and
@@ -56,6 +64,13 @@ will by default refuse to write to an unlabeled tape, or to a labeled tape that
 option) than there are runs in the backup cycle (see the
 \fBdumpcycle\fR
 option) to prevent overwriting a backup image that would be needed to do a full recovery\&.
+.SH "SEE ALSO"
+.PP
+\fBamanda\fR(8),
+\fBamanda.conf\fR(5)
+.PP
+The Amanda Wiki:
+: http://wiki.zmanda.com/
 .SH "AUTHORS"
 .PP
 \fBJames da Silva\fR <\&jds@amanda\&.org\&>