             
                                                                
                            þ DARN! Don't Forget!þ              
                                 Version 3.0                    
                            (c)EmmaSoft 1989, 1990              
                                                                
                                                                
                                                                
                                                                
                                                                
                                                                
                                                                
                                                                
                                                                
                    An Annual Events Reminder for Computers     

                                   that use DOS                  














                                  _______
                             ____|__     |               (tm)
                          --|       |    |-------------------
                            |   ____|__  |  Association of
                            |  |       |_|  Shareware
                            |__|   o   |    Professionals
                          -----|   |   |---------------------
                               |___|___|    MEMBER


                 
     
          --------------Page 1
     þWHAT IS DARN!?
     
     DARN! is a simple program with a simple task:  to remind you of 
     events that occur on the same day each year.  Tax payments, 
     dividends, mortgage payments, even birthdays and anniversaries 
     are entered onto a master list (which can hold up to 300 such events).
     A reminder appears on your screen a number (you set) of days before
     an event.  The reminder is repeated through the day of the event.

     DARN! is not a TSR (Terminate and Stay Resident) program.  Thus it
     takes absolutely no memory from your other applications.

     DARN! was written by Dan Veaner.  I can be reached to answer
     questions at EmmaSoft, or on Compuserve 71460,2644.

     þSHAREWARE

     DARN! is Shareware.  Shareware distribution gives users a chance to 
     try software before buying it. If you try a DARN! and continue using 
     it, you are expected to register.  This allows you to try the
     program before you buy it.  When you register your copy of DARN!
     you will recieve the latest version of DARN! .  You will also be 
     assigned a serial number which entitles you to technical support.
     
     Copyright laws apply to both Shareware and commercial software,
     and the copyright holder retains all rights, with a few specific
     exceptions as stated below. Shareware authors are accomplished
     programmers, just like commercial authors, and the programs are
     of comparable quality. (In both cases, there are good programs
     and bad ones!) The main difference is in the method of
     distribution. The author specifically grants the right to copy
     and distribute the software, either to all and sundry or to a
     specific group. 

     Shareware is a distribution method, not a type of software. You
     should find software that suits your needs and pocketbook,
     whether it's commercial or Shareware. The Shareware system makes
     fitting your needs easier, because you can try before you buy.
     And because the overhead is low, prices are low also. Shareware
     has the ultimate money-back guarantee -- if you don't use the
     product, you don't pay for it.

     YOU MAY:

     -Use this program.
     -Make copies of it (if you copy all the original files including
      this documentation.  You may not copy some of the files without all
      of them).
     -Give copies to friends (if they like it they must register).
     -Distribute it on a shareware disk provided the cost of the disk is
      less than $6.  You must contact EmmaSoft before doing this.
     -Enjoy it.
     -Register it.

     YOU MAY NOT:
     
     -Alter the program.
     -Distribute altered files.
     -Receive money for the program.     --------------Page 2

     If you like DARN! and use it please register your copy after 30
     days using the form at the end of this manual.
     
     
     þLICENSE AGREEMENT AND WARRANTY:

     License

           1.    You may use the program on a single computer at one
                 time.  You may not copy the program and
                 accompanying materials except for backup purposes
                 or to distribute it as shareware (see above).

           2.    You may not make copies of the program for sale.

           3.    This software is copyrighted, and all rights
                 therein are reserved for EmmaSoft.  Registration 
                 or purchase of this product does not transfer any
                 right, title, or interest in the software except as
                 specifically set forth in this agreement.  You are
                 hereby notified that the software product is protected
                 by United States Copyright Law, and you may be held by
                 responsible by EmmaSoft for any infringement of
                 such rights or violations to this agreement.

           4.    This license is effective until terminated.  You
                 may terminate it at any time by destroying the
                 program and all copies of it.  It will also
                 terminate if you fail to comply with any term or
                 condition on this agreement.  You agree upon
                 termination to destroy the program together with
                 all copies of the program.
     
     Warranty
     
           1.    This program is provided "as is" without warranty
                 of any kind, either expressed or implied, including
                 any warranty of merchantability or fitness for a
                 particular purpose.  In no event shall EmmaSoft be
                 held liable for any loss of profit, special,
                 incidental, consequential, or other similar claims.

           2.    EmmaSoft does warrant that the magnetic media on
                 which the software is furnished is free of defects
                 of materials and workmanship under normal use for
                 60 days, provided that EmmaSoft provided your copy
                 of the program on such media.  If during this period
                 the diskette should become defective it may be returned
                 to EmmaSoft for replacement without charge.

     TECHNICAL SUPPORT:

     Only registered users may get technical support.  When you register
     you are assigned a serial number (this will be on your disk label)
     which you must provide when asking for tech support.  EmmaSoft is
     open M-F 9-Noon, 1-5 and sometimes on Saturdays.  The number is
     (607) 533-4685.

     --------------Page 3

     þSYSTEM REQUIREMENTS

     DARN! works on IBM PCs, XTs, ATs, 80386 and most compatible
     machines with 80 x 25 character displays including monochrome,
     Hercules, CGA, EGA and VGA.

     þINSTALLATION

     DARN! can be used on hard or floppy disk systems.  As with most
     programs it works more elegantly on a hard disk.  The best way to
     use DARN! is to load it before the first utility called in your
     "autoexec.bat" file.

     DARN! comes with an automatic installation program.  Type
     "install<Enter>" to start the program.

     What the Installation program does:

        1.  It installs DARN! from any disk to any disk
        2.  It allows you to read the "readme" file 
        3.  It makes life easy.

     What it doesn't do:

        1.  It doesn't change any files including autoexec. bat and
            config.sys.  I hate it when installation programs noodle
            with my files, so this one won't noodle with yours.

     To manually install just copy the program and all its files to the
     directory you plan to use, and add the loading commands to your
     autoexec.bat file.

     þGETTING DARN! TO LOAD

     Starting with Version 3.0 you can call DARN! from any disk and/or
     directory provided you set the "ANCAL" DOS environment variable.
     We strongly suggest you write this and the DARN! command into your 
     autoexec.bat file.  It should go something like this:

                 SET ANCAL=C:\DARN     tells DARN where its files are
                 ANCAL                 calls the program              
                 1STPROG               1st program you use after booting

     (Replace "C:\DARN" with the drive/directory YOU are keeping the
     DARN! files in.)
 
     Place the commands as shown just before the first utility you
     normally load.  

     If you only want DARN! to come up the first time you turn on or
     boot your computer each day you may do this.  In your autoexec.bat
     file use the following command:

                              ANCAL ONCE
     
          --------------Page 4
     
     þUSING DARN!
     
     Most days you will only need one key for this program:  the exit
     key (<F10>).  DARN! will appear on your screen with the events for
     the day.  Once you have viewed them press <F10> to exit the
     program.  (You may also use the <Esc> and <q> keys to exit.)  Use
     <Ctrl><Break> to Quick Quit.
     
     In the Main Screen use the following keys:
     
       <q>           Quit the program
       <Esc>         Quit the program
       <F10>         Quit the program
       <F1>          Go to the Action Menu
       <F9>          See today again
       <Alt><d>      Pick a day you want to view
       <Alt><t>      See today again
       <Alt><s>      Set How many days to see ahead*
       <Alt><h>      Help Screen
     
     THE ACTION MENU CHOICES:
     
     <F1> VIEWING the events list
     
     Once you are in the viewing section use the following keys:
     
       <q>           Go back to Main Screen
       <Esc>         Go back to Main Screen
       <F10>         Go back to Main Screen
       <Up>          Go back one entry
       <Page Up>     Go back one entry
       <Up Arrow>    Go back one entry
       <Home>        First entry on the events list
       <End>         Last entry on the list
       <F2>          Edit the entry you are viewing
       <F3>          Delete the entry you are viewing
       <F4>          Search for an entry
       <F5>          Print the list to your printer (goes to stdprn)
       <Alt><h>      Help Screen
     
     When searching type in all or part of the name or event you are
     searching for and press:
     
       <Enter>
       <h>           Search forward from here in the list
       <b>           Search forward from the beginning of the list
     
     When editing type all information onto the screen.
     
       <Enter>       Goes to next field
       Arrow Keys    Move around the form
     
       When on the last field press <Enter> then <Enter> again to accept
       your changes and any other key to go back to editing.

*Press F9 after setting number of days to see revised list
          --------------Page 5
     
     <F2> Add Entries
     
     DARN! will prompt you to add entries.  There are three parts: date,
     name, and event.  If the event is a birthday or anniversary DARN!
     senses this and also prompts for a number (age).  There are some
     conventions you must follow here:
           
                 Date:  You must use the mm/dd format. 
                 You may enter the date in many ways as long 
                 as there is a slash(/), dash(-), or space( ) 
                 between the month and day.  Examples:
     
                           05/08
                           5-8
                           05 8
                           5/08
     
                 Name:  Names may be up to 25 characters long, 
                 but no longer.
     
                 Event:  Events may be up to 15 characters 
                 long, but no longer.
        
                 Age:  Type the age of the person (or the number 
                 of the anniversary) this year, even if the event 
                 has passed. For example Bob is 45 in May and Betty
                 is 45 in December.  This is July.  Type "45" in 
                 both cases.  If you don't include an age here it 
                 won't show on the main or view screens.  However, 
                 you can add an age later using the Edit (<F2>)
                 facility in the View (<F1>) section.
     
     You don't have to enter a name or event, but you do have to enter
     a date.  You can enter anything under name or event.  For example
     a name entry could be "Quarterly Income Tax" with the event entry
     "first quarter."  Or name could be "Mother's" with event being
     "birthday."
     
     <F3> Quick Sort and Save
     
     When DARN! saves a list it sorts all entries by date.  Pressing
     this key sorts and saves the list to the same file name.  (If your
     list is "sample.drn" it will be overwritten.  If you are simply
     updating a list this is a quick way to save it.  WARNING:  Don't
     press this key if you want to keep the old version of the list.  In
     that case use <F6>.
     
     <F4> New Events List
     
     If you want to start a new events list from scratch use this
     option.  Make sure you save <F6> it before exiting the program.  
     Be careful not to use <F3> to save unless you want to write over
     the old list.
          --------------Page 6
     
     <F5> Load a List
     
     Use this option to load a different events list.  (You will
     usually use only one list and so won't need this often.) Type the
     name of the list WITHOUT the extention (.drn).  Thus if you are
     loading the sample.drn list type "sample".
     
     <F6> Save
     
     This option is used to save your changes or new list.  You may use
     the same name, in which case the old list will be overwritten, or
     you may choose a new name, thus keeping a backup copy with the old
     name. The last name saved (or loaded) will load automatically the
     next time you start the program.
     
     <F7> Program Information
     
     This tells you a little about the program.
     
     <F8> Export List to Ascii File
     
     As of Version 3.0 DARN! can export its Events Lists in ascii format,
     using two varieties of field delimiters.  You may choose to delimit
     fields by quotes or back-slashes.  When you choose quotes the file 
     will look like this:
     
                        "04/15","Dave's","Birthday","27"
     
     If you choose slashes:
     
                        04/15\Dave's\Birthday\27\
     
     The order of the fields is always:
     
                date  name  event  number_of_birthday_or_anniversary
     
          --------------Page 7
     
     þABOUT EMMASOFT
           
           EmmaSoft is an independent software development company.
           We develop programs for Business, Programmers, and Theatre  
           technicians.  Call or write for more information.
           
           EmmaSoft also sells bulk preformatted 5«" DSDD diskettes. 
           Call or write for our excellent prices.
     
     þWHAT'S NEW IN DARN!
     
     Version 2
     
     1.    The "once" feature is added.  DARN! now loads once a day if 
           you don't want it to appear each time you reboot.
     
     2.    Database extended from 200 to 300 entries.
     
     3.    Internal databse handling bugs fixed.
     
     4.    Custom message capability added.
     
     5.    Inimake integrated into main executable file, and made      
           easier to use.  Pressing <r>eset sets DARN! to use the
           sample.drn file provided with the software.
     
     Version 3
     
     6.    <Esc> and <q> keys added to make exiting functions and
                 the program easier.
     
     7.    Executable file renamed from DARN.EXE to ANCAL.EXE
     
     8.    DARN automatically sets itself up for monochrome systems.
     
     9.    F9 redisplays long lists of events
     
     10.   List viewing capabilities added.  DARN now views forward,
           backward, and goes to the beginning or end of the list.
     
     11.   Lists are sorted by date.
     
     12.   Search functions added.
     
     13.   Print function added.
     
     14.   Ability to remember age or anniversary number added.
     
     15.   ANCAL environmental variable added for finding files 
           from any directory
     
     16.   Viewing events for any day (alt-d) added
     
     17.   Date entry simplified so the user can use single or double
           digit numbers for month or day separated by a slash, dash,
           or space
          --------------Page 8
     
     18.   Help screens added
     
     19.   Exporting events list to ascii file capability added
     
     20.   Expanded action menu displays name of current Events list
     
     21.   Added ability of user to set how many days ahead DARN shows
           on the main screen (alt-s)


     
ASP:

This program is produced by a member of the Association of Shareware
Professionals (ASP).  ASP wants to make sure that the shareware principle
works for you. If you are unable to resolve a shareware-related problem with
an ASP member by contacting the member directly, ASP may be able to help. The
ASP Ombudsman can help you resolve a dispute or problem with an ASP member,
but does not provide technical support for members' products. Please write to
the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
message via easyplex to ASP Ombudsman 70007,3536
   
     
     
     
     
     
     
     
     
     
     
     ORDERING DARN!:
     
     The registration fee for DARN! is $10.  (NY residents please add
     sales tax.)  Each additional copy is $10.
     
     CUSTOM MESSAGE
     
     DARN! may be customized to display a message of your choice on the
     screen.  This message is encrypted in the program and always
     displays.  There is a one time set up fee for this message, and
     then you may order as many copies of DARN! on disk at the regular
     price at any time.  This message may be up to 59 characters long.
     
     1 time set up fee: 30.00
     
     CUSTOM CALENDAR
     
     If you want to give DARN! away with your own events list we can set
     this up for you.  Again, there is a one time set up fee, then each
     copy of DARN! you purchase will come with this list.
     
     1 time set up fee: 20.00 plus $1 per entry (minimum 10 entries)
     
          
     
                             Registration Form
                          ---DARN! Don't Forget!---
     
     
     If you use DARN! for 30 days or more you must register your copy.
     
     
     
     
                           Name:__________________________
                 Street Address:__________________________
                                __________________________
                    City/ST/Zip:__________________________
          
                      Disk Size:________
                        Payment: check___  MC___ VISA___
                      MC/VISA #:__________________________
                        Expires:__________________________
          
          
                  No. of Copies:______  Cost:_____________
                       Custom Message Set Up:_____________
                      Custom Calendar Set Up:_____________
                                    Subtotal:_____________
                      NY Tax (if applicable):_____________
                              Total Enclosed:_____________
               
               ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
               º                                              º
               º                Send this to:                 º
               º                                              º
               º                EmmaSoft                      º
               º                PO Box 238                    º
               º                Lansing, NY 14882-0238        º
               º                                              º
               º     Or register with MC or VISA by phone:    º
               º                                              º
               º                (607)533-4685                 º
               º                                              º                 
               º                                              º
               ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ¼




