.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH otl2pdb 1 "January 13, 2005"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
otl2pdb \- converts vimoutliner outline to AddressDB Palm file.
.SH SYNOPSIS
.B otl2pdb
.RI [ filename ]
.SH DESCRIPTION
This manual page documents briefly the
.B otl2pdb
Perl script.
.P
.B otl2pdb
is a
.BR perl (1)
script that takes an outline from
.BR vimoutliner (1)
with contact information and creates an AddressDB.pdb file
for a Palm.
.P
For now this script can only create a .pdb file.
You then have to use a syncing tool to load it into your Palm.
I recommend the
.I pilot-link
package for linux.
.P
The format of the contact outline is the following:

    $category
        $record_name
            c:$cell
            a:$address
            ....
.P
You can have as many categories and records(entries) as you want.
The following are valid fields for a record with the necessary text
to indicate them in quotes:

    'a:'-address
    'c:'-cell
    'e:'-email
    'h:'-home phone
    'n:'-note
    'web:'-website
    'w:'-work phone

Also, each record's category is left as 'Unfiled' as I can't get the record's
category to write correctly.

.SH SEE ALSO
.BR vim (1),
.BR perl (1)
.SH REQUIREMENTS
This program uses the
.B Palm::Address
perl module, which is available on
.B CPAN.
.SH TIPS
If using the pilot-link package:

    -load the pdb with 'pilot-xfer -i AddressDB.pdb'
    -specify the serial port if other than /dev/pilot (which will usually be the case
    unless you link to it) with -p in the above command; usually this is /dev/ttyS0 in linux

.SH AUTHOR
The original version was written by Gabriel Walker
<cldwalker@chwhat.com>.
.P
If you like using perl, linux, vim and databases to make your
life easier (not lazier ;) check out my website at
.UR http://www.chwhat.com
http://www.chwhat.com.
.UE
.P
This manual page was written by Matej Cepl <matej@ceplovi.cz>
(using
.BR perldoc (1)
part of the documented script),
for the Debian GNU/Linux system (but may be used by others).