home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RGPF19.ZIP / RGPF.DOC < prev    next >
Encoding:
Text File  |  1993-04-11  |  6.7 KB  |  165 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.             ▄████████▄   ▄████████▄ ▄████████▄  ▄█████████▄
  7.             ███▀   ▀███ ████▀   ▀▀▀ ███▀   ▀███ ████    ▀▀▀
  8.             ███▄   ▄███ ████  ▄▄▄▄  ███▄   ▄███ ████▄▄▄▄
  9.             █████████▀  ████  ▀▀███ █████████▀  ████▀▀▀▀
  10.             ████ ▀████▄ █████▄▄▄███ ████        ████
  11.             ▀██▀   ▀██▀  ▀████████▀ ▀██▀        ▀██▀
  12.  
  13.  
  14.                  Renegade Popular Files version 1.9
  15.                Copyright (c) 1992 by Kerry W. Sanders
  16.                
  17.  
  18.  
  19.  
  20. INTRODUCTION
  21. ~~~~~~~~~~~~
  22.     RGPF is a very easy to use file list utility for Renegade 1.x 
  23.     BBS Systems.  RGPF creates a nicely formatted list of files that
  24.     are the most popular downloads from your BBS.  As the program is running,
  25.     it informs you of the current file base being processed.
  26.     
  27.     The cost of RGPF is $10 (US funds).  Include $5 shipping and handling
  28.     for orders outside the United States.  Add $3 if you require RGPF on a
  29.     3-1/2" disk.  A completed and signed order form must accompany each
  30.     order.  The order form is found in the file REGISTER.FRM
  31.     
  32.     What does registration bring to me?  You will receive a registered
  33.     copy of RGPF on diskette.  This will remove the [UNREGISTERED] line
  34.     from RGPF.  All updates of RGPF will be of no charge after you
  35.     register your copy.  Registration also brings you piece of mind
  36.     knowing that you have supported someone's hard work.
  37.  
  38.  
  39. INSTALLATION INSTRUCTIONS
  40. ~~~~~~~~~~~~~~~~~~~~~~~~~
  41.     Installation of RGPF is very easy!  The program must be run from your
  42.     main BBS subdirectory where Renegade.Dat is located.  RGPF must find
  43.     this file in the current subdirectory or it will not run.
  44.     
  45.     RGPF now supports internal configuration.  By specifying a -C or /C on
  46.     command line, RGPF will go into its configuration mode.  After you have
  47.     answered all questions for the configuration, it will generate your
  48.     file list according to those instructions.  Case for the command line
  49.     parameter does not matter.
  50.  
  51.     RGPF requires a two line configuration file which tells it how to
  52.     generate your list of available files.  The name of this config file
  53.     can be passed as the first command line paramter to RGPF.  No extension
  54.     should be included.  If no config file name is specified on the command
  55.     line, RGPF defaults to using RGPF.CFG.  This file should be located in
  56.     the same directory where RGPF.EXE is located.  If this file is not found
  57.     when the program is executed, RGPF will immediately go into its
  58.     configuration mode.  No more editing of text files.  This makes things
  59.     a lot easier.
  60.                    
  61.     The config file should have the following lines in this order:
  62.     
  63.       1)  Name of output file.  Do not include an extension, as RGPF will
  64.           automatically add the .ASC extension.
  65.           
  66.       2)  Number of files to include in your list.
  67.  
  68.     You can now setup a second configuration file which lists all file bases
  69.     not to include in the list of popular files.  The name of this exclude
  70.     file will be the same as the name of your config file, but with an
  71.     extension of .OFF, and it should be located in the directory where
  72.     RGPF.EXE is located.  If this file is not found when RGPF excecutes,
  73.     then it will assume that no areas are to be excluded.  The default
  74.     exclude file name is RGPF.OFF.
  75.  
  76.     When the configuration portion of RGPF is executed, it asks you to
  77.     specify the areas that are to be excluded.  This file is text, so you
  78.     can edit it if you wish, but be WARNED - RGPF does a text match with
  79.     each file area *.DIR file name that it finds in the exclude file
  80.     against each *.DIR file name in your FBASES.DAT file.  If a match is
  81.     not found, even though that name is in the exclude file, nothing is
  82.     excluded.
  83.  
  84.  
  85. You are all set!  All you have to do now is run RGPF at the DOS command line.
  86. It will read the configuration file and create your file list accordingly.
  87.  
  88.  
  89. TECHNICAL SUPPORT
  90. ~~~~~~~~~~~~~~~~~
  91.     Questions, comments, or bug reports regarding this product should be
  92.     directed to:
  93.     
  94.          Kerry W. Sanders
  95.          1132 7th Avenue
  96.          Gadsden, AL  35901
  97.     
  98.  
  99.     I can also be contacted at my home BBS:
  100.     
  101.           Programmer's Shack
  102.             (205) 546-2968
  103.        US Robotics Dual Standard
  104.          1200/2400/9600/14400
  105.     
  106.     or
  107.        
  108.       on the FIDOnet RENEGADE conference or
  109.       the ITCRene conference of ITC net.
  110.  
  111.       Address messages to KERRY SANDERS.
  112.       
  113.        ITC 85:882/0  --  FIDO 1:3657/3
  114.  
  115.     
  116. LICENSE AGREEMENT
  117. ~~~~~~~~~~~~~~~~~
  118.     RGPF (the software) is licensed to you.  The author, Kerry W. Sanders,
  119.     retains sole ownership of the software.
  120.  
  121.     RGPF has been released under the ShareWare Concept.  This concept gives 
  122.     you the chance to try the software before you buy it.  There are no 
  123.     crippling effects in this software, it is a fully funtional copy.
  124.     You may try the shareware version for no more than 30 days, after which
  125.     you must either register it or quit using the program.  Registration is 
  126.     required for use in a business, government or institutional setting.
  127.     
  128.     Registered users may only use the software on one computer at a time.  
  129.     At no time should more than one copy of the software be running on 
  130.     different computers at the same time.
  131.  
  132.     You may NOT alter, decompile or disassemble the software or any of the
  133.     supporting files other than what occurs during the natural use of the
  134.     program.
  135.  
  136.     You may NOT assign, sublicense, or transfer the program or any rights
  137.     under this License to anyone else.  This License Agreement is NOT
  138.     transferable, and can only be revoked by the user if he or she destroys
  139.     ALL copies of the program.
  140.  
  141.  
  142. DISCLAIMER OF ALL WARRANTIES AND LIABILITY
  143. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  144.    RGPF IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED 
  145.    OR IMPLIED.  YOU ASSUME THE ENTIRE RISK OF USING THE PRODUCT.  THE AUTHOR 
  146.    WILL NOT BE LIABLE FOR, BUT NOT LIMITED TO, DIRECT, INDIRECT, INCIDENTAL 
  147.    OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT IN, OR USE OF, THE 
  148.    SOFTWARE.
  149.  
  150.  
  151. DISTRIBUTION
  152. ~~~~~~~~~~~~
  153.     Unaltered copies of RGPF's original shareware distribution archive
  154.     may be freely copied and shared with others as long as no fee is
  155.     charged to do so.  It may be uploaded to local and national BBS's.
  156.  
  157.     Anyone desiring to distribute RGPF by charging a per disk fee
  158.     (i.e. disk vendors) must obtain written permission from the author,
  159.     Kerry W. Sanders, before doing so.
  160.  
  161.     RGPF may be distributed via subscription BBS's as long as no inference
  162.     is made that the subscription in any way pays for the use or evaluation
  163.     of RGPF.
  164.  
  165.