File: otl2pdb.1

package info (click to toggle)
vimoutliner 0.3.4%2Bpristine-9.1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 592 kB
  • ctags: 287
  • sloc: python: 897; perl: 678; sh: 133; makefile: 29
file content (94 lines) | stat: -rw-r--r-- 2,602 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.\"                                      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).