Merge branch 'develop' into spotlight

[netatalk.git] / man / man1 / apple_dump.1

diff --git a/man/man1/apple_dump.1 b/man/man1/apple_dump.1
index 56be391e3d1eaf4d96a5dabe51850854d44e39d5..f8676fda90bce203e9ed4fbeca5940da97fc0e73 100644 (file)
--- a/man/man1/apple_dump.1
+++ b/man/man1/apple_dump.1
@@ -1,13 +1,22 @@
 '\" t
 .\"     Title: apple_dump
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 22 May 2012
+.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
+.\"      Date: 16 Jul 2012
 .\"    Manual: Netatalk 3.0
 .\"    Source: Netatalk 3.0
 .\"  Language: English
 .\"
-.TH "APPLE_DUMP" "1" "22 May 2012" "Netatalk 3.0" "Netatalk 3.0"
+.TH "APPLE_DUMP" "1" "16 Jul 2012" "Netatalk 3.0" "Netatalk 3.0"
+.\" -----------------------------------------------------------------
+.\" * 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
 .\" -----------------------------------------------------------------
@@ -22,13 +31,13 @@
 apple_dump \- Dump AppleSingle/AppleDouble format data
 .SH "SYNOPSIS"
 .HP \w'\fBapple_dump\fR\fB\fR\fBapple_dump\fR\fB\fR\fBapple_dump\fR\fB\fR\fBapple_dump\fR\fB\fR\fBapple_dump\fR\fB\fR\fBapple_dump\fR\fB\fR\ 'u
-\fBapple_dump\fR\fB\fR [\-a] \fIFILE\fR | \fIDIR\fR 
+\fBapple_dump\fR\fB\fR [\-a] [\fIFILE\fR | \fIDIR\fR]
 .br
 \fBapple_dump\fR\fB\fR \-e \fIFILE\fR | \fIDIR\fR 
 .br
-\fBapple_dump\fR\fB\fR \-f \fIFILE\fR
+\fBapple_dump\fR\fB\fR \-f [\fIFILE\fR]
 .br
-\fBapple_dump\fR\fB\fR \-d \fIFILE\fR
+\fBapple_dump\fR\fB\fR \-d [\fIFILE\fR]
 .br
 \fBapple_dump\fR\fB\fR \-h | \-help | \-\-help 
 .br
@@ -36,10 +45,17 @@ apple_dump \- Dump AppleSingle/AppleDouble format data
 .SH "DESCRIPTION"
 .PP
 \fBapple_dump\fR
-dump AppleSingle/AppleDouble format data\&.
+is a perl script to dump AppleSingle/AppleDouble format data\&.
+.PP
+This script can dump various AppleSingle/AppleDouble data created by mailer, archiver, Mac OS X, Netatalk and so on\&.
+.PP
+With no
+\fIFILE\fR|\fIDIR\fR, or when
+\fIFILE\fR|\fIDIR\fR
+is \-, read standard input\&.
 .SH "OPTIONS"
 .PP
-\fB\-a\fR \fIFILE\fR|\fIDIR\fR
+\fB\-a\fR [\fIFILE\fR|\fIDIR\fR]
 .RS 4
 This is default\&. Dump a AppleSingle/AppleDouble file for
 \fIFILE\fR
@@ -62,13 +78,13 @@ or
 \fIDIR\fR\&.
 .RE
 .PP
-\fB\-f\fR \fIFILE\fR
+\fB\-f\fR [\fIFILE\fR]
 .RS 4
 Dump
 \fIFILE\fR\&. Assume FinderInfo to be FileInfo\&.
 .RE
 .PP
-\fB\-d\fR \fIFILE\fR
+\fB\-d\fR [\fIFILE\fR]
 .RS 4
 Dump
 \fIFILE\fR\&. Assume FinderInfo to be DirInfo\&.
@@ -85,12 +101,14 @@ Show version and exit
 .RE
 .SH "NOTE"
 .PP
-There is no way to detect whether FinderInfo is FileInfo or DirInfo\&. By default, apple_dump examins whether file or directory, a parent directory is \&.AppleDouble, filename is \&._*, filename is \&.Parent, and so on\&.
+There is no way to detect whether FinderInfo is FileInfo or DirInfo\&. By default, apple_dump examines whether file or directory, a parent directory is \&.AppleDouble, filename is \&._*, filename is \&.Parent, and so on\&.
 .PP
-If setting option \-e, \-f or \-d, assume FinderInfo and doesn\'t look for another file\&.
+If setting option \-e, \-f or \-d, assume FinderInfo and doesn\*(Aqt look for another file\&.
 .SH "SEE ALSO"
 .PP
 \fBad\fR(1),
 \fBgetfattr\fR(1),
 \fBattr\fR(1),
-\fBrunat\fR(1)
+\fBrunat\fR(1),
+\fBgetextattr\fR(8),
+\fBlsextattr\fR(8)