home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / rushdemo2-37.5370.lha / RushDemo2 / README < prev    next >
Encoding:
Text File  |  1994-02-08  |  15.1 KB  |  445 lines
  1.  
  2.                  Rush release 2 DEMO Version 37.5370
  3.  
  4.                            February 7, 1994
  5.  
  6.                       Written by Douglas Keller
  7.                  Copyright (C) 1994 by Douglas Keller
  8.  
  9.  
  10. 0. What is Rush?
  11. ----------------
  12.  
  13.   Rush is a directory utility for AmigaDOS 2.0 or greater.  It allows
  14.   files and directories to be manipulated quickly and easily.  Rush uses
  15.   features of AmigaDOS 2.0, 2.1, and 3.0, and follows the Amiga User
  16.   Interface Style Guide.
  17.  
  18.   This demo version differs from the registered version in the following
  19.   ways:
  20.  
  21.    - The demo version will not save the definitions for the center
  22.      gadgets, the settings file is ascii text so it can be changed with
  23.      a text editor.
  24.  
  25.    - Annoying requesters will appear periodically in the demo version.
  26.  
  27.    - The registered version includes more utilities, see the
  28.      registration section below for a full list.
  29.  
  30.  
  31. 1. Installing and Using Rush
  32. ----------------------------
  33.  
  34.   When this demo archive is extracted it will create a directory called
  35.   RUSH with all Rush's files in it.  To install Rush just copy this
  36.   whole directory tree to the desired location.  There are no assigns
  37.   or anything need, Rush will find all of its files automatically.
  38.  
  39.   To run Rush just double click on the Rush icon or execute Rush from
  40.   a shell.
  41.  
  42.   From any window in Rush the Help key can be pressed for AmigaGuide®
  43.   online help.  Of course this does require AmigaGuide® which is
  44.   included with AmigaDOS 3.0 and is available on bulletin boards for
  45.   AmigaDOS 2.x users.  The registered version of Rush includes
  46.   AmigaGuide® for AmigaDOS 2.x users.
  47.  
  48.   Rush requires AmigaDOS 2.0 or greater to run.
  49.  
  50.  
  51. 2. Features of Rush
  52. -------------------
  53.  
  54.   The following is a list of some features of Rush.  It is broken up into
  55.   sections based on the operating system.
  56.  
  57.  
  58.   AmigaDOS 2.0 (v37) Support
  59.  
  60.    - Conforms very closely to the Amiga User Interface Style Guide.
  61.  
  62.    - Configuration files are easy to edit ASCII text, and can be edited
  63.      from within Rush.
  64.  
  65.    - AmigaGuide® context sensitive online help.
  66.  
  67.    - Automatic archive format recognition for archive extracting and
  68.      listing.
  69.  
  70.    - Automatic format recognition when double clicking on files.
  71.  
  72.    - Rush can open in any 2.0, 2.1, 3.0, or beyond screen mode, in
  73.      any available depth.
  74.  
  75.    - Public screen support.  When it opens a screen it is a public
  76.      screen, when it opens a window the window can be open on another
  77.      public screen.
  78.  
  79.    - Enforcer and Mungwall tested!!!
  80.  
  81.    - Rush iconifies down to an AppIcon on Workbench.
  82.  
  83.    - Rush is an AppWindow, icon can be dropped on either of the
  84.      listviews and Rush will load the directory.
  85.  
  86.    - User selectable fonts, does not force Topaz.
  87.  
  88.    - Uses the ASL file and font requester.
  89.  
  90.    - Rush is built as a shared library so only one copy of the code is
  91.      in memory, even if multiple copies of Rush are running.
  92.  
  93.    - Multiple Assign support.
  94.  
  95.    - Center gadgets can be configured to execute internal or external
  96.      commands, or load a specific directory.
  97.  
  98.    - Uses memory pools to reduce fragmentation and increase speed.
  99.  
  100.  
  101.   AmigaDOS 2.1 (v38) Support
  102.  
  103.    - Rush is fully localized, the following languages catalogs are
  104.      included: dansk, deutsch, français, and norsk.
  105.  
  106.  
  107.   AmigaDOS 3.0 (v39) and 3.1 (v40) Support
  108.  
  109.    - Use AmigaDOS 3.0 color model, so the full 24-bit color range for
  110.      AGA can be selected and saved.
  111.  
  112.    - Uses system busy pointer, so it can be changed with the system
  113.      pointer preference editor.
  114.  
  115.    - Opens an interleaved bitmap screen so color smearing is minimized.
  116.  
  117.    - Opens the screen with shared pens so visitor window programs can use
  118.      the pens that Rush does not use.  This will only effect 3.0 programs
  119.      that use ObtainPen().
  120.  
  121.    - Under 3.0 there are three additional screen pens which control the
  122.      colors for the newlook titlebar and menus.  Rush allows these to be
  123.      changed.
  124.  
  125.    - While Rush is iconified and memory gets low, Rush will free
  126.      the memory for the entries in each listview and the select
  127.      list.  This uses a new feature of 3.0 called memory handlers.
  128.  
  129.    - Uses AmigaDOS 3.0 memory pools to reduce fragmentation and increase
  130.      speed.
  131.  
  132.  
  133.   Major additions to Rush Release 2:
  134.  
  135.    - Added an Arexx port!  Now Rush is a real Amiga application :-)
  136.      See the "Arexx" section in the Rush.guide file for a list of
  137.      Arexx functions that are available.  Various example Arexx
  138.      programs are included in the "Rexx" directory.
  139.  
  140.    - Fixed Enforcer hit if a device is bad, happened with CrossDos
  141.      and bad DOS disk.
  142.  
  143.    - Fixed some typos in the Rush.guide file, updated it to include all
  144.      the release 2 change.  Things that have changed in release 2 have
  145.      a vertical bar (|) in the right margin.
  146.  
  147.    - Fixed Control-C from quitting Rush if is pressed more then once in
  148.      a shell execute an external command.
  149.  
  150.    - Added APPLY to makedir internal command, this creates a directory
  151.      without closing the makedir window.  This is useful when multiple
  152.      directories need to be created.  Shift-Return is the same as
  153.      APPLY.
  154.  
  155.    - Fixed %d and %p so they work for all external commands.
  156.  
  157.    - Changed Right mouse button to do menus while over the center
  158.      gadgets.  This will allow popup menu type programs to work over
  159.      the center gadgets.
  160.  
  161.    - Recompiled with Sas/C 6.50, code size dropped by a couple
  162.      kilobytes.  I also am compiling with the new instruction scheduler
  163.      which reorders instructions for the 040.  This makes things faster
  164.      for the 040 but does not hurt <040's.
  165.  
  166.    - Added hortizontal listview scrolling.  The DISPLAY gadget and
  167.      options are not longer need so they have removed.  The options
  168.      in the .prefs file that are related to display have been removed
  169.      but an error will not occur if old .prefs are used, the options
  170.      are ignored.
  171.  
  172.    - Changed copy and move to use a fixed 64k buffer rather than the
  173.      size of the file.  This slowed down copying a small amount but is
  174.      much nicer to the system.
  175.  
  176.    - Titlebar memory now only updates if the memory changes, this makes
  177.      it flicker less.
  178.  
  179.    - Archive extract, list, add, double-click, and external commands
  180.       now all have seperate console strings.  Rush can be automaticlly
  181.      pulled to the front after external commands execute.  These are
  182.      all changed in the External Commands Settings window.
  183.  
  184.    - Center gadgets can now be scrolled if more then one screen full
  185.      of gadgets are defined.
  186.  
  187.    - Center gadgets can now have keyboard shortcuts.  To enter a
  188.      keyboard short cut put an underscore in front of the letter is to
  189.      be used for the short cut.
  190.  
  191.    - Added FileFind internal command.
  192.  
  193.    - When the listview file and dir pens are the same, dir lines are
  194.      displayed in bold, rather than a reversed video <Dir> like
  195.      before.
  196.  
  197.    - Left and Right arrow now scroll the active listview left and right
  198.      rather then change the active side, DEL is now used to toggle the
  199.      active side.
  200.  
  201.    - Added Command Shell to execute Rush's Arexx commands.
  202.  
  203.    - Added Execute Arexx script menu item.
  204.  
  205.    - Changed archive extract to extract to the active side if the other
  206.      side is the device list, this is helpful if the current directory
  207.      is actived up and you want to dearchive it.
  208.  
  209.    - Now using fixed memory pools library, the old library would not
  210.      free empty puddles until the whole pool was released.  This fix
  211.      will only effect AmigaDOS 2.x users, AmigaDOS 3.0 users will have
  212.      to wait for a SetPatch from Commodore that fixes the problem.
  213.  
  214.    - The problem some people were seeing where Rush would not come
  215.      uniconified is caused by a bug in AmigaGuide not Rush.  This
  216.      will only effect AmigaDOS 2.x users using a version of
  217.      amigaguide.library less then or equal to v34.11.
  218.      Amigaguide.library v34.12 should fixed the problem.
  219.  
  220.    - All new items in the Rush.guide help file have a vertical bar (|)
  221.      in the right margin.
  222.  
  223.  
  224. 3. Comparison between Rush, DirectoryOpus, and DiskMaster
  225. ---------------------------------------------------------
  226.  
  227.   The following is a comparison between Rush 1.0, DirectoryOpus 4.0,
  228.   and DiskMaster 2.1.  All the benchmarks were run with the default
  229.   configuration of the program on an Amiga 3000 with 8 megs of memory
  230.   running AmigaDOS 3.0 with Enforcer and Mungwall running.  The results
  231.   are based on the author's experience only.
  232.  
  233.                                    Rush   DOpus    DM2
  234.  
  235.   enforcer and mungwall tested(1)  yes     no      no
  236.  
  237.   read directory(2)                13s     46s     36s
  238.  
  239.   copy 6meg file(3)                25s    160s     25s
  240.  
  241.   copy 300 files(4)                64s    142s     86s
  242.  
  243.   delete 300 files(5)               7s     60s     41s
  244.  
  245.   total executable file size(6)   171k    430k     80k
  246.  
  247.   AmigaGuide online help(5)        yes     yes     no
  248.  
  249.   localized to other languages(6)  yes     no      no
  250.  
  251.   Conforms to Style Guide(7)       yes     yes     no
  252.  
  253.   Requires AmigaDOS 2.x or 3.x(8)  yes     no      no
  254.  
  255.   AppIcon and AppWindow Support(9) yes    no/yes   no
  256.  
  257.   Supports AmigaDOS 3.x/AGA(0)     yes     ?       ?
  258.  
  259.  
  260.   (1) During testing if any Enforcer or Mungwall hit occurred a "no" was
  261.       entered here.  Opus did not have too many Enforcer hits, but it did
  262.       have a few.  DM2 would crash the whole machine if Enforcer and
  263.       Mungwall where run.
  264.   (2) Time to read and sort a directory of 1883 files, in seconds.
  265.   (3) Time to copy one 6 meg file, in seconds.
  266.   (4) Time to copy 300 1 byte files, in seconds.
  267.   (5) Time to delete 300 1 byte files, in seconds.
  268.   (6) This is the total executable size, for Rush it is the Rush
  269.       executable and rush.library, for DirectoryOpus it is the
  270.       DiectoryOpus executable, ConfigOpus, and the dopus.library,
  271.       and for DiskMaster it is the size of the executable DM2.
  272.   (7) Conforms to the Amiga User Interface Style Guide.
  273.   (8) Requires at least AmigaDOS 2.0, this allows the application
  274.       to take full advantage of 2.0 and 3.0.
  275.   (9) Supports iconifying down to AppIcon and directory loading by
  276.       an AppWindow.
  277.   (0) All 3.x screen modes and color ranges are selectable.  I was
  278.       unable to test this for Opus and DM on an AGA machine.
  279.  
  280.  
  281. 4. Future plans for Rush
  282. ------------------------
  283.  
  284.   There are a lot of things that did not make it into release 1.0 of
  285.   Rush.  Here is a list of some of the things that a planned for future
  286.   versions of Rush:
  287.  
  288.    - Font sensitive layout engine, this will allow any size fonts to be
  289.      used.
  290.  
  291.    - More internal commands like, file search (search for a string in
  292.      files).
  293.  
  294.    - Allow archives to be treated like directories.
  295.  
  296.    - Configurable menu much like the center gadgets to allow more
  297.      commands to put there.
  298.  
  299.    - Directory caching, this is not as important once AmigaDOS 3.1 is
  300.      available for all machines since it includes the directory caching
  301.      filesystem.
  302.  
  303.   I can not guarantee when these features will be added.  Some of
  304.   the features will probably be in the minor update/bug fix patches
  305.   which will be distributed on bulletin boards at no charge.
  306.  
  307.  
  308. 5. Registering Rush
  309. -------------------
  310.  
  311.   Registered Users will receive a disk containing a serialized copy of
  312.   Rush with no limitations for annoying requesters.  Bug fixes and minor
  313.   updates will be distributed periodically as patch files on bulletin
  314.   boards at no charge.  Major updates will cost a small amount.
  315.  
  316.  
  317.   The registered version of Rush includes the following:
  318.  
  319.     Rush        - Registered version of Rush with no limitations or
  320.                   annoying requesters.
  321.  
  322.     Rush.guide  - 153k bytes of online AmigaGuide documentation for
  323.                   Rush.
  324.  
  325.     AmigaGuide  - AmigaGuide for AmigaDOS 2.x users, this includes
  326.                   AmigaGuide, amigaguide.library, and wdisplay.
  327.                   AmigaGuide is included with AmigaDOS 3.0.
  328.  
  329.     Installer   - Installation script using Commodore's Installer
  330.      script       program.
  331.  
  332.     Localized   - Language catalogs for français and deutsch.  An
  333.      language     empty catalog is included so catalogs for other
  334.      catalogs     languages can created.  People who create a new
  335.                   language catalog will receive free registration.
  336.                   Contact me before creating a catalog to insure one
  337.                   has not been created already.
  338.  
  339.     Utilities   - Three useful utilities are included:
  340.  
  341.                   Read          - Simple text reader
  342.  
  343.                   RequestChoice - Allows Intuition requesters to be used
  344.                                   from AmigaDOS scripts.  AmigaDOS 3.0
  345.                                   includes a similar program.
  346.  
  347.                   RequestFile   - Allows ASL file requesters to be used
  348.                                   from AmigaDOS scripts.  AmigaDOS 3.0
  349.                                   includes a similar program.
  350.  
  351.     Scripts     - Example AmigaDOS and ARexx scripts showing some of 
  352.                   the functions Rush can perform.
  353.  
  354.     Preferences - Example preference files showing different
  355.                   configuration of Rush.
  356.  
  357.     Fonts       - Two useful fonts are included.
  358.  
  359.  
  360.   To register Rush, send $25US per copy to the address below.
  361.   Directory Opus users can upgrade to Rush for $15US by including the
  362.   front page of the DOpus manual.
  363.  
  364.   Orders made by personal check will not be shipped until the check
  365.   clears.  Orders made by money orders or certified checks will be
  366.   shipped immediately.  Money order or certified checks are preferred
  367.   over personal checks.
  368.  
  369.   Only U.S. funds drawn on a U.S. banks will be accepted.  Make checks
  370.   playable to Douglas Keller.
  371.  
  372. ----------------------------------------------------------------
  373.  
  374.                        Rush release 2 Order Form
  375.  
  376.  
  377.                   Mail to:   Douglas Keller
  378.                              3A Hudson Harbour Drive
  379.                              Poughkeepsie, NY 12601
  380.  
  381.  
  382.      Quantity
  383.  
  384.  
  385.      ______  Rush release 2    @  US $25.00 each  $ ________
  386.  
  387.  
  388.      ______  Directory Opus upgrade to
  389.              Rush release 2    @  US $15.00 each  $ ________
  390.              (Include front page of Opus manual)
  391.  
  392.  
  393.           TOTAL (U.S. funds drawn on a U.S. bank) $ ________
  394.  
  395.  
  396.  
  397.      Name: _________________________________________________
  398.  
  399.  
  400.   Address: _________________________________________________
  401.  
  402.  
  403.            _________________________________________________
  404.  
  405.  
  406.            _________________________________________________
  407.  
  408.  
  409.   Computer model: ___________________  Memory: _____________
  410.  
  411.  
  412.   Kickstart Version: ______________ Workbench: _____________
  413.  
  414.  
  415.   Email Address: ___________________________________________
  416.  
  417.  
  418.           Prices are subject to change without notice
  419.  
  420.  
  421. 6. Other Rush Related Files Available
  422. -------------------------------------
  423.  
  424.   Here is a list of Rush related files available on AmiNet sites and
  425.   Bix.
  426.  
  427.     RushPch2.lha - Patch for registerd Release 1 users to upgrade to
  428.                    Release 2.
  429.  
  430.     RushDem2.lha - Demo of Rush Release 2 (this archive).
  431.  
  432.     RushDemo.lha - Demo of Rush Release 1, replaced by RushDem2.lha.
  433.  
  434.  
  435. 7. Questions and Comments
  436. -------------------------
  437.  
  438.   For questions and comments I can be reached at:
  439.  
  440.      Internet: dkeller@bix.com
  441.           Bix: dkeller
  442.  
  443.   I also read most of the Amiga news groups on Internet so
  444.   comments can be posted in the approbate groups.
  445.