PI-TODO

Introduction:
   After suffering for quite some time without a decent stand-alone pilot
todo list program under linux, I decided to try my luck at programming one.
I was very familiar with perl, so I figured I'd take this opportunity to
expand my horizons and learn the Tk module for perl and pilot conduit
programming.  If you find this useful, or if you have any suggestions,
please let me know.

Author:
   twivel[AT]slothmud.org -- Twivel
        replace [AT] with @ above.

Documentation:
   This program reads the todolist from the filename given on the command line
or can read it from the pilot.  It defaults to using $HOME/.pi-todolist.
This program requires you to install the Tk module for perl.  Under RH 5.2,
you can download the perltk rpm from redhat contrib.  I couldn't find an RPM
for RH 6.0, so I just compiled and installed it.  This also requires the
pilot-link utilities, as well as installing the Perl5 module found in the
pilot-link distribution.

  The .pi-todolist format is one that I created from the format used by
  read-todos.  I realize it is not a "safe" format, in that if you include
  "Id:" as the first 3 chars of a line in a note, you lose the rest of the
  note.  I'm just being lazy right now.  I like a text format though.

If you want to know more, read the code [Do you feel lucky, PUNK?]
or try it out...

  If you lose all data on your pilot (eg hard reset), add the letter "n"
to the beginning of each Id: in your .pi-todolist. The next sync will place
all of these todo entries into the pilot.  For example, make:
Id: 2478194 instead read:  Id: n2478194 for each record in .pi-todolist.

Usage:
   pi-todo [todolist]

   Syncronizing between the pilot and pi-todo is setup so that the pilot
   always wins.  If a record is modified in both places, the pilot data is
   taken.  The Pilot-R button reads and replaces all data within pi-todo with
   the current data in the pilot, without sending any updates.

Disclaimer:
   This program might accidentally tie you up, connect electrodes to your
forehead, and initiate electro-shock-therapy if you aren't nice to it. It could also destroy all data on your computer, your pilot, or both, or even cause
you to quit your job and follow me to the edge of the world.  I will not
be held liable for anything you or it does.  Remember, use this program at
your own risk....  You've got at least half a brain if you are reading this.
Thats enough to know you should:
BACKUP YOUR PDA BEFORE USING THIS. or else..... *ZAP*

Frequently Asked Questions:
Q: Is this a beta version?
A: Call it alpha for now. Try it and you decide.

Q: Is this program Y2K compliant?
A: Yes, I ran s/Y/K/g on the source. (Dates won't be implemented until post Y2K)

Q: What license is this released under?
A: GNU GPL -- see the file: COPYING

Q: Why didn't you use kpilot,gpilot,pilotmgr,etc?
A: They are all great projects, but I really like the ical interface.
   Enough to sacrifice and run pi-addresses, and write my own todo list program.
   I couldn't find any other stand-alone pilot todo list application.

Q: Why does this code look like crap?
A: Cut me some slack... it's my first-ever perl/TK program.

Q: Can I contribute?
A: Please do! -- email me.

Q: What features would you like contributed, that you don't plan on writing?
A: Due Date support/selection from an ical style calender interface.
   Dialog/file browse window for picking the filename maybe.

Q: Why don't you add those features yourself?
A: Laziness, lack of time, etc. I got something that works and decided
   that was good enough for me.  Nevertheless, the rest would be nice.

Contributors:
   Twivel -- Maintainer, Author of initial version.

----
Be sure to contribute, i appreciate any help.
^1,6,17,26,38
Have a great day, may the weather be wonderful.
^1,6,16,26,27,29,33,41