TODAY 5.1
*********

1-31-97
By Nate Morriss
mel-1@uiuc.edu

Note this program will only work with ORGANIZER v1.1 and 
above.

TODAY is a library to be used with ORGANIZER by Jack 
Levy.  Three commands are stored within the library: 
TODAY, ADDORG, ORGEDIT.  These programs are designed to 
make up for some small deficiencies of the ORGANIZER 
program.  Actually a forth command called GR1145 is also 
included for use with a library menu replacement I wrote.  
GR1145 contains only a grob and I suppose I should make 
it a hidden xlib...

Quick overview of commands:
***************************

[TODAY]
=======

  TODAY searches ORGANIZER's data file for annual events 
and appointments for the current date and displays them 
on the screen. 

Features:

 + Simple text browser for scrolling longer Appointments.
 + Uses the small font from the UFL for ten informative
   display lines.
 + Displays up to eight lines of appointments and
   indicates if more exist that don't fit on the screen.
 + Display's informative No Annual Event or No
   Appointments if applicable.
 + Errors out if UFL, FNT1 or OrgDATA not found.
 + Small calendar to graphical show what day of a month
   your on.  Current day flashes for about a minute and a
   half.
 + Parses appointment created by ADDORG into an
   abbreviated display.  Display the time followed by the
   first line of the appointment.

Directions:

  Just run TODAY and if the UFL and OrgDATA exist then 
you're all set.  Otherwise find those programs and 
install them NOW! 

Keys:

8: Scrolls one page up
2: Scrolls one page down
4 or LEFT ARROW: Moves one day back
6 or RIGHT ARROW: Moves one day forward
UP ARROW: Moves one week back
DOWN ARROW: Moves one week forward
TICK: Returns to current day
ON: Exits
OFF: Turns off

[ADDORG]
========

  This program is designed to simplify addition of 
appointment.  When run you will be prompted to change the 
time and date to when the appointment should be set.  
Then you will be prompted to enter the text for the 
desired appointment.  Finally you will be prompted to set 
an alarm.  ADDORG will then insert your appointments in 
the proper day and if other appointments exist created by 
ADDORG the new appointments will be inserted in the 
proper time order.

  Note this should work for any combination of 24 hour or 
AMPM time combinations.

Commands for changing time and date:

 + menu keys add to time or date
 + keys under menu subtract
 + DEL resets to current time and date
 + enter enters
 + ON cancels

Appointment entering information:

   An input line will appear with all the standard 
commands.  An alternate can be used by storing a command 
for the editor in EDIT in the home menu.  

   EXAMPLE
   << TED >> 'EDIT' STO

   If STRINGWRITER is used this may be a tricky 
accomplishment but can be done.

Alarm setting information:

   Finally you will be prompted for when and if to set an 
alarm.  This way you can schedule the appointment for the 
correct time and have an alarm go off ten minutes 
earlier.  The menu keys correspond to the number of 
minutes before the appointment to set an alarm any other 
key will skip setting an alarm.  ADDORG will set an alarm 
to run TODAY or 'ADDORGEXEC' in the home directory if it 
exists.  ADDORGEXEC can be anything you want to run to 
announce you have an appointment.

[ORGEDIT]
=========

  ORGEDIT is designed to be called from ORGANIZER as the 
alternate editor.  ORGEDIT allows from breaking a days 
appointments down to starting times and also allows for 
setting alarms.


Directions:

  To use ORGEDIT 1) go to the OPT menu in ORGANIZER 2) 
select EXTED 3) type in ORGEDIT.  Now when ->APP is 
selected ORGEDIT will be called up.  

  Once in ORGEDIT a selector is called up with a "misc:" 
field and fields for any timed appointments.  These 
fields may then be edited, deleted, time changed, viewed, 
or new apps added.  In addition an actual editor can be 
specified using an 'EDIT' global var in the home 
directory as described above.

Keys:

[EDIT]: Edits selected field.

[ADD]: Adds a timed app field with prompts for time and
       when to set an alarm.

[VIEW] RIGHT ARROW: View the entire selected field.

[deltaTIME]: Change the time of a app field (doesn't
             change old alarms).

[DEL]: Delete selected app field (doesn't delete alarms).

[EXIT] ON ENTER: Exit ORGEDIT back to ORGANIZER you will
                 need to answer the question "SET ALARM".

UP ARROW: Move field up.

DOWN ARROW: Move fields down.

Notes:
======

  Due to not being able to determine if ->app or ->ann 
was pressed, when editing annual events use only the 
"misc: " field.

History:
********
version 5.0
  - Created and added ORGEDIT

version 4.0a
  - Fixed error check to make sure ORGANIZER 1.1 used

version 4.0
  - Works on ORGANIZER 1.1 but not 1.0

version 3.2
  - Fixed 5 minute bug (I forgot who told me this email
    me if it was you...)
  - Added appointment parser to display appointments
    added with ADDORG more compactly.
  - Added mini calendar
  - Rewrote TODAY keys similar to ORGANIZER
  - Improved browser for speed
  - Added location bar
  - Fixed midnight bug
  - some other stuff

version 3.11
  - ??? old versions...

Future Improvements:
********************

  - TODAY: Jump to specific date.
  - TODAY: Call to ADDORG
  - ADDORG: Block time periods i.e. 1:00P-3:00P (I doubt
    it though I'm not sure how to this..)
  - Attempt to use the XDB call to run TODAY for selected
    day.
  - Suggestions are welcome

Credits:
********

Mika Heiskanen: 
    - For JAZZ without which this program would not
      exist.

Jack Levy: 
    - For writing such a great program like ORGANIZER and
      also for writing the small font display routine
      (SDISP) I got from the UFL.
    - For allowing me to use a code segment for inserting
      appointments in order.

Andre Schoorl: 
    - For some great help and improvements in my code.
    - Also, for bringing us the UFL and getting Jack Levy
      to write the SDISP commands. 

Edric C. Kennemer:
    - Proposing the idea for ADDORG.