

                               ST ALMANAC
                        Version 1.0  May 1, 1991

          This file should contain ALMANAC.PRG, DATES.CAL, 9 Files
  with the extension .YRL and several monthly .CAL files.  Another file
  is available called ALM_MORE.LZH which contains several alternative
  almanac files .  HOLIDAYS.ALM shows various holidays from around
  the world on each date and BIRTHDAY.ALM shows a list of famous
  people born on each date.

          ST ALMANAC is designed to be an easy to use all purpose
  calendar and planner to keep track of holidays, special events,
  birthdays, appointments and anything else you want to keep an
  up to-date record of.  It includes thousands of holidays and 
  historical events in the files included with it.
          The program is shareware and if you find it useful
  a contribution of $10-$20 would be greatly appreciated.  Naturally
  I'll be glad to mail you back an updated version of the program.
  Any comments or suggestions can also be sent to:

                             Manfred Sierke
                             84 Barrette Street
                             Vanier, Ontario
                             Canada
                             K1L 8A3


  REQUIREMENTS
          Almanac must be run in medium resolution but otherwise should
  run on any Atari ST.  The program requires about 300k of free memory
  but unless you have a lot of accessories installed this should be
  no problem even on a 520ST.

  SETUP
          Included are numerous files which contain the data
  the program will require.  The program will look for these the
  first time it is run in the same path as it is itself located.
  However, I would suggest grouping all the files with the extension
  *.cal and *.alm in a one folder and the files with the
  extension *.yrl in another folder.  Then when the program is run
  use the 'Change Path' option in the menu bar to tell the program
  where the data files are and the 'Set Year Path' option to tell
  the program where the *.yrl files are located. Then use the 
  'Save Config' option to save these settings.  This will create a
  file call ALMANAC.CFG which will be read for the correct paths
  when the program is run.

  OVERVIEW
          Holidays and special events can be stored to be
  displayed on the same date (or day/week of month) for every
  year as well as keeping track of appointments for a specific
  date and year.
          ST ALMANAC maintains three distinct categories of data.
  These are the appointments mode, the diary mode and the almanac mode.
  There are also two main screens - the calendar screen which appears
  when the program is run, and the editor screen which shows the
  appointments for a specific date.  Clicking the mouse on the desired
  date switches to the editor screen.
          The default mode is the appointments mode and you'll notice
  that on the calendar screen the APPTS button is in inverse. To
  switch to one of the other modes click on the ALMANAC or on the
  DIARY button.  The data in the appointment mode or the dairy mode
  will be stored on disk in a file for that month/year whereas the
  data for the almanac mode will only be saved by month.  This is
  used as an almanac of events on that date without regard for the
  year.  Any changes of data will be automatically saved to the
  correct files when you change months or exit the program.

  THE MENU BAR
          'Change Path' and 'Set Year Path' have already been mentioned
  and allow the user to instruct the program where to find the
  required data files.  'Save Changes' does an immediate save of all
  data that has been altered.  If you wish to maintain several sets
  of data files this should be used before 'Change Path'. 'Save Almanac'
  allows you to save the data in the almanac mode to a different file
  name.  'Load Almanac' allows you to load in an alternate almanac file
  (extension *.alm).  If you wish to create a new almanac file enter
  in the name of the almanac file with an extension of ".alm"  and a
  file of that name will be created.
          'Print Calendar' sends a hard copy of the calendar to
  the printer if it is connected. 'Print Planner' does the same but
  in a planner type of format.
          'Save Config' saves the current data paths,the mode, and
  whether the editor should be in overwrite or insert(the default)
  mode to a file call ALMANAC.CFG.  This will be read when the program
  is run.  'Exit' saves any changes which have been made and returns
  you to the desktop.

  THE CALENDAR SCREEN
          Most of the screen is taken by the dates of the current
  month and in blue print you'll see any special events or holidays
  that fall on those dates.  A red check mark in the square indicates
  where there are appointments for that date (in the current mode).
  How to alter this display will be explained in the section on the
  editor screen.
          Of the buttons along the bottom the one marked 'appts'
  will be in inverse to indicate what mode is set. Clicking on
  'diary' or 'almanac' will switch to that mode.  Note that the text
  and check marks in the date boxes depend on which mode is in effect.
          The six buttons on the right allow for the changing of the
  month being displayed.  The year and month buttons allow you to
  go forward of baskward a year or a month at a time. This can also
  be done by using the cursers on the keyboard.  The 'reset'
  button reads the ST's internal clock and returns you to the correct
  month and year (assuming you set the clock when you booted the
  computer).  'Select' provides a selector box to chose the month
  and year you wish to go to.  The year can be changed with the mouse by
  clicking on the '+' or '-' box, using the up or down curser button
  or by typing in the year on the keyboard.  When done either press
  return or click on the 'OK' button.
          The 'Print' button prints a copy of the current month if
  a printer is connected.
          The 'Clear' button clears all appointments for the month
  in the current mode (appts/almanac/diary).
          The 'Exit' button saves all changes to disk and returns
  you to the desktop.
          The 'View Month' button shows you all appointments set
  for the current month in the selected mode.
          The 'View Year' button shows a variety of events that
  occured in the year. You can change the year of the display with
  the 'NEXT' or 'PREV' buttons.  These include the winners of various
  sport events and world headlines,etc.  If this is not working
  use the 'Set Year Path' option in the menu bar to locate the files
  which end in the extension *.yrl.

  THE EDITOR SCREEN
          This screen allows you to edit the events for a particular
  date.  The heading along the top of the screen shows which mode
  is set.  The mode or the date can be changed by the buttons along
  the bottom.  The 'clear' button clears all entries for this date
  not including 'by date:' or 'by day:'.  'Cancel' restores the
  entries to what they where before any changes where made.
  'Print' send a copy of the appointments for the next two weeks
  to the printer(only the first seven entries are sent to the printer).
  The 'Insert' (or 'Overwrte') buttons toggles the editor beween
  insert and overwrite.
          At the top of the screen you'll find two special entries.
  'BY DATE:' and 'BY DAY:' are for special events and holidays and
  are not dependent on the current mode but will always be displayed.
  Data entered here will also be shown for that date on the main
  calendar screen.  'BY DATE:' is for events which fall on a specific
  date of the year (eg:Christmas). 'BY DAY:' is for events which
  fall on a certain day of the week.  An example would be Mother's
  Day which falls on the second Sunday of May.  An entry here would
  be displayed on the appropriate day.  One could also make an entry 
  for the last day of a month (eg:Memorial Day falls on the last
  Monday of May) by saving it on the 5th week.  If the 5th occurence
  of that day does not occur in a month the event will be displayed
  on the 4th week.  To edit this entry though, skip to a year that
  has the 5th occurence and edit it there. These entries and the
  first appointment line if it includes an asterisk are the entries
  displayed for the dates on the main calendar screen.
  Example: "  this is *** Easter   Sunday *** today". If this is the
  first item in the appointments list "Easter Sunday" is the part
  that would be displayed on the calendar screen.  Since as
  many as four possible special entries could fall on the same
  date and only one can be shown on the calendar screen the order
  of precedence to determine which is shown is:
                 1. by day - last of month
                 2. by day
                 3. by date
                 4. 1st line of appointments after asterisk

          The curser can be moved to the desired location by clicking
  on the mouse or by using the keyboard curser key. There are also
  a few combination keys to make editing easier:
        Return - move to beginning of next line 
        Shifted left curser - move to beginning of line
        Shifted right curser - move to end of line
        Clr Home - move the start of the first appointment line
        Control c (center) - centers the text on that line
        Escape - if line is empty moves curser to the start of line,
  if it contains text erases the line and saves it to the 'Undo' buffer.
        Undo - restores the last line erased through escape if
  pressed while the curser is on an empty line.  Only appontment lines
  can be restored to an appointment line and by day/by date lines
  can only be restored to those headings.
        the following codes work only on the 10 appointment lines
  and not on the by day/by date headings:
        Control i or Control Insert - inserts an empty line. Any text 
  on the 10th appointment line will be lost.
        Control d or Control Delete - deletes the current line. If
  the line contained text this will be saved in the undelete buffer.
        Control u (undelete) - when pressed while the curser is on
  an empty line will restore the last line erased with control delete.

  FILES
          The monthly appts and diary modes are save to disk any time
  the months are changed in files with names comprised of "A" (appts)
  or "D" (diary) the year and the first 3 letters of the month
  and the extension ".CAL".  The special dates from the 'by date'
  and 'by day' headings and saved when the program is exited
  in a file called "DATES.CAL".  The almanac mode files are saved
  with the name of the almanac ("ALMANAC" by default) and the
  extension ".ALM" when the program is exited.  Files that are to
  be erased of written over are changed to an extension of ".BAK"
  so it'll be useful to check these every now and then remove all
  the ".BAK" files which are for there in case of an accidental
  erasure but are not required by the program.  The yearly events
  calendar requires the files with the extension ".YRL".

  THAT'S IT
          I hope you find that this program works as promised
  and is useful.  If you don't feel like sending in a shareware
  contribution feel free to use it anyways and perhaps one day
  you'll reconsider.
