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)