3
|
1 .\" Hey, EMACS: -*- nroff -*-
|
|
2 .\" First parameter, NAME, should be all caps
|
|
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
4 .\" other parameters are allowed: see man(7), man(1)
|
|
5 .TH READPST 1 "February 24, 2004"
|
|
6 .\" Please adjust this date whenever revising the manpage.
|
|
7 .\"
|
|
8 .\" Some roff macros, for reference:
|
|
9 .\" .nh disable hyphenation
|
|
10 .\" .hy enable hyphenation
|
|
11 .\" .ad l left justify
|
|
12 .\" .ad b justify to both left and right margins
|
|
13 .\" .nf disable filling
|
|
14 .\" .fi enable filling
|
|
15 .\" .br insert line break
|
|
16 .\" .sp <n> insert n+1 empty lines
|
|
17 .\" for manpage-specific macros, see man(7)
|
|
18 .SH NAME
|
|
19 readpst \- convert PST (MS Outlook Personal Folders) files to mbox format
|
|
20 .SH SYNOPSIS
|
|
21 .B readpst
|
|
22 .RI [ options ] " files" ...
|
|
23 .SH DESCRIPTION
|
|
24 This manual page documents briefly the
|
|
25 .B readpst
|
|
26 command.
|
|
27 .PP
|
|
28 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
|
29 .\" \fI<whatever>\fP escape sequences to invode bold face and italics,
|
|
30 .\" respectively.
|
|
31 \fBreadpst\fP is a program that can read an Outlook PST (Personal Folders) file
|
|
32 and convert it into an mbox file, a format suitable for KMail, a recursive mbox
|
|
33 structure, or seperate emails.
|
|
34 .SH OPTIONS
|
|
35 A summary of options is included below.
|
|
36 .TP
|
|
37 .B \-d
|
|
38 Specify name of debug log file. Defaults to "readpst.log". The log
|
|
39 file isn\'t an ascii file, it is a binary file readable by \fBreadpstlog\fP.
|
|
40 .TP
|
|
41 .B \-h
|
|
42 Show summary of options.
|
|
43 .TP
|
|
44 .B \-k
|
|
45 Changes the output format to KMail.
|
|
46 .TP
|
|
47 .B \-o
|
|
48 Specifies the output directory. The directory must already exist, and
|
|
49 is entered after the PST file is opened, but before any processing of
|
|
50 files commences.
|
|
51 .TP
|
|
52 .B \-q
|
|
53 Changes to silent mode. No feedback is printed to the screen, except
|
|
54 for error messages.
|
|
55 .TP
|
|
56 .B \-r
|
|
57 Changes the output format to Recursive. This will create folders as
|
|
58 named in the PST file, and will put all emails in a file called "mbox"
|
|
59 inside each folder. These files are then compatible with all
|
|
60 mbox\-compatible email clients.
|
|
61 .TP
|
|
62 .B \-S
|
|
63 Output messages into seperate files. This will create folders as
|
|
64 named in the PST file, and will put each email in its own file. These
|
|
65 files will be numbered from 000000000 increasing in intervals of 1 (ie
|
|
66 000000000, 000000001, 0000000002). Any attachments are saved alongside
|
|
67 each email as 000000000\-attach0, or with the name of the attachment if
|
|
68 one is present.
|
|
69 .TP
|
|
70 .B \-V
|
|
71 Show version of program.
|
|
72 .TP
|
|
73 .B \-w
|
|
74 Overwrite any previous output files. \fBBeware\fP: When used with the \-S
|
|
75 switch, this will remove all files from the target folder before
|
|
76 writing. This is to keep the count of emails and attachments correct.
|
|
77 .SH SEE ALSO
|
|
78 .BR readpstlog (1)
|
|
79 .SH AUTHOR
|
|
80 This manual page was written by Dave Smith <dave.s@earthcorp.com>, and updated
|
|
81 by Joe Nahmias <joe@nahmias.net> for the Debian GNU/Linux system (but may be
|
|
82 used by others).
|