Mercurial > libpst

changeset 20:1acd3231c3a4

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 20:19:38 -0800
parents 1246d317a05b
children e5418051878c
files man/readpst.1 man/readpstlog.1 xml/Makefile.am xml/Makefile.in xml/libpst.in
diffstat 5 files changed, 110 insertions(+), 305 deletions(-) [+]
line wrap: on
line diff
--- a/man/readpst.1	Sun Feb 19 20:19:38 2006 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,106 +0,0 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "READPST" 1 "2006-02-19" "" ""
-.SH NAME
-readpst \- convert PST (MS Outlook Personal Folders) files to mbox format
-.SH "SYNOPSIS"
-.ad l
-.hy 0
-.HP 8
-\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\&.\&.\&.]
-.ad
-.hy
-
-.SH "DESCRIPTION"
-
-.PP
-This manual page briefly documents the \fBreadpst\fR command\&.
-
-.PP
- \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\&.
-
-.SH "OPTIONS"
-
-.TP
-\-c \fIformat\fR
-Set the Contact output mode\&. Use \-cv for vcard format or \-cl for an email list\&.
-
-.TP
-\-d \fIdebug\-file\fR
-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\&.
-
-.TP
-\-h
-Show summary of options\&.
-
-.TP
-\-k
-Changes the output format to KMail\&.
-
-.TP
-\-o \fIoutput\-directory\fR
-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\&.
-
-.TP
-\-q
-Changes to silent mode\&. No feedback is printed to the screen, except for error messages\&.
-
-.TP
-\-r
-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\&.
-
-.TP
-\-S
-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\&.
-
-.TP
-\-V
-Show version of program\&. Subsequent options are then ignored\&.
-
-.TP
-\-w
-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\&.
-
-.SH "SEE ALSO"
-
-.PP
- \fBreadpstlog\fR() 
-
-.SH "AUTHOR"
-
-.PP
-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>\&.
-
-.SH "COPYRIGHT"
-
-.PP
-Copyright (C) 2002 by David Smith <dave\&.s@earthcorp\&.com>\&. XML version Copyright (C) 2005 by 510 Software Group <carl@five\-ten\-sg\&.com>\&.
-
-.PP
-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\&.
-
-.PP
-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\&.
-
-.SH "CVS VERSION"
-
-.PP
-$Id$
-
--- a/man/readpstlog.1	Sun Feb 19 20:19:38 2006 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,118 +0,0 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "READPSTLOG" 1 "2006-02-19" "" ""
-.SH NAME
-readpstlog \- convert a readpst logfile to text format
-.SH "SYNOPSIS"
-.ad l
-.hy 0
-.HP 8
-\fBreadpst\fR [\fB\-f\ \fIformat\fR\fR] [\fB\-t\ \fIinclude\-types\fR\fR] [\fB\-x\ \fIexclude\-types\fR\fR] [logfile]
-.ad
-.hy
-
-.SH "DESCRIPTION"
-
-.PP
-This manual page briefly documents the \fBreadpstlog\fR command\&.
-
-.PP
- \fBreadpstlog\fR is a program that reads the binary logfile generated by \fBreadpst\fR, and outputs it in a more desirable format (i\&.e\&. text)\&.
-
-.SH "OPTIONS"
-
-.TP
-\-f \fIformat\fR
-Sets the format of the text log output\&. Currently, the only valid output format is T, for text; anything else gives the default\&.
-
-.TP
-\-t \fIinclude\-types\fR
-Print only the specified types of log messages\&. Types are specified in a comma\-delimited list (e\&.g\&. 3,10,5,6)\&.
-
-.TP
-\-x \fIexclude\-types\fR
-Exclude the specified types of log messages\&. Types are specified in a comma\-delimited list (e\&.g\&. 3,10,5,6)\&.
-
-.SH "MESSAGE TYPES"
-
-.PP
- \fBreadpstlog\fR understands the following types of log messages:
-
-.TP
-1
-File accesses
-
-.TP
-2
-Index accesses
-
-.TP
-3
-New email found
-
-.TP
-4
-Warnings
-
-.TP
-5
-Read accesses
-
-.TP
-6
-Informational messages
-
-.TP
-7
-Main function calls
-
-.TP
-8
-Decrypting calls
-
-.TP
-10
-Function calls
-
-.TP
-11
-HexDump calls
-
-.SH "AUTHOR"
-
-.PP
-This manual page was written by Joe Nahmias <joe@nahmias\&.net> for the Debian GNU/Linux system (but may be used by others)\&. It was converted to xml format by Carl Byington <carl@five\-ten\-sg\&.com>\&.
-
-.SH "COPYRIGHT"
-
-.PP
-Copyright (C) 2002 by David Smith <dave\&.s@earthcorp\&.com>\&. XML version Copyright (C) 2005 by 510 Software Group <carl@five\-ten\-sg\&.com>\&.
-
-.PP
-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\&.
-
-.PP
-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\&.
-
-.SH "CVS VERSION"
-
-.PP
-$Id$
-
--- a/xml/Makefile.am	Sun Feb 19 20:19:38 2006 -0800
+++ b/xml/Makefile.am	Sun Feb 19 20:19:38 2006 -0800
@@ -1,4 +1,4 @@
-all: dnsbl
+all: libpst
 	   cat header.xml  libpst >libpst.xml
 	   cat header.sgml libpst >libpst.sgml
 	   rm -f ../html/*html
--- a/xml/Makefile.in	Sun Feb 19 20:19:38 2006 -0800
+++ b/xml/Makefile.in	Sun Feb 19 20:19:38 2006 -0800
@@ -37,14 +37,14 @@
 host_triplet = @host@
 subdir = xml
 DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \
-	$(srcdir)/dnsbl.in
+	$(srcdir)/libpst.in
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
 am__aclocal_m4_deps = $(top_srcdir)/configure.in
 am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
 	$(ACLOCAL_M4)
 mkinstalldirs = $(install_sh) -d
 CONFIG_HEADER = $(top_builddir)/config.h
-CONFIG_CLEAN_FILES = dnsbl
+CONFIG_CLEAN_FILES = libpst
 SOURCES =
 DIST_SOURCES =
 DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
@@ -177,7 +177,7 @@
 	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
 $(ACLOCAL_M4):  $(am__aclocal_m4_deps)
 	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
-dnsbl: $(top_builddir)/config.status $(srcdir)/dnsbl.in
+libpst: $(top_builddir)/config.status $(srcdir)/libpst.in
 	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
 
 mostlyclean-libtool:
@@ -307,16 +307,16 @@
 	mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am \
 	uninstall-info-am
 
-all: dnsbl
-	   cat header.xml  dnsbl >dnsbl.xml
-	   cat header.sgml dnsbl >dnsbl.sgml
+all: libpst
+	   cat header.xml  libpst >libpst.xml
+	   cat header.sgml libpst >libpst.sgml
 	   rm -f ../html/*html
 	   rm -f ../html/*pdf
-	   xmlto        -o ../man  man   dnsbl.xml
-	   xmlto        -o ../html xhtml dnsbl.xml
-	   xmlto        -o ../html pdf   dnsbl.xml
-	   docbook2texi -o ../info       dnsbl.sgml
-	   rm -f dnsbl.xml dnsbl.sgml
+	   xmlto        -o ../man  man   libpst.xml
+	   xmlto        -o ../html xhtml libpst.xml
+	   xmlto        -o ../html pdf   libpst.xml
+	   docbook2texi -o ../info       libpst.sgml
+	   rm -f libpst.xml libpst.sgml
 # Tell versions [3.59,3.63) of GNU make to not export all variables.
 # Otherwise a system limit (for SysV at least) may be exceeded.
 .NOEXPORT:
--- a/xml/libpst.in	Sun Feb 19 20:19:38 2006 -0800
+++ b/xml/libpst.in	Sun Feb 19 20:19:38 2006 -0800
@@ -21,22 +21,12 @@
             <refmiscinfo>readpst @VERSION@</refmiscinfo>
         </refmeta>
 
-        <refnamediv id='name.1'>
+        <refnamediv id='readpst.name.1'>
             <refname>readpst</refname>
             <refpurpose>convert PST (MS Outlook Personal Folders) files to mbox format</refpurpose>
         </refnamediv>
 
-        <refsect1 id='description.1'>
-            <title>Description</title>
-            <para>This manual page briefly documents the <command>readpst</command> command.</para>
-            <para>
-                <command>readpst</command> 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.
-            </para>
-        </refsect1>
-
-        <refsynopsisdiv id='synopsis.1'>
+        <refsynopsisdiv id='readpst.synopsis.1'>
             <title>Synopsis</title>
             <cmdsynopsis>
                 <command>readpst</command>
@@ -54,7 +44,16 @@
             </cmdsynopsis>
         </refsynopsisdiv>
 
-        <refsect1 id='options.1'>
+        <refsect1 id='readpst.description.1'>
+            <title>Description</title>
+            <para>This manual page briefly documents the <command>readpst</command> command.</para>
+            <para><command>readpst</command> 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.
+            </para>
+        </refsect1>
+
+        <refsect1 id='readpst.options.1'>
             <title>Options</title>
             <variablelist>
                 <varlistentry>
@@ -83,7 +82,7 @@
                     </para></listitem>
                 </varlistentry>
                 <varlistentry>
-                    <term>-o <replaceable class="parameter">output-directory</term>
+                    <term>-o <replaceable class="parameter">output-directory</replaceable></term>
                     <listitem><para>
                         Specifies the output directory. The directory must already exist, and
                         is entered after the PST file is opened, but before any processing of
@@ -109,7 +108,7 @@
                 <varlistentry>
                     <term>-S</term>
                     <listitem><para>
-                        Output messages into seperate files. This will create folders as
+                        Output messages into separate 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
@@ -126,7 +125,7 @@
                 <varlistentry>
                     <term>-w</term>
                     <listitem><para>
-                        Overwrite any previous output files. <B>Beware</B>: When used with the -S
+                        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.
                     </para></listitem>
@@ -134,25 +133,25 @@
             </variablelist>
         </refsect1>
 
-        <refsect1 id='also.1'>
+        <refsect1 id='readpst.also.1'>
             <title>See Also</title>
             <para>
-                <citerefentry><refentrytitle>readpstlog</refentrytitle><para>
+                <citerefentry><refentrytitle>readpstlog</refentrytitle></citerefentry>
             </para>
         </refsect1>
 
-        <refsect1 id='author.1'>
+        <refsect1 id='readpst.author.1'>
             <title>Author</title>
             <para>
                 This manual page was originally written by Dave Smith
                 &lt;dave.s@earthcorp.com&gt;, and updated by Joe Nahmias &lt;joe@nahmias.net&gt;
                 for the Debian GNU/Linux system (but may be used by others). It was
-                subsequently updated by Brad Hards &ltbradh@frogmouth.net&gt;, and converted to
+                subsequently updated by Brad Hards &lt;bradh@frogmouth.net&gt;, and converted to
                 xml format by Carl Byington &lt;carl@five-ten-sg.com&gt;.
             </para>
         </refsect1>
 
-        <refsect1 id='copyright.1'>
+        <refsect1 id='readpst.copyright.1'>
             <title>Copyright</title>
             <para>
                 Copyright (C) 2002 by David Smith &lt;dave.s@earthcorp.com&gt;.
@@ -171,7 +170,7 @@
             </para>
         </refsect1>
 
-        <refsect1 id='version.1'>
+        <refsect1 id='readpst.version.1'>
             <title>CVS Version</title>
             <para>
                 $Id$
@@ -191,22 +190,12 @@
             <refmiscinfo>readpstlog @VERSION@</refmiscinfo>
         </refmeta>
 
-        <refnamediv id='name.1'>
+        <refnamediv id='readpstlog.name.1'>
             <refname>readpstlog</refname>
             <refpurpose>convert a readpst logfile to text format</refpurpose>
         </refnamediv>
 
-        <refsect1 id='description.1'>
-            <title>Description</title>
-            <para>This manual page briefly documents the <command>readpstlog</command> command.</para>
-            <para>
-                <command>readpstlog</command>
-                is a program that reads the binary logfile generated
-                by <command>readpst</command>, and outputs it in a more desirable format (i.e. text).
-            </para>
-        </refsect1>
-
-        <refsynopsisdiv id='synopsis.1'>
+        <refsynopsisdiv id='readpstlog.synopsis.1'>
             <title>Synopsis</title>
             <cmdsynopsis>
                 <command>readpst</command>
@@ -217,7 +206,17 @@
             </cmdsynopsis>
         </refsynopsisdiv>
 
-        <refsect1 id='options.1'>
+        <refsect1 id='readpstlog.description.1'>
+            <title>Description</title>
+            <para>This manual page briefly documents the <command>readpstlog</command> command.</para>
+            <para>
+                <command>readpstlog</command>
+                is a program that reads the binary logfile generated
+                by <command>readpst</command>, and outputs it in a more desirable format (i.e. text).
+            </para>
+        </refsect1>
+
+        <refsect1 id='readpstlog.options.1'>
             <title>Options</title>
             <variablelist>
                 <varlistentry>
@@ -244,46 +243,76 @@
             </variablelist>
         </refsect1>
 
-        <refsect1 id='message.types.1'>
+        <refsect1 id='readpstlog.message.types.1'>
             <title>Message Types</title>
             <para>
                 <command>readpstlog</command> understands the following types of log messages:
             </para>
             <variablelist>
-                <listitem><para>
-                    1 File accesses
-                </para></listitem>
-                <listitem><para>
-                    2 Index accesses
-                </para></listitem>
-                <listitem><para>
-                    3 New email found
-                </para></listitem>
-                <listitem><para>
-                    4 Warnings
-                </para></listitem>
-                <listitem><para>
-                    5 Read accesses
-                </para></listitem>
-                <listitem><para>
-                    6 Informational messages
-                </para></listitem>
-                <listitem><para>
-                    7 Main function calls
-                </para></listitem>
-                <listitem><para>
-                    8 Decrypting calls
-                </para></listitem>
-                <listitem><para>
-                    10 Function calls
-                </para></listitem>
-                <listitem><para>
-                    11 HexDump calls
-                </para></listitem>
+                <varlistentry>
+                    <term>1</term>
+                    <listitem><para>
+                        File accesses
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>2</term>
+                    <listitem><para>
+                        Index accesses
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>3</term>
+                    <listitem><para>
+                        New email found
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>4</term>
+                    <listitem><para>
+                        Warnings
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>5</term>
+                    <listitem><para>
+                        Read accesses
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>6</term>
+                    <listitem><para>
+                        Informational messages
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>7</term>
+                    <listitem><para>
+                        Main function calls
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>8</term>
+                    <listitem><para>
+                        Decrypting calls
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>10</term>
+                    <listitem><para>
+                        Function calls
+                    </para></listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>11</term>
+                    <listitem><para>
+                        HexDump calls
+                    </para></listitem>
+                </varlistentry>
             </variablelist>
         </refsect1>
 
-        <refsect1 id='author.1'>
+        <refsect1 id='readpstlog.author.1'>
             <title>Author</title>
             <para>
                 This manual page was written by Joe Nahmias &lt;joe@nahmias.net&gt;
@@ -292,7 +321,7 @@
             </para>
         </refsect1>
 
-        <refsect1 id='copyright.1'>
+        <refsect1 id='readpstlog.copyright.1'>
             <title>Copyright</title>
             <para>
                 Copyright (C) 2002 by David Smith &lt;dave.s@earthcorp.com&gt;.
@@ -311,7 +340,7 @@
             </para>
         </refsect1>
 
-        <refsect1 id='version.1'>
+        <refsect1 id='readpstlog.version.1'>
             <title>CVS Version</title>
             <para>
                 $Id$