TODO23.DOC
NOTICE: The program TODO.LIB and documentation TODO23.DOC are
copyrighted by Ludvik Krulik. TODO.LIB and TODO23.DOC may
be distributed non commercially, provided that program is
not modified and original documentation is preserved
unchanged. Commercial use of this material is not allowed
without prior permission from the author.
WARNING: The following library works ONLY on G/GX series HP48
calculators. It has been tested on G/rev M and GX/rev R,
but I suppose it should work on other versions as well.
USE AT YOUR OWN RISK.
If you have any questions, suggestions or bug reports,
drop me an e-mail at Ludvik.Krulik@snet.fer.uni-lj.si
1. Overview
TODO v2.3 == TO-DO manager
TODO consists of two programs:
- TODO, program itself
- ABOUTTODO
Additional, separate programs named UPGRADE and UPGRADE2 are
used to convert to-do files
from v1.0 and v1.1 into v2.1 and
from v2.0 into v2.1, respectively.
Other upgrades are compatible.
The code is written entirely in SysRPL. My main concern was the
size of the program.
2. Revision history
- Version 1.1:
- Fixed bug: after calling DBASE 3.0 or 3.1 program (by
Matthew Todd Eckrich), CAL wouldn't refresh screen.
- Removed QCD and SIZER from library. They can be found in
LKUTILS package.
- Version 2.0:
- Added date component to every to-do entry.
- Added INFORM instead of INPUT for data entry.
- Added back-up of TODOs directory via XModem.
- Added UPGRADE program.
- Changed CAL display for more HP look with two new menu keys.
- Fixed bug: When putting record on stack from DBASE program,
CAL would eat it.
- Version 2.1:
- Removed CAL, ALARM and WAKEUP from library and renamed it
from CALTD into TODO. CAL can be found in a separate
library called CALENDAR.
- Better handling if control alarm goes off when TODO is active.
- On exit, position of selection as well as to-do file name are
saved.
- Added order menu key.
- Version 2.2:
- Fixed bug from v2.1: TODO wouldn't start if there were no
TODO files.
- Added ability to call CALENDAR library directly from
ADD/EDIT input forms.
- Version 2.3:
- After running CALENDAR from ADD or EDIT input forms, TODO
automatically sets 'ATTACH DATE' field.
3. How to use TODO library
3.1 TODO
Even though a 'todo' is defined as a message, bound to
certain period of time, 'todo' in this lib has one part
(message) or two parts (message & date).
You can also have multiple lists of todos. For example:
one for what you have to buy, one for books from library, one
for home, one for school/work etc.
A to-do entry would look like this:
"SUN 30.07.95 TextOfTodo" or this:
"TUE 18.07.95 > TextOfTodo" or this:
"SUN 16.07.95 ? TextOfTodo" or this:
"TextOfTodo..............."
' ' means that the date of to-do is greater then current date
'>' means that the date of to-do is equal to current date
'?' means that to-do is past due
3.1.1 Soft keys:
[ADD ] [EDIT] [VIEW] [DEL ] [>>? ] [ >> ]
_
[NEW ] [PURG] [ORDER] [A. ] [ABOUT] [EXIT]
! Note: [ADD ] [EDIT] [VIEW] [DEL ] [>>? ]
[>> ] [PURGE] [ORDER] [A. ]
are not always active.
- ADD prompts you for new entry
After pressing ADD input form prompts you for message of
to-do and if you want to attach date.
If you decide to attach date,
- enter date and
- number of days/weeks/months to add to original date,
or
- press [CALE] menu key if you have CALENDAR library
(lib num 1500) installed.
Example: you have to return a book within a week:
Leave current date and add 1 week.
! Note: Immediately after pressing ADD, you can lock alpha
and start to write text without "" as long as you
include at least one space in the text. Using
spaces instead of other delimiters (.,-...) enables
VIEW message box to nicely word wrap the text.
! Note: If you enter illegal date, it will be discarded
with only the message remaining.
! Note: Adding 1 month equals adding 30 days!
- EDIT lets you edit an entry. Input form is the same as for
ADD.
- VIEW displays to-do message in a message box.
- DEL deletes highlighted entry.
- >>? displays choose box with available to-do files.
- >> advances to next to-do file.
- NEW prompts you for the name and creates empty to-do file.
! Note: You have to enter variable name as a string.
- PURGE purges current to-do file.
- ORDER puts current file in first place in TODOs directory.
This option is useful if you use non-valid file names that
cannot be sorted with regular ORDER command.
- A. (actually up arrow) backs up TODOs directory via XModem
protocol.
3.1.2 Key bindings:
- Cancel/Enter exits TODO.
- Up/Down arrow moves highlight one up/down.
- Up/Down arrow + RightShift moves highlight to beginning /
end of list.
- Up/Down arrow + LeftShift moves highlight up/down one page.
3.1.3 Notes
- to-do files are kept in TODOs sub directory in hidden
directory. TODOs sub directory also contains hidden file
called TODOpar. You can access hidden directory by
entering: #640BEh SYSEVAL
Warning: Do not attempt to modify to-do files outside TODO
program.
- TODO uses built in browser so it's a bit slow but much
shorter.
4. Data about library
- Version: 2.3
- ROM ID (library number): 1501
- Size: 3696.5 bytes
- Checksum: #639Dh
October 1995, Ludvik Krulik (Ludvik.Krulik@snet.fer.uni-lj.si)
