home *** CD-ROM | disk | FTP | other *** search
/ Tools en Utilities / CDASS_5.ISO / shell / file / apndit10.arj / APPENDIT.DOC next >
Encoding:
Text File  |  1992-09-11  |  9.9 KB  |  201 lines
  1.  
  2.     APPENDIT.DOC                                          Page:1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               Append-It Version 1.0
  10.                       A Utility To Combine ASCII Text Files
  11.            Copyright (C) 1992 Lightning Software, All Rights Reserved
  12.                        Written And Coded By Robert L. Folmer
  13.  
  14.           ***Bear Cat BBS Home Of Lightning Software (404) 739-1216***
  15.  
  16.           Warranty
  17.           ========
  18.           Append-It 1.0 is distributed without warranty. In no event 
  19.           will Lightning Software be liable to you for any damages from
  20.           running this program. Including any loss of profits, lost
  21.           savings, or other incidental or consequential damages arising
  22.           out of your use of or inability to use the program, even if
  23.       Lightning Software or a authorized representative has been
  24.       advised of the possibility of such damages.
  25.       Lightning Software will not be liable for any such claim by
  26.       any other party. All risk associated with using this program
  27.       are the complete responsibility of the user.
  28.  
  29.       Introduction
  30.           ============
  31.           Append-It is a simple small and fast utility that takes the
  32.           contents of one ASCII text file and combines it with another ASCII
  33.           text file. There are literally thousands of uses for such a utility
  34.       and a good example of one is to make a master listing of files on
  35.       a bulletin board system (BBS). There are several programs out there
  36.           that does this same task, however Append-It is designed with both
  37.           speed and flexibility in mind. Append-It processes files FAST!
  38.       Normally Append-It can process files up to 95% faster than all
  39.           other utilities of it's kind. Please remember that Append-It is
  40.           shareware, it is in NO WAY free software! If you find Append-It to
  41.           be a useful utility for you, then you are required to send a $10
  42.           registration fee. The evaluation version of Append-It has a few
  43.       restrictions, for a overview of what the unregistered version can
  44.           and cannot do please see the registration section of this guide.
  45.  
  46.           Installation
  47.           ============
  48.           Append-It is very easy to install, it can be installed on either a
  49.           floppy diskette or run from systems equiped with a hard disk drive.
  50.           To install Append-It onto a floppy diskette, simply format a disk
  51.           to hold all of the Append-It files, then simply uncompress the
  52.           Append-It archive to the newly created disk. To install Append-It
  53.           on a system equiped with a hard disk drive, simply create a 
  54.           directory to hold all of the Append-It files, then simply uncompress
  55.           the Append-It archive into the newly created directory. Append-It
  56.           is now completely installed and ready to run! To start Append-It
  57.           please follow the simple instructions below.
  58.  
  59.           Running The Program
  60.  
  61.  
  62.     APPENDIT.DOC                                          Page:2
  63.  
  64.  
  65.  
  66.           ===================          
  67.           Append-It is very easy to operate, the program offers two methods of
  68.           processing files, 1 is the manual method, and the next is the
  69.           automated method. The manual method of processing will allow you to
  70.           enter the source and target names from Append-It. And the automated
  71.           method allows you to enter this information from the DOS prompt
  72.           when you start Append-It. Note that only the manual method of
  73.           processing is included with the evaluation version. The most
  74.           important thing to remember is the source filename is the file which
  75.           you will be appending to, and the target is the file which will be
  76.           added to the end of the source. The following shows how to start
  77.           Append-It in the manual mode...
  78.  
  79.                                         APPENDIT
  80.  
  81.           The above command entered at the DOS prompt will start Append-It in
  82.           the manual mode, after typing the above you will see Append-It's 
  83.           title screen and then you will notice that the program is prompting
  84.           you for a source name and path. Here enter the full path and
  85.           filename to the file you wish to add to. Now Append-It will prompt
  86.           you to enter a target name and path, simply enter the full path and
  87.           filename of the file you wish to add to the source file. Below shows
  88.           an example...
  89.     
  90.       SOURCE: C:\DOS\README.DOC
  91.  
  92.           TARGET: C:\DOS\README.1ST
  93.  
  94.           The above example will append the contents of the README.1ST file to
  95.           the end of the README.DOC file. After Append-It is done processing
  96.           it will create a file named APPENDIT.NEW in the directory you run
  97.           Append-It from, this is appended files, you may then rename the file
  98.           to whatever you wish.
  99.  
  100.                                *REGISTERED VERSION ONLY!!*
  101.  
  102.           To operate Append-It in the automated mode is really just as easy as
  103.           using the program in the manual mode, the only real difference is
  104.           that you would enter the source and target filenames from the DOS
  105.           prompt. The following is an example on how to start Append-It in the
  106.           automated mode and append files...
  107.  
  108.                      APPENDIT C:\DOS\README.DOC + C:\DOS\README.1ST
  109.  
  110.           The above example will start Append-It in the automated mode, and
  111.           append the source file C:\DOS\README.DOC to the target file 
  112.           C:\DOS\README.1ST, as you may have noticed the only differences in
  113.           starting Append-It in the automated mode is that you include the
  114.           source path and filename first on the command line, then you include
  115.           the + character before the target path and filename, this character
  116.           tells Append-It to add the target file to the source file. As with
  117.           the manual method of running Append-It, the automated method will
  118.           create the APPENDIT.NEW file. When Append-It is done processing the
  119.           program will drop back to the DOS command line.
  120.  
  121.  
  122.     APPENDIT.DOC                                          Page:3
  123.  
  124.  
  125.  
  126.  
  127.           Using Batch Files With Append-It
  128.           ================================
  129.           Append-It can be installed and run from a batch file if using the
  130.           automated method of processing. This feature is useful to create
  131.           master file listings for Bulletin Board Systems (BBS's), the
  132.           following example shows how to create a simple master file listing
  133.           for a Bulletin Board System...
  134.  
  135.           ECHO OFF
  136.           CD\BBS\APPENDIT
  137.           APPENDIT D:\FILES\UPLOADS\FILES.LST + D:\FILES\DOSUTILS\FILES.LST
  138.           APPENDIT C:\BBS\APPENDIT\APPENDIT.NEW + D:\FILES\GAMES\FILES.LST
  139.           APPENDIT C:\BBS\APPENDIT\APPENDIT.NEW + D:\FILES\WINDOWS\FILES.LST
  140.           REN APPENDIT.NEW MASTER.LST
  141.           COPY MASTER.LST D:\FILES\UPLOADS
  142.           DEL MASTER.LST
  143.  
  144.           The above example may look confusing at first, but it is really quite
  145.           simple. First the batch file will set the DOS echo feature to off,
  146.           this keeps from echoing the commands to the screen. Then changes to
  147.           the Append-It directory. Then starts Append-It in the automated mode
  148.           and begins processing, appends the D:\FILES\UPLOADS\FILES.LST file to
  149.           the D:\FILES\DOSUTILS\FILES.LST file, since Append-It always creates
  150.           the updated version in it's current directory we now have a file
  151.           called APPENDIT.NEW in the C:\BBS\APPENDIT directory, now the next
  152.           couple of lines, simply adds each file listing to the APPENDIT.NEW
  153.           file, then when done renames the file to MASTER.LST, copies the file
  154.           to the systems upload directory, then deletes the file from the
  155.           Append-It directory. Note that this is just a example of using
  156.           Append-It, you could do many other different functions, such as
  157.           run a compress utility when done and copy the compressed file to your
  158.           new uploads directory so that it is set to download. Plus if your
  159.           system is capable of running events, then this entire process could
  160.           be automated. Use your imagination, remember that you are in no way
  161.           limited with Append-It!
  162.  
  163.           Registration
  164.           ============
  165.           Append-It 1.0 is being distributed under the shareware concept,
  166.           you are free to use this product for a period of 30 days after
  167.           which you must either register the program or discontinue it's use.
  168.           Registration is only $10.00, registering Append-It will allow you to
  169.           process files directly from the DOS prompt or a batch file, and will
  170.           get rid of the UNREGISTERED notices contained in the program, the 
  171.           evaluation version is limited to manual processing only. When you
  172.           register Append-It you will receive a fully operational version of
  173.           of the software on your choice of 3 1/2" or 5 1/4" disk and a key
  174.           file that will display your registration number on the title screen.
  175.           As well as the latest version, complete printed documentation and
  176.           full lifetime support. To register your copy please complete the
  177.           included form (REGISTER.FRM) and return it to the address on the
  178.           form.
  179.  
  180.  
  181.  
  182.     APPENDIT.DOC                                          Page:4
  183.  
  184.  
  185.  
  186.           Questions And Or Comments
  187.           =========================
  188.           If you have questions or comments about this or any other
  189.           Lightning Software product, please write to the address below
  190.           or call the Lightning Software Support BBS (Bear Cat BBS)
  191.           at (404) 739-1216 24 hours a day.
  192.  
  193.  
  194.                                    Lightning Software
  195.                                       P.O. Box 177
  196.                                  Lithia Springs, Ga 30057
  197.  
  198.  
  199.  
  200.  
  201.