home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 #20 / q20.d81 / t.TotalRecall < prev    next >
Encoding:
Text File  |  1990-01-01  |  13.9 KB  |  370 lines

  1.  
  2.  
  3.                            T o t a l R e c a l l
  4.                                       
  5.                                by e. g. bell
  6.  
  7.      TotalRecall is a program you can use to create calendars the size of
  8. your refrigerator door.  No more relying on your local bank to provide you
  9. with a big calendar every January.  Once you have all events that occur on
  10. the same date every year (birthdays, anniversaries, holidays) you will only
  11. need to update the program each month for specific events that take place
  12. that month.
  13.  
  14.      The program supports 80, 96, and 132 column printers -- as long as they
  15. can emulate a Commodore 1525 7-pin printer.  The wider paper you can use,
  16. the more spectacular the calendar you can create.  You can use 2 or 3 block
  17. Print Shop (tm) graphics to liven your creations and your occasions can be
  18. printed in single or double width, and from 1 to 8 times the single-
  19. character height.  Each calendar includes a small display of the previous
  20. and next months.
  21.  
  22.      TotalRecall does a LOT!  Thus it takes a while to run.  However, it
  23. need only be run once a month.  Of course, you may find yourself running
  24. copies for your family.  The output is simply that nice!
  25.  
  26.      There are two ways to use the TotalRecall package:
  27.  
  28.  (1) Read the following text, learn how Master and Normal batch files are
  29. formatted, create batch files with any word processor, then run TotalRecall
  30. to print the calendar.
  31.  
  32.   or
  33.  
  34.  (2) Read the following text, learn how Master and Normal batch files are
  35. formatted, run BatchMaker, which prompts you through making batch files,
  36. then run TotalRecall to print the calendar.
  37.  
  38.      Method #1 is recommended because it's really easy once you learn the
  39. batch file format.
  40.  
  41.  TotalRecall - The program
  42.  -------------------------
  43.  
  44.      There is very little required of you to run the program.  Once you have
  45. the birthdays, anniversaries, etc. out of the way, it is clear sailing.
  46. That only needs to be done once, and updated only occasionally after that
  47. (when someone is born or married, for example).
  48.  
  49.      The first four prompts ask for source drive, destination drive, printer
  50. number and paper width.  Throughout the program, defaults are supplied so
  51. you will probably be able to just press RETURN to get the proper settings.
  52. The defaults are drive 8 for both source and destination, printer device #4
  53. and 80-column printer.
  54.  
  55.      Next you are asked if you want to Create a batch file or print the
  56. calendar.  DO NOT choose Create.  BatchMaker is a much better program for
  57. creating batch files.  TotalRecall is only to be run AFTER you've created a
  58. batch file with BatchMaker or with a word processor.
  59.  
  60.      Remember, don't run TotalRecall until you've got a batch file, then
  61. ALWAYS choose "Print Calendar", not "Create Batch Files".
  62.  
  63.      Batch files can be Master Batch Files or Normal Batch Files.  Master
  64. Batch Files contain words (which represent files) like "Birthdays",
  65. "Anniversaries", etc. -- events that occur on the same date every year.
  66. Normal Batch Files come in three kinds: Daily, Weekly and Info.
  67.  
  68.  DAILY BATCH FILES
  69.  -----------------
  70.  
  71.      First is the "DAILY" type files.  These have the following format:
  72.  
  73.  daily              First line is the word "daily"
  74.  1                  Second line is the number of the month (1=Jan, etc.)
  75.                     Next 2 lines should be blank.
  76.  
  77.  
  78.  start              1 line with the word "start"
  79.  0221               This is the description of the data to follow.
  80.                     The first 2 digits are how many lines are in the
  81.                     description.  In this example, there are 2 lines
  82.                     of description to follow.
  83.                     The next digit is the height of the characters. The
  84.                     minimum is 1, the maximum is the height of the
  85.                     block.  This height is determined by the columns
  86.                     your printer supports and the number of rows of the
  87.                     calendar.  The last digit is the width of the
  88.                     characters, and may be either 1 or 2.  Those are
  89.                     the only 2 values supported.  So, in this example:
  90.                     0221 = 2 lines of description, double height,
  91.                     single width.
  92.  30 Dr. Blinky      Text for calendar block.  The first 2 digits must be
  93.  -at 11{SHIFT-+}00 am       the date.  After that comes the first line of text
  94.                     for that data.  If more than one line is specified
  95.                     in the description line, the subsequent lines are
  96.                     preceded with a "-" character.  The number of lines
  97.                     of text MUST match the number indicated by the
  98.                     first 2 digits in the description line described
  99.                     above.  Note that you must use different codes for
  100.                     colons and commas.  More on that later.
  101.  end                Last line for a block for a month.  You may have more
  102.                     than 1 month in a file like this.  Just add each
  103.                     subsequent month to the file following this format.
  104.                     *NOTE* You only need the "daily" word at the start
  105.                     of the file, not at the start of every month block.
  106.  eof                Last line in any batch file.  I usually put several
  107.  eof                of these lines in.  These tell TotalRecall that
  108.  eof                the file is complete.
  109.  
  110.  
  111.      So, from this information, a sample file for January and February might
  112. look like this:
  113.  
  114.  daily
  115.  1
  116.  
  117.  
  118.  start
  119.  0322
  120.  01 New
  121.  - Year's
  122.  - Day
  123.  end
  124.  2
  125.  start
  126.  0221
  127.  14 Valentine's
  128.  -Day
  129.  end
  130.  eof
  131.  eof
  132.  eof
  133.  
  134.  
  135.  GRAPHICS IN DAILY BATCH FILES
  136.  -----------------------------
  137.  
  138.      Now, let's expand on what we have learned so far.   Here is how you
  139. would add 2 or 3 block Print Shop graphics to your calendar blocks.
  140.  
  141.  start              This is the same "start" described above.  Only one is
  142.                     required per month description block.
  143.  graphic            This is the first line of a graphic description block,
  144.                     and MUST be the word "graphic".
  145.  sherlock           This is the second line, and is the name of the graphic
  146.                     file EXACTLY as it appears on the disk you will be 
  147.                     using as your source drive for your calendar batch
  148.                     files.  (You may use ANY Print Shop graphic)
  149.  14                 This line contains the date.  It must be 2 digits, so
  150.                     days 1 through 9 would have a leading zero (01,02..)
  151.  0141               This is an optional text description.  You may include
  152.  - A & E            text beside your graphic if you like.  The description
  153.  0141               is similar to the method described under "daily" above
  154.  - Monday           with this exception.  All lines in a "graphic" block
  155.                     start with "-" followed by the text.  The date only 
  156.                     appears in the line above.  3 block Print Shop
  157.                     graphics support up to 8 lines of text (or heights
  158.                     that add up to 8) and 2 block graphics support up to
  159.                     7 lines.  Text may be 9 characters wide for single
  160.                     width text and 4 characters wide for double width when
  161.                     using graphics.
  162.  graphic end        The last line in a graphic block MUST be the words
  163.                     "graphic end".  You may have as many graphic blocks
  164.                     as you like, but remember only so many will fit in
  165.                     a date block.  You can combine them with non-graphic
  166.                     block descriptions also if you like.
  167.  end                Same as "daily" description earlier.  Only one "end"
  168.                     line is needed per month block.
  169.  
  170.      So, from this information, a sample file for January and a graphic for
  171. February might look like this:
  172.  
  173.  daily
  174.  1
  175.  
  176.  
  177.  start
  178.  0322
  179.  01 New
  180.  - Year's
  181.  - Day
  182.  end
  183.  2
  184.  start
  185.  graphic
  186.  heart
  187.  14
  188.  0221
  189.  -Valentine          Remember, 9 or fewer characters in a graphics
  190.  -Day                block.
  191.  graphic end
  192.  end
  193.  eof
  194.  eof
  195.  eof
  196.  eof
  197.  eof
  198.  
  199.  
  200.  INFO FILES
  201.  ----------
  202.  
  203.     TotalRecall recognizes that all blocks in a calendar may not be occupied
  204. by "dates".  The calendars are printed out in grids of 7 columns by 4-6
  205. rows, depending on which day the month starts and how many days are in the
  206. month.  Thus, there may be up to 11 blocks in the month that have no "date"
  207. in them.  Info files contain information you want printed in these "non-
  208. date" areas.
  209.  
  210.  info                                   Very first line in the file.
  211.                                         Next 2 lines are blank.  **NOTE**
  212.                                         There is NO month number 1-12.
  213.  start                                  The word "start".
  214.  0221                                   The data description.
  215.  32 Dollar Bank  244-8589               The first line of text starts with
  216.  -Penn Hills    Banking Hours           a 2 character number that is not
  217.                                         really relevant.  You can use 00
  218.                                         if you like.  As for the blocks 
  219.                                         described above, you can have as
  220.                                         many lines as will fit in the 
  221.                                         calendar block.
  222.  0111
  223.  32
  224.  0112
  225.  32 Lobby
  226.  0311
  227.  32 Mon - Thu  9{SHIFT-+}30 am - 4{SHIFT-+}00 pm
  228.  -Fri        9{SHIFT-+}30 am - 7{SHIFT-+}00 pm
  229.  -Sat        9{SHIFT-+} 30 am - 1{SHIFT-+}30 pm
  230.  0111
  231.  32
  232.  0112
  233.  32 Drive-Thru
  234.  0211
  235.  32 Mon- Fri   9{SHIFT-+}30 am - 7{SHIFT-+}00 pm
  236.  -Sat        9{SHIFT-+}30 am - 1{SHIFT-+}30 pm
  237.  end
  238.  eof
  239.  eof
  240.  eof
  241.  
  242. Note that you must substitute "{SHIFT-+}" [chr$(219) or SHIFT +] for any colons, and
  243. "{SHIFT--}" [chr$(221) or SHIFT -] for any commas.  BatchMaker takes care of this
  244. automatically.  You will have to do it if you use a word processor.
  245.  
  246.      You can have graphics in an "info" file, following exactly the method
  247. outlined above in that section.  If you want to have 2 graphics in your
  248. information blocks, the "graphic" format is the same with one exception:
  249. Follow the word "graphic" with a "+" sign on the second graphic.
  250.  
  251.      Here is an example of that based on all we have seen so far:
  252.  
  253.  info
  254.  
  255.  
  256.  start
  257.  graphic
  258.  alarm clock
  259.  00 
  260.  0122
  261.  - It's
  262.  0142
  263.  - That
  264.  0122
  265.  - Time
  266.  graphic end
  267.  graphic+
  268.  scale
  269.  00 
  270.  0141
  271.  - Lose
  272.  0142
  273.  - Weight
  274.  graphic end
  275.  end
  276.  eof
  277.  eof
  278.  eof
  279.  eof
  280.  eof
  281.  
  282.      Due to the way TotalRecall processes info blocks, each one is assigned
  283. a vacant block.  When the blocks are all used, any info files you request in
  284. TotalRecall will be ignored.
  285.  
  286.      The recommended naming convention for informational files is
  287. "tr.xxxxxxx" where xxxxxxx is any name you choose.   After TotalRecall asks
  288. you for the name of your master batch file (see below), it will ask if you
  289. want to include any informational files.  If you decide you want to, it will
  290. then give a directory of files starting with "tr." and notify you of how
  291. many can be added via a number in brackets.  Then it will prompt you for up
  292. to 12 of them.  Any filename is acceptable, but only the ones that start
  293. with "tr." are displayed in the directory.
  294.  
  295.  
  296.  WEEKLY INFO FILES
  297.  -----------------
  298.  
  299.      A weekly info file is EXACTLY the same as any other info file except
  300. that it has a day of the week for a filename.  Capitalize the first letter
  301. of the day, as usual.  So if you have some event (like garbage pickup) that
  302. occurs on the same day of the week, every week, create an info file called
  303. "Monday" or "Tuesday", etc.  When TotalRecall processes that day, this file
  304. will be read in, including text and graphics.  Any day that has room will
  305. have this information in that day's block for the whole month.  These files
  306. have the lowest priority of all of the information, so anything in them will
  307. only get printed if there is actually room enough for the information when
  308. the specific day is printed.  Thus, sometimes graphics in these files will
  309. be loaded and not used.
  310.  
  311.  
  312.  MASTER BATCH FILES
  313.  ------------------
  314.  
  315.      Finally, you need some way to be able to use the various file types
  316. above.  After all, you don't want to have one huge file for a whole year
  317. that you would have to process, update, etc.  Better would be a way to keep
  318. your anniversaries, birthdays, holidays, bill reminders, appointments, etc.
  319. in their own separate files that would be easier to update, maintain and
  320. correct when necessary.  More files, but smaller files.  Thus, TotalRecall
  321. will, if you want, use a Master Batch file to read in the files you specify
  322. in the order you specify.  This type of file takes the following format:
  323.  
  324.  all months              Line 1 MUST have the words "all months"
  325.                          The next 2 lines are blank.  **NOTE**  There is NO
  326.                          month number 1-12.
  327.  start                   Line 4 MUST be the word "start"
  328.  file                    Follwing this, the file will have the word "file"
  329.  Menu                    on a line followed by the name of the file as it
  330.  file                    appears on the disk.  You can have as many files
  331.  Appointments            and file categories as you like.  You may NOT
  332.  file                    use the Master Batch filename inside a batch file.
  333.  Birthdays               That would create an endless loop.
  334.  file
  335.  Anniversaries
  336.  file
  337.  Holidays.Date
  338.  file
  339.  Holidays.Day
  340.  file
  341.  Bills
  342.  file
  343.  PayDays
  344.  file
  345.  Reminders
  346.  end
  347.  eof
  348.  eof
  349.  eof
  350.  
  351.      These master batch files should be named "TR.xxxxxxx" where "xxxxxxx"
  352. is whatever name you choose to give the file.  During TotalRecall, you will
  353. be asked for the name of your master batch file, and a directory will be
  354. given of all files that start with "TR.".  You can have files that do not
  355. follow this naming convention, but they will not show up in this directory.
  356.  
  357. NOTE: In this program when a directory is displayed and you are asked for a
  358. filename, the directory is to show you what names NOT to use.
  359.  
  360.      In addition to the "file" command, master batch files can contain any
  361. of the other block formats already described under "info" and "daily" files,
  362. including graphics.  I don't recommend it, but it causes no problem and will
  363. work fine.
  364.  
  365.      Enjoy!  Now you can have TotalRecall!
  366.  
  367. egb
  368.  
  369.                         **** R - Run    RETURN - Menu ****
  370.