Mercurial > libpst

comparison man/readpst.1 @ 16:c508ee15dfca

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
switch to automake/autoconf
author carl
date Sun, 19 Feb 2006 18:47:46 -0800
parents
children 1246d317a05b
comparison
equal deleted inserted replaced
15:ac98f448b6ab 16:c508ee15dfca
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 "15 January 2005"
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 \-c
38 Set the Contact output mode. Use -cv for vcard format or -cl for
39 an email list
40 .TP
41 .B \-d
42 Specify name of debug log file. Defaults to "readpst.log". The log
43 file isn\'t an ascii file, it is a binary file readable by \fBreadpstlog\fP.
44 .TP
45 .B \-h
46 Show summary of options. Subsequent options are then ignored.
47 .TP
48 .B \-k
49 Changes the output format to KMail.
50 .TP
51 .B \-o
52 Specifies the output directory. The directory must already exist, and
53 is entered after the PST file is opened, but before any processing of
54 files commences.
55 .TP
56 .B \-q
57 Changes to silent mode. No feedback is printed to the screen, except
58 for error messages.
59 .TP
60 .B \-r
61 Changes the output format to Recursive. This will create folders as
62 named in the PST file, and will put all emails in a file called "mbox"
63 inside each folder. These files are then compatible with all
64 mbox\-compatible email clients.
65 .TP
66 .B \-S
67 Output messages into seperate files. This will create folders as
68 named in the PST file, and will put each email in its own file. These
69 files will be numbered from 000000000 increasing in intervals of 1 (ie
70 000000000, 000000001, 0000000002). Any attachments are saved alongside
71 each email as 000000000\-attach0, or with the name of the attachment if
72 one is present.
73 .TP
74 .B \-V
75 Show version of program. Subsequent options are then ignored.
76 .TP
77 .B \-w
78 Overwrite any previous output files. \fBBeware\fP: When used with the \-S
79 switch, this will remove all files from the target folder before
80 writing. This is to keep the count of emails and attachments correct.
81 .SH SEE ALSO
82 .BR readpstlog (1)
83 .SH AUTHORS
84 This manual page was originally written by Dave Smith
85 <dave.s@earthcorp.com>, and updated by Joe Nahmias <joe@nahmias.net>
86 for the Debian GNU/Linux system (but may be used by others). It was
87 subsequently updated by Brad Hards <bradh@frogmouth.net>.