home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / apps / bbs / today201 / todaycfg.new < prev    next >
Text File  |  1994-10-29  |  19KB  |  445 lines

  1. ;
  2. ;       Configuration file for TODAYS v 2.01
  3. ;
  4. ; Note:  This file is read in and 'parsed' by TODAYS v 2.01 when it is
  5. ; run.  Any thing after a semicolon (;) in this file is ignored, 
  6. ; which allows me to put in all sorts of information about the 
  7. ; commands in the file, and allows the user to easily 'comment out'
  8. ; anything they don't want in their configuration file.  The lines 
  9. ; that begin with a semicolon may be removed if the user so wishes.  
  10. ; They are not required to be a part of the file.  The commands may 
  11. ; also be used in any order the user wishes.  Order is not important.
  12. ;
  13. ;  The Path is where TODAYS expects to find the TODAY.mmm monthly
  14. ; files, TODAYS.LNG, TODAYS.HDR and the TODAYS.RPT file.  Don't forget
  15. ; the final \
  16. ;
  17. ; Path E:\DAY905\
  18. %L1%
  19. ;
  20. ;  The AdditonalFiles command gives TODAYS the extenders of 
  21. ; additional files you want the program to use in addition to the 
  22. ; TODAY.mmm monthly files.  These files must be in the same directory 
  23. ; as the monthly files.  The line below shows how multiple file 
  24. ; extenders can be given to the program.  Note that there are no 
  25. ; spaces or periods between the extenders, except when the extender 
  26. ; isn't 3 characters long. (TODAYS.UN and TODAYS.BC for example.)
  27. ;
  28. ; AdditionalFiles 1stAstAthBc FrrHrcJewLntNatOlyPvpRtvUn Rbt
  29. %L2%
  30. ;
  31. ;  The AlternateFile command gives TODAYS the path and file name of
  32. ; an additional file to read.  This file may, or may not be in the 
  33. ; same directory as set with the Path command, and you may name it 
  34. ; anything you want.  You may only use *one* file like this!
  35. ;
  36. ; AlternateFile E:\TODAYS\MY_DATA\TODAY.HOL
  37. %L3%
  38. ;
  39. ;  The LngFile command give the program an alternate TODAYS.LNG file 
  40. ; filename and path.  Please use only if you don't want to use the one
  41. ; in the directory set with the Path command, or if your running into
  42. ; file name conflicts.
  43. ;
  44. ; LngFile C:\alt\todaylng.ger
  45. ;
  46. ;  The ReportFile command gives TODAYS an alternate TODAYS.RPT 
  47. ; filename and path to use.  The program will default to using the 
  48. ; TODAYS.RPT file in the directory set by the path command if this 
  49. ; command isn't used.  As with the LngFile command, this command 
  50. ; should only be used if there are file name conflicts.
  51. ;
  52. ; ReportFile C:\today\alt\todayrpt.ger
  53. ;
  54. ;  The ErrorFile command gives TODAYS the location and name of the 
  55. ; file to send it's reports of errors and problems to.  If not used, 
  56. ; the program uses the file name "TODAYS.ERR" in the current 
  57. ; directory.
  58. ;
  59. ; ErrorReport C:\system\bbs\bbs.log
  60. %L17%
  61. ;
  62. ;  Output tells the program where to send the output to.
  63. ; To send output to the Screen, use the command CON: (short for 
  64. ; 'console monitor').  To send it to the printer use PRN:  Don't 
  65. ; forget the colon (:) when using PRN: or CON:
  66. ; Most people will want to send the output to a disk file, which is 
  67. ; done by simply putting the drive, path and file name, such as 
  68. ; F:\todays.txt after the keyword
  69. ; Output F:\TODAY.TXT
  70. %L4%
  71. ;
  72. ;  The Hold command tells TODAYS how many seconds to hold a screen 
  73. ; after the user presses a key.  This works *only* when sending output 
  74. ; to CON:.
  75. ;
  76. Hold 300 ; 300 seconds = 5 minutes. The default.
  77. ;
  78. ;  The Append command tells TODAYS to append to an existing file if it
  79. ; finds one with the same name as the one given in the Output command.
  80. ; Append is a default value, so if you forget this line and don't use
  81. ; the Replace command, it'll append anyways.
  82. ;
  83. ; Append
  84. %L5%
  85. ;
  86. ;  The Replace command tells TODAYS to replace or overwrite the 
  87. ; output file.  (The defualt it to Append, see above)
  88. ;
  89. ; Replace
  90. ;
  91. ;  The Age command gives a value to be used when calculating events.  
  92. ; See TODAYS.DOC for more information on how this is used.  Age 60 or 
  93. ; Age 90 seem to work well for most people if you have no idea what 
  94. ; to put here.
  95. ;
  96. ; Age 60
  97. %L6%
  98. ;
  99. ;  The Wrap command tell TODAYS the maximum length of a data line to 
  100. ; be outputed in the data sections.  Note: it has no effect on the 
  101. ; text in the TODAYS.RPT file, or the 'header' lines.
  102. ;
  103. ; Wrap 78
  104. %L7%
  105. ;
  106. ;  The Indent command tells TODAYS to indent the _second_ (and/or 
  107. ; third, forth, fifth, etc. as needed) line(s) of a wraped line, and 
  108. ; it also tells it how many spaces to indent it from the left edge of 
  109. ; the screen.
  110. ;
  111. ; Indent 15
  112. %L8%
  113. ;
  114. ; The CarridgeReturn command gives TODAYS a series of ASCII values 
  115. ; that it will use when it replaces the 'pipe' symbol (|) and when it
  116. ; wraps lines to fit within the Wrap value.  Note that there are no
  117. ; spaces between the values.  Shown below is a 'hard' return of two
  118. ; carridge return characters (013) and one line feed character (010).
  119. ; This is different from the 'standard' method of having just one
  120. ; carridge return and one line feed (013010).  Delete out one 013 if
  121. ; you'd rather have 'soft' returns.
  122. ; NOTE: On some computers, and with some terminal programs, Line 
  123. ; Feeds are ignored, and Carridge Returns automaticlly cause Line 
  124. ; Feeds.  When hard returns are used, the users get what looks like
  125. ; 'double spacing' in the report.
  126. ;
  127. ; CarridgeReturn 013010     ; "Soft" return (standard)
  128. ; CarridgeReturn 013013010  ; "Hard" return
  129. %L9%
  130. ;
  131. ;  The Sort command tells TODAYS to sort the data it collects by the 
  132. ; year before it sends it out.  If the Sort command isn't used the 
  133. ; data is displayed in the order it was collected in, with the 
  134. ; exception of the calculated dates which are always sorted.
  135. ; You may also choose which catagories you want the program to sort 
  136. ; by placing them after the word "sort", and a space.  In the example 
  137. ; below, the A, B, C, D, E, and F catagories will be sorted, but any 
  138. ; others will not be sorted.  To sort on _all_ catagories, don't put 
  139. ; any catagories on the line.  This is the default mode.
  140. ;
  141. ; SORT ABCDEF
  142. %L10%
  143. ;
  144. ;  The Show command tells the program to append to each data line a 
  145. ; number that can be used to determine which file the line came from. 
  146. ; By adding a 2 to it (Show2), it will also give the line number. The 
  147. ; file number will be in parahensases, the line number in brackets.
  148. ;
  149. ; SHOWF     ; Show file names
  150. %L11%
  151. ;
  152. ;  The MaxData command tells the program the Maximum number of data 
  153. ; lines to collect.  The higher this number is, the more memory will 
  154. ; be used. 1000 is the suggested number. (If you get more then 1000 on
  155. ; one day, I want to see your data files!!!) 512K users may want to 
  156. ; lower this number.
  157. ;
  158. ; MaxData 1000
  159. %L12%
  160. ;
  161. ;  The Seperator command defines the string to place between the Year 
  162. ; and the Text.  The 'built in default' for this is a single dash 
  163. ; mark (-), however with the Seperator command you can re-define this 
  164. ; to be whatever you want.  By default, the Seperator command will 
  165. ; add a space onto each side of the string you set, unless you enclose
  166. ; the string you want in quote marks (").
  167. ;
  168. ; Seperator <->
  169. %L13%
  170. ;
  171. ;  The PreYear command allows you to set a string to be printed out 
  172. ; before each Year is displayed.  This is useful for those of you who 
  173. ; want the Year to be a different color then the Text.
  174. ;
  175. ; PreYear b6
  176. ;
  177. ;  The PreText command works just like the PreYear command, however 
  178. ; it is displayed before the Text.
  179. ;
  180. ; PreText b2
  181. ;
  182. ;  The PreHeader command works like the PreText and PreYear commands, 
  183. ; however it is sent out before a *non-blank* header line is sent out.
  184. ;
  185. ; PreHeader b1
  186. ;
  187. ;  The PostHeader is sent out _after_ a non blank header line is sent 
  188. ; out.
  189. ;
  190. ; PostHeader b3
  191. ;
  192. ;  The LineFormat command tells TODAYS how you want each line it puts 
  193. ; out to be displayed.  Note that this command is ignored when there 
  194. ; is a function code on the line.
  195. ;
  196. LineFormat %FYOSNNR9% %FTEXAWN%
  197. ;
  198. ;  The ZeroSwap command gives TODAYS a string to use in place of the 
  199. ; number 0 when function calls result in 0.  This allows for more
  200. ; 'English-like' reports.
  201. ;
  202. ; ZeroSwap None
  203. %L16%
  204. ;
  205. ;  The NoMonthly command tells the program not to look for or use the 
  206. ; TODAY.mmm monthly files.
  207. ;
  208. ; NoMonthly
  209. ;
  210. ;  The Quick command turns on 'quick read' mode.  This method of 
  211. ; reading the data files causes the program to figure out the day of 
  212. ; the year for each line.  If the day of the year of the line is 
  213. ; greater then the day of the year the program is running for, the 
  214. ; program will abort the read of the data file in use, and the 
  215. ; program will go on to read the next file, or produce the report.  
  216. ; This can be very helpfull to those users with large amounts of data.
  217. ; By placing a number after the word 'Quick', you may also control 
  218. ; which files to apply Quick mode to.  Numbers 1-12 indicate the 
  219. ; TODAY.mmm monthly files, and numbers above 12 indicate the files 
  220. ; you've told the program to use with the AdditonalFiles and/or 
  221. ; Alternate files commands.  The command 'Quick 12' tells the program
  222. ; to apply Quick mode to the AdditionalFiles and/or AlternateFile 
  223. ; files, but not the monthly files. 'Quick -12' tells the program to
  224. ; apply Quick mode to the monthly files, but not the AdditionalFile 
  225. ; or AlternateFile file.  Further selection of which files to apply 
  226. ; Quick mode to is allowed by increasing the Quick number.  Quick -14,
  227. ; for instance, tells the program to apply Quick mode to the monthly
  228. ; files and the first 2 Additonal and/or Alternate files.
  229. ;
  230. Quick -26
  231. ;
  232. ;  The BusinessDays command tells TODAYS which days of the week it 
  233. ; should consider as a 'Business Day'.  For most people this line 
  234. ; will be as shown below which tells TODAYS to consider Monday through
  235. ; Friday as 'Business Days', but not Saturday (day #7) or Sunday (day 
  236. ; #1).
  237. ;
  238. ; BusinessDays 23456
  239. BusinessDays 23456
  240. ;
  241. ;  The Once command tells TODAYS to run only once a day.  It works by
  242. ; 'updating' the time/date stamp of TODAYS.  This may cause those of 
  243. ; you who are backing up your hard drive(s) on a regular basis to be
  244. ; backed up every time you do your backups, but that's a small bug.
  245. ;
  246. ; Once
  247. ;
  248. ;  The GMT command gives the program the conversion factor it needs 
  249. ; to convert your local time to GMT time.  The number you put after 
  250. ; the GMT command will be _added_ to the local time to get the GMT 
  251. ; time.  Use of GMT is not required by the program.  The number you 
  252. ; place after the keyword GMT may be as precise as you wish.  For most
  253. ; users, the "zonal" time (just the hours) will be enough, but feel 
  254. ; free to be _real_ precise if you wish (TODAYS computes this time in 
  255. ; seconds, in case you're interested).
  256. ; For North America/USA, the zones shown below may be used:
  257. ;   GMT  4 ; Atlantic
  258. ;   GMT  5 ; Eastern Standard Time
  259. ;   GMT  6 ; Central Standard Time
  260. ;   GMT  7 ; Mountain Standard Time
  261. ;   GMT  8 ; Pacific Standard Time
  262. ;   GMT  9 ; Yukon Standard Time
  263. ;   GMT 10 ; Alaskan/Hawaii Standard Time
  264. ;   GMT 11 ; Bering (Samoa) Standard Time
  265. ;
  266. ; If you're not in one of the above zones, sorry, but you'll have to 
  267. ; figure out your time conversion on your own.  Below is mine, for 
  268. ; Minneapolis, Minnesota, USA, North America. (Western Hemisphere, 
  269. ; Earth/SOL 3, etc., etc. <grin> )
  270. ;
  271. ; GMT 6   ;.217 is the minutes (13) for Minneapolis (but who cares)
  272. GMT 6
  273. ;
  274. ;  The DaylightStart and DaylightEnd commands give the program the 
  275. ; date when Daylight Savings Time starts and ends.  This is a bit 
  276. ; tricky, so please read carefully.
  277. ;
  278. ;  There are several ways to tell TODAYS when Daylight Savings Time 
  279. ; starts and ends.
  280. ;
  281. ;  The first method gives the exact date that the changes occur, and
  282. ; is indicated by a dollar sign ($) at the start of the date.
  283. ; "DaylightStart $04/30" means that Daylight Savings Time starts on
  284. ; April 30th of each year.  Note that the month is given as two 
  285. ; digits, as is the day of the month.  Please always use two digits 
  286. ; for both the month and the day of the month.  (The European method 
  287. ; of putting the day of the month before the month is allowed, just 
  288. ; make sure you seperate it with a period (.) rather then a forward 
  289. ; slash (/).)
  290. ;
  291. ;  The second method allows for dates that vary.  If, for instance, 
  292. ; Daylight Savings Time starts on the last Sunday in April, you would 
  293. ; use the command: "DaylightStart !L104"  The exclaimation mark (!) 
  294. ; indicates that the program should figure out which week of the 
  295. ; month this is, the L indicates that DST changes on the Last week, 
  296. ; the 1 indicates a Sunday, and the 04 indicates the month of April.
  297. ;
  298. ;  The third method gives TODAYS the day of the month and the month 
  299. ; that Daylight Savings Time goes into effect (or ends) and is 
  300. ; indicated by the use of a 'at' sign (@).  For example, 
  301. ; "DaylightStart @2604" tells TODAYS that Daylight Savings Time begins
  302. ; on the 26th day of the 4th month.
  303. ;
  304. ;  The forth method gives TODAYS the day of the year rather then the 
  305. ; Gregorian date or the week and month.  You tell TODAYS you are 
  306. ; using this method by placing a pound sign (#) in front of the day.  
  307. ; For example, "DaylightStart #117" says that Daylight Savings Time
  308. ; begins on the 117th day of the year (April 25 on non-leap years).
  309. ;
  310. ;
  311. ; Dating coding structure:
  312. ;
  313. ; if the first character is a exclaimation mark (!):
  314. ;  second character = the week of the month:
  315. ;    1 = first week of the month,
  316. ;    2 = second week of the month,
  317. ;    3 = third week of the month,
  318. ;    4 = forth week of the month,
  319. ;    5 = fifth week of the month.
  320. ;   values over 5 are ignored, since no month has more then 5 weeks.
  321. ;
  322. ;  third character = the day of the week:
  323. ;    1 = Sunday,    2 = Monday,   3 = Tuesday,
  324. ;    4 = Wednesday, 5 = Thursday, 6 = Friday,
  325. ;    7 = Saturday.
  326. ;
  327. ;  forth and fifth characters = the month of the year:
  328. ;    01 = January, 02 = Feburary, 03 = March,
  329. ;    04 = April,   05 = May,      06 = June,
  330. ;    07 = July,    08 = August,   09 = September,
  331. ;    10 = October, 11 = November, 12 = December.
  332. ;
  333. ;   *note* must use 2 characters for months!
  334. ;
  335. ; if first character is a "@" use the day of the month instead:
  336. ;    01 = first day of month, 02 = second day of month,
  337. ;    30 = 30th day of month,  31 = 31st day of month, etc.
  338. ;
  339. ; if first character is a "#", use day of year instead:
  340. ;    #001 = first day of the year, #002 = second day of year, etc.
  341. ;    There's no need to give the month with this method, and it may 
  342. ;    cause problems, so please don't.
  343. ;
  344. ; if first character is a "$", use Gregorian date instead:
  345. ;    $06/05 = June 5th of current year,
  346. ; European dates allowed using $dd.mm or $dd.mm.yyyy
  347. ;
  348. ;  *note* all months and days of months must be 2 characters long!
  349. ;         all years (when used) must be 4 characters long!
  350. ;         if a year isn't given, the program will assume the current
  351. ;         year.
  352. ;         Use leading zeros to fill out missing characters in the dates!
  353. ;         $2/2 is *NOT* a valid date!  (should be $02/02)
  354. ;
  355. DaylightStart !1104
  356. DaylightEnd !L110
  357. ;
  358. ;  The DaylightTime command gives TODAYS the number of minutes your 
  359. ; area adds to the 'standard' time to get Daylight Savings Time.  For 
  360. ; most places, this is 60 minutes.
  361. ;
  362. DaylightTime 60
  363. ;
  364. ; The DefineHeader command gives TODAYS the 'header' or 'title' for
  365. ; your data types.  The header line will replace the %H codes in the
  366. ; TODAYS.RPT as it's being printed.  The header line will only be
  367. ; sent out if there is data of that type to be displayed.  It will 
  368. ; only come out once durring the report unless the user has multiple
  369. ; %H codes of the same type in their TODAYS.RPT file.
  370. ; The first non-space character after the word 'DefineHeader' will be
  371. ; considered by the program to be the type of data that the line is 
  372. ; for.  If you want the header text to go over several lines, you may 
  373. ; use a 'pipe' character (|) to do so.  The pipe character will be
  374. ; replaced by the CarridgeReturn code when the line is printed out.
  375. ;
  376. ; DefineHeader !|Monthly Events:
  377. ; DefineHeader #|Upcomming Events:
  378. ; DefineHeader -|Past Events:
  379. ; DefineHeader $|Anniversaries:
  380. ; DefineHeader @|Weekly events:
  381. ; DefineHeader A|Athletics and Sports news:
  382. ; DefineHeader B|Birthdays:
  383. ; DefineHeader C|Weather:
  384. ; DefineHeader D|Deaths and Disasters:
  385. ; DefineHeader E|Economics and Explorations:
  386. ; DefineHeader F|Famous (or not so famous) Firsts:
  387. ; DefineHeader G|Galatic News (Astrononmy!)
  388. ; DefineHeader H|Religious Events:
  389. ; DefineHeader I|Insignificant Items:
  390. ; DefineHeader J|Not In Use (I Think!)
  391. ; DefineHeader K|Killers and Murderers:
  392. ; DefineHeader L|Legal News:
  393. ; DefineHeader M|Music and Entertainment:
  394. ; DefineHeader N|National Holidays:
  395. ; DefineHeader O|Olympic News:
  396. ; DefineHeader P|Political Events:
  397. ; DefineHeader Q|Deaths from OTD:
  398. ; DefineHeader R|And Remember:
  399. ; DefineHeader S|Special Events:
  400. ; DefineHeader T|Test stuff:
  401. ; DefineHeader U|News from the United Nations:
  402. ; DefineHeader W|War News:
  403. ; DefineHeader X|Science and Technology:
  404. ; DefineHeader Y|Yearly/Calander Events:
  405. ; DefineHeader Z|Zodiac:
  406. %LHU%
  407. ;
  408. ; The following two lines are somewhat special.  Because they are
  409. ; header lines for type ^ events.  They work _exactly_ as the
  410. ; other DefineHeader lines, however type ^ events are hard coded into 
  411. ; the program to appear only when the program detects that it's Friday
  412. ; the 13th.
  413. ; This is also an example of how you can use multiple header lines in
  414. ; your reports without using the pipe character.
  415. ;
  416. ; DefineFriday13 |Friday the 13th!
  417. ; DefineFriday13 Watchout for Black cats and Viruses!
  418. %LHF%
  419. ;
  420. ; The DefineNoData command works just like the DefineHeader command,
  421. ; except it defines the line to be printed when TODAYS doesn't find 
  422. ; any data for the date being run.  The _entire_ line will be printed
  423. ; out, including the first non-space character, as there isn't a data
  424. ; type for these events.  (How could there be?  The program didn't 
  425. ; find any data for today!)
  426. ;
  427. ; DefineNoData |NOTHING TODAY!
  428. %LHN%
  429. ;
  430. ;  The DefineAfter command gives TODAYS information on what it should 
  431. ; print out after a header line has been printed out.  Sort of a 
  432. ; 'header seperator' line.  The first non-space character after the 
  433. ; command gives TODAYS the option you want to use: F, L, or E.  The F
  434. ; option tells the program to make a 'Full line' (equal to the wrap
  435. ; value above) of the next character on the line.  The L option tells 
  436. ; TODAYS to make it the same length as the Header line, and the E 
  437. ; option tells TODAYS to print it out Exactly as shown in the 
  438. ; TODAYS.CFG.
  439. ;
  440. DefineAfter L=
  441. ;
  442. ; End of configuration file for TODAYS v 2.01
  443. ;
  444.