home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / commodity / archandler / archandler.txt < prev    next >
Text File  |  1995-02-27  |  11KB  |  251 lines
  1.  
  2.                               ARCHandler 2.0
  3.                              ================
  4.  
  5.          ARCHandler is Copyright © 1994, 1995 Rafael D'Halleweyn.
  6.                            All rights reserved.
  7.  
  8.  
  9. Introduction
  10. ------------
  11.  
  12. ARCHandler  installs  a filesystem that gives you transparent access to the
  13. files in archives: you can read, view and execute those files/programs from
  14. archives without the need to extract them first.
  15.  
  16. You can test the program without installing it first, just double-click the
  17. `ARCHandler'.
  18.  
  19. When  you  have  decided  to install ARCHandler you should use the included
  20. `Install' script. It needs the Commodore `Installer' program. The Installer
  21. program  should  be somewhere in your path. You can use the `Remove' script
  22. to deinstall ARCHandler.
  23.  
  24. The `Script' drawer contains several scripts for directory utilities. These
  25. are not installed by the Install script.
  26.  
  27. For  full  documentation  you  should  read the included AmigaGuide (in the
  28. `Help' drawer).
  29.  
  30.  
  31. Distribution
  32. ------------
  33.  
  34. This package is released as shareware. This means you can copy it freely as
  35. long  as  you  don't ask any money for it, except perhaps a nominal fee for
  36. copying.  If  you  use this package on a regular base, you should send me a
  37. contribution of 500 BEF or USD 20. Send money by International Money Order,
  38. EuroCheck (in BEF!) or Cash.
  39.  
  40. Magazines that want to include ARCHandler on their coverdisk(s) should also
  41. register  ARCHandler  (one  registration fee) and send one free copy of the
  42. magazine (including disks) to the author.
  43.  
  44. The  package  is  Copyright  © Rafael D'Halleweyn, All Rights Reserved. The
  45. author  reserves the right to change the status of this package whenever he
  46. finds it appropriate.
  47.  
  48. This  package  should  not  be  spread  in  any  other form than an LhA (or
  49. equivalent)  archive  and  all  parts  of it should be spread together. The
  50. package  may  not  be  altered in any way and cannot be used for commercial
  51. purposes  without  the  prior written permission of the author. The archive
  52. should contain the following files:
  53.       ARCHandler (dir)
  54.           ARCFiles
  55.             Disk.info
  56.             Drawer.info
  57.             Volume.info
  58.           C (dir)
  59.             FindCommand
  60.             FromARC
  61.             PrefLanguage
  62.             StartARC
  63.             StartARC.info
  64.             ToARC
  65.           Catalogs (dir)
  66.             «language» (dir)
  67.               archandler.catalog
  68.             ...
  69.             archandler.cd
  70.           Help (dir)
  71.             «language».info
  72.             «language» (dir)
  73.               ARCHandler.guide
  74.             ...
  75.           Scripts (dir)
  76.             FromARC.dmrx
  77.             FromARC.dopus
  78.             Scripts.txt
  79.             Scripts.txt.info
  80.             ToARC.dmrx
  81.             ToARC.dopus
  82.           Pictures (dir)
  83.             ARCHandlerCxPrefs.pic
  84.             ARCHandlerDevPrefs.pic
  85.             ARCHandlerKeyReq.pic
  86.             ARCHandlerMain.pic
  87.         ARCHandler
  88.         ARCHandler.info
  89.         ARCHandler.txt
  90.         ARCHandler.txt.info
  91.         ARCHandler_small
  92.         ARCHandler_small.info
  93.         Help.info
  94.         Install
  95.         Install.info
  96.         Remove
  97.         Remove.info
  98.         Scripts.info
  99.     ARCHandler.info
  100.  
  101. Distribution  of  the program on any medium (CD, floppy, ...) in such a way
  102. that  it is ready to be used (eg. as a front-end for a CD-ROM) requires the
  103. permission of the author.
  104.  
  105. The   installation-script  (`Install')  and  the  extra  commands  it  uses
  106. (`FindCommand',  `PrefLanguage'  and  `StartARC')  are also copyrighted and
  107. can't  be  used  in  any  other  project/archive  without the prior written
  108. permission of the author.
  109.  
  110.  
  111. History
  112. -------
  113.  
  114. ===========================================================================
  115.  
  116.   ·release 1.0 [37.129 (12.7.94)]
  117.     -First release.
  118.  
  119.   -----------------------------------------------------------------------
  120.  
  121.   ·release 1.0a [37.131 (14.7.94)]
  122.     -Volumes  that  have  the  same  name as a device couldn't be used
  123.      through the handler (reported by Erik Bergen).
  124.     -Removed a nasty Enforcer hit.
  125.     -Made some changes to the installation script.
  126.  
  127. ===========================================================================
  128.  
  129.   ·release 1.1 [37.157 (21.8.94)] «never released»
  130.     -ARCHandler now uses it's own routine to list  lha-archives.  As a
  131.      result, ARCHandler no longer  needs the PIPE-device.  The strange
  132.      files, that sometimes showed up, should also be gone.  Listing is
  133.      now also a bit faster.
  134.     -Files  are now  extracted much  faster (upto 5  times faster  for
  135.      small files like icons).
  136.     -ARCHandler won't start to list an archive when another process is
  137.      already listing the same archive.
  138.     -Added a '.backdrop' file  to the root of the filesystem.  Now you
  139.      can permanently leave out files and drawers.
  140.     -The  handler  now  supports  ACTION_COPY_DIR_FH  (DupLockFromFH),
  141.      ACTION_EXAMINE_FH (ExamineFH), and ACTION_PARENT_FH (ParentOfFH).
  142.      Suggested  by  Nicola  Salmoria  and  Matthias Scheler. Currently
  143.      these  packets only work with normal files and files in archives,
  144.      they  don't  work  with  the extra icons the handler produces nor
  145.      with the backdrop-file.
  146.     -ARCHandler  now adds a '/' to TEMPDIR  when there wasn't one (LhA
  147.      needs this). Suggested by Tattoo Mabonzo.
  148.     -ARCHandler no  longer  uses  LhA  to extract  uncompressed  files
  149.      (`-lh0-'), this should speed up access to archives in archives.
  150.     -Added a new startup-option:  ONLYEXT;  when you use  the ONLYEXT-
  151.      option,  ARCHandler  will  only  check  the filename-extension to
  152.      decide on the filetype (suggested by Nicola Salmoria).
  153.     -Some  preparations  for a writable  filesystem  and some  general
  154.      fixes.
  155.     -ARCHandler now  returns a `disk not validated'-error when there's
  156.      something wrong with an archive or with LhA.
  157.     -The  handler  now  adds  DISKINSERTED/DISKREMOVED  events to  the
  158.      input  stream  when it's started/removed. This way, the Workbench
  159.      notices the new volume faster.
  160.     -Added  two  support commands for shell users,  ToARC and FromARC.
  161.     -The  DISKICON  and  DRAWERICON  arguments  may  now  be  upto  96
  162.      characters.
  163.     -`Smarter' installation script.
  164.     -Added ToARC and FromARC scripts for DiskMaster.
  165.  
  166. ===========================================================================
  167.  
  168.   ·release 2.0 [37.290 (3.2.95)]
  169.     -ARCHandler  is  no  longer  a real handler (one that lives in the
  170.      'L:'  directory).  Instead,  ARCHandler is now a program, you can
  171.      place it everywhere, even in your WbStartup directory.
  172.     -The most visible  change is the  graphical user  interface (GUI).
  173.      The  GUI  is  fully  font/locale  sensitive.  Almost  all  of the
  174.      settings  can be changed (and saved) with this GUI (you no longer
  175.      have  to  mess with the `Startup' field). The settings that can't
  176.      be  changed with the GUI are set while installing ARCHandler. The
  177.      GUI has context sensitive online-help.
  178.     -The  internals  of  the handler have completly been rewritten. It
  179.      now  uses  coroutines  to  implement a multi-threaded filesystem:
  180.      there's  no longer a need for extra processes to complete packets
  181.      (an  ACTION_FINDINPUT  of  an  archive  will  still need an extra
  182.      process   since   LhA   can't  be  used  in  this  multi-threaded
  183.      environment, the same is true for the filerequesters).
  184.     -ARCHandler is now also a commodity, with a `Hot Key' and a `Flush
  185.      Key'.
  186.     -Instead  of  scanning  the  DosList  on every ACTION_EXAMINE_NEXT
  187.      packet,  ARCHandler  now scans the DosList every x seconds (x can
  188.      be changed).
  189.     -ARCHandler  also  listens to DISKINSERT, DISKREMOVED events. Both
  190.      events  will  trigger  a  rescan  of the DosList. ARCHandler also
  191.      checks the list of archives, when it finds an archive that exists
  192.      on  a  removed volume, the archive will be freed if it was not in
  193.      use  (or if it is in use, it will be freed when the archive is no
  194.      longer in use).
  195.     -The `FlushARC' command  is  gone, there's now a `Flush Key' and a
  196.      'Flush'  gadget. The use of the DISKINSERT and DISKREMOVED events
  197.      should  also  replace  some  uses of this command. The `FlushARC'
  198.      command  will  no longer work, please delete it if you still have
  199.      it.
  200.     -All  the  extra files that ARCHandler needs are now placed in one
  201.      directory  (default is `PROGDIR:ARCFiles'). This directory should
  202.      contain  a `Volume.info', resp. a `Drawer.info' if you want icons
  203.      for volumes without a disk-icon, resp. icons for archives.
  204.     -Non-archive   files   are   now   writable.  The  default  volume
  205.      `Disk.info'  and the icon for the archives are also writable (the
  206.      position information of the icon is ignored).
  207.     -ACTION_LOCATE_OBJECT  (Lock()) supports exclusive  (ACCESS_WRITE)
  208.      locks.
  209.     -The filesystem now has full support for the following packets:
  210.        ACTION_COPY_DIR_FH;
  211.        ACTION_EXAMINE_FH;
  212.        ACTION_FH_FROM_LOCK;
  213.        ACTION_PARENT_FH and
  214.        ACTION_RENAME_DISK.
  215.      It also has partial support for the following packets:
  216.        ACTION_CHANGE_MODE;
  217.        ACTION_FINDOUTPUT;
  218.        ACTION_FINDUPDATE;
  219.        ACTION_DELETE_OBJECT;
  220.        ACTION_RENAME_OBJECT;
  221.        ACTION_SET_COMMENT;
  222.        ACTION_SET_DATE;
  223.        ACTION_SET_OWNER;
  224.        ACTION_SET_PROTECT;
  225.        ACTION_SET_FILE_SIZE.
  226.     -ARCHandler  should  now  also work correctly on systems using the
  227.      MultiUser FileSystem (muFS). I hope to add full MultiUser support
  228.      in  a  future  version.  The  only  thing  that has to be done is
  229.      access-checking.  ACTION_EXAMINE_OBJECT  and  ACTION_EXAMINE_NEXT
  230.      should already return the correct protection/file owner, even for
  231.      the virtual files (icons), these are always owned by root and are
  232.      readable by all, but only changeable by root.
  233.     -The  ARCHandler  archive  contains  NewIcons. You won't see these
  234.      icons  unless  you  have  the  NewIcons package installed. If you
  235.      don't  have  the  NewIcons  package  installed you can remove the
  236.      `IM1'  and  `IM2'  tooltypes.  NewIcons  was  written  by  Nicola
  237.      Salmoria, the artwork is based on work by Roger McVey.
  238.  
  239.   -----------------------------------------------------------------------
  240.  
  241.   ·future release
  242.     -Fully  writable  filesystem,  with  the ability to create/change
  243.      files in archives.
  244.     -Support for more archive types (zip/zoo/tar/...).
  245.     -Support for packed files (XPK/PowerPacker/Imploder/...).
  246.  
  247. These are just some of the features I @{i}might @{ui} add to a future
  248. release. I don't guarantee that any of these features will ever be
  249. implemented (but I hope they will). If you've got any good ideas for a
  250. future release let me know.
  251.