home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RGFC0320.ZIP / RGFC.DOC < prev    next >
Encoding:
Text File  |  1993-03-20  |  20.3 KB  |  392 lines
  1.         Bechtel Consulting (717) 652-6604
  2.         (C) 1993 All Rights Reserved
  3.  
  4.         ┌──────────┐ ┌─────────┐ ┌─────────┐
  5.         └┐  ┌───┐  │ └┐  ┌───┐ │ │  ┌────┐ │
  6.          │  │   │  │  │  │   └─┘ │  │    └─┘  The Sysop's Best Friend
  7.          │  └───┘  │  │  └──┐    │  │
  8.          │  ┌┐  ┌──┘  │  ┌──┘    │  │         Renegade File Commander
  9.          │  │└┐ └┐    │  │       │  │    ┌─┐
  10.         ┌┘  └┐└┐ └─┐ ┌┘  └┐      │  └────┘ │  Version 1.0  March 1993
  11.         └────┘ └───┘ └────┘      └─────────┘
  12.  
  13.         Written By
  14.         Eric Givler and Dale Bechtel
  15.  
  16.         Renegade File Commander is available at MetaSys Support System BBS
  17.         (717) 545-7975 7/24 hours. Support is available via the ITCnet
  18.         Renegade Echo. Current versions of the program can be FREQ'ed from
  19.         the MetaSys BBS using the magic name RGFCMD.
  20.  
  21.         This version -must- be registered to fully use the program.
  22.         We program for a living and can't afford to give it way.
  23.         Suggestions and recommendations for enhancements are always welcome.
  24.  
  25.      ─────────────────────────────────────────────────────────────────────
  26.      First, let's get the legal stuff over with....
  27.      ─────────────────────────────────────────────────────────────────────
  28.  
  29.   WARRANT/DISCLAIMER:
  30.  
  31.           The Renegade File Commander (RGFC) is guaranteed to take up
  32.      room on your hard disk until you see fit to erase it!  Due to the
  33.      volatile nature of Renegade updates, and until Renegade is out of
  34.      beta, we cannot guarantee that RGFC will continue to function during
  35.      subsequent releases of Renegade.  If the users of RGFC support our
  36.      development effort, we will attempt to keep up to date...
  37.  
  38.      The authors specifically disclaim all other  warranties, expressed
  39.      or implied,  including  but not  limited  to  implied warranties  of
  40.      merchantability  and  fitness  for  a  particular  purpose  and  the
  41.      program  license granted herein  in particular, and without limiting
  42.      operation  of the  program  license with  respect to  any particular
  43.      application, use,  or  purpose.   IN NO  EVENT SHALL  THE AUTHOR  BE
  44.      LIABLE  FOR ANY LOSS OF  PROFIT, LOST SAVINGS, COMMERCIAL DAMAGE, OR
  45.      OTHER  INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  46.      INABILITY TO USE  RGFC  EVEN  IF THE AUTHORS HAVE BEEN ADVISED  OF
  47.      THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  48.  
  49.      ─────────────────────────────────────────────────────────────────────
  50.       Whew!  Now that we are done with that!  Gotta cover your ... ya know!
  51.      ─────────────────────────────────────────────────────────────────────
  52.  
  53.      WHAT IS THE RENEGADE FILE COMMANDER, ANYWAY???
  54.  
  55.           RGFC was designed for the industrious Renegade sysop to allow
  56.      for easy maintenance of the file system.  It was designed to make
  57.      child's play out of keeping your file lists, descriptions, and actual
  58.      files in sync.  Editing is made as easy and seamless as possible,
  59.      by using fully editable input routines.  No longer do you have to type
  60.      in the complete description, simply to correct spelling of a word!  The
  61.      edit routines allow you to use several cursor movement keys that
  62.      most people that ever used a word processor take for granted.
  63.  
  64.  
  65.      LIMITATIONS TO SHAREWARE VERSION
  66.  
  67.           The shareware version of RGFC will allow you to testdrive the
  68.      whole program, but will not update your Renegade data files.  This
  69.      allows you to get an idea if this program is for you.  We are
  70.      professional programmers, and this is our whole living.  We just
  71.      plain can't afford to give away the results of our work.  By
  72.      registering this program, you are ensuring that we keep an interest
  73.      in updating it to meet the new releases of Renegade as they come out.
  74.  
  75.           We are only asking $15 U.S. to register RGFC, which is more than
  76.      fair considering that we charge $75 per hour to our clients to do the
  77.      same kind of programming :).
  78.  
  79.      ─────────────────────────────────────────────────────────────────────
  80.      HOW DO I INSTALL THIS PROGRAM?
  81.  
  82.           Installation couldn't be easier!  Copy RGFC to your main
  83.      Renegade directory (where Renegade.dat lives), and  it is installed!
  84.      When you register RGFC, you will recieve a key number.  To register
  85.      the key into the program, start RGFC, and press F9 from anywhere
  86.      inside the program.  Type in your key, and you are registered!  If you
  87.      recieve a message that tells you to register, you have either mis-typed
  88.      your key, or you are not registered...
  89.  
  90.      ─────────────────────────────────────────────────────────────────────
  91.      HOW DOES IT WORK?
  92.  
  93.           When you start RGFC, you will see the introduction screen first.
  94.      Press any key when you are finished reading.  At this point, you are
  95.      presented with a browse screen containing your file bases.
  96.  
  97.  
  98.      ──────────────────[ Example File Base Browse ]───────────────────────
  99.  
  100.                                    FBASES.DAT
  101. ╓──────────────────────────────────────────────────────────────────────────────╖
  102. ║           Area                                       File                    ║
  103. ║════════════════════════════════════════════════════╤═════════════════════════║
  104. ║           Sysop's Directory -= No Lamers! =-       │ SYSOP                   ║
  105. ║           Program Development                      │ DEVL                    ║
  106. ║           PD/Shareware UPLOAD Area                 │ PDUPLOAD                ║
  107. ║           BBS Programs                             │ BBS                     ║
  108. ║           Renegade Files                           │ RENEGADE                ║
  109. ║           BBS Online Door Games                    │ BBSDOORS                ║
  110. ║           BBS Doors & Utilities                    │ BBS-REG                 ║
  111. ║           Business Programs                        │ BUSINESS                ║
  112. ║           Clipper Files                            │ CLIPPER                 ║
  113. ║           Communication Utilities                  │ COMM                    ║
  114. ║           Demo Programs                            │ DEMOS                   ║
  115. ║           Educational Software                     │ EDUC                    ║
  116. ║           Games & Entertainment                    │ GAMES                   ║
  117. ║           GIF Files - G Rated                      │ GIF-G                   ║
  118. ║           Graphics Utilities                       │ GRAPHICS                ║
  119. ║           Misc Files                               │ MISC                    ║
  120. ║           Music/SoundBlaster Files                 │ MUSIC                   ║
  121. ╙──────────────────────────────────────────────────────────────────────────────╜
  122. Area in Color: Sysop's Directory -= No Lamers! =-
  123.  [Space] Edit, [Enter] Select, [Esc] Quit
  124.  
  125.      ─────────────────────────────────────────────────────────────────────
  126.      AREAS OF THE SCREEN
  127.  
  128.      Top Line       - Area that you are currently viewing/editing.
  129.      Middle         - This is the browse!
  130.      Area In Color  - Display of file area description in sysop defined colors
  131.                       NOTE: ONLY PIPE CODES ARE SUPPORTED.  Control P codes
  132.                       are not supported, but are filtered out of the browse.
  133.                       The old ASCII 3 codes are not supported at all.
  134.      Bottom Line    - Active key display.
  135.  
  136.      ─────────────────────────────────────────────────────────────────────
  137.      FILE BASE EDITING
  138.  
  139.           The browse allows you to scroll up or down as well as left and
  140.      right.  By scrolling to the right, all the editable fields are displayed
  141.      to you.  Pressing the space bar allows you to edit the currently
  142.      highlighted field.  Pressing ENTER anywhere in the browse will take you
  143.      to the DIR file that is currently highlighted.  You can always tell
  144.      which one is current by looking at the area in color display at the
  145.      bottom of the screen.  Now we will look at how the various fields
  146.      are handled during edits:
  147.  
  148.      AREA           - Area Description displayed to the users.  You can
  149.                       optionally add pipe codes to colorize these.  If
  150.                       using pipe codes, you should use them in
  151.                       foreground/background pairs or they may not be filtered
  152.                       properly...  If the descriptions look funny after you
  153.                       edit them, this is why.  Pipe codes must be formatted
  154.                       as |nn|nn to work properly.
  155.  
  156.      FILE           - This is the file (DIR) that Renegade stores all the
  157.                       file names and descriptions in.  If you press space while
  158.                       highlighting this field, you will be asked if you want to
  159.                       rename this file.
  160.  
  161.      DOWNLOAD PATH  - This is the path where all the files available for
  162.                       download are stored.  If you press space on this field
  163.                       you can change this to a different path, optionally
  164.                       create the path if it does not exist, and optionally
  165.                       move the files, if any, from the old path to the new
  166.                       one.  Real handy way to move files to another drive.
  167.  
  168.      UPLOAD PATH    - This is where incoming files are stored.  Works exactly
  169.                       the same as DOWNLOAD PATH.
  170.  
  171.      MAXFILES       - The maximum number of files allowed in this directory.
  172.                       RGFC does not enforce this, but Renegade probably will!
  173.  
  174.      PASSWORD       - Optional password to access this area.
  175.  
  176.      ARCTYPE        - Archive type for this area.  RGFC does nothing here.
  177.  
  178.      CMTTYPE        - Comment type for this area.  RGFC does nothing here.
  179.  
  180.      FBSTAT         - File base status bits.  Pressing space here will pop
  181.                       up a dialog box that allows you to toggle the flags
  182.                       on or off with the space bar.  Press ENTER to record.
  183.  
  184.      ACCESS
  185.      U/L ACCESS
  186.      D/L ACCESS     - Security levels to access the file bases.
  187.  
  188.      ─────────────────────────────────────────────────────────────────────
  189.                              FILE DIRECTORY SCREEN
  190.      ─────────────────────────────────────────────────────────────────────
  191.  
  192.                                     BBS.DIR                        <  74 Files >
  193. ╒══════════════════════════════════════════════════════════════════════════════╕
  194. │ Filename       Description                                                   │
  195. │══════════════╤═══════════════════════════════════════════════════════════════│
  196. │ CALLANAL.ARJ │ Call Analyser For Rbbs                                        │
  197. │ CB118   .ARJ │ Rbbs-PC Callback Verifier v1.18 By Eric J. Givler             │
  198. │ CDROM15A.ZIP │ A nice utility                                                │
  199. │ CISHLP  .ARJ │ Compuserve Help.                                              │
  200. │ DCI219-1.ARJ │ Dci BBS                                                       │
  201. │ DCI219-2.ARJ │ Dci BBS                                                       │
  202. │ DLMST240.ARJ │ Download Master For Rbbs                                      │
  203. │ DOSMAX12.ZIP │ Max dos out                                                   │
  204. │ DSZ1206 .ARJ │ Dsz External Protocol.                                        │
  205. │ FDSETUP .ARJ │ Front Door Setup Example For Tribbs                           │
  206. │ FLAGFLY .ARJ │ Old Glory Ansi File                                           │
  207. │ FLASH32 .ARJ │ Flash (Daily News File Generator)                             │
  208. │ FLST20  .ARJ │ Files.Lst Utility  For Tribbs                                 │
  209. │ FMS-CNV .ARJ │ Rbbs Fms Convertor                                            │
  210. │ FUPDAT11.ARJ │ File List Update For Rbbs.                                    │
  211. │ GARBAGE .ARJ │ Tribbs Nuke Screen - Displays Line Noise...                   │
  212. │ GATEWAY2.ARJ │ Gateway Device Driver                                         │
  213. │ GSBBS301.ARJ │ Gs BBS                                                        │
  214. │ GSZ0807 .ARJ │ Graphics Dsz External Protocol.                               │
  215. ╘══════════════════════════════════════════════════════════════════════════════╛
  216. [F2] Dir, [F10] Menu,  [Esc] Quit
  217.  
  218.      ─────────────────────────────────────────────────────────────────────
  219.      EDITING FILE DIRECTORIES
  220.  
  221.           After pressing ENTER at the file base browse, you are presented
  222.      with the file directory browse.  At the top of the screen you have
  223.      the area tag, and the file count for this area.  At the bottom of the
  224.      screen, the edit keys are displayed.
  225.  
  226.      F2        - Displays the actual directory listing, from the download
  227.                  directory in a scrollable window.  Allows you to compare
  228.                  the listing with the actual files on disk.
  229.  
  230.      F10 or /  - Brings up the edit menu.
  231.  
  232.      Any Other
  233.      Charactor - performs an incremental search for a file name.  The space
  234.                  bar will clear the search buffer.
  235.  
  236.      ─────────────────────────────────────────────────────────────────────
  237.      THE EDIT MENU
  238.  
  239.                     ╒════════ Select One ═══════╕
  240.                     │                           │
  241.                     │ U) Upload Files      {/U} │
  242.                     │ D) Delete File       {/D} │
  243.                     │ E) Edit FileStats    {/E} │
  244.                     │ M) Move File         {/M} │
  245.                     │ R) Rename File       {/R} │
  246.                     │ O) Scan For Offline  {/O} │
  247.                     │ V) View Record       {/V} │
  248.                     │ S) Sort This Area    {/S} │
  249.                     │ A) View Archive      {/A} │
  250.                     ╘═══════════════════════════╛
  251.  
  252.           The file menu provides a rich collection of functionality to
  253.      RGFC.  This menu can be displayed by pressing F10, or by pressing the
  254.      'speed keys' displayed inside the {} to the right of each option.
  255.  
  256.      Let's explore the options:
  257.  
  258.      U or /U   - Upload Files: Performs the same duty as Renegade's /U
  259.                                command but many times faster!  This function
  260.                                compares the current DIR file to the actual disk
  261.                                directory, and adds any files it finds that
  262.                                are not in Renegade yet.  Then moves the
  263.                                highlight bar to the first new file.
  264.  
  265.      D or /D   - Delete File: Erases the current file from Renegade's DIR
  266.                               file, and optionally, from the hard drive.
  267.                               Optionally, you can deduct the file credits
  268.                               from the uploader.
  269.  
  270.      E or /E   - Edit FileStats: Performs the edits on the file area flags.
  271.                                  Simply press the space bar to toggle the
  272.                                  various options on or off. Press ENTER
  273.                                  to record.
  274.  
  275.      M or /M   - Move File: Move the current file to a different file area.
  276.                             A pop up menu will appear, that allows you to
  277.                             select the area to move to.  Move the highlight
  278.                             to the area you want, and press ENTER.  You can
  279.                             also type the first letter of the area for a
  280.                             speed search.
  281.  
  282.      R or /R   - Rename File: Renames the current file on disk and in Renegade.
  283.  
  284.      O or /O   - Scan For Offline: This does the opposite of the upload
  285.                                    command.  This function compares the
  286.                                    Renegade DIR file to the actual DOS
  287.                                    directory, and marks files that are not
  288.                                    really on disk as offline.  Offline files
  289.                                    are displayed in a dimmed color.
  290.  
  291.      V or /V   - View Record: Pops up a box displaying all the info for the
  292.                               current file.  This saves you from panning the
  293.                               browse just to see a few fields.
  294.  
  295.      S or /S   - Sort This Area: Sorts the current file area, real fast!
  296.  
  297.      A or /A   - View Archive: This option will display the contents of the
  298.                                current archive file.  While the contents are
  299.                                displayed you can highlight any text file, and
  300.                                press ENTER to display the contents.  This allows
  301.                                you to read doc files, and desc.sdi files
  302.                                and figure out what the devil it is!
  303.  
  304.      ─────────────────────────────────────────────────────────────────────
  305.      EDITABLE FIELDS IN FILE DIRECTORY MODE
  306.  
  307.           FILENAME       - Rename this file.
  308.  
  309.           DESCRIPTION    - Full function edit of description.
  310.  
  311.           FILEPOINTS     - Edit the filepoints.
  312.  
  313.           DOWNLOADS      - Edit the number of downloads for this file.
  314.  
  315.      ─────────────────────────────────────────────────────────────────────
  316.      FUTURE ENHANCEMENTS PLANNED FOR RGFC.
  317.  
  318.           o Multiple file tagging to allow moving or deleting files
  319.             in bunches.
  320.           o Extended Description edits.
  321.           o Creation/Deletion of file areas.
  322.           o Repositioning Of File bases.
  323.           o Automatic archive adjustments.  Allow sysop to run external
  324.             archive conversion, and automatically change extension in
  325.             Renegade's file listing.
  326.           o Reporting options.  Create custom file listings, reports, ect.
  327.           o Global search/replace function.
  328.           o Global offline scanning.  Allow sysop to scan all file areas
  329.             for offline files with one command.
  330.           o Pop up color matrix selection table for colorizing descriptions.
  331.           o Mouse support?
  332.           o Fileviewer configuration support for graphics files and other
  333.             formats!
  334.  
  335.      ─────────────────────────────────────────────────────────────────────
  336.      COMMENTS & NOTES
  337.  
  338.      o RGFC assumes that the sysop is user number one.
  339.  
  340.      o RGFC is multi-user aware.  It checks for the presence of share.  If
  341.        you are running multinode, make sure share is loaded.  All efforts
  342.        have been made to insure data integrity, but always be real careful
  343.        what you try while users are online.  Things like renaming file
  344.        bases and/or files while the user is accessing them are not a real
  345.        good idea...
  346.  
  347.      o The program also sets a multiuser variable to determine if SHARE.EXE
  348.        is installed.  If so, all file updates will use Interrupt $5c
  349.        record locks.  Multi-record appends will LOCK the entire file during
  350.        update and unlock on completion.  Integrity of your files is important
  351.        to me!
  352.  
  353.      o RGFC supports up to 4000 file areas containing up to 4000 file
  354.        descriptions each.
  355.  
  356.      o If a file directory is empty, RGFC will attempt to upload any files
  357.        in the directory, and barring that, will display a message saying
  358.        the file area is empty.
  359.  
  360.      ─────────────────────────────────────────────────────────────────────
  361.      REGISTRATION PROCEDURES
  362.  
  363.           This program is not Public Domain.  If you continue to use it,
  364.      please register.  Many more features are in the works depending on how
  365.      this goes.  To register the Renegade File Commander please send
  366.      $15 U.S. funds in a check or money order to:
  367.  
  368.           Bechtel Consulting
  369.           ATTN: RGFC
  370.           408 Piketown Road
  371.           Harrisburg, PA. 17112
  372.  
  373.      Upon registration, we will generate a key to open up the complete
  374.      functionality of RGFC.  Simply press F9 while in RGFC to enter
  375.      your key into the program.  Your key will also be valid for future
  376.      releases of RGFC.
  377.  
  378.           Remember, we can be contacted via:
  379.  
  380.           o The ITC Renegade echo       - Address 85:863/206
  381.           o The FIDOnet Renegade Echo   - Address 1:270/112
  382.  
  383.           o MetaSys Support System      - (717) 545-7975 14.4k
  384.           o Bechtel Consulting          - (717) 652-6604
  385.  
  386.      ─────────────────────────────────────────────────────────────────────
  387.                Renegade File Commander Is Copyrighted (c) 1993,
  388.                          Dale Bechtel & Eric Givler
  389.                             All Rights Reserved
  390.      ─────────────────────────────────────────────────────────────────────
  391.  
  392.