TODAY 5.1b ********** 21-APR-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.1b - Added a forgotten ABND on ORGEDIT and ORGEDT. version 5.1a - Added a forgotten ABND on TODAY and ORGEDIT. - Adjusted ADDORG titles to say Organizer 1.1 version 5.1 - 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.