home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RAFT29.ZIP / RAFT.DOC < prev    next >
Encoding:
Text File  |  1993-08-13  |  12.1 KB  |  258 lines
  1.  
  2. ┌─█████┐───████┐──██████┐─██████┐─────────────────────────────────────────────┐
  3. │ ██┌─██┐ ██┌─██┐ ██┌───┘ └─██┌─┘      The Remote Access Filearea Tools, V2.9 │
  4. │ █████┌┘ ██████│ ████┐     ██│                                               │
  5. │ ██┌─██┐ ██┌─██│ ██┌─┘     ██│                                               │
  6. │ ██│ ██│ ██│ ██│ ██│       ██│             Copyright (C) 1993 by Chris Buijs │
  7. └─└─┘─└─┘─└─┘─└─┘─└─┘───────└─┘───────────────────────────────────────────────┘
  8.  
  9.   Well, after installing RA V2.xx and using the RAMGR utility i felt that i
  10.   needed something more flexibel to maintain my file-areas, i already had
  11.   written RAFT for the older versions of RA, the new RA has a completly
  12.   new file-system so i completly rewrote RAFT with a new interface and
  13.   new functions so that RAFT could be used with the new RA, here it is...
  14.  
  15.   RAFT is FREEWARE, RAFT is in no way crippled, if you use RAFT more then
  16.   30 days and you think it is a usefull programm, you can send me a
  17.   postcard telling so, send it to:
  18.  
  19.     Chris Buijs
  20.     De Spil 22
  21.     1507 CX Zaandam
  22.     The Netherlands
  23.  
  24.   You can also send me a message on CompuServe, write to 100117,3242.
  25.  
  26.   Thanks for using RAFT...
  27.  
  28. ┌─────────────────────────────────────────────────────────────────────────────┐
  29. │ ▒▒▒▒ Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  30. └─────────────────────────────────────────────────────────────────────────────┘
  31.  
  32.   RAFT and the accompaying programs and documentation (later on collectively
  33.   referred to as RAFT) are distributes as is. Chris Buijs (the author) makes
  34.   no warranty of any kind, expressed or implied, including but not limited to
  35.   warranties of merchantability or fitness for a particular purpose, with
  36.   respect to this software and documentation. In no event shall the author be
  37.   liable for any damages, including lost profits, lost savings, or any other
  38.   incidental or consequential damages arising out of the use or the inability
  39.   to use this program, even if the author has been advised of the possibility
  40.   of such damages, or for any claim by any other party.
  41.  
  42.   RAFT.EXE is protected with the 'Protect! EXE/COM' utility of Jeremy Lilley,
  43.   this means everytime RAFT is started it checks itself with an CRC-Check,
  44.   when RAFT.EXE is changed in any way it simply does not startup.
  45.  
  46.   Files included in this package:
  47.  
  48.     RAFT.EXE     - RAFT Executable
  49.     RAFT.CTL     - RAFT Example control-file.
  50.     RAFT.DOC     - You are reading it.
  51.     TODO.DOC     - Future features that going to be build in.
  52.     WHATSNEW.DOC - What's new in this version of RAFT.
  53.  
  54.     RAUS.EXE     - An upload check utility for RA.
  55.     RAUS.DOC     - Documentation for RAUS.
  56.  
  57.     AVIEW.EXE    - An archive viewer which can be used with RAFT.
  58.     AVIEW.CTL    - AVIEW Example control-file.
  59.     AVIEW.DOC    - Documentation for RAFT.   
  60.  
  61. ┌─────────────────────────────────────────────────────────────────────────────┐
  62. │ ▒▒▒▒ Features ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  63. └─────────────────────────────────────────────────────────────────────────────┘
  64.  
  65.   Some of the features:
  66.  
  67.   ■ Total control over your file-areas and files.
  68.   ■ Creating/Deleting/Editing file-areas, up to 65535 areas.
  69.   ■ Cleaning option to clean old unused files from the filebase.
  70.   ■ Adopting/Deleting/Editing of files, up to 65535 files per area.
  71.   ■ Adding/Deleting/Editing of text in your listings.
  72.   ■ Import/Export file-listings from/to text-files (FILES.BBS style).
  73.   ■ Import an description from a DIZ file from within an archive.
  74.   ■ Editing of your file-descriptions with a internal full-screen-editor.
  75.   ■ Editing of file-names.
  76.   ■ Editing of file-flags.
  77.   ■ Editing of uploader-name.
  78.   ■ Editing of download-counter.
  79.   ■ Editing of password on file.
  80.   ■ Smart-sorting, RAFT sorts BETWEEN text-blocks.
  81.   ■ Multi line-tagging, up to 65535 tags per area.
  82.   ■ Wildcard tagging/untagging, you can tag/untag files by wildcard-selection.
  83.   ■ Tagged text/files can be pasted within an area.
  84.   ■ Tagged text/files can be copied to another area.
  85.   ■ Tagged text/files can be moved to another area.
  86.   ■ Tagged text/files can be deleted.
  87.   ■ Tagged file-descriptions can be deleted (without deleting the files).
  88.   ■ Block-functions which stretch over all your areas, clipboard included.
  89.   ■ An backup-area for backing up your file-data/descriptions.
  90.  
  91.   And lots more...
  92.  
  93. ┌─────────────────────────────────────────────────────────────────────────────┐
  94. │ ▒▒▒▒ Requirements/Setting up ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  95. └─────────────────────────────────────────────────────────────────────────────┘
  96.  
  97.   All You'll need are the following things:
  98.  
  99.   ■ An installed RA V2.xx environment.
  100.   ■ 256 KB of free conventional memory.
  101.   ■ For memory-swapping an additional 248 KB of EMS, XMS or DiskSpace
  102.     is needed.
  103.   ■ Minimum of 512 KB Free disk-space on the drive where your file-base
  104.     is on.
  105.   ■ Some external utilitys are needed for some options in RAFT:
  106.  
  107.         PKUNPAK.EXE from PKWare for processing .ARC files.
  108.         ARJ.EXE     from R.Jung for processing .ARJ files.
  109.         PAK.EXE     from NoGate for processing .PAK files.
  110.         LHA.EXE     from Yoshi  for processing .LHA or .LZH files.
  111.         PKUNZIP.EXE from PKWare for processing .ZIP files.
  112.  
  113.     Place them in the same directory as RAFT or somewhere in your PATH.
  114.  
  115.     AVIEW V2.0 is included in the RAFT package.
  116.  
  117.     These utilitys are only needed when you use the DIZ-Import function,
  118.     they are not needed to run RAFT on it's own without the use of the
  119.     DIZ-Import function.
  120.  
  121. ┌─────────────────────────────────────────────────────────────────────────────┐
  122. │ ▒▒▒▒ Configuration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  123. └─────────────────────────────────────────────────────────────────────────────┘
  124.  
  125.   RAFT looks for the RA environment variable to find out where the RA system-
  126.   files are, when found, RAFT gets all information needed from the RA system-
  127.   files, RAFT doesn't need to be setup and can be placed in any directory
  128.   (i suggest a directory which is included in your PATH).
  129.  
  130.   RAFT searches at startup also to a file called RAFT.CTL which must exist
  131.   in the same directory as RAFT.EXE, this file is completly optional and
  132.   can be used customize RAFT operation, see the example RAFT.CTL which
  133.   is included in this package for more information.
  134.  
  135. ┌─────────────────────────────────────────────────────────────────────────────┐
  136. │ ▒▒▒▒ Parameters ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  137. └─────────────────────────────────────────────────────────────────────────────┘
  138.  
  139.   Syntax:   RAFT [/?] [/B] [/C] [/M] [/N] [/S] [/V]
  140.  
  141.             /? - Gives a help-screen with all parameters.
  142.             /B - Use BIOS instead of DIRECT screen-writes, an ANSI driver is
  143.                  needed for this.
  144.             /C - Create/Compile backup-area.
  145.             /M - When you use this parameter, RAFT will startup in mono
  146.                  (B/W) mode.
  147.             /N - When you use this parameter, RAFT will NOT check for any
  148.                  missing files when you enter an file-area.
  149.             /S - Use short area-list instead of full.
  150.             /V - Skip Remote Access version check.
  151.  
  152. ┌─────────────────────────────────────────────────────────────────────────────┐
  153. │ ▒▒▒▒ Usage ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  154. └─────────────────────────────────────────────────────────────────────────────┘
  155.  
  156.   ■ RAFT is very simple to use, everything is cursor-controlled, there are
  157.     several help-screens included which can be called up with the F1 key
  158.     (also in the editors), also the key-bar (the last line on the screen) is
  159.     used for poping up some help-message when using some functions.
  160.  
  161.   ■ All functions that delete or change items have a 'are you sure' prompt.
  162.  
  163.   ■ One major difference between RAFT and RAMGR is that RAFT can do
  164.     multi-line tagging, this means you can tag several lines individualy
  165.     instead of block-wise (like RAMGR), tagged lines are highlited.
  166.  
  167.   ■ With the GREY + and - you can do wildcard tagging, this means that you
  168.     can tag/untag files which match a wildcard pattern you enter.
  169.     Normal tagging/untagging can be done with SPACE or INS.
  170.  
  171.   ■ AREA-SELECTOR
  172.     RAFT starts up with an area-selector, this selector shows all the area's
  173.     that are currently defined in your FILES.RA file, you can do several
  174.     things here, press F1 for help on the functions you can use.
  175.  
  176.   ■ AREA-EDITOR
  177.     When you select an area in the area-selector and you press ENTER, you
  178.     will enter the area-editor which is build up in two section, the upper
  179.     half of the screen shows a page of files with some data, the bottom
  180.     half of the screen shows the description of the file the cursor-bar
  181.     is on. Press F1 for help on the functions you can use.
  182.  
  183.   ■ All input is checked if it is valid.
  184.  
  185.   ■ All functions are self-explaining so we will keep this doc small and
  186.     tidy.
  187.  
  188. ┌─────────────────────────────────────────────────────────────────────────────┐
  189. │ ▒▒▒▒ ASCII Chars and Line-Drawing ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  190. └─────────────────────────────────────────────────────────────────────────────┘
  191.  
  192.   When editing text (file-descriptions or plain file-area text), there are
  193.   two special keys availble which can be handy.
  194.  
  195.   The first special key is CTRL-A, when you press CTRL-A an ascii-table pops
  196.   up, you can then select an character and press enter, the charachter will
  197.   be pasted to the position of your cursor in the text.
  198.  
  199.   The second special key is CTRL-L, when you press CTRL-L, you enter
  200.   line-drawing-mode, you can select what kind of lines you want to draw,
  201.   when line-drawing is active, switch ON num-lock and use the numeric
  202.   key-pad for easy use, the following keys will be availble in four modes:
  203.  
  204.   Mode 1                       Mode 2
  205.   ┌─────┬─────┬─────┐          ┌─────┬─────┬─────┐
  206.   │ 7   │ 8   │ 9   │          │ 7   │ 8   │ 9   │
  207.   │   ┌ │   ┬ │   ┐ │          │   ╔ │   ╦ │   ╗ │
  208.   ├─────┼─────┼─────┤          ├─────┼─────┼─────┤
  209.   │ 4   │ 5   │ 6   │          │ 4   │ 5   │ 6   │
  210.   │   ├ │   ┼ │   ┤ │          │   ╠ │   ╬ │   ╣ │
  211.   ├─────┼─────┼─────┤          ├─────┼─────┼─────┤
  212.   │ 1   │ 2   │ 3   │          │ 1   │ 2   │ 3   │
  213.   │   └ │   ┴ │   ┘ │          │   ╚ │   ╩ │   ╝ │
  214.   ├─────┴─────┼─────┤          ├─────┴─────┼─────┤
  215.   │ 0         │ .   │          │ 0         │ .   │
  216.   │         ─ │   │ │          │         ═ │   ║ │
  217.   └───────────┴─────┘          └───────────┴─────┘
  218.  
  219.   Mode 3                       Mode 4
  220.   ┌─────┬─────┬─────┐          ┌─────┬─────┬─────┐
  221.   │ 7   │ 8   │ 9   │          │ 7   │ 8   │ 9   │
  222.   │   ╒ │   ╤ │   ╕ │          │   ╓ │   ╥ │   ╖ │
  223.   ├─────┼─────┼─────┤          ├─────┼─────┼─────┤
  224.   │ 4   │ 5   │ 6   │          │ 4   │ 5   │ 6   │
  225.   │   ╞ │   ╪ │   ╡ │          │   ╟ │   ╫ │   ╢ │
  226.   ├─────┼─────┼─────┤          ├─────┼─────┼─────┤
  227.   │ 1   │ 2   │ 3   │          │ 1   │ 2   │ 3   │
  228.   │   ╘ │   ╧ │   ╛ │          │   ╙ │   ╨ │   ╜ │
  229.   ├─────┴─────┼─────┤          ├─────┴─────┼─────┤
  230.   │ 0         │ .   │          │ 0         │ .   │
  231.   │         ═ │   │ │          │         ─ │   ║ │
  232.   └───────────┴─────┘          └───────────┴─────┘
  233.  
  234.   NOTE: Line-drawing mode stays active until you press CTRL-L again, you can
  235.         see if line-drawing mode is active, the text 'LM' is displayed in
  236.         the upper status-bar when line-drawing mode is active.
  237.  
  238. ┌─────────────────────────────────────────────────────────────────────────────┐
  239. │ ▒▒▒▒ Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  240. └─────────────────────────────────────────────────────────────────────────────┘
  241.  
  242.   For suggestions, bug-reports, complaints or the latest version of RAFT, you
  243.   can call Action Board Zaandam in The Netherlands, +31-(0)75-704890, or you
  244.   can write me a letter, send it to:
  245.  
  246.     Chris Buijs
  247.     De Spil 22
  248.     1507 CX Zaandam
  249.     The Netherlands
  250.  
  251.   You can also reach me at CompuServe, write a message to user 100117,3242.
  252.  
  253.   Have Fun,
  254.         Chris Buijs.
  255.  
  256.  
  257. <EOF>
  258.