annotate man/readpst.1 @ 19:1246d317a05b

switch to automake/autoconf
author carl
date Sun, 19 Feb 2006 20:19:38 -0800
parents c508ee15dfca
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
2 .de Sh \" Subsection
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
3 .br
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
4 .if t .Sp
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
5 .ne 5
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
6 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
7 \fB\\$1\fR
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
8 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
9 ..
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
10 .de Sp \" Vertical space (when we can't use .PP)
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
11 .if t .sp .5v
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
12 .if n .sp
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
13 ..
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
14 .de Ip \" List item
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
15 .br
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
16 .ie \\n(.$>=3 .ne \\$3
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
17 .el .ne 3
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
18 .IP "\\$1" \\$2
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
19 ..
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
20 .TH "READPST" 1 "2006-02-19" "" ""
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
21 .SH NAME
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
22 readpst \- convert PST (MS Outlook Personal Folders) files to mbox format
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
23 .SH "SYNOPSIS"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
24 .ad l
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
25 .hy 0
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
26 .HP 8
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
27 \fBreadpst\fR [\fB\-c\ \fIformat\fR\fR] [\fB\-d\ \fIdebug\-file\fR\fR] [\fB\-h\fR] [\fB\-k\fR] [\fB\-o\ \fIoutput\-directory\fR\fR] [\fB\-q\fR] [\fB\-r\fR] [\fB\-S\fR] [\fB\-V\fR] [\fB\-w\fR] [files\&.\&.\&.]
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
28 .ad
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
29 .hy
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
30
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
31 .SH "DESCRIPTION"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
32
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
33 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
34 This manual page briefly documents the \fBreadpst\fR command\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
35
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
36 .PP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
37 \fBreadpst\fR is a program that can read an Outlook PST (Personal Folders) file and convert it into an mbox file, a format suitable for KMail, a recursive mbox structure, or separate emails\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
38
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
39 .SH "OPTIONS"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
40
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
41 .TP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
42 \-c \fIformat\fR
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
43 Set the Contact output mode\&. Use \-cv for vcard format or \-cl for an email list\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
44
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
45 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
46 \-d \fIdebug\-file\fR
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
47 Specify name of debug log file\&. Defaults to "readpst\&.log"\&. The log file isn't an ascii file, it is a binary file readable by \fBreadpstlog\fR\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
48
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
49 .TP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
50 \-h
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
51 Show summary of options\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
52
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
53 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
54 \-k
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
55 Changes the output format to KMail\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
56
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
57 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
58 \-o \fIoutput\-directory\fR
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
59 Specifies the output directory\&. The directory must already exist, and is entered after the PST file is opened, but before any processing of files commences\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
60
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
61 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
62 \-q
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
63 Changes to silent mode\&. No feedback is printed to the screen, except for error messages\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
64
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
65 .TP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
66 \-r
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
67 Changes the output format to Recursive\&. This will create folders as named in the PST file, and will put all emails in a file called "mbox" inside each folder\&. These files are then compatible with all mbox\-compatible email clients\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
68
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
69 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
70 \-S
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
71 Output messages into seperate files\&. This will create folders as named in the PST file, and will put each email in its own file\&. These files will be numbered from 000000000 increasing in intervals of 1 (ie 000000000, 000000001, 0000000002)\&. Any attachments are saved alongside each email as 000000000\-attach0, or with the name of the attachment if one is present\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
72
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
73 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
74 \-V
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
75 Show version of program\&. Subsequent options are then ignored\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
76
16
c508ee15dfca switch to automake/autoconf
carl
parents:
diff changeset
77 .TP
19
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
78 \-w
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
79 Overwrite any previous output files\&. Beware: When used with the \-S switch, this will remove all files from the target folder before writing\&. This is to keep the count of emails and attachments correct\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
80
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
81 .SH "SEE ALSO"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
82
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
83 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
84 \fBreadpstlog\fR()
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
85
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
86 .SH "AUTHOR"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
87
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
88 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
89 This manual page was originally written by Dave Smith <dave\&.s@earthcorp\&.com>, and updated by Joe Nahmias <joe@nahmias\&.net> for the Debian GNU/Linux system (but may be used by others)\&. It was subsequently updated by Brad Hards <bradh@frogmouth\&.net>, and converted to xml format by Carl Byington <carl@five\-ten\-sg\&.com>\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
90
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
91 .SH "COPYRIGHT"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
92
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
93 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
94 Copyright (C) 2002 by David Smith <dave\&.s@earthcorp\&.com>\&. XML version Copyright (C) 2005 by 510 Software Group <carl@five\-ten\-sg\&.com>\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
95
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
96 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
97 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
98
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
99 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
100 You should have received a copy of the GNU General Public License along with this program; see the file COPYING\&. If not, please write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA\&.
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
101
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
102 .SH "CVS VERSION"
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
103
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
104 .PP
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
105 $Id$
1246d317a05b switch to automake/autoconf
carl
parents: 16
diff changeset
106