home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk944 / lhf / lhf.doc < prev    next >
Text File  |  1993-12-21  |  20KB  |  505 lines
  1.  
  2.       
  3.              Lhf v1.03 (CLI and Intuition archiver)
  4.              (c) Copyright 1993 by author Stefan Pampin.
  5.              Written using varios translators.
  6.  
  7.  0) This document
  8.  ---------------------------------------------------------------------------
  9.    This text is written in bad english. I'm sure that the extra work this 
  10.  will take you reading it will be rejectable consider to the work I spend to
  11.  write it. In all cases, the work is done for you.  
  12.  
  13.  1) Disclaimer
  14.  ---------------------------------------------------------------------------
  15.  The author cannot be held liable for the  suitability or  accuracy  of this
  16.  manual  and/or  the  program(s)  it  describes.   Any  damage  directly  or
  17.  indirectly caused by the use or misuse of  this manual  and/or the  program
  18.  it describes is the sole responsibility of the user her/him self.
  19.  
  20.  
  21.  2) Copyright/Distribution
  22.  ---------------------------------------------------------------------------
  23.  Lhf, (c) Copyright 1993 by author. All rights reserved. This
  24.  program is FREEWARE so no financial donations are required ( but welcome ).
  25.  This   program  may  be  freely  distributed  as  long  as all files, i.e.
  26.  documentation and executable(s) remain unchanged and are included  with the
  27.  distribution. (See the exception 3) below). Also no profit is to be made by
  28.  selling  this  program. You may not charge more than a resonable fee for the 
  29.  distribution.  This program may be distributed on disk magazines, cover 
  30.  disks etc.  When you do decide to distribute this program on a disk magazine
  31.  tell me before.
  32.  
  33.  
  34.  3) Electronic Distribution
  35.  ---------------------------------------------------------------------------
  36.  It is allowed for non-commercial BBSs to distribute  an archive  with  only
  37.  the following files in it:
  38.  
  39.     Lhf             - Main Program
  40.     Lhf.doc         - Main Program Manual (This file)
  41.     Lhf.info        - Main Program Icon.
  42.  
  43.     LhfEd        - Config Program
  44.     LhfEd.doc        - Config Program Manual
  45.     LhfEd.info      - Config Program Icon.
  46.  
  47.  You may NOT upload this or any  other form of  this  software on  BBSs that
  48.  claim copyrights on the uploaded material!
  49.  
  50.  
  51.  4) Requirements
  52.  ---------------------------------------------------------------------------
  53.   Lhf should run with all amigas version 1.3 or higher. One feature is
  54.  disabled for pre 2.0 users, 2.x style pattern maching. The colors will
  55.  look inverted on the 1.3 system. Perhaps I write specific versions for
  56.  pre and nonpre 2.0 users.
  57.   IT IS STILL UNTESTED UNDER OTHER SYSTEMS THAN 2.1 PAL. PLEASE IF YOU HAVE 
  58.  PROBLEMS WITH LHF UNDER YOUR SYSTEM LET ME KNOW, SO I CAN CORRECT IT.
  59.  SPECIALLY, NOTES ON SCREEN DIMENSIONS ARE WELCOME. I THINK THERE COULD BE
  60.  PROBLEMS WITH SYSTEMS MIXING BETWEEN PAL AND NTSC DISPLAY MODES.    
  61.  
  62.  5) Running Lhf
  63.  --------------------------------------------------------------------------    
  64.     You can start Lhf from either the CLI or the Workbench. Lhf have two
  65.  user interfaces. One is CLI and the other is Intuition driven. The CLI-
  66.  interface is invoked from CLI by entering one or more command lines
  67.  arguments. You can type 'Lhf ?' for a description (or see 7) below). If
  68.  no parameters are given when Lhf is started from CLI it will act like it
  69.  was started from WB, i.e. enter it's intuition interface described under
  70.  6) below. 
  71.  
  72.  6) Intuition Interface
  73.  ----------------------------------------------------------------------------
  74.     * --- GENERAL --- *
  75.  
  76.        Almost every gadget have diffrent action when they are selected
  77.     with the right or left mouse button (even arrow gadgets which pages
  78.     instead of scrolling when pressed with the right). 
  79.  
  80.     * --- ENTRY BOX ACTION--- *
  81.  
  82.      To enter a directory or a archive in a entry box simply press the
  83.     right mouse button over the entry. To select file entries press the
  84.     left mouse button over the entry. You can multi select (even with 
  85.     scroll) by holding the left button down and drag over the entries.
  86.     To unselect a entry simply select it again. See also [ ALL ] and
  87.     [ CLR ] about selection.
  88.      If a directory are selected the selection acts recursively on
  89.     the childs to that directory, but in some cases (such as the
  90.     [ RENAME ] function) this action is not taken. The action for
  91.     the user defined buttons are optional - act only on files,act
  92.     only on directory,act on both file and directories and finally
  93.     acts recursively or not.
  94.       If you enter a legal path that is a existing real path or a
  95.     existing path to a archive ev joined by slash with a archive
  96.     path,  that path file content will be showed.
  97.      With the textless gadgets you can switch between showing size
  98.     protection,date or time. Some archive directories are fictive,
  99.     why there creation date are not showen. 
  100.     
  101.      * --- TEXT BUTTON GADGET ACTION --- *
  102.  
  103.     
  104.        If you select a gadget (that is not obviosly specific to a
  105.     slider box) with left (right) mouse button, the box left (right)
  106.     box wish displays file entries will be called the source box. 
  107.            The right (left) box is the destination box.
  108.  
  109.     [ ALL ]
  110.            Selects all entries in the source box.
  111.  
  112.     [ CCOPY ]  
  113.            Function like [ COPY ]  but files are CLONE copied
  114.         instead of using the copy action you can select in a
  115.         option window.
  116.     
  117.     [ COPY ]
  118.            This function will copy FROM source box TO the dest-
  119.         ination box. Thus if the source and destination box both
  120.         are ordinary directories ,ordinary copy is performed. If
  121.         the boxes are archives, selected entries are effectively 
  122.         replaced in the destination arhive (without having to 
  123.         extract and recompress). If the boxes are of diffrent
  124.         kind extraction or compression are performed.
  125.         
  126.            Currently there is one restriction. Source and dest-
  127.         ination archives must be destinct.
  128.            If you want you can copy a archive to it self (like 
  129.         an archive backup) but ensure that the archive is packed
  130.         before and that no files are replaced. You can in all 
  131.         cases safely delete it from the archive.     
  132.         
  133.  
  134.     [ CMOVE ]
  135.            Function like [ CCOPY ] but files are moved.
  136.  
  137.     [ CLR ]
  138.            Unselects all entries in the source box.
  139.      
  140.     [ DELETE ]
  141.            This deletes the selected files and directories of a
  142.         ordinary or archive directory. In the latter case no pack -
  143.         ing are performed (to recieve minimal size you have to
  144.         [ PACK ] it). 
  145.     [ DUP ]
  146.            Duplicates the source box display to destination box
  147.         display.
  148.      
  149.     [ FREEUP ]
  150.            Reset the state of source box. All associated cathe
  151.         will be flushed.                   
  152.  
  153.     [ MAKEARC ]
  154.            This makes a archive (if not existed) in the source
  155.         box with the name you are ask to enter. 
  156.  
  157.     [ MAKEDIR ]
  158.            This makes a directory (if not existed) in the source
  159.         box with the name you are ask to enter. This even works
  160.         if you are in a archive.
  161.         
  162.     [ MOVE ]
  163.            Function like [ COPY ] but files are moved.
  164.  
  165.     [ OPTIONS ]
  166.            Will give you posibility to setup options. Diffrent 
  167.         options windows will appear depending on the mouse 
  168.         selection. With the save posibility, you can setup
  169.         your prefered default options for an unaltered copy
  170.         of Lhf (see Options below).
  171.     
  172.     [ PACK ]
  173.           This will pack those entries in the source box
  174.         representing an unoptimated archive. No compression
  175.         is performed only file operations.
  176.                     
  177.     [ RENAME ]
  178.            A string requester will ask you to enter a new name
  179.         for each selected file. This new name is relative to the
  180.         source box's path.
  181.     
  182.     [ REPAIR ]
  183.            Applies to the files selected in the source box. If 
  184.         they appear as a corrupted archive, the function will try 
  185.         to recover some data from them by repairing them.
  186.  
  187.     [ SCREEN ]
  188.            Toggle if Lhf should try to open a own screen for its
  189.         windows.
  190.     [ STORE ]
  191.            This require that the source box displays  a ordinary
  192.         directory and the destination box displays a archive
  193.         directory.  It stores files without any compression into
  194.         the archive. It is preferable if you wish to add a archive
  195.         as a simple file to another archive, since the compression
  196.         ratio, in general, will be better.     
  197.  
  198.     [ SWAP ]
  199.           This swaps the source and destination box.
  200.     
  201.     [ UPDATE ]
  202.            Update the source box. This can be nessasary due to
  203.         that the internal catche,external command action  or 
  204.         multitasking.
  205.  
  206.     [ <User defined> ]
  207.