home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / rasbqbbs / rafi_203.zip / RA_FILES.DOC next >
Text File  |  1992-02-12  |  20KB  |  485 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           ┌───────────────────────────────────────────────────────────────────┐
  7.           │ ▒▒▒▒  RA_FILES v2.3  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  8.           └───────────────────────────────────────────────────────────────────┘
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                             Running on RA 1.10 and above ONLY!
  15.  
  16.  
  17.  
  18.                                RemoteAccess FILES.BBS lister
  19.  
  20.  
  21.  
  22.                             Written by Ron Huiskes / Intersoft
  23.                            (c) Copyright 1990-1991 by Intersoft
  24.                                    All Rights Reserved
  25.  
  26.  
  27.  
  28.                                 Ron Huiskes / Interface
  29.                                      P.o. Box 528
  30.                                   2280 AM  Rijswijk
  31.                                    The Netherlands
  32.  
  33.  
  34.  
  35.                     +31-70-3361380 / +31-70-3361381 +31-70-3360698
  36.                            Netmail: [2:281/506@fidonet.org]
  37.  
  38.  
  39.  
  40.  
  41.  
  42.           ┌───────────────────────────────────────────────────────────────────┐
  43.           │ ▒▒▒▒  RA_FILES v2.3  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  44.           └───────────────────────────────────────────────────────────────────┘
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.           ┌────────────────────────────────────────────────────────────────────┐
  53.           │ ▒▒▒▒  Introduction   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  54.           └────────────────────────────────────────────────────────────────────┘
  55.  
  56.  
  57.  
  58.           RA_FILES is a RemoteAccess compatible door which replaces the
  59.           menu type 31 (show files.bbs) in all your RA menus.  RA_FILES
  60.           will enhance your file-area listings. Users can view the contents
  61.           of each archive, tag files and start filedoor with one touch of a
  62.           key.
  63.  
  64.           How many times have you, as a user, logged onto an other BBS
  65.           wishing you could see the files inside the archives before
  66.           downloading them? Or, you just displayed the file list of a big
  67.           file area and found some interesting files, and you wished you
  68.           could scroll back to find the exact name?  It all happens with
  69.           RA_FILES.
  70.  
  71.           RA_FILES started as a small bonus program to RA_NEW, a fast new
  72.           files lister.  During the last month I installed the new Filedoor
  73.           from Rob van Hoeven, and became more and more discontented that
  74.           users couldn't tag files.
  75.  
  76.           Well, after the 1.2 release I rewrote RA_FILES completely from
  77.           scratch, and it now has the following features:
  78.  
  79.                ■    Fully configurable, great looks, all colors can be
  80.                     changed.
  81.  
  82.                ■    Users can scroll back to the top of the listing.
  83.  
  84.                ■    Users can tag files creating Generic Filedoor
  85.                     compatible tag-files (auto-load).
  86.  
  87.                ■    View total files and kilobytes instantly.
  88.  
  89.                ■    View contents of archives (including Arc type 7 &
  90.                     Macintosh Sit)
  91.  
  92.                ■    View ASCII, ANSI, Avatar, GBS (Opus), TXT and DOC files
  93.                     instantly.
  94.  
  95.                ■    Support for FILES.RA's "list security" and "download
  96.                     security" levels.
  97.  
  98.                ■    Users can start an external filedoor from RA_FILES.
  99.  
  100.                ■    Users can start an external archive viewing door from
  101.                     RA_FILES.
  102.  
  103.                ■    Support for any screen length (10-66) on user's side.
  104.  
  105.                ■    Support for long comments.
  106.  
  107.                ■    Complete ANSI and Avatar aware (Avt/0+ including RLE
  108.                     compression).
  109.  
  110.                ■    DESQview, Multi-node, Fossil and EMS support.
  111.  
  112.                ■    Support for Livesystems Useron door.
  113.  
  114.                ■    RA look-a-like. Status bar works as in RA, as well as
  115.                     most of the function keys!
  116.  
  117.  
  118.  
  119.           ┌───────────────────────────────────────────────────────────────────┐
  120.           │ ▒▒▒▒  Installing... ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  121.           └───────────────────────────────────────────────────────────────────┘
  122.  
  123.  
  124.  
  125.           Installing RA_FILES is very simple.  First you need to run the
  126.           RF_SETUP program.  This will create a RA_FILES.SYS file. You can
  127.           put this file in the same directory as where you placed
  128.           RA_FILES.EXE. RA_FILES itself must be installed as a menu type 7
  129.           in your RA menu(s).
  130.  
  131.           As for the optional data field, all it needs is:
  132.  
  133.                <d:><path>RA_FILES.EXE <path to files.bbs> [-N:*N] [*M]
  134.  
  135.           or if you use RA's file templates:
  136.  
  137.                <d:><path>RA_FILES.EXE *0 [-N:*N] [*M]
  138.  
  139.           The -N:*N parameter is only necessary if you are running in a
  140.           multi-node environment.  Normally RA_FILES will try to detect
  141.           itself on which line it runs, but with the upcoming RA 1.10 the
  142.           source needs a change.  So, if you run RA_FILES on your second
  143.           node, and in the status bar of RA_FILES you still see "Node: 1",
  144.           you must overrule RA_FILES internal detection by specifying
  145.           "-N:*N" on the command-line.
  146.  
  147.           The *M parameter is only necessary if you don't have enough
  148.           memory available.
  149.  
  150.  
  151.  
  152.           ┌───────────────────────────────────────────────────────────────────┐
  153.           │ ▒▒▒▒  Setup Program  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  154.           └───────────────────────────────────────────────────────────────────┘
  155.  
  156.  
  157.  
  158.           The RF_SETUP program is the main part of RA_FILES.  Here you can
  159.           change everything you like.
  160.  
  161.           Sysop name:         In this field you fill in your name exactly
  162.                               as on the registration form.  It will be used
  163.                               to calculate your registration key.
  164.  
  165.           Registration code:  The code received from us after you've
  166.                               registered, or 0 for unregistered.
  167.  
  168.           Filedoor path:      Full path and name of an external filedoor
  169.                               program.  This field reacts the same as a
  170.                               menu type 7 command, and the following
  171.                               parameters are valid:
  172.  
  173.                               *B:  Present bps-rate.
  174.                               *C:  Full path to COMMAND.COM.
  175.                               *F:  User's first name.
  176.                               *L:  User's last name.
  177.                               *M:  Swap to disk or EMS.
  178.                               *N:  Node-number.
  179.                               *P:  Comms-port used.
  180.                               *R:  User's record number.
  181.                               *T:  Time left.
  182.                               *0:  Full path to the current file directory.
  183.                                    If you don't want your users to start
  184.                                    filedoor from within RA_FILES just leave
  185.                                    the field blank.
  186.  
  187.           View-door path:     Full path and name of an external archive
  188.                               viewing program.  This field reacts the same
  189.                               as a menu type 7, and the following
  190.                               parameters are valid:
  191.  
  192.                               *B:  Present bps-rate.
  193.                               *C:  Full path to COMMAND.COM.
  194.                               *F:  User's first name.
  195.                               *L:  User's last name.
  196.                               *M:  Swap to disk or EMS.
  197.                               *N:  Node-number.
  198.                               *P:  Comms-port used.
  199.                               *R:  User's record number.
  200.                               *T:  Time left.
  201.                               *0:  Full path to the current file directory.
  202.                               *9:  Full path and name to the file the user
  203.                                    wants to view.  If you leave this field
  204.                                    blank, the internal archive (and
  205.                                    text-files) viewer will be used.
  206.  
  207.           Tag-file path:      Complete path where the tag-file should be
  208.                               created.  You can let RA_FILES create a
  209.                               tag-file in the current directory by entering
  210.                               a '.', and if you leave this field blank the
  211.                               user cannot tag at all.
  212.  
  213.           Off-line String:    Will be shown when a file is missing.
  214.                               "Off-line", "On Request", "On disk", Make it
  215.                               neat!
  216.  
  217.           No Description:     Should RA_FILES be unable to locate the
  218.                               description a file, it will show this field.
  219.  
  220.           Advanced setup:     Here you can specify if ra_files must make
  221.                               the compiled file lists must get the hidden
  222.                               bit or not, and if they must be placed in one
  223.                               special directory.
  224.  
  225.           Colors:             Press enter and you can change any color you
  226.                               like, or simply change everything to the
  227.                               build in default colors.
  228.  
  229.  
  230.  
  231.           ┌───────────────────────────────────────────────────────────────────┐
  232.           │ ▒▒▒▒  Long comments  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  233.           └───────────────────────────────────────────────────────────────────┘
  234.  
  235.  
  236.  
  237.           RA_FILES is able display comments longer than 1 line.  You can do
  238.           this in two ways:
  239.  
  240.                1.   When you are editing a FILES.BBS comment, just type
  241.                     ahead with everything you want to tell about the
  242.                     program. RA_FILES will wrap the comment if it's to
  243.                     long, and continue the next line.
  244.                2.   Begin optional second, third (and so on) lines in
  245.                     files.bbs with a '+'.  These lines will also be
  246.                     displayed correctly.
  247.  
  248.           Artwork in your FILES.BBS must be preceded by a space per line.
  249.  
  250.  
  251.  
  252.           ┌───────────────────────────────────────────────────────────────────┐
  253.           │ ▒▒▒▒  Tagging        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  254.           └───────────────────────────────────────────────────────────────────┘
  255.  
  256.  
  257.  
  258.           Tagging is available in RA_FILES with by touch of a key.  No need
  259.           to enter filenames manually, or to press a certain character.
  260.  
  261.           Tagging with RA_FILES is a real pleasure. Even the numlock key
  262.           doesn't have to be toggled on to get it working.  Users can
  263.           backscroll, switch to another file-area, untag already tagged
  264.           files, append or overwrite existing tag-files etc.  RA_FILES
  265.           takes care of everything.
  266.  
  267.           The tag-file RA_FILES creates is a generic filedoor compatible
  268.           file used by filedoor 2.0x and above...
  269.  
  270.           The only limit to the tag system is that a user cannot tag more
  271.           than 30 files in one file area.
  272.  
  273.  
  274.  
  275.           ┌────────────────────────────────────────────────────────────────────┐
  276.           │ ▒▒▒▒  Archives       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  277.           └────────────────────────────────────────────────────────────────────┘
  278.  
  279.  
  280.  
  281.           Internal
  282.           --------
  283.  
  284.           The built-in archive viewing source code was presented by Gerhard
  285.           Hoogterp and supports the following archives:
  286.  
  287.           ARC, Arc-7, PAK, ZIP, LhArc, LHA, ARJ, HYPER, ZOO and Macintosh
  288.           SIT.
  289.  
  290.           Common self-extracting archives are also supported:
  291.  
  292.           PAK, LHA, LhArc (com & exe), ZIP and ARJ.
  293.  
  294.           ASCII, ANSI, Avatar, GBS (Opus), TXT and DOC files will be shown
  295.           to the user instantly.
  296.  
  297.  
  298.           External
  299.           --------
  300.  
  301.           If you want to start an external archive viewing door you can set
  302.           it up in RF_SETUP the same way as a normal menu type 7.  Only if
  303.           this field is blank (empty) the internal viewer will be used.
  304.  
  305.  
  306.  
  307.           ┌───────────────────────────────────────────────────────────────────┐
  308.           │ ▒▒▒▒  Databases      ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  309.           └───────────────────────────────────────────────────────────────────┘
  310.  
  311.  
  312.  
  313.  
  314.           RFW by Rob van Hoeven and RAFM from Rene van Hoorn use huge
  315.           databases, BROWSE by Patrick Sjoberg compiles everything in
  316.           memory each time, and both methods are or time or space
  317.           consuming.  Of course, RA_FILES also needs some kind of database,
  318.           but it takes a different approach.
  319.  
  320.           Every time your FILES.BBS file has been changed, RA_FILES
  321.           compiles a hidden database in the same directory, and uses that
  322.           database to show the user all the files.  ONLY when you add files
  323.           to your files.bbs file will RA_FILES compile this database again.
  324.           Fully automatic and while the user is on-line.  This method is,
  325.           as I see it, the best method, since it's fast, and free of
  326.           maintenance!  No need for an extra utility that compiles the
  327.           database(s), and the database(s) will only be compiled if there
  328.           is a need too.
  329.  
  330.           Btw: If you want, all the compiled databases can be put together
  331.           in one directory.  Specify this directory in the advanced setup
  332.           section of the setup program.
  333.  
  334.  
  335.  
  336.           ┌───────────────────────────────────────────────────────────────────┐
  337.           │ ▒▒▒▒  Behavior      ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  338.           └───────────────────────────────────────────────────────────────────┘
  339.  
  340.  
  341.  
  342.           RA_FILES checks to see which screen-length the user has chosen,
  343.           and acts accordingly.  If the screen-length is different than the
  344.           sysop's local screen (23 lines), tagging and viewing files will
  345.           look a little bit messed up on the local screen.  This is normal,
  346.           and you can trust me that the user sees everything correct,
  347.           provided he has his screen length setup correct!
  348.  
  349.           RA_FILES has smart fossil and carrier detect routines, no need
  350.           for a watch-dog or redirect program.  As soon as the connection
  351.           is broken, RA_FILES returns to the BBS, and it can take
  352.           appropriate action.
  353.  
  354.  
  355.  
  356.           ┌───────────────────────────────────────────────────────────────────┐
  357.           │ ▒▒▒▒  Disclaimer     ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  358.           └───────────────────────────────────────────────────────────────────┘
  359.  
  360.  
  361.  
  362.           RA_FILES was tested, and worked flawlessly on my system (3 lines
  363.           running under Novell).  But this does not mean that RA_FILES will
  364.           work correctly in your environment.  Please take every precaution
  365.           you think is necessary.
  366.  
  367.           RA_FILES comes with limited warranty: NONE.
  368.  
  369.           In no event shall Ron Huiskes and/or InterSoft be liable for any
  370.           damages caused by RA_FILES.  The software is supplied as-is . If
  371.           it breaks in two, you own both halves...
  372.  
  373.  
  374.  
  375.           ┌───────────────────────────────────────────────────────────────────┐
  376.           │ ▒▒▒▒  License        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  377.           └───────────────────────────────────────────────────────────────────┘
  378.  
  379.  
  380.  
  381.           RA_FILES is distributed as -SHAREWARE-.
  382.  
  383.           RA_FILES is the copyrighted material of InterSoft & Ron Huiskes.
  384.           You may use RA_FILES for a period of 21 days on a trial basis in
  385.           order to determine it's suitability for your particular
  386.           application.  After this period you must register RA_FILES.
  387.  
  388.           Registration entitles you to use RA_FILES and any future version
  389.           of RA_FILES for as long as you wish.  InterSoft or Ron Huiskes
  390.           are in no way obligated to provide future versions of, or support
  391.           for, RA_FILES. Whether new versions will be developed will depend
  392.           on the number of registrations received for this version.
  393.  
  394.           You may not modify or otherwise reverse-engineer RA_FILES, and
  395.           RA_FILES may not be included as part of any software library
  396.           without prior written permission from InterSoft & Ron Huiskes.
  397.           If you do not agree with this license agreement you may not use
  398.           RA_FILES.
  399.  
  400.  
  401.  
  402.           ┌───────────────────────────────────────────────────────────────────┐
  403.           │ ▒▒▒▒  Registering    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  404.           └───────────────────────────────────────────────────────────────────┘
  405.  
  406.  
  407.  
  408.           The registration fee for RA_FILES is - in my opnion  - very
  409.           reasonable and affordable.
  410.  
  411.           Non-commercial: Dfl. 10,-
  412.  
  413.           Systems that qualify for this category must be physically run
  414.           from a non-commercial site.
  415.  
  416.           Commercial: Dfl. 50,-
  417.  
  418.           All other systems.
  419.  
  420.           Payments only by POSTAL MONEY ORDER, INTERNATIONAL POSTAL ORDERS,
  421.           CASH, EUROCHEQUE, GIRO or GIROTEL, payable to Ron Huiskes.
  422.           Foreign checks are NOT accepted, and everything must be written
  423.           out in Dutch currency.
  424.  
  425.           Giro-account 6031590 (Postbank NV., Amsterdam) payable to R.
  426.           Huiskes, Rijswijk.
  427.  
  428.           Print or reproduce the registration form enclosed in the RA_FILES
  429.           archive and send it, accompanied by your registration payment to:
  430.  
  431.                Interface Software            Interface Hq
  432.                P.o. Box 528                  +31-70-3361380
  433.                2280 AM Rijswijk
  434.                The Netherlands.
  435.  
  436.           You can also contact our US registration site for more
  437.           information:
  438.  
  439.                Scott Livingston              Phone Henge BBS
  440.                290F Brittany Farms Rd.       +1-203-826-1153
  441.                New Britain, CT 06053
  442.                USA
  443.  
  444.           After arrival of your payment and registration form, the key will
  445.           be sent to you by netmail.  If you don't have a node-number, it
  446.           will be sent to you by regular mail.
  447.  
  448.  
  449.  
  450.           ┌───────────────────────────────────────────────────────────────────┐
  451.           │ ▒▒▒▒  Credits        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  452.           └───────────────────────────────────────────────────────────────────┘
  453.  
  454.  
  455.  
  456.           ARC              is a trademark of SEA inc.
  457.           ARJ              is a trademark of Robert K. Jung.
  458.           Avatar           is a trademark of George A. Stanislav.
  459.           Browse           is a trademark of Patrick Sjoberg.
  460.           DesqView         is a trademark of Quarterdeck Systems.
  461.           Filedoor and RFW are trademarks of Rob van.Hoeven.
  462.           HYPER            is a trademark of P.Sawatzki and Klaus P.Nischke.
  463.           LZH and LhArc    are trademarks of Yoshi.
  464.           PAK              is a trademark of NoGate Consulting.
  465.           PKPAK and PKZIP  are trademarks of PKWare Inc.
  466.           RAFM             is a trademark of Rene van.Hoorn.
  467.           RemoteAccess     is a trademark of Continental Software.
  468.           ZOO              is a trademark of Rahul Dhesi.
  469.  
  470.           The RA_FILES package is written in Turbo Pascal 6.0 and Turbo
  471.           Assembler 2.01, with help of the Turbo Debugger 2.01.  Archive
  472.           viewing routines of Gerhard Hoogterp are used as well as
  473.           InterSoft's own Communication units.
  474.  
  475.           Turbo Pascal, Turbo Assembler and Turbo Debugger are trademarks
  476.           of Borland International.
  477.  
  478.  
  479.  
  480.  
  481.           ┌───────────────────────────────────────────────────────────────────┐
  482.           │ ▒▒▒▒  RA_FILES v2.2  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  483.           └───────────────────────────────────────────────────────────────────┘
  484.  
  485.