home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / accs / cal47 / calshow.doc < prev    next >
Encoding:
Text File  |  1991-03-16  |  6.1 KB  |  133 lines
  1.              CalShow v4.7  --  Copyright (c)1991 by Bill Aycock
  2.  
  3.  
  4. CalShow is designed to run from your AUTO folder when you boot your ST. It
  5. will find Cal, read all your events, and display an entire screen's worth of
  6. events so you can easily see what's on tap for the next few weeks.
  7.  
  8. You can also run CalShow from the desktop as a .TTP program. If you do so,
  9. you have the option of telling CalShow to:
  10.  
  11.         * print out the list of upcoming events
  12.         * save the list to a disk file
  13.         * specify a 'cutoff period' in days for displaying events
  14.         * specify the maximum number of events to list
  15.         * specify a starting or ending date for the display
  16.         * tell CalShow where to look for Cal
  17.         * show only significant events or all events
  18.  
  19.  
  20. * Installing CalShow as an AUTO program
  21.  
  22.  
  23. There are two steps involved in installing CalShow in your AUTO folder.
  24. First, you need to create a special "configuration file" which will be read
  25. when CalShow runs. This file must be called CALSHOW.PTH, and should be kept in
  26. the root directory of your boot disk. CALSHOW.PTH is a standard ASCII text file
  27. which can be created and edited with just about any ST word processor or text
  28. editor (as long as your editor has an option to 'Save as ASCII'). This file
  29. tells CalShow where it should look for the Cal program file. Just type in the
  30. full filename and path of your Cal program, hit Return, and save the file. The
  31. filename should be flush with the left side of the screen; don't add any spaces
  32. in front of the filename. Here's an example of a valid CALSHOW.PTH file:
  33.  
  34. C:\DESKACCS\CAL47.ACC
  35.  
  36. That one line is all it takes! The file CALSHOW.PTX included in this ARC is a
  37. sample CalShow path file; take a look at it if you have any questions.
  38.  
  39. If CalShow doesn't find its CALSHOW.PTH file, it will look for Cal in two
  40. places before it gives up. First it will try to find a file named \CAL????.AC?
  41. on your boot disk. (The question mark is a 'wildcard', which matches any
  42. character; see your ST Owner's Manual for more information.) If that doesn't
  43. work, CalShow will look for \ACCS\CAL????.AC? on your boot disk. (This means
  44. that if you don't rename Cal AND you have Cal in either your root directory or
  45. in a folder named \ACCS\, then you don't need to create a CALSHOW.PTH file.) If
  46. CalShow can't find Cal anywhere it looks, it will tell you so when it runs.
  47.  
  48.  
  49. When you have your CALSHOW.PTH file set up, just copy CALSHO47.PRG into the
  50. AUTO folder on your boot disk. Then, next time you boot up, you should see a
  51. screen of upcoming events automatically! The display sticks around for fifteen
  52. seconds, then the boot process continues. If you'd rather not wait the full
  53. fifteen seconds, just press any key to continue booting. If there are no
  54. significant events to display, CalShow shows a message and doesn't pause at
  55. all so your bootup isn't delayed. (If you pass CalShow a command line, even if
  56. it only contains a blank, the pause will occur.)
  57.  
  58.  
  59. NOTE: You _must_ use this version of CalShow if your copy of Cal has any
  60. events marked 'not significant'. The use of an older version may cause an
  61. address error or incorrect display when processing an event that is not
  62. significant.
  63.  
  64.  
  65. * Running CalShow from the desktop
  66.  
  67.  
  68. You can run CalShow from the desktop like any other program. Rename the file
  69. to have the extension .TTP, then double-click on its icon. When you see a
  70. dialog box asking you to enter parameters for the program, you can enter any
  71. combination of these commands:
  72.  
  73.     ?              display a screen showing the possible commands
  74.     a              show all events instead of just significant events
  75.     p              print (ignored if printer isn't online and ready)
  76.     p<filespec>    print output to a file (specify full filespec!)
  77.     =<filespec>    specify Cal's full filename (overrides CALSHOW.PTH)
  78.     c<number>      specify cutoff in days (0=no cutoff, default is 10)
  79.     n<number>      specify the number of upcoming events to list
  80.     s<mmddyyyy>    specify a starting date for the event list
  81.     e<mmddyyyy>    specify an ending date for the event list
  82.     <number>       seconds to pause (1-999, default is 15 seconds)
  83.  
  84. Commands may be upper or lower case, and must be separated with blanks. You
  85. can enter the commands in any order. If you type the same command twice, the
  86. information from last one you enter will be used. If you don't pass any
  87. commands at all, CalShow will simply display one screen of events and pause for
  88. 15 seconds. If there were no events to display in the period you specify, Cal
  89. won't pause at all. (But if you pass any command line, even if it's all
  90. blank, Cal will pause after the display.)
  91.  
  92. Don't include the <> characters in your commands. For the commands that need
  93. a <filespec>, enter a full filename including the drive letter, path, and
  94. filename. For a <number>, enter a group of decimal digits. For starting and
  95. ending dates shown as <mmddyyyy>, use a two-digit month number, a two-digit
  96. date, and a four-digit year. If the date you enter doesn't make any sense
  97. (e.g., the ending date precedes the starting date), Cal will use a reasonable
  98. value instead of what you entered.
  99.  
  100.  
  101. Here are a few examples of CalShow commands:
  102.  
  103.   1. Show 50 events starting Nov 25, 1991 and save to A:\EVENTS.TXT...
  104.  
  105.           a n50 s11251991 pa:\events.txt
  106.  
  107.   2. Print all events in D:\CAL.PRG occurring between now and Christmas...
  108.  
  109.           p a =d:\cal.prg e1225
  110.  
  111.   3. List significant events this year and next, pause for two minutes...
  112.  
  113.           s01011991 e12311992 120
  114.  
  115.  
  116. The program is pretty straightforward to use. If you have any questions or
  117. comments, let me know!
  118.  
  119.  
  120.       Bill Aycock
  121.       2310 North Elm Street
  122.       Greensboro, NC 27408
  123.  
  124.       Compuserve ID: 76703,4061
  125.       Internet: 76703.4061@compuserve.com
  126.       March 17, 1991
  127. --------------------------------
  128. v4.7: adds support for event significance
  129. v4.6: corrects loop occurring when a one-time event is scheduled in the same
  130.       month as, but in a different year from, the start date, on a date that
  131.       precedes that of the first valid event to show (thanks to Tom Miller for
  132.       documenting this problem)
  133.