home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / STEN / STEN07.MSA / PROGRAMS / ALMANAC / ALMANAC.TXT < prev   
Encoding:
Text File  |  2010-04-21  |  11.3 KB  |  209 lines
  1.  
  2.  
  3.                                ST ALMANAC
  4.                         Version 1.0  May 1, 1991
  5.  
  6.           This file should contain ALMANAC.PRG, DATES.CAL, 9 Files
  7.   with the extension .YRL and several monthly .CAL files.  Another file
  8.   is available called ALM_MORE.LZH which contains several alternative
  9.   almanac files .  HOLIDAYS.ALM shows various holidays from around
  10.   the world on each date and BIRTHDAY.ALM shows a list of famous
  11.   people born on each date.
  12.  
  13.           ST ALMANAC is designed to be an easy to use all purpose
  14.   calendar and planner to keep track of holidays, special events,
  15.   birthdays, appointments and anything else you want to keep an
  16.   up to-date record of.  It includes thousands of holidays and 
  17.   historical events in the files included with it.
  18.           The program is shareware and if you find it useful
  19.   a contribution of $10-$20 would be greatly appreciated.  Naturally
  20.   I'll be glad to mail you back an updated version of the program.
  21.   Any comments or suggestions can also be sent to:
  22.  
  23.                              Manfred Sierke
  24.                              84 Barrette Street
  25.                              Vanier, Ontario
  26.                              Canada
  27.                              K1L 8A3
  28.  
  29.  
  30.   REQUIREMENTS
  31.           Almanac must be run in medium resolution but otherwise should
  32.   run on any Atari ST.  The program requires about 300k of free memory
  33.   but unless you have a lot of accessories installed this should be
  34.   no problem even on a 520ST.
  35.  
  36.   SETUP
  37.           Included are numerous files which contain the data
  38.   the program will require.  The program will look for these the
  39.   first time it is run in the same path as it is itself located.
  40.   However, I would suggest grouping all the files with the extension
  41.   *.cal and *.alm in a one folder and the files with the
  42.   extension *.yrl in another folder.  Then when the program is run
  43.   use the 'Change Path' option in the menu bar to tell the program
  44.   where the data files are and the 'Set Year Path' option to tell
  45.   the program where the *.yrl files are located. Then use the 
  46.   'Save Config' option to save these settings.  This will create a
  47.   file call ALMANAC.CFG which will be read for the correct paths
  48.   when the program is run.
  49.  
  50.   OVERVIEW
  51.           Holidays and special events can be stored to be
  52.   displayed on the same date (or day/week of month) for every
  53.   year as well as keeping track of appointments for a specific
  54.   date and year.
  55.           ST ALMANAC maintains three distinct categories of data.
  56.   These are the appointments mode, the diary mode and the almanac mode.
  57.   There are also two main screens - the calendar screen which appears
  58.   when the program is run, and the editor screen which shows the
  59.   appointments for a specific date.  Clicking the mouse on the desired
  60.   date switches to the editor screen.
  61.           The default mode is the appointments mode and you'll notice
  62.   that on the calendar screen the APPTS button is in inverse. To
  63.   switch to one of the other modes click on the ALMANAC or on the
  64.   DIARY button.  The data in the appointment mode or the dairy mode
  65.   will be stored on disk in a file for that month/year whereas the
  66.   data for the almanac mode will only be saved by month.  This is
  67.   used as an almanac of events on that date without regard for the
  68.   year.  Any changes of data will be automatically saved to the
  69.   correct files when you change months or exit the program.
  70.  
  71.   THE MENU BAR
  72.           'Change Path' and 'Set Year Path' have already been mentioned
  73.   and allow the user to instruct the program where to find the
  74.   required data files.  'Save Changes' does an immediate save of all
  75.   data that has been altered.  If you wish to maintain several sets
  76.   of data files this should be used before 'Change Path'. 'Save Almanac'
  77.   allows you to save the data in the almanac mode to a different file
  78.   name.  'Load Almanac' allows you to load in an alternate almanac file
  79.   (extension *.alm).  If you wish to create a new almanac file enter
  80.   in the name of the almanac file with an extension of ".alm"  and a
  81.   file of that name will be created.
  82.           'Print Calendar' sends a hard copy of the calendar to
  83.   the printer if it is connected. 'Print Planner' does the same but
  84.   in a planner type of format.
  85.           'Save Config' saves the current data paths,the mode, and
  86.   whether the editor should be in overwrite or insert(the default)
  87.   mode to a file call ALMANAC.CFG.  This will be read when the program
  88.   is run.  'Exit' saves any changes which have been made and returns
  89.   you to the desktop.
  90.  
  91.   THE CALENDAR SCREEN
  92.           Most of the screen is taken by the dates of the current
  93.   month and in blue print you'll see any special events or holidays
  94.   that fall on those dates.  A red check mark in the square indicates
  95.   where there are appointments for that date (in the current mode).
  96.   How to alter this display will be explained in the section on the
  97.   editor screen.
  98.           Of the buttons along the bottom the one marked 'appts'
  99.   will be in inverse to indicate what mode is set. Clicking on
  100.   'diary' or 'almanac' will switch to that mode.  Note that the text
  101.   and check marks in the date boxes depend on which mode is in effect.
  102.           The six buttons on the right allow for the changing of the
  103.   month being displayed.  The year and month buttons allow you to
  104.   go forward of baskward a year or a month at a time. This can also
  105.   be done by using the cursers on the keyboard.  The 'reset'
  106.   button reads the ST's internal clock and returns you to the correct
  107.   month and year (assuming you set the clock when you booted the
  108.   computer).  'Select' provides a selector box to chose the month
  109.   and year you wish to go to.  The year can be changed with the mouse by
  110.   clicking on the '+' or '-' box, using the up or down curser button
  111.   or by typing in the year on the keyboard.  When done either press
  112.   return or click on the 'OK' button.
  113.           The 'Print' button prints a copy of the current month if
  114.   a printer is connected.
  115.           The 'Clear' button clears all appointments for the month
  116.   in the current mode (appts/almanac/diary).
  117.           The 'Exit' button saves all changes to disk and returns
  118.   you to the desktop.
  119.           The 'View Month' button shows you all appointments set
  120.   for the current month in the selected mode.
  121.           The 'View Year' button shows a variety of events that
  122.   occured in the year. You can change the year of the display with
  123.   the 'NEXT' or 'PREV' buttons.  These include the winners of various
  124.   sport events and world headlines,etc.  If this is not working
  125.   use the 'Set Year Path' option in the menu bar to locate the files
  126.   which end in the extension *.yrl.
  127.  
  128.   THE EDITOR SCREEN
  129.           This screen allows you to edit the events for a particular
  130.   date.  The heading along the top of the screen shows which mode
  131.   is set.  The mode or the date can be changed by the buttons along
  132.   the bottom.  The 'clear' button clears all entries for this date
  133.   not including 'by date:' or 'by day:'.  'Cancel' restores the
  134.   entries to what they where before any changes where made.
  135.   'Print' send a copy of the appointments for the next two weeks
  136.   to the printer(only the first seven entries are sent to the printer).
  137.   The 'Insert' (or 'Overwrte') buttons toggles the editor beween
  138.   insert and overwrite.
  139.           At the top of the screen you'll find two special entries.
  140.   'BY DATE:' and 'BY DAY:' are for special events and holidays and
  141.   are not dependent on the current mode but will always be displayed.
  142.   Data entered here will also be shown for that date on the main
  143.   calendar screen.  'BY DATE:' is for events which fall on a specific
  144.   date of the year (eg:Christmas). 'BY DAY:' is for events which
  145.   fall on a certain day of the week.  An example would be Mother's
  146.   Day which falls on the second Sunday of May.  An entry here would
  147.   be displayed on the appropriate day.  One could also make an entry 
  148.   for the last day of a month (eg:Memorial Day falls on the last
  149.   Monday of May) by saving it on the 5th week.  If the 5th occurence
  150.   of that day does not occur in a month the event will be displayed
  151.   on the 4th week.  To edit this entry though, skip to a year that
  152.   has the 5th occurence and edit it there. These entries and the
  153.   first appointment line if it includes an asterisk are the entries
  154.   displayed for the dates on the main calendar screen.
  155.   Example: "  this is *** Easter   Sunday *** today". If this is the
  156.   first item in the appointments list "Easter Sunday" is the part
  157.   that would be displayed on the calendar screen.  Since as
  158.   many as four possible special entries could fall on the same
  159.   date and only one can be shown on the calendar screen the order
  160.   of precedence to determine which is shown is:
  161.                  1. by day - last of month
  162.                  2. by day
  163.                  3. by date
  164.                  4. 1st line of appointments after asterisk
  165.  
  166.           The curser can be moved to the desired location by clicking
  167.   on the mouse or by using the keyboard curser key. There are also
  168.   a few combination keys to make editing easier:
  169.         Return - move to beginning of next line 
  170.         Shifted left curser - move to beginning of line
  171.         Shifted right curser - move to end of line
  172.         Clr Home - move the start of the first appointment line
  173.         Control c (center) - centers the text on that line
  174.         Escape - if line is empty moves curser to the start of line,
  175.   if it contains text erases the line and saves it to the 'Undo' buffer.
  176.         Undo - restores the last line erased through escape if
  177.   pressed while the curser is on an empty line.  Only appontment lines
  178.   can be restored to an appointment line and by day/by date lines
  179.   can only be restored to those headings.
  180.         the following codes work only on the 10 appointment lines
  181.   and not on the by day/by date headings:
  182.         Control i or Control Insert - inserts an empty line. Any text 
  183.   on the 10th appointment line will be lost.
  184.         Control d or Control Delete - deletes the current line. If
  185.   the line contained text this will be saved in the undelete buffer.
  186.         Control u (undelete) - when pressed while the curser is on
  187.   an empty line will restore the last line erased with control delete.
  188.  
  189.   FILES
  190.           The monthly appts and diary modes are save to disk any time
  191.   the months are changed in files with names comprised of "A" (appts)
  192.   or "D" (diary) the year and the first 3 letters of the month
  193.   and the extension ".CAL".  The special dates from the 'by date'
  194.   and 'by day' headings and saved when the program is exited
  195.   in a file called "DATES.CAL".  The almanac mode files are saved
  196.   with the name of the almanac ("ALMANAC" by default) and the
  197.   extension ".ALM" when the program is exited.  Files that are to
  198.   be erased of written over are changed to an extension of ".BAK"
  199.   so it'll be useful to check these every now and then remove all
  200.   the ".BAK" files which are for there in case of an accidental
  201.   erasure but are not required by the program.  The yearly events
  202.   calendar requires the files with the extension ".YRL".
  203.  
  204.   THAT'S IT
  205.           I hope you find that this program works as promised
  206.   and is useful.  If you don't feel like sending in a shareware
  207.   contribution feel free to use it anyways and perhaps one day
  208.   you'll reconsider.
  209.