home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / today199 / upgrade.199 < prev   
Text File  |  1992-04-25  |  12KB  |  243 lines
  1.  
  2.      The information in this file is _only_ for those users who are 
  3. upgrading from version 1.9x to 1.99 of TODAYS.PRG. New users should 
  4. read the FULL TODAYS.DOC file included in the version 1.99 
  5. distribution package. Thanks!
  6.  
  7.  
  8.                Changes to TODAYS.LNG:
  9.  
  10.      Please be sure to replace your existing TODAYS.LNG file with the 
  11. new one in the TODAYS199.LZH file. There are some changes in it, and 
  12. failure to do so can result in some _very_ weird results!
  13.  
  14.  
  15.                Changes to TODAYS.INF:
  16.  
  17.      There are some MANDATORY changes you must make to your 
  18. TODAYS.INF file. Failure to make the changes below can result in some 
  19. _very_ unexpected results!
  20.  
  21.      First off, the 4 equinox and Solstice lines in the TODAYS.INF 
  22. file have been removed. Instead you can now use the new %FS options 
  23. in the TODAYS.RPT file rather then these lines.
  24.  
  25.      The 'header lines' that came after the lines for the solstices 
  26. and equinoxes have also been removed from the TODAYS.INF files and 
  27. are now in their own seperate file called TODAYS.HDR.
  28.      TODAYS.HDR has the same format as before, and should be in the 
  29. same directory as TODAYS.RPT and TODAYS.LNG.
  30.  
  31.      Line 2 of the file is now used for the filename extenders of any 
  32. additional TODAY.xxx files you want the program to read in addition 
  33. to the TODAY.mmm monthly files.
  34.      In the TODAYS.INF file in the distribution archive, line 2 has 
  35. HOLOTD on line 2 and Line 1 has "C:\TODAY\" on it, which is the path 
  36. for these files _and_ the TODAY.mmm monthly files.
  37.      Using the distribution file as an example, the files 
  38. C:\TODAY\TODAY.HOL and C:\TODAY\TODAY.OTD will be read durring each 
  39. run in addition to the C:\TODAY\TODAY.mmm monthly file.
  40.      You may have the program read as many 'additional' files as you 
  41. want on this line, I've tested it here on 12 different files, and it 
  42. does fine. Just remember that each additional file's extender must be 
  43. three characters long. Use trailing spaces in your TODAYS.INF file if 
  44. the extender is less then three characters long. (If you've got a 
  45. file that's named TODAY.F and another named TODAY.HOL, have the line 
  46. read "F  HOL" or "HOLF  ".)
  47.  
  48.  *******************************************************************
  49.  *                              NOTE:                              *
  50.  * TODAY.HOL is no longer automatically read each time the program *
  51.  *       program is run _unless_ you have HOL on line 2!           *
  52.  *******************************************************************
  53.  
  54.  
  55.      The next change to the TODAYS.INF file comes on the line after 
  56. the Wrap value. Line 9 now defines the codes used for carridge 
  57. returns.
  58.      Each character on this line must be a 3-character decimal ASCII 
  59. value. The 'default' code is 013010 which is the standard CR/LF 
  60. string. (13 is the ASCII code for a carridge return, converted to 3 
  61. characters, it becomes 013. 10 is the ASCII code for a line feed, 
  62. converted to 3 characters it becomes 010.)
  63.      You may use whatever codes you want on this line, VT-52, ANSI, 
  64. TX2, IGS or whatever, just remember to use the same code structure 
  65. throughout your TODAYS.INF, TODAYS.HDR and TODAYS.RPT files.
  66.      This allows those users who want 'hard' returns in their report 
  67. to have them, and those that want 'soft' returns to have them.
  68.  
  69.      Line 12 is allows you to set the maximum number of items you 
  70. want, or rather will allow the program to collect, as it reads 
  71. through your data files. This also effects how much memory the 
  72. program will use. For most users it can be left sitting at 1000, 
  73. however users who are running a lot of ACCs on a 512K machine may 
  74. want to lower it.
  75.  
  76.  
  77.      If you've looked at the TODAYS.INF file in the distribution 
  78. package, you'll notice that I've made comments on the lines and 
  79. seperated them from the data by semi-colons (;). You do not need to 
  80. remove the comments from the lines as long as you keep the semi-colon 
  81. on the line. The program will 'parse' the line and remove whatever is 
  82. to the right of the semi-colon.
  83.      Now you don't have to refer back to the documentation to figure 
  84. out which line is for what whenever you want to make a change.
  85.  
  86.           TODAYS.HDR notes:
  87.  
  88.      Although I didn't explain it correctly in the documentation, 
  89. realize that you don't _need_ the pipe character (|) after the type 
  90. code in your TODAYS.HDR file. I put it in mine because I wanted a 
  91. blank line between each type of data displayed. (The pipe character 
  92. is replaced with the Carridge Return string as defined on line 9.)
  93.      If you'd rather not have that blank line, remove the pipe 
  94. character. The program will run fine without it. If you'd rather have 
  95. more blank lines, add in more pipe characters.
  96.      I also failed to explain in the documentation that if you'd 
  97. rather use multiple header lines then pipes, you may feel free to do 
  98. so. I've updated the distribution TODAYS.HDR to give an example to 
  99. users. Note that the 'Friday the 13th' line is 2 lines long.
  100.      I've also updated the documentation to explain these better.
  101.  
  102.  
  103.           Changes to TODAYS.RPT:
  104.  
  105.      In the TODAYS.RPT file, *ALL* %F options ending with W% have 
  106. been deleted! These have been replaced with 2 new options which end 
  107. with either C% or O%. (Capitol letter o, not the number zero).
  108.      Both these commands do basicly the same thing as the old W% 
  109. (Converts number symbols to words) however you can now choose whether 
  110. to have TODAYS.PRG give you Cardinal numbers or Ordinal numbers. 
  111. (Cardinal numbers are the numbers used when counting (i.e. One, Two, 
  112. Three, Four, etc.) Ordinal numbers are numbers as when used in 
  113. showing order or succession. (i.e. First, Second, Third, Forth, 
  114. etc.))
  115.      If you're currently using %F options that end in W% and you want 
  116. to continue using them, load your TODAYS.RPT file into your favorite 
  117. word processor and have it do a 'search and replace' looking for W% 
  118. and change it to O%. (If you've got a %HW% in your report file, be 
  119. sure to fix that back after the search and replace is complete!)
  120.  
  121.      There are also 29 other new options in the TODAYS.RPT you can 
  122. use. Most of them are fairly straight-forward, however a few do need 
  123. explaining...
  124.  
  125.      %F74E% gives the 'Stardate' as it's spoken on the TV show 'Star 
  126. Trek'. Each number is seperatly 'spoken' (i.e. 8734 comes out 'Eight 
  127. Seven Three Four')
  128.  
  129.      %F75% gives the 'Stardate' point. This is a single digit number 
  130. between 0 and 9 that represents the time of day. Star Trek Fans 
  131. should note that this number does *NOT* conform to the STARFLEET (the 
  132. official Star Trek fan club) standard, as it uses LOCAL time rather 
  133. then the Universal Coordinated Time (UCT), or Grenwich Mean Time 
  134. (GMT) that STARFLEET specifies.
  135.  
  136.      To keep things 'standardized', %F75C% gives the Stardate point 
  137. as a Cardinal Word, %F75O% gives the Stardate point as a Ordinal 
  138. word, as does %F75E%
  139.  
  140.  
  141.           Changes to type codes:
  142.  
  143.      You no longer need to use type ! for Monthly Events or type @ 
  144. for weekly events. You may now define Monthly and Weekly events as 
  145. whatever you want them to be. You also can have as many different 
  146. codes for different Weekly and Monthly events as you require.
  147.      These don't have to be fixed in your data files, Report, and 
  148. Header files. ! and @ will still work fine for Monthly and Weekly 
  149. events. (I'm still using them for that on my system.)
  150.  
  151.      With this change, there are only 3 'hard coded' type codes left 
  152. in the program:
  153.           ^ (for Friday the 13th),
  154.           # (for calculated events)
  155.       and $ (for anniversaries.)
  156.  
  157.      You still can not use a type code '%' due to the way the report 
  158. generation routine works.
  159.  
  160.  
  161.           Changes to the Data files:
  162.  
  163.      You may now have Yearly events in your data files by simply
  164. leaving the month and day of month fields (columns 2-5) blank and 
  165. having only a year value in columns 6-9. Lines created this way will 
  166. show up in your output when the year in columns 6-9 matches the 
  167. system clock's year, and the line will show up on every day of the 
  168. year. (Usefull to tell users what this is the 'year of'.)
  169.      You may also use any column 10 option with this, to make lines 
  170. that only show up on Fridays or whatever, and put it under any type 
  171. code you want.
  172.  
  173.  
  174.      There is a new way to use the 'month' and 'day of month' fields
  175. in the data files (columns 2-6).
  176.  
  177.      A request was made to 'key' off of the day of the year (also 
  178. known as the 'Julian Period'). When you put a pound sign (#) in 
  179. column 2, TODAYS.PRG will assume that what you have in columns 3-5 is 
  180. the _day of the year_ rather then the normal Gregorian month and day 
  181. (mmdd).
  182.      If you've got an event that happens on the 163rd day of the year 
  183. for example, put a pound sign in column 2 and 163 in columns 3-5 to 
  184. make it #163.  The program will figure out internally when this day 
  185. is (in this case, June 10th on leap years and June 11th on non-leap 
  186. years) and use it in the same way as if you had the Gregorian date 
  187. (mmdd) on the line.
  188.      When using the julian period (day of the year) rather then the 
  189. Gregorian date, please remember that on leap years the day will 
  190. happen one day later then on non-leap years. (Assuming the day comes 
  191. after Februrary 28th of course.)
  192.      You can use whatever catagory you want for this as well as any 
  193. column 10 option.
  194.  
  195.  
  196.           Program fixes and enhancements:
  197.  
  198.      There was a intermittent problem in the program with using zeros 
  199. in the data files instead of spaces. This has been corrected. 
  200. Hopefully it did not cause too many problems. Sorry for the 
  201. inconvenience.
  202.  
  203.      A problem was noticed by a user when they tried to use a space 
  204. as a type code. When they used it, the 'header line' for NO DATA came 
  205. out! Opps! Sorry, that was an error on my part. I've fixed that, so 
  206. you may now use a space as a valid type code.
  207.  
  208.      Event type codes are no longer case sensitive. TODAYS.PRG now 
  209. sees 'z' as a different type of event then 'Z'. Be sure to make the 
  210. necessary changes to your TODAYS.INF, TODAYS.RPT and data files if 
  211. you choose to use lowercase type codes. This opens up 26 more type 
  212. codes for you to use.
  213.  
  214.      Calculated dates now 'count' down and up correctly.
  215.  
  216.      Word Wrap, when using the SHOW options, now workscorrectly.
  217.  
  218.      The 'bug' with continuation lines (a 'C' in column 10) and the 
  219. SHOW options has also been fixed.
  220.  
  221.      When you have no data for the day you're running for, the No 
  222. Data line now (properly) comes before the first '%H' in your report 
  223. file. Another programming bug found and killed!
  224.  
  225.  
  226.                 Documentation 'fixes' / improvements
  227.  
  228.      I've done some more work on the TODAYS.DOC file to make it a bit 
  229. easier to understand all the various things you can do with the 
  230. program.
  231.  
  232.      It's also been PRINTED to disk so that those of you who want to 
  233. print it from the desktop can now do that without having page breaks 
  234. in all sorts of 'weird' places, and use pre-punched paper for 
  235. insertion into 3-ring binders.
  236.  
  237.  
  238.      Well, I think that's it.  As always, if you discover any bugs or 
  239. if you have a enhancement request, feel free to send it to me at the 
  240. E-Mail addresses listed in the documentation. (I added in my UseNet 
  241. address to it, by the way.)
  242.  
  243.