home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PERSONAL / CAL94E10.ZIP / README.CAL < prev    next >
Text File  |  1994-02-22  |  46KB  |  1,221 lines

  1.                     CAL94E (TM) Copyright 1994 Brian E. Paquin
  2.                      All rights reserved.
  3. 0.0   DISCLAIMER
  4.       ==========
  5.  
  6.   BY ACCEPTING THIS SOFTWARE THROUGH USING IT FOR ANY PERIOD OF TIME,
  7.   YOU HAVE BECOME SUBJECT TO THE TERMS OF THIS WARRANTY.
  8.   THE AUTHOR DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE,
  9.   WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, ANY
  10.   IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  11.   PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY AND SPECIFICALLY
  12.   DISCLAIMED.  NEITHER THE AUTHOR NOR ANYONE ELSE WHO HAS BEEN INVOLVED
  13.   IN THE CREATION, PRODUCTION OR DELIVERY OF THIS SOFTWARE SHALL BE
  14.   LIABLE FOR ANY INDIRECT, CONSEQUENTIAL OR INCIDENTAL DAMAGES ARISING
  15.   FROM THE USE, THE INABILITY TO USE, THE LACK OF COMPATIBILITY WITH
  16.   ANY EQUIPMENT, HARDWARE OR SOFTWARE, OR FROM THE LANGUAGE OR
  17.   INSTRUCTIONS OF THIS SOFTWARE, OR FROM ANY BUSINESS INTERRUPTION
  18.   ALLEGED TO HAVE BEEN CAUSED BY THIS SOFTWARE, EVEN IF THE AUTHOR
  19.   HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  20.   IN ADDITION, THE AUTHOR IS NOT LIABLE TO DAMAGES BASED ON CONTRACT,
  21.   TORT, WARRANTY OR ON ANY OTHER LEGAL OR EQUITABLE GROUNDS.  IN THE
  22.   EVENT THAT ANY LIABILITY SHOULD ARISE AT LAW, THE ACCEPTER OF THIS
  23.   SOFTWARE AGREES THAT SUCH LIABILITY, IF ANY, SHALL BE LIMITED TO AND
  24.   IN NO EVENT SHALL EXCEED, THE PRICE PAID BY THE LICENSEE REGARDLESS
  25.   OF THE FORM OF THE CLAIM.  THE PERSON USING THE SOFTWARE BEARS ALL
  26.   RISK FOR THE INSTALLATION, USE AND RESULTS OBTAINED FROM THE PROGRAM.
  27.  
  28.   THE AUTHOR RETAINS ALL RIGHTS TO THE PROGRAM.
  29.  
  30.   This software and the disks on which it is contained is licensed to
  31.   you, for your own use.  This is copyrighted software.  You are not
  32.   obtaining title to the software or any copyright rights.  You may
  33.   not sublicense, rent, lease, convey, modify, translate, convert to
  34.   another programming language, decompile, or disassemble the software
  35.   for any purpose.
  36.  
  37.   You may make as many copies of this software as you need for backup
  38.   purposes.  You may use this software on more than one computer, provided
  39.   that there is no chance that it will be used simultaneously on more
  40.   than one computer.
  41.  
  42.   This agreement shall be construed, interpreted and governed by
  43.   the laws of the Province of Ontario.  Any action or proceeding
  44.   brought by either party against the other arising out of or related
  45.   to this agreement shall be brought only in a court of competent
  46.   jurisdiction located in Frontenac County, Ontario Canada.
  47.  
  48.  
  49.  
  50.                  CAL94E VERSION 1.0  USER GUIDE
  51.                  ------------------------------
  52.  
  53.                 CAL94E (TM) Copyright 1994 Brian E. Paquin
  54.                 All rights reserved.
  55.  
  56.  
  57.   CAL94E is a straightforward and intuitive program that will assist you
  58.   in managing personal information.  It does this by providing:
  59.  
  60.       -  A calendar / scheduler.
  61.       -  Storage of names and addresses.
  62.       -  Storage of quick (brief) notes.
  63.       -  A calculator.
  64.  
  65.   CAL94E provides a wide variety of support functions to help you create,
  66.   maintain, view and print the data that you need on a day-to-day basis.
  67.  
  68.   When did you last change the batteries in your smoke detector?  Do
  69.   you already have something planned for next Wednesday?  What birthdays
  70.   are coming up next month?   What is the name and phone number of the
  71.   plumber who did such good work for you?  Get control of this information
  72.   by storing it with CAL94E.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                            TABLE OF CONTENTS
  79.                            =================
  80.  
  81.              Legal Matters  ..........................  1.0
  82.              Suggestions / Warnings  .................  2.0
  83.              Registration  ...........................  3.0
  84.              Support   ...............................  4.0
  85.              System Requirements  ....................  5.0
  86.              Program Setup  ..........................  6.0
  87.              Description of CAL94E ...................  7.0
  88.                The Calendar / Scheduler ............... 7.1
  89.                Names and Addresses  ................... 7.2
  90.                Quick Notes  ........................... 7.3
  91.                The Calculator ......................... 7.4
  92.                Miscellaneous Points ................... 7.5
  93.              Use of the Keyboard .....................  8.0
  94.              Use of a Mouse ..........................  9.0
  95.  
  96.  
  97.  ----------------------------------------------------------------------
  98.  
  99. 1.0   LEGAL MATTERS
  100.       =============
  101.  
  102.   The author grants permission for the program and its associated files
  103.   to be copied and distributed freely, provided that no fee is charged.
  104.   SHAREWARE DISTRIBUTORS:  Refer to file VENDOR.DOC for terms and
  105.   conditions for charging distribution fees.
  106.  
  107.   You may give only complete and unmodified copies of the program,
  108.   associated data files and documentation to others for their evaluation.
  109.  
  110.   If you use this software for more than 30 days, you are required to
  111.   register it, as described in the section on registration.
  112.  
  113.  
  114.    TRADEMARK ACKNOWLEDGMENT:
  115.    ------------------------
  116.  
  117.     All brand and product names mentioned are trademarks of their
  118.     respective companies.
  119.  
  120.  
  121.  
  122.  ----------------------------------------------------------------------
  123.  
  124. 2.0   SUGGESTIONS / WARNINGS
  125.       ======================
  126.  
  127. CAL94E files are not encrypted or hidden.  They could be viewed, changed
  128. or deleted by anyone who has access to them.
  129.  
  130. Do not rely on this program (or any other single means) to remind you of
  131. important events, to store important notes or important name and address
  132. information.  Computer systems can fail for various reasons.
  133.  
  134. Ensure that the disk(ette)s containing your datafiles have enough space
  135. available on them for the addition of new data.
  136.  
  137. There is nothing in CAL94E designed to detect viruses or to correct the
  138. damage that can be done by viruses.
  139.  
  140. Back up computer files on a regular basis to protect from loss of data.
  141.  
  142. The Standard Events in the base calendar event files have been selected
  143. by the author.  They contain common holidays and other observed days, as
  144. well as selected historical days.  The accuracy of this information is
  145. not guaranteed.  Many standard holidays are observed on different dates
  146. in different locations, and so you should 'check your local listings'.
  147. Most of the standard events are set to start in 1980, regardless of the
  148. actual date on which they were first observed.  Standard events that
  149. have irregular dates (such as Easter) do not go past the year 2020.
  150.  
  151. Section 7.5.6 describes some problems that you might encounter, and their
  152. solutions.
  153.  
  154.  
  155.  ----------------------------------------------------------------------
  156.  
  157. 3.0   REGISTRATION
  158.       ============
  159.  
  160. CAL94E is distributed as shareware, which is a marketing concept that
  161. allows you to "try before you buy" a program.  CAL94E is copyright
  162. protected, and the author retains all rights to the program.  The
  163. registration fee entitles you to use the program on one computer at
  164. any given time.
  165.  
  166. Note that this is a FULLY FUNCTIONAL PROGRAM - it is not a demonstration
  167. version, and it will not quit working after a certain period of time or
  168. a certain number of uses.  The shareware industry depends on your honesty
  169. in order to continue providing an inexpensive alternative to buying
  170. software off the store shelf, sight unseen.
  171.  
  172. You are allowed to use this program for your evaluation for a period
  173. of 30 days without registering it.  After 30 days, you must either
  174. register this program or cease using it.  It is not public domain
  175. software, and it is not free.
  176.  
  177.  
  178.   THE BENEFITS OF REGISTERING CAL94E ARE:
  179.   ======================================
  180.  
  181. 1.  You will be entitled to receive support (see the next section).
  182.  
  183. 2.  You will receive a dot-matrix printed list of 94 examples of
  184.     personal information that you might want to store using CAL94E.
  185.  
  186.         You might find that this particular piece of literature is
  187.         worth the price of registration by itself.  It is amazing
  188.         how much information is necessary these days in order to
  189.         stay organized and out of trouble!
  190.  
  191. 3.  You will receive a letter from the author thanking you for your
  192.     registration.
  193.  
  194. 4.  You will be notified of significant new releases of the software.
  195.     There will be no additional license fees for minor upgrades.  Major
  196.     upgrades will be available at a reduced fee for registered users.
  197.  
  198. 5.  Your comments and suggestions for changes will be considered for a
  199.     future release of the software.
  200.  
  201. 6.  You will be supporting the shareware industry.
  202.  
  203. 7.  You will avoid violating the author's copyright of CAL94E.
  204.  
  205. 8.  You will enjoy guilt-free use of the program for years to come.
  206.  
  207.  
  208.  
  209.   HOW TO REGISTER:
  210.   ===============
  211.  
  212. File  REGISTER.FRM  contains information on how to register.  The
  213. first copy that you register costs $23.  For site licenses, a sliding
  214. scale is appied to the cost of additional copies, as explained in that
  215. file.
  216.  
  217. The registration fee for CAL94E is low because you have already been
  218. provided with everything that you need to use the program.  When you
  219. send in your registration fee, you will not receive a registered
  220. (better) version of the program or a printed manual.  If you register
  221. multiple copies, you will have to make the copies yourself from the
  222. files that you already have.  These saved expenses are passed along
  223. to you.
  224.  
  225. The contact for registration and for any questions or comments is:
  226.  
  227.                   Brian Paquin
  228.                   P.O. Box 1724
  229.                   Kingston, Ont.  K7L 5J6
  230.                   Canada
  231.  
  232.  
  233.  ----------------------------------------------------------------------
  234.  
  235. 4.0   SUPPORT
  236.       =======
  237.  
  238. Support from the author is offered:
  239.  
  240. 1. Through the mail.  Send questions and/or comments to the address
  241.    noted in the Registration Section.
  242.  
  243. 2. Through Compuserve (73654,1166).
  244.  
  245. Your questions will be answered during your 30 day trial period, and
  246. for 3 months after you have registered.
  247.  
  248.  
  249.  ----------------------------------------------------------------------
  250.  
  251. 5.0  SYSTEM REQUIREMENTS
  252.      ===================
  253.  
  254. - An IBM PC or compatible system.
  255. - A color or monochrome video card.
  256. - MS-DOS Operating System, Version 3.0 or greater.
  257. - Approximately 244k of available memory.
  258.  
  259. The amount of available memory on your system will depend on the total
  260. amount of conventional memory that is installed on your machine, and the
  261. amount that is being used for other purposes, such as the operating
  262. system, device drivers, TSR's, etc.   CAL94E does not use extended or
  263. expanded memory.
  264.  
  265. A HARD DISK is highly recommended.  It is much faster than a diskette,
  266. and you are less likely to run out of disk space.
  267.  
  268. A MOUSE makes the program easier to use, but it is not required.
  269.  
  270. A PRINTER is helpful if you need hardcopy information, such as printed
  271. calendars, names and addresses, or quick notes.  CAL94E can only deal
  272. with printers connected through a parallel port.  However, if you have
  273. a serial connection, or if you have any problems with printing from this
  274. program, you always have the option of "printing" to a disk file.  After
  275. you exit the program, you can then print the disk file using whatever
  276. method that works for you.  As an alternative, you could consider
  277. redirecting LPTn (parallel) to COMn (serial) using the DOS 'MODE'
  278. command, if your printer is connected to a serial port.
  279.  
  280. CAL94E will detect the presence of a NUMERIC COPROCESSOR (8087) for
  281. use in the "Instant Calculator" function.  It is possible that your
  282. computer might give CAL94E incorrect information about the presence
  283. of a coprocessor, saying that it has one when it doesn't.  If you
  284. experience problems with the Instant Calculator, then key:
  285.  
  286.        SET 87=N
  287.  
  288. from the DOS prompt before running the program.
  289.  
  290.  ----------------------------------------------------------------------
  291.  
  292. 6.0  PROGRAM SETUP
  293.      =============
  294.  
  295.  6.1   Installation
  296.        ------------
  297.  
  298. **NOTE:  Some software distributors include their own procedures for
  299.          program installation.  If you have received such a procedure
  300.          with the program (often called  INSTALL.EXE  or  INSTALL.BAT ),
  301.          and that procedure installs the software to your hard drive,
  302.          then proceed to Section 6.2.
  303.  
  304. The most common way to install this program and its associated files
  305. is to copy them from the 'A' diskette drive to the 'C' hard drive.
  306. Here is the sequence of MS-DOS commands needed to do so.  After keying
  307. each command, press the ENTER key.
  308.  
  309.   C:              { changes to the 'C' drive                 }
  310.   CD \            { changes to the root directory of 'C'     }
  311.   MD \CAL94E      { makes a directory on 'C' called 'CAL94E' }
  312.   CD \CAL94E      { changes to that directory                }
  313.   COPY A:\*.*     { copies all files on the diskette in the  }
  314.                   { 'A' drive to C:\CAL94E                   }
  315.  
  316. It is not necessary to call the new directory 'CAL94E'.
  317.  
  318. Continue reading for more information on completing the initial setup.
  319.  
  320.  
  321.  6.2  Files
  322.       -----
  323.  
  324. After installation, you should have the following files:
  325.  
  326. Programs         - CAL94E.EXE
  327.                  - README.EXE
  328.  
  329. Program files    - CTRL.CAL
  330.                  - HELP.CAL
  331.                  - MACRO.CAL
  332.  
  333. Data files       - BASECAN.EVT  (base Calendar Events file for Canada)
  334.                  - BASEUSA.EVT  (base Calendar Events file for the USA)
  335.                  - BASE.NAM     (base Name and Address file)
  336.                  - BASE.NOT     (base Notes file)
  337.  
  338.      (The above-mentioned "base" files are files that are in the format
  339.       needed by CAL94E.)
  340.  
  341.  
  342. Documentation files
  343.                  - README.CAL   (the file that you are now reading)
  344.                  - CALDOC.NOT   (Additional documentation for this program,
  345.                                  accessible through the 'QUICK NOTES'
  346.                                  function of CAL94E.
  347.                  - ABOUT.CAL    (an overview of CAL94E)
  348.                  - SHORT.DOC    (a short summary of CAL94E)
  349.                  - VENDOR.DOC   (information for shareware distributors)
  350.                  - FILE_ID.DIZ  (information for BBS postings)
  351.                  - FILES.CAL    (a list of all files)
  352.  
  353. Registration form
  354.                  - REGISTER.FRM  (includes prices for volume discounts)
  355.  
  356. Commands
  357.                  - PRINTME.BAT   (print README.CAL)
  358.                  - PRINTREG.BAT  (print REGISTER.FRM)
  359.  
  360. Optional files (might not be present)
  361.                  - CAL94E10.SDA  (similar to ABOUT.CAL)
  362.                  - other files may be included, but only as allowed by the
  363.                    standards of the Association of Shareware Professionals
  364.                    (ASP).
  365.  
  366. When giving this program to others for their evaluation, all of the
  367. files listed above must be included in their original state, without
  368. any changes made to the content.  Not only is this a requirement, but
  369. it is also a good idea, since you will probably be storing information
  370. of a personal nature on your files.
  371.  
  372. For your own use, you should copy the appropriate "BASE" files.
  373. Refer to Section 7.5.5 for a description of how to do this.
  374.  
  375.  
  376.  6.3  Running the Program
  377.       -------------------
  378.  
  379.  Method #1 - The simple (and best) way to run the program.
  380.  ---------
  381.  
  382. CAL94E will look for some of its files in the current directory (the
  383. one to which DOS is currently pointing).  The simple approach is to
  384. store the program and those files in the same directory.
  385.  
  386. For example, if you followed the installation procedure suggested in
  387. Section 6.1, then CAL94E.EXE (the program), and files CTRL.CAL, HELP.CAL
  388. and MACRO.CAL will be in directory 'CAL94E' on your 'C' drive.  From the
  389. DOS prompt, key:
  390.  
  391.   C: <Enter>           { changes to the 'C' drive             }
  392.   CD\CAL94E <Enter>    { makes 'CAL94E' the current directory }
  393.  
  394. You can then start the program by keying:
  395.  
  396.   CAL94E   <Enter>
  397.  
  398. If you have an old CGA video card that gives problems with snow on
  399. the screen, then key:
  400.  
  401.   CAL94E SNOW  <Enter>
  402.  
  403. instead.  When snow checking is invoked, the screen display speed
  404. is considerably slower.
  405.  
  406. Note that the datafiles containing Calendar Events, Names/Addresses,
  407. and Quick Notes do not have to be stored in the current directory
  408. because you will be able to tell CAL94E to go looking for them from
  409. the "File Selection Menu".   However, for the purposes of simplicity,
  410. you should consider storing them in the same directory with the program
  411. and the program files.
  412.  
  413.  
  414.  Method #2 - Another way to run the program.
  415.  ---------
  416.  
  417. Alternatively, if you have stored the three program files in
  418. directory 'CAL94E', but have stored the program in directory
  419. 'PROGS', then the sequence will be:
  420.  
  421.   C: <Enter>                { changes to the 'C' drive             }
  422.   CD\CAL94E <Enter>         { makes 'CAL94E' the current directory }
  423.   \PROGS\CAL94E <Enter>     { runs CAL94E from directory 'PROGS'   }
  424.      or
  425.   \PROGS\CAL94E SNOW <Enter>
  426.  
  427.  
  428. One more point:  if your computer has a color graphics card but
  429. not a color monitor (as is the case with many laptop computers),
  430. then you might find that the screen is easier to read if you key
  431. the MS-DOS command:
  432.  
  433.    MODE BW80
  434.  
  435. from the DOS prompt, before running the program.
  436.  
  437. If you wish, you can return to color mode after exiting the program
  438. by keying
  439.  
  440.    MODE CO80
  441.  
  442. from the DOS prompt.
  443.  
  444.  
  445. When the program starts, you will be presented with several screens of
  446. instructions and comments - read them carefully the first few times that
  447. you use the program.
  448.  
  449.  ** ALWAYS WATCH THE BOTTOM OF THE SCREEN FOR INSTRUCTIONS **
  450.  
  451.  
  452.  ----------------------------------------------------------------------
  453.  
  454. 7.0  DESCRIPTION OF CAL94E
  455.      =====================
  456.  
  457. CAL94E was designed to provide a straightforward and intuitive means
  458. of performing several functions that are needed to manage personal
  459. information.  They include:
  460.  
  461.      1.  A calendar / scheduler.
  462.      2.  Storage of names and addresses.
  463.      3.  Storage of quick (brief) notes.
  464.      4.  A calculator.
  465.  
  466. In order to gain an appreciation of the importance of personal information,
  467. try this quick quiz:
  468.  
  469.   -  When did you last change the batteries in your smoke detector or the
  470.      filters in your furnace?
  471.  
  472.   -  When was your chimney last cleaned?
  473.  
  474.   -  How many sick days have you taken from work this year?
  475.  
  476.   -  What is the name of your company president's dog?
  477.  
  478.   -  When does the warranty on your exhaust system expire?
  479.  
  480.   -  When did you get your last raise, and how much was it?
  481.  
  482.   -  What is the name and phone number of the plumber who responded
  483.      quickly and effectively to your last emergency call?
  484.  
  485.   -  Do you already have a meeting scheduled for next Wednesday that
  486.      will prevent you from going out for lunch on that day?
  487.  
  488.   -  How many speeding tickets have you had in the last three years?
  489.  
  490.   -  What exactly was it that your accountant advised you to do as soon
  491.      as you get the opportunity?
  492.  
  493.   -  When does your parking permit have to be renewed?
  494.  
  495. By using CAL94E, you will be able to store and access all types of
  496. information that you need.  You only have to remember to use the program
  497. regularly, and allow it to work for you.
  498.  
  499.  
  500. 7.1   The Calendar / Scheduler
  501.       ------------------------
  502.  
  503. The CALENDAR / SCHEDULER provides a means of storing 'events' that
  504. you wish to keep track of.  Events can be anything, such as birthdays,
  505. doctor appointments, scheduled oil changes, lunches, or even 'do list'
  506. items such as remembering to buy dog food.  There are a variety of support
  507. functions in the program, such as viewing and printing a selected month
  508. or year, searching for text occurrences, and finding overlaps (conflicts)
  509. in scheduling.  It is a simple matter to change, view, add and delete
  510. events from your files.  You can also maintain various event files for
  511. different purposes.  The 'base' event files that are provided with CAL94E
  512. already contain common holidays and observed days so that you don't have
  513. to create them yourself.  However, you might have to customize them to
  514. meet local requirements.
  515.  
  516. There are a wide variety of frequencies available for calendar events,
  517. such as:
  518.  
  519.     once
  520.     every day
  521.     every month, 2nd Tuesday
  522.     every year, 3rd Sunday in June
  523.       etc.
  524.  
  525. There is even an option to handle the unusual frequency of U.S. Election
  526. Day, which occurs on the Tuesday after the first Monday in November (which
  527. is not always the first Tuesday).  It can also handle Victoria Day in
  528. Canada, which occurs on the Monday before May 25th.  (Both events are
  529. contained in the standard events provided in the base files, so you
  530. should not have to be concerned with these particular options.)
  531.  
  532. You select a category for every event, such as:
  533.  
  534.     Holiday
  535.     Social Event
  536.     Meeting
  537.     Day in History
  538.       etc.
  539.  
  540. The one-character category indicator that precedes the category name
  541. (e.g. 'H' with Holiday) will be displayed on the 'View Month' screen in
  542. the boxes for all days that have event occurrences.
  543.  
  544. The category 'PESTER' has a special meaning in CAL94E.  These events
  545. always show up under today's date (e.g. when you are viewing a month).
  546. This is particularly useful for 'do list' items, because the program
  547. will 'pester' you with these items until you either delete them or
  548. change the category to something else.
  549.  
  550. The date range allowed for calendar functions is January 1, 1800 through
  551. December 21, 2099.   A function is provided to do date arithmetic, which
  552. will tell you the difference in days between two dates, as well as date
  553. span between those dates in terms of the number of years, months and days.
  554.  
  555. It is worth noting that CAL94E never displays a month value in numeric
  556. format - the months of the year have names, and CAL94E always uses them!
  557.  
  558.  
  559. 7.2   Names and Addresses
  560.       -------------------
  561.  
  562. The NAMES AND ADDRESSES function provides a means of storing, viewing
  563. and printing text data about people and/or companies that you deal with.
  564. You can create any number of different files for different purposes.
  565.  
  566. The support functions (for searching, printing, etc.) are similar to
  567. those provided with the calendar / scheduler.
  568.  
  569.  
  570. 7.3   Quick Notes
  571.       -----------
  572.  
  573. The QUICK NOTES function is very similar the NAMES AND ADDRESSES.  It can
  574. be used to store any piece of information in which you have an interest.
  575. When you store miscellaneous information in a CAL94E Quick Note, you will
  576. always know where to look for it.
  577.  
  578.  
  579. 7.4   The Calculator
  580.       --------------
  581.  
  582. The CALCULATOR function allows you work with two numeric fields, 'A' and
  583. 'B'.  It is referred to as an 'Instant Calculator' because after every
  584. keystroke, various results are automatically displayed, such as  A * A,
  585. A * B, A / B, etc.  You can scroll down into the results area and move
  586. the selected value into 'A' or 'B' (whichever one is 'current'), again
  587. with an automatic recalculation of new results.
  588.  
  589.  
  590. 7.5   Miscellaneous Points
  591.       --------------------
  592.  
  593. Rather than giving a blow-by-blow description of every detail about
  594. CAL94E, the following is a list of specific topics that you might find
  595. to be helpful.  In addition to the documention that you are now reading,
  596. there are a variety of notes and suggestions contained in CALDOC.NOT,
  597. as mentioned earlier.  CALDOC.NOT is accessible through the 'Quick Notes'
  598. function of the program.
  599.  
  600. Always pay attention to the context-sensitive instructions that are
  601. found at the bottom of every screen in CAL94E.
  602.  
  603. If you have any questions, you can contact the author (Refer to Section 4).
  604.  
  605.  
  606.  7.5.1  Selection Versus Keying
  607.         -----------------------
  608.  
  609. This is one of the major features of CAL94E that makes it easy to use:
  610. with the exception of text information, almost everything is selected
  611. rather than keyed.  For example, when you create a calendar event for
  612. your birthday, you do not key your birth date on a screen, and risk
  613. getting the wrong format (02/04/1960 ?  04/02/60 ?).  Instead, you select
  614. the year, month, and day from screens containing all possible values.
  615. (Month values are always displayed in alphabetic format, e.g. 'Jan' or
  616. 'January'.)
  617.  
  618. The idea of selection also applies when you are selecting a datafile,
  619. such as a Calendar Events File.  Refer to Section 7.5.5.
  620.  
  621.  
  622.  7.5.2  Scrolling
  623.         ---------
  624.  
  625. In addition to the methods for scrolling that are noted on the
  626. screens, you can also scroll downwards using the spacebar.  You
  627. can scroll upwards using:
  628.  
  629.        alt + spacebar,
  630.        ctrl + spacebar
  631.           or
  632.        shift + spacebar.
  633.  
  634. In the 'View Month' screen under the Calendar option, the arrow keys
  635. and mouse movement will normally change the day.  There are a number
  636. of ways to scroll the list of events for the highlighted day:
  637.  
  638.       - Use the Tab key to switch sides, then use the arrows or mouse.
  639.         You can also switch sides by holding down the left mouse button
  640.         and moving the mouse to the left or right.
  641.  
  642.       - Set Num Lock on, then use the arrow keys on the numeric keypad.
  643.  
  644.       - Hold down the right mouse button and move the mouse up or down.
  645.  
  646.  
  647.  7.5.3  The Options Menu
  648.         ----------------
  649.  
  650. A menu of options will be available at various points in the program,
  651. wherever your see:
  652.  
  653.      - <Enter>:  Options Menu
  654.  
  655. at the bottom of the screen.
  656.  
  657. In addition to pressing <Enter>, these menus can be accessed in a
  658. number of ways, depending on your preference:
  659.  
  660.      - Press the left mouse button
  661.      - Press F1 (the standard 'Help' key)
  662.      - Press '/'
  663.      - Press '\'
  664.  
  665.  
  666.  7.5.4  Calendar User Events and Standard Events
  667.         ----------------------------------------
  668.  
  669. A CAL94E Calendar Events File is in a specific format required by the
  670. program.  It must contain ONE OR MORE User events followed by ONE OR
  671. MORE Standard events, and all records must be in the format required
  672. by CAL94E.
  673.  
  674. The 'base' calendar event files have multiple entries for certain
  675. standard events.  For example, Remembrance Day (Canada) has entries
  676. that designate it as a:
  677.  
  678.     1.  'Observed Day',
  679.     2.  'Holiday (here)' and
  680.     3.  'Holiday (elsewhere)'.
  681.  
  682. You should select the "List Events" option from the Calendar Menu, scroll
  683. to these events, activate the choice that applies to you, and deactivate
  684. the other entries.
  685.  
  686. It is possible to change, add or delete user events, but standard
  687. events can only be activated or deactivated.  An inactive standard
  688. event will not show on the monthly calendar that you view or print.
  689. (To answer your question, the author did not want to be blamed if you
  690. were to accidentally move Thanksgiving to the middle of the summer.
  691. That is why you can't change Standard Events.)
  692.  
  693. Most standard events are set to start in 1980, regardless of the year
  694. in which they were first observed.  If you wish to store such events
  695. with a date that is prior to the one in the standard events list, create
  696. your own user event, and then deactivate the standard event.
  697.  
  698. Most of the standard events that have irregular dates (such as Easter)
  699. have an end date in the year 2020.
  700.  
  701.  
  702.  
  703.  7.5.5  Program Files and Data Files
  704.         -----------------------------
  705.  
  706. CAL94E uses two types of files when it is running, program files and
  707. data files.
  708.  
  709. The program files are:
  710.  
  711.     CTRL.CAL
  712.     MACRO.CAL
  713.     HELP.CAL
  714.  
  715. CAL94E uses these files for its own purposes.  As mentioned earlier, it
  716. will look for them in the current directory.
  717.  
  718. Data files are used to store your personal information.  They are:
  719.  
  720.     (anything).EVT   Calendar Event files
  721.         "      NAM   Name and Address files
  722.         "      NOT   Quick Notes
  723.  
  724. CAL94E requires that these files be in a specific format, and so you
  725. should only create new files by copying files that you know to be in
  726. the correct format.
  727.  
  728. To start, you should copy the appropriate "BASE" files that came with the
  729. program.  For example, you might copy "BASECAN.EVT" to "BARNEY.EVT",
  730. and use "BARNEY.EVT" to store your own calendar events (if your name is
  731. Barney, and you live in Canada).  If you require additional event files for
  732. different purposes, e.g. home and office, you can repeat this process.
  733.  
  734. You should also copy:
  735.    "BASE.NOT" to (e.g.) "BARNEY.NOT"   and
  736.    "BASE.NAM" "    "    "BARNEY.NAM".
  737.  
  738. File copying can be done on the "File Selection Menu" that appears as
  739. soon as you invoke one of the major functions of the program (Calendar,
  740. Names/Addresses and Quick Notes).  You will be able to copy any existing
  741. file (e.g. a "base" file) to a new file, with a name of your own choice.
  742. However, this approach only allows you to do copying within a given DOS
  743. directory.  If you wish to copy a file from one directory to another,
  744. you must do this outside the program, using a DOS command.
  745.  
  746. You should also consider creating a set of the data files for your own
  747. training purposes.  Any time that you want to experiment with certain
  748. program functions, you can use and abuse those files without fear of
  749. destroying valuable data.
  750.  
  751. Every time that you invoke a major function in CAL94E, it will 'remember'
  752. the file that you selected the last time that you used it, and it will
  753. prime the File Selection Menu accordingly.  When you want to select a
  754. different file, then go through the drive - directory - file hierarchy
  755. as needed:
  756.  
  757.      - Select a disk drive from the list of all drives that are available
  758.        on your system.
  759.      - Select a directory from the list of all those directories on
  760.        the selected drive that contain any appropriate files.
  761.      - Select a file from the list of all Event files that are
  762.        in the selected directory.
  763.  
  764. There is no need (and no opportunity) to key in something like:
  765.  
  766.      C:\CAL94E\BARNEY.EVT
  767.  
  768. in order to select the file that you want to use.
  769.  
  770.  
  771.  7.5.6  Troubleshooting
  772.         ---------------
  773.  
  774. Please note that CAL94E has only been tested with the MS-DOS operating
  775. system.  The author has made no attempt to ensure that it will function
  776. correctly under competing operating systems.
  777.  
  778. CAL94E could occasionally refuse to do something that you request of it,
  779. but it will normally give an indication of the problem.  The following is
  780. an elaboration on a few of the problems that you might encounter.
  781.  
  782.  
  783. - Printer problems
  784.  
  785.    CAL94E performs simple text printing.  Printers are not standardized
  786.    throughout the industry, and if you encounter problems, it might be
  787.    necessary to select the option of printing to a disk file instead of
  788.    LPTn.  After you exit the program, you can then use you own method of
  789.    printing the disk file.
  790.    Printers can occasionally have problems because of loose connections,
  791.    low humidity causing static electricity, or general malfunctions.
  792.    Also, be sure that the printer is plugged in, turned on, and connected!
  793.  
  794. - Mouse problems
  795.  
  796.    If your mouse is not responding, it is possible that you have removed
  797.    the connection in order to use the port for something else, such as
  798.    your modem.  Also, make sure that the mouse driver software has been
  799.    installed correctly - refer to the documentation that came with it.
  800.  
  801. - Problems with disk files
  802.  
  803.    CAL94E cannot update files that have been flagged as "read-only", and
  804.    it will reject them.  Use the DOS "ATTRIB" command to allow those files
  805.    to be updated.
  806.  
  807.    When creating a new file, you cannot choose a file name that is the
  808.    same as an existing DOS device name, such as LPT1, AUX, etc.
  809.  
  810.    If you work with diskette files, you can avoid interruptions in your
  811.    work ahead of time by making sure that they have space available for
  812.    the addition of new data, and that the write-protect tab is set to
  813.    allow data to be written to them.  Follow the manufacturer's
  814.    suggestions for the safe storage of diskettes.
  815.  
  816. - Problems with the "Instant Calculator" function.
  817.  
  818.    As mentioned earlier, you might own a computer system that "lies"
  819.    about the presence of a numeric coprocessor (8087).  If you
  820.    experience problems when using the Instant Calculator, then key:
  821.  
  822.         SET 87=N
  823.  
  824.    from the DOS prompt before running the program.
  825.  
  826.  
  827.  ----------------------------------------------------------------------
  828.  
  829. 8.0  USE OF THE KEYBOARD
  830.      ===================
  831.  
  832. You can avoid using the keyboard for almost everything by invoking
  833. the Options Menu, as described earlier (especially if you have a
  834. mouse).  However, you might prefer to use the keyboard for commonly
  835. used functions.
  836.  
  837. Keyboard functions that require two keystrokes are denoted on the
  838. screens with a plus sign between them.
  839.  
  840. For example, 'ctrl + rightarrow' is used to add 1 to the value of a
  841. a year.  Hold down either 'ctrl' key, and press the right arrow key.
  842.  
  843.  
  844.  8.1  Miscellaneous Keys
  845.       ------------------
  846.  
  847.        Enter
  848.           Move forward through the program.
  849.           Invoke the Options Menu, where applicable.
  850.           Accept data changes that have been keyed.
  851.           (The left mouse button is equivalent to the 'Enter'
  852.            key in CAL94E.)
  853.  
  854.        Esc  (Escape)
  855.           Move backwards through the program.
  856.           Remove the Options Menu.
  857.           Abandon data changes that have been keyed.
  858.           (The right mouse button is equivalent to the 'Escape'
  859.            key in CAL94E.)
  860.  
  861.        Arrow keys (up, down, left, right)
  862.           Used in a variety of places, with predictable results.
  863.  
  864.        Ctrl + Leftarrow
  865.           Subtract 1 from the value of the year.
  866.  
  867.        Ctrl + Rightarrow
  868.           Add 1 to the value of the year.
  869.  
  870.        Ctrl + Pageup
  871.           Set the 'Find Text' direction to 'upwards'.
  872.  
  873.        Ctrl + Pagedn
  874.           Set the 'Find Text' direction to 'downwards'.
  875.  
  876.        Backspace
  877.           Delete the character to the left of the cursor on a text
  878.           line.
  879.  
  880.        Tab
  881.           1. Move 8 spaces to the right on a text line.
  882.           2. Switch sides on the "View Month" Calendar Screen.
  883.           3. Switch formats on the "View Year" Calendar Screen.
  884.  
  885.        Shift + Tab
  886.           1. Move 8 spaces to the left on a text line.
  887.           2. Switch sides on the "View Month" Calendar Screen.
  888.           3. Switch formats on the "View Year" Calendar Screen.
  889.  
  890.        Insert
  891.           Switch between Insert mode and Typeover mode for keying text.
  892.  
  893.        Delete
  894.           1. Delete the file that is named on the File Selection Menu.
  895.               (You will be asked for confirmation.)
  896.           2. Delete a Calendar Event, a Name/Address entry or a Note.
  897.               (You will be asked for confirmation.)
  898.           3. Delete the character highlighted by the cursor on a text
  899.              line.
  900.           4. Delete the time from an event, which makes time
  901.              'not applicable' to the event.
  902.  
  903.        Home
  904.           1. Move to the first entry on the screen.
  905.           2. Move to the first entry in a list.
  906.           3. Move to the first position in a text line.
  907.  
  908.        Ctrl + Home
  909.           1. Set the highlighted date to the lowest possible value,
  910.              which is January 1, 1800.
  911.           2. Set the highlighted time to the lowest possible value,
  912.              which is 12:01 a.m.
  913.  
  914.        End
  915.           1. Move to the last entry on the screen.
  916.           2. Move to the last entry in a list.
  917.           3. Move to the last position in a text line.
  918.  
  919.        Ctrl + End
  920.           1. Set the highlighted date to the highest possible value,
  921.              which is December 31, 2099.
  922.           2. Set the highlighted time to the highest possible value,
  923.              which is 11:59 p.m.
  924.  
  925.        Page Up
  926.           Scroll upwards in a list by one screen.
  927.  
  928.        Page Down
  929.           Scroll downwards in a list by one screen.
  930.  
  931.        Spacebar
  932.           Scroll downwards in a list by one entry.
  933.  
  934.        Shift + Spacebar  or
  935.        Ctrl  + Spacebar  or
  936.        Alt   + Spacebar
  937.  
  938.           Scroll upwards in a list by one entry.
  939.  
  940.        'a'
  941.           Change the month to the next one that begins with 'a'
  942.           (April, August).
  943.  
  944.        'd'
  945.           Change the month to December.
  946.  
  947.        'f'
  948.           Change the month to February.
  949.  
  950.        'j'
  951.           Change the month to the next one that begins with 'j'
  952.           (January, June, July).
  953.  
  954.        'm'
  955.           Change the month to the next one that begins with 'm'
  956.           (March, May).
  957.  
  958.        'n'
  959.           Change the month to November.
  960.  
  961.        'o'
  962.           Change the month to October.
  963.  
  964.        's'
  965.           Change the month to September.
  966.  
  967.        ';'
  968.           Set the size of the scrolling window to the default value.
  969.  
  970.        '>'
  971.           Set the size of the scrolling window to the maximum value.
  972.  
  973.        '<'
  974.           Set the size of the scrolling window to the minimum value.
  975.  
  976.        '.'
  977.           Increase the size of the scrolling window by 1.
  978.  
  979.        ','
  980.           Decrease the size of the scrolling window by 1.
  981.  
  982.        '/' or '\'
  983.           Invoke the Options Menu, where applicable.
  984.  
  985.  
  986.  8.2  Function Keys
  987.       -------------
  988.  
  989.        F1
  990.           Invoke the Options (Help) Menu
  991.  
  992.        F2
  993.           Edit (Make a change to data)
  994.  
  995.        F3
  996.           Exit (same as <Esc> )
  997.  
  998.        F4
  999.           1. Find text within a list of entries.
  1000.           2. Find text within a Quick Note or a Name/Address entry.
  1001.  
  1002.        F5
  1003.           1. Continue finding text in the list of entries.
  1004.           2. Redisplay 'found' text within a Quick Note or a Name/Address
  1005.              entry.
  1006.  
  1007.        F6
  1008.           Erase the remainder of the text line, from the cursor.
  1009.  
  1010.        F7
  1011.           Page Up
  1012.  
  1013.        F8
  1014.           Page Down
  1015.  
  1016.        F9
  1017.           1. Create a new file (from the File Selection Menu).
  1018.           2. Add a new file entry (calendar, name/address or note).
  1019.  
  1020.        F10
  1021.           Accept the screen
  1022.  
  1023.        Shift + F1
  1024.           Copy the text character from the line immediately above,
  1025.           if there is such a line ( or use <Alt + s> ).
  1026.  
  1027.        Shift + F3
  1028.           Copy the text line immediately above, if there is such a line.
  1029.  
  1030.        Shift + F7
  1031.           Find date overlaps for the highlighted calendar event.
  1032.  
  1033.        Shift + F8
  1034.           Find date and time overlaps for the highlighted calendar event.
  1035.           This applies only to events that have a time associated with
  1036.           them.
  1037.  
  1038.  
  1039.  8.3  'Alt' Key Combinations
  1040.       ----------------------
  1041.  
  1042.        Alt + 0  (20xx)
  1043.           Set the century portion of a year to '20'.
  1044.           (Also see 'Alt + 8' and 'Alt + 9'.)
  1045.  
  1046.        Alt + 1
  1047.           Print individual entry to LPT1.
  1048.  
  1049.        Alt + 2
  1050.           Print individual entry to LPT2.
  1051.  
  1052.        Alt + 3
  1053.           Print individual entry to LPT3.
  1054.  
  1055.        Alt + 4
  1056.           Go to the top of a list.
  1057.  
  1058.        Alt + 5
  1059.           Go to the first entry in the Standard Events (Calendar).
  1060.  
  1061.        Alt + 6
  1062.           Go to the bottom of a list.
  1063.  
  1064.        Alt + 7
  1065.           Print individual entry to a disk file instead of a printer.
  1066.  
  1067.        Alt + 8  (18xx)
  1068.           Set the century portion of a year to '18'.
  1069.  
  1070.        Alt + 9  (19xx)
  1071.           Set the century portion of a year to '19'.
  1072.  
  1073.        Alt + a
  1074.           Activate an inactive standard calendar event.
  1075.  
  1076.        Alt + c  (century)
  1077.           Advance century:  18 -> 19, 19 -> 20, 20 -> 18.
  1078.  
  1079.        Alt + d  (downwards movement)
  1080.           1. Move entry (e.g. a Calendar Event) down 1 position in
  1081.              the list.
  1082.           2. Move a text line down 1 position on the screen.
  1083.           3. In the 'Instant Calculator' move the 'A' value down to
  1084.              the 'B' value (and move 'B' up to 'A').
  1085.  
  1086.              Note that the same effect can be achieved by holding down
  1087.              the left mouse button and moving the mouse towards you.
  1088.              ('Alt + u' is the opposite of 'Alt + d').
  1089.  
  1090.        Alt + f  (full day)
  1091.           Set the 'start time' and 'end time' to 12:01 a.m. and
  1092.           11:59 p.m. respectively, which is a full day.
  1093.  
  1094.           Note that it is not possible to set the time to 12 midnight.
  1095.           This is because it is ambiguous as to whether a day begins or
  1096.           ends at midnight.
  1097.  
  1098.        Alt + m
  1099.           Select a month in the 'View Month' calendar screen.
  1100.  
  1101.        Alt + n  (now)
  1102.           Insert the current date and time into a line of text,
  1103.           beginning at the cursor, for a length of 32 characters.
  1104.  
  1105.        Alt + s  (same value)
  1106.           1. Set the highlighted date to the same value as the other
  1107.              date on the screen (in cases where there is one).
  1108.           2. Set the highlighted time to the same value as the other
  1109.              time field on the screen.
  1110.           3. Copy the text character from the line immediately above,
  1111.              if there is such a line (same as Shift + F1).
  1112.           4. In the 'Instant Calculator', set the highlighted number
  1113.              ('A' or 'B') to the same value as the other one.
  1114.  
  1115.        Alt + t  (today)
  1116.            Set the highlighted date to today's date (taken from the
  1117.            system).
  1118.  
  1119.        Alt + u  (upwards movement)
  1120.            This is the opposite of 'alt + d' as described earlier.
  1121.  
  1122.        Alt + x  (exit)
  1123.            This is the equivalent to the Escape key, described earlier.
  1124.  
  1125.        Alt + y
  1126.            Select a year in the 'View Month' calendar screen.
  1127.  
  1128.        Alt + z
  1129.            Deactivate an active standard calendar event.
  1130.  
  1131.        Alt + F1
  1132.            Print full list to LPT1.
  1133.  
  1134.        Alt + F2
  1135.            Print full list to LPT2.
  1136.  
  1137.        Alt + F3
  1138.            Print full list to LPT3.
  1139.  
  1140.        Alt + F7
  1141.            Print full list to disk.
  1142.  
  1143.  
  1144.  
  1145.  ----------------------------------------------------------------------
  1146.  
  1147. 9.0  USE OF A MOUSE
  1148.      ==============
  1149.  
  1150. If you do not currently own a mouse, you should seriously consider
  1151. getting one, especially if you do not have strong typing skills.  It
  1152. is a major asset when using a program such as CAL94E, because you
  1153. can navigate through the program without the need to constantly look
  1154. up and down between the screen and the keyboard.
  1155.  
  1156. CAL94E does not recognize the middle mouse button, if you have one.
  1157. However some mouse driver software does not recognize it either, and
  1158. considers the middle button to be the same as the left button.
  1159.  
  1160. Here are the mouse functions in CAL94E:
  1161.  
  1162.   9.1  Pressing the left mouse button =  'ENTER' on the keyboard.
  1163.  
  1164.        In most cases you will click the button.  At other times
  1165.        you hold it down, such as when you as scrolling using the
  1166.        flashing arrow, or when you are 'dragging' the mouse (see
  1167.        below).
  1168.  
  1169.   9.2  Pressing the right mouse button =  'ESC' (Escape) on the keyboard.
  1170.  
  1171.   9.3  Pressing the left and right mouse buttons at the same time
  1172.        = function key 'F2' on the keyboard.  (Give them a sharp click
  1173.        together.)
  1174.  
  1175.        F2 is used for selecting or changing data, e.g. changing an existing
  1176.        calendar event, or changing a date value within an event.
  1177.  
  1178.        Many programs recognize a 'double click' of the left mouse button
  1179.        to indicate selection or change.  It is hoped that you will find
  1180.        CAL94E's  'simultaneous click' of both buttons to be easier.
  1181.  
  1182.   9.4  Mouse movement = the arrow keys on the keyboard.
  1183.  
  1184.        Note that there are some cases where this is not true.  For
  1185.        example, when changing or adding a new calendar event, date
  1186.        fields can be changed directly on the screen by using the left
  1187.        and right arrow keys, without the need to invoke the 'Full Screen
  1188.        Selection'.  They cannot be changed by moving the mouse to the
  1189.        left or right because it would be too easy to accidentally make a
  1190.        change with the mouse.
  1191.  
  1192.   9.5  'Dragging' with the left mouse button.
  1193.  
  1194.        (Note that the term 'dragging' means holding down one of the
  1195.         mouse buttons while moving the mouse.)
  1196.  
  1197.       -You can move a table entry (such as a calendar event) by holding
  1198.        down the left mouse button and moving the mouse towards you or
  1199.        away from you.  You can do the same thing to move a text line
  1200.        within a Name and Address entry or a Note entry.  This method can
  1201.        also be used to swap the 'A' and 'B' values in the Instant
  1202.        Calculator.
  1203.  
  1204.       -In the 'View Month' screen under the Calendar option, you can
  1205.        easily switch sides on the screen by holding down the left
  1206.        mouse button and moving the mouse to the left or right.
  1207.        When you are on the left side of the screen, ordinary movement
  1208.        of the mouse (without holding either button down) will change
  1209.        the day.  When you are on the right side, movement of the mouse
  1210.        will scroll the list of the day's events.
  1211.  
  1212.   9.6  'Dragging' with the right mouse button.
  1213.  
  1214.        In the 'View Month' screen, you can scroll the day list that
  1215.        appears on the right side of the screen without the need to
  1216.        switch to that side.  This can be done by holding down the
  1217.        right mouse button and moving the mouse towards you or away from
  1218.        you.
  1219.  
  1220.  ------------------------  End of README.CAL --------------------------
  1221.