home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT227.ZIP / GENREAD.ME < prev    next >
Text File  |  1991-07-07  |  10KB  |  239 lines
  1.                            GENERATIONS (TM)
  2.  Copyrighted 1991 by Competitive Edge Software all rights reserved.
  3.  
  4.  
  5. What is GENERATIONS?
  6.  
  7.     Simply put it's a DOS utility that gives you some extended memory,
  8.     and we do mean you, not your computer.
  9.  
  10.     Here's what we mean; how many times have you needed to modify a
  11.     file, document or program, but before you started to make your
  12.     changes you wanted to copy the original file to an alias name.
  13.     This process works fine if you only do this once in awhile.
  14.     The problem is, if you're like most of us you tend to do this
  15.     frequently, to several different files and over time the alias
  16.     names and their contents are forgotten and/or mistakenly deleted.
  17.  
  18.     Well this is where GENERATIONS comes in. GENERATIONS takes on
  19.     the responsibility of remembering what are the alias names and
  20.     what the content is of each alias. For example, the command:
  21.              "gcopy resume.doc for-hospital-job"
  22.     This command will make a copy of the file "resume.doc", the
  23.     copied file is assigned an alias name that GENERATIONS stores.
  24.     The copied file is now considered the minus 1 generation of the
  25.     file "resume.doc". When you need to know what alias copies exist
  26.     and the content is of each alias, use the "gdir" command:
  27.              "gdir resume.doc"
  28.     Sample output from this gdir follows:
  29.  
  30.  
  31.      --FILE NAME--     ALIAS    SIZE     DATE / TIME  ----COMMENT----
  32.  
  33.      resume.doc                12250   2-10-91 10:18p
  34.      resume.doc(-1)  #449.doc  12250   2-10-91 10:21p for-hospital-job
  35.      resume.doc(-2)  #217.doc  11584  12-18-90  9:44a sent-to-agency
  36.      resume.doc(-3)  #245.doc  11584  12-04-90  3:12p for-bank-position
  37.      resume.doc(-4)  #121.doc  12036  11-21-90  7:33p second-draft
  38.      resume.doc(-5)  #108.doc   9923  10-01-90  4:09p first-draft
  39.  
  40.     The date/time is the date and time that "gcopy" created the alias
  41.     files (except for the current generation, in which case, date/time
  42.     shows the last date and time that generation 0 was modified.)
  43.  
  44.     Notice that the example "gcopy" command has resulted in a new -1
  45.     version of resume.doc being created. The alias name that was formed
  46.     is #449.doc. Also, note that the comment that was entered with the
  47.     "gcopy" command is now a reminder as to the content of the -1
  48.     version of resume.doc. As you can see, the older versions are
  49.     clearly labeled as to the content of each version based on their
  50.     comments. The comment parameter on the "gcopy" command is optional,
  51.     although, for obvious reasons, highly recommended.
  52.  
  53.     It is important to note that when a file reaches the maximum
  54.     number of generations to be retained, that the oldest generation
  55.     gets deleted automatically during subsequent "gcopy" processes.
  56.     The maximum number of generations retained for any file within
  57.     GENERATIONS control can be set to any value from 1 to 999. The
  58.     default that comes with GENERATIONS is 5. To change this default
  59.     use the gset command, i.e., "gset 20" changes this default to 20.
  60.  
  61.  
  62.  
  63.  
  64.     GENERATIONS works with any and all types of files. The alias
  65.     copies always contain the same suffix as the original files suffix.
  66.     As a result the alias file can function in the same manner as the
  67.     original file functions:
  68.  
  69.          If you entered:                  gcopy dbase.exe
  70.  
  71.          GEN will create a copy with
  72.          a name that looks like this:     #22.exe
  73.  
  74.          Then if you ever needed to
  75.          execute this copy, enter:        #22
  76.  
  77.  
  78.     For every file that you place under the control of GENERATIONS,
  79.     there is one .gen control file created, this is where the data
  80.     is kept related to each generation of a file. The name of this
  81.     control file is gnnnnnnn.gen, where nnnnnnn is a uniquely
  82.     assigned number. This control file is always placed in the same
  83.     directory that the source file is in.
  84.  
  85.  
  86. Simple Recap:
  87.  
  88.     You have always known:            Now you've got:
  89.            copy                            gcopy
  90.            dir                             gdir
  91.                                     There are other GENERATIONS
  92.                                     commands, although these 2
  93.                                     are the meat and potatoes
  94.                                     of GENERATIONS.
  95.  
  96.  
  97. Now What Do I do?
  98.  
  99.     Follow these simple steps to install, test and understand
  100.     Generations:
  101.  
  102. Installation Steps:
  103.  
  104.    1. Copy all of the following 12 files to either a new directory or
  105.       to any current directory.
  106.  
  107.              NAME            Size    Description
  108.              ------------    ----    ---------------------------
  109.  
  110.              GEN.EXE        65504    Generations Program
  111.              GEN-MSTR.CTL     145    Master control file
  112.              GENREAD.ME     10369    Read Me First File
  113.              GENORDER.DOC    2728    Registration Form
  114.              GCHANGE.BAT       36    Batch file
  115.              GCOPY.BAT         37    Batch File
  116.              GCOLOR.BAT        38    Batch File
  117.              GDEL.BAT          32    Batch file
  118.              GDIR.BAT          30    Batch file
  119.              GHELP.BAT          9    Batch file
  120.              GSET.BAT          33    Batch file
  121.              VENDOR.DOC      2526    Vendor Instructions
  122.                             -----
  123.                             81487    Total Disk Space Requirements
  124.  
  125.  
  126.  
  127.    2. Make sure that the directory that you use is in your active
  128.       path statement.
  129.  
  130.  
  131. Test Generations:
  132.  
  133.    3. gcopy genread.me 1st-copy gen-readme-document
  134.    4. gcopy genread.me 2nd-copy
  135.    5. gcopy genread.me 3rd-copy
  136.    6. gdir  genread.me
  137.    7. gdel  genread.me all
  138.  
  139.        Note:   The 3 gcopy commands will result in 3 copies of this
  140.                file (genread.me) being copied to saved names. The gdir
  141.                command will tell you the names and content of these
  142.                files. The gdel command will delete all generations
  143.                of the genread.me file, that's the -1, -2 and -3
  144.                generations of your file. It does NOT delete the zero
  145.                generation of your file (genread.me).
  146.  
  147.  
  148. Get Started:
  149.  
  150.    8. Enter "GEN" with no parameters for a list of valid gen commands.
  151.    9. Start by entering the "gcolor" command to set your screen
  152.       colors (if you have a color monitor). Enter the "gcolor" command
  153.       without any parameters for detailed instructions.
  154.   10. Play around with the other commands until you understand their
  155.       functionality, it should only take a short time.
  156.       We recommend that you enter the following commands to complete
  157.       your orientation to GENERATIONS:
  158.      * a.   gcopy
  159.        b.   gcopy   genorder.doc first-copy order-form
  160.        c.   gdir    genorder.doc
  161.        d.   gcopy   genorder.doc second-copy
  162.        e.   gdir    genorder.doc
  163.        f.   gcopy   genorder.doc 3rd
  164.        g.   gcopy   genorder.doc 4th
  165.        h.   gcopy   genorder.doc 5th
  166.        i.   gdir    genorder.doc
  167.        j.   gcopy   genorder.doc 6th
  168.      * k.   gchange
  169.        l.   gchange genorder.doc 6
  170.        m.   gcopy   genorder.doc 7th
  171.        n.   gdir    genorder.doc
  172.      * o.   gdel
  173.        p.   gdel    genorder.doc 3
  174.        q.   gdir    genorder.doc
  175.        r.   gdel    genorder.doc all
  176.  
  177.      * - These commands do not perform any function other than
  178.          to print out the description of the commands function.
  179.  
  180.  
  181.   11. Now your in business and can put GENERATIONS to work for you!
  182.  
  183.   12. As you have most likely noticed all of the gen commands are
  184.       executed via a batch (.bat) file. The reason for this is
  185.       simply to make it a little easier for you to remember the
  186.       gen commands. In example, the command "gcopy" is easier to
  187.       get used to then the command "gen gcopy". If you prefer not
  188.       to use the supplied batch files simply enter the following
  189.       prior to every gen command: "gen ". This will come in handy
  190.       if you ever intend to stack multiple gen commands in your
  191.       own batch file, since nested bat files don't work well under
  192.       DOS.
  193.  
  194.   13. GENERATIONS maintains a central file to control all of the
  195.       files that you copy via GENERATIONS. This file is named
  196.       GEN-MSTR.CTL. This file is updated every time you enter a
  197.       gcopy, gdel, gchange, gset and gcolor command. DON'T FORGET
  198.       to include this file in your backup considerations.
  199.       A gcopy to gen-mstr.ctl works just fine.
  200.  
  201. License Agreement:
  202.  
  203.     GENERATIONS (TM) copyrighted 1991 by Competitive Edge Software
  204.     all rights reserved.
  205.  
  206.     GENERATIONS (GEN for short) is a Shareware program. It's not free!
  207.     Continued use requires a license registration fee of $10 to $20.
  208.     Use the file GENORDER.DOC to register your copy of GENERATIONS.
  209.  
  210.     Registration covers use on one PC only. Multiple copies of
  211.     Generations must be purchased for use on multiple PC's.
  212.  
  213.     You are encouraged to copy and share Generations with other users.
  214.     When sharing, all files must be distributed without alteration.
  215.  
  216.  
  217. Disclaimer:
  218.     Competitive Edge Software specifically disclaims any warranty,
  219.     either expressed or implied, including but not limited to the
  220.     implied warranties of merchantability and fitness for a particular
  221.     use. In no event shall Competitive Edge Software be liable for any
  222.     special, consequential, or other damages, including loss of profit
  223.     arising out of the use of this program.
  224.  
  225.  
  226. **********************************************************************
  227. *   GENERATIONS is simple to install!  - 10 minutes!                 *
  228. *   GENERATIONS is simple to learn!    - 20 minutes!                 *
  229. *   GENERATIONS is simple to operate!  - Just type a "g" before copy *
  230. *   GENERATIONS is extremely valuable! - Only cost $10 to $20        *
  231. *   GENERATIONS is long overdue!       - But it's here today!        *
  232. **********************************************************************
  233.  
  234.  
  235. Please!!!  Don't forget that this is not freeware. Complete your
  236.            registration form (in genorder.doc file) and mail in your
  237.            registration fee today.
  238.                                             Thank You Very Much.
  239.