pilot-read-todos(1)

💖 NAME 💖

pilot-read-todos — the little conduit that syncronizes your Palm ToDo application's database with your desktop machine. bestie, it's literally the bridge between your ancient lil handheld and your computer 🫶

🌸 SECTION 🌸

pilot-link: Userland conduits — yep, that's the club it's in ✨

🎀 SYNOPSIS 🎀

 pilot-read-todos [-p|--port <port>] [-q|--quiet] [-A|--archived]
[-w|--write]

 pilot-read-todos [-f|--file  file] [-A|--archived] [-w|--write]

 pilot-read-todos [--version] [-?|--help] [--usage]

no cap, those are the three shapes this thing comes in 👑

🦋 DESCRIPTION 🦋

okay so here's the vibe: pilot-read-todos will read the ToDo database on the Palm handheld, or it'll read the ToDoDB.pdb file directly from disk on your desktop machine, and then it prints the contents to STDOUT (which is generally the screen, iykyk).

use only one of --port or --file. like, pick one. not both. the manpage said it, not me 💅

---

✨ OPTIONS ✨

💜 pilot-read-todos option

• -f, --file file — read a local todo database file from disk for printing. this one excludes --port 🚫
• -A, --archived — write archived entries only, in human-readable format 📝
• -w, --write — write output — every operation must include a write command. it's giving mandatory, fr fr

🧚 Conduit Options

• -p, --port port — use device file port to talk to the Palm handheld device. if this isn't specified, pilot-read-todos will look for the $PILOTPORT environment variable. if neither are found or supplied, pilot-read-todos will print the usage information. also: it excludes --file 💀
• -q, --quiet — suppress the 'Hit HotSync button' message 🤫
• -v, --version — display version of pilot-read-todos and exit without connecting. no connection, just vibes ✌️

🌈 Help Options

• -h, --help — display the help synopsis for pilot-read-todos and exit without connecting 🙋‍♀️
• --usage — display a brief usage message and exit without connecting. short and sweet 🍓

---

⭐ USAGE ⭐

connect to a target Palm handheld and read the ToDo database, or read the ToDoDB.pdb file from disk and print the entries found to STDOUT. either way, you're getting your todos, bestie 💅

🔥 EXAMPLES 🔥

read the on-Palm ToDo database, and dump to STDOUT:

 pilot-read-todos  -w  -p  /dev/pilot

read the ToDoDB.pdb file on disk, and dump to STDOUT:

 pilot-read-todos  -w  -f  ToDoDB.pdb

see? -w in both. the manpage told us it's mandatory and it was NOT kidding 👑

👑 AUTHOR 👑

pilot-read-todos was originally written by Kenneth Albanowski — thank you icon, we appreciate you 🫶

😭 BUGS 😭

🩹 Known Bugs

lowkey a sad one: pilot-read-todos does not support Notes attached to ToDo items at this time. notes girlies, we'll have to wait 💔

🐛 Reporting Bugs

we have an online bug tracker. using this is the only way to ensure that your bugs are recorded and that we can track them until they are resolved or closed. reporting bugs via email, while easy, is not very useful in terms of accountability. please point your browser to http://bugs.pilot-link.org: http://bugs.pilot-link.org and report your bugs and issues there 🙈

💖 COPYRIGHT 💖

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 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTIBILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details. (yes, that caps lock is load-bearing, do not touch it 😤)

you should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

🎀 SEE ALSO 🎀

install-todo (1), install-todos (1), pilot-link(7) — go read those too, bestie, they're iconic 🌟

---

and that's the whole page, mwah 💋 this was pilot-read-todos(1) from the PILOT-LINK manual, version 0.13.0, Copyright 1996-2007 FSF — periodt, go sync those todos 🦋✨