home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk933 / guiarc / guiarc_e.doc < prev    next >
Text File  |  1993-12-21  |  28KB  |  517 lines
  1.           
  2.  
  3.  
  4.                                       GuiArc V1.22
  5.           
  6.                          Graphical User Interface for Achivers.
  7.  
  8.  
  9.  
  10.           1. Copy-rights.
  11.            
  12.           This program is spread as  FreeWare.  It  means  you  may  freely
  13.           distribute and copy this program, as  long  as  everything  stays
  14.           unchanged and all documentation and other files are  spread  with
  15.           it. 
  16.            
  17.           It also means, that this  program  is  Copy-righted  by  me,  the
  18.           author of this program.  You are not allowed to change  anything,
  19.           ask money for the program or use the program commericaly.  Nobody
  20.           but myself is allowed to make money with this program.  This also
  21.           implicates that  this  program  may  not  be  included  with  any
  22.           commercial product without  written  permission  of  the  author.
  23.           This program may be included on  non-commercial  PD  disks  like
  24.           Fish Disks.
  25.  
  26.  
  27.           2. Distribution contents.
  28.            
  29.           The distribution should contain at least: 
  30.                   ArcTypes
  31.                   ArcTypes.info
  32.                   GuiArc
  33.                   GuiArc.info
  34.                   GuiArc_E.doc
  35.                   GuiArc_E.doc.info
  36.                   GuiArc_N.doc
  37.                   GuiArc_N.doc.info
  38.  
  39.           The file 'GuiArcConfig' may absolutely NOT  be  included  in  any
  40.           distribution. When this file is present, the requester  which  is
  41.           shown at the start of the program, will be disabled, and I think
  42.           everybody should see this requester at least one time :-).
  43.  
  44.  
  45.           3. What's the program for.
  46.            
  47.           This program is written, to give you a user friendly and easy  to
  48.           use method of dealing with archivers. The main archiver  where  I
  49.           wrote this program for, is 'Lha'  from  Stefan  Boberg,  but  the
  50.           program is fully configurable  to  use  an  unlimited  number  of
  51.           different archivers at once.
  52.  
  53.           The program recognizes different types  of  archives  automaticly
  54.           from  their  file  pattern.  When  you,  for  example,  select  5
  55.           archives, of different  types,  and  choose  'extract'  from  the
  56.           gadgets menu, all archives will  get  unpacked,  with  their  own
  57.           archiver. The program automaticly selects the  correct  archiver.
  58.           This is also  done  with  all  other  actions,  like  adding  and
  59.           listing. When you create a  new  archive,  and  don't  explicitly
  60.           specify the type, the first defined type (default 'lha') will  be
  61.           chosen.
  62.  
  63.  
  64.           4. How to use the program.
  65.            
  66.           You can start the program from CLI or WorkBench. After  that,  it
  67.           will open a window on the WB-screen, that looks like this:
  68.  
  69.           +--------------------+  +--------------------+
  70.           |                    |  |                    |
  71.           :         A          :  :         B          :
  72.           :                    :  :                    :
  73.           |                    |  |                    |
  74.           +--------------------+  +--------------------+
  75.           |         C          |  |         D          |
  76.           +--------------------+  +--------------------+
  77.            
  78.           +------------+ +-----+  +------------+ +-----+
  79.           |            | |     |  |            | |     |
  80.           |     E      | |  F  |  |      G     | |  H  |
  81.           +------------+ +-----+  +------------+ +-----+
  82.            
  83.            
  84.           The blocks A and B will contain  the  contents  of  the  selected
  85.           directory or archive for the left and right work area.  C  and  D
  86.           contains the path for A and B. They're editable. Blocks E  and  G
  87.           are short-cuts for the paths  C  and  D.  The  right-bottom  most
  88.           gadget of each block is  configurable.  And  at  last,  F  and  H
  89.           contain gadgets for all different actions you can perform on  the
  90.           archives.
  91.  
  92.  
  93.           5. Possible actions.
  94.            
  95.           In this chapter, I will discuss all actions you  can  perform  on
  96.           archives with this program. Therefore,  I  will  first  introduce
  97.           some terms.
  98.  
  99.           The source area is always the block (A or B) whose  contents  are
  100.                used to perform the actions on. If you selected an action in
  101.                F, block A is the source area, and the same with H and B. If
  102.                you selected the action by double  clicking,  the  area  you
  103.                first clicked in, is the source area. 
  104.            
  105.           The target area is the block where the results of the action  are
  106.                placed. This is always the other block. 
  107.            
  108.           The source archive is a selected archive in the source area. This
  109.                can be the source area itself (if you are 'in' a archive) or
  110.                one or more selected archives in the source area. 
  111.            
  112.           Source files are the selected files  and/or  directories  in  the
  113.                source area. This can be files/directories in a directory or
  114.                from the archive you're 'in'. This depends on the action you
  115.                want to perform. 
  116.            
  117.           A target archive is the selected  archive  in  the  targed  area.
  118.                Again, this can be the target area itself (if you're 'in' an
  119.                archive) or exactly one selected archive in the target area.
  120.                If not, the program will ask for the name of a new file. 
  121.            
  122.           Some actions can be activated with an other method than  clicking
  123.           the gadget or  pressing  the  underlined  letter.  This  will  be
  124.           mentioned at the action. An action is always performed  from  the
  125.           source area, to the destination area, or, is case no result  will
  126.           show up, in the  source  area.  These  actions  are  possible  (if
  127.           supported by the archiver, Lha supports them all).
  128.  
  129.           Add  
  130.                With add, you can add files to an archive  (surprise!).  The
  131.                source files are added to the destination archive,  which  is
  132.                created, if nessesary. When a new archive  is  created,  the
  133.                default type is the one of the first defined  archive  type.
  134.                Ofcourse you can  force  the  program  to  use  a  different
  135.                archiver, by adding the right file-extension (or so) to  the
  136.                name.  For  example,  if  you  type  'test',   the   archive
  137.                'test.lha' will be created with 'Lha'  (supposing  'lha'  is
  138.                the first defined type) but,  if  you  type  'test.zoo'  the
  139.                archive 'test.zoo' will be created, with the archiver 'Zoo'.
  140.                This way, you can select all different archivers. 
  141.                You can also start adding files to  an  archive,  by,  after
  142.                selecting the last file to add, clicking in the  destination
  143.                archive within the time of a double-click. You must be  'in'
  144.                the destination archive in the destination area. 
  145.            
  146.           Move  
  147.                Similair to add, but all added files will  be  deleted  from
  148.                the source. This action can not be  activated  in  an  other
  149.                way. 
  150.            
  151.           Ext/Cp  
  152.                Ext means Extract. All selected  source  archives,  will  be
  153.                unpacked and the result will be in the destination area.  If
  154.                you are 'in' a source archive, only  those  files which  are
  155.                selected, will be unpacked. 
  156.                Cp means Copy. This will copy all (non-archive) files and/or
  157.                directorys to the destination area. The  program  uses  the
  158.                cli 'Copy' instruction for  this  action,  so  this  command
  159.                should be  available  in  your  path  (normally  in  the  C:
  160.                directory). 
  161.                You can also activate extract by,  after  you  selected  the
  162.