home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / compress / lazi.lha / LAZiv11.DOC < prev    next >
Text File  |  1992-04-07  |  23KB  |  583 lines
  1.  
  2.  
  3.             LAZi - A CanDo archive utility interface
  4.                      (Lharc Arc Zoo interface)
  5.                      Version 1.1 updated 3/6/92
  6.                           by Mark W. Davis
  7.                  Compatible with Arc version     0.23
  8.                                  Zoo version     2.00
  9.                                  Lharc version   1.30
  10.                                  LZ version         1.92
  11.  
  12.                                What it is?
  13.  
  14. What is LAZi?  LAZi is a graphic interface for the archive utilities LZ,
  15. Lharc, Arc, and Zoo.  You supply the archive utilities.  LAZi will add,
  16. delete, extract, and update single or multiple files; list and test
  17. archives; allow you to read extracted readmes/docs or any other ascii
  18. file; save a configuration file that holds the locations of your work
  19. directory(s), archive utilities, and  icon  position; recurse into SRC
  20. subdirectories if Pathnames are set.  If you have no experience using LZ,
  21. Lharc, Arc, or Zoo I suggest you read their respective documentation.
  22.  
  23. LAZi was created as a learning project using CanDo version 1.5.  It is
  24. a 'bound' CanDo deck and does not require CanDo nor the freely
  25. distributable program "DeckBrowser" to run.  Due to LAZi being a
  26. 'bound' deck (DeckBrowser built in) its size is rather large.  You
  27. should be able to "pack" it using one of the "crunchers" available if
  28. disk space is a concern.  I haven't tried this but was told that it
  29. works.  1meg ram is recommended.
  30.  
  31.                              Disclaimer, etc
  32.  
  33. It hasn't hung, crashed my machine, or munched any of my files.
  34. nevertheless...  If you use this program you do so at your own risk.  I
  35. take no responsibility for any problems that you may have while using
  36. LAZi.  If you find a problem I can be contacted at the address given at
  37. the end of this document.   LAZi may be freely distributed  under  the
  38. conditions that all textfiles accompanies the program and that it not be
  39. distributed with any commercial software packages without the written
  40. consent of the author.  If you use LAZi consistently please donate some
  41. time and/or money to an organization that gives assistance to the
  42. homeless.
  43.  
  44.  
  45.            PLEASE READ THE README.FIRST FILE BEFORE CONTINUING
  46.  
  47.                                Installation
  48.  
  49. LAZi MUST be able to access the following *CBM* files and directories
  50. or results will be unpredictable:
  51.  
  52. + In your Workbench PATH                           - LIST; DELETE; COPY
  53. + In the FONTS: directory (or in ROM for v2.04)   - TOPAZ 8 and TOPAZ 9
  54. + S: must exist to save defaults. (unless you like configuring your
  55.      applications every startup)
  56. + "RAM DISK:", "RAM:", or an assign (logical) to "RAM:"
  57.  
  58. There are two LAZi executables, one for users of Workbench v1.3 and one
  59. for users of Workbench v2.04.  The complete LAZi archive consists of 13
  60. files:
  61.  
  62. LAZi:readme.first
  63. LAZi:readme.first.info
  64. LAZi:LAZiv11.DOC
  65. LAZi:LAZiv11.DOC.info
  66. LAZi:LAZi_13/        LAZi/LAZidefaults for Workbench v1.3 users
  67. LAZi:LAZi_13.info
  68. LAZi:LAZi_204/        LAZI/LAZiDefaults for Workbench v2.04 users
  69. LAZi:LAZi_204.info
  70. LAZi:Cover.pntr
  71. LAZi:MHelp.TXT
  72. LAZi:OHelp.TXT
  73.  
  74. I suggest you extract LAZi.lzh using expanded paths to avoid confusion.
  75. Here is the command for 'LHarc':   "lharc -x -m x lazi.lzh"
  76.  
  77. Place LAZi and its respective LAZiDefaults, cover.pntr, both help files,
  78. and the icons in a common directory.  LAZi.DOC may be placed wherever you
  79. wish.  You are now ready to use LAZi.  You can either double click on its
  80. icon or start it from the CLI by typing "lazi".  Easy, huh?
  81.  
  82.                               Using LAZi
  83.  
  84.  
  85. Entry - a file, directory, archive, or file within an archive
  86.  
  87. Source Directory (SRC)- the directory LAZi searches for entries to work
  88.                         with.
  89.                         the directory files are MOVED TO.
  90.  
  91.  
  92. Destination Directory (DST) - the directory in which LAZi places modified
  93.                               archives.
  94.                               the directory LAZi searches for archives to
  95.                               MOVE. Archives get Deleted from this
  96.                               directory during MOVES.
  97.  
  98. Default SRC/DST - the work directories saved in LAZi.config as defaults.
  99.  
  100. Right Mouse Button (RMB)
  101.  
  102.  
  103. **Clicking the RMB in any window, except the 'defaults' and LAZiView
  104. windows, will return you to the Main Window with your current SRC and
  105. DST directories.  This is a change from previous versions of LAZi.**
  106.  
  107. -------------------------------------------------------------------------
  108. some examples:
  109.  
  110.  Main Window
  111.  
  112. +To extract all files from an archive:
  113.  
  114. v2.04 - drop an archive's icon into the main window
  115. v2.04 & v1.3 - click on the archive entry in the SRC list; click on
  116.                the 'extract all' button.
  117.  
  118. +To list an archive:
  119.  
  120. Double click on the archive name in the list entry.
  121.  
  122. +To extract a single file from an archive:
  123.  
  124. Double click on the archive name in the list entry; doubleclick on the
  125. entry in the archive.
  126.  
  127. +To read a text file:
  128.  
  129. Double click on the text file entry.
  130.  
  131. Options Window
  132.  
  133. +To delete, add, or update an entry in an archive:
  134.  
  135. Double click on the archive name; click the 'pick' button; click on the
  136. entry you wish to delete, add, or update; click delete (or add or update;
  137. click 'perform'.
  138.  
  139. -------------------------------------------------------------------------
  140.  
  141. @ All Windows
  142.  
  143. If you click on a button then decide that you do not want that function
  144. just move the pointer away from the button before releasing and the
  145. button will not be activated.
  146.  
  147. @ Main Window
  148.  
  149. Upon startup LAZi will attempt to load and display in the list display
  150. your default SRC directory.  If no defaults have been saved it will
  151. display the directory it was started from as its SRC directory.  You
  152. should pick a DST directory before continuing.
  153.  
  154.  
  155. *** LAZi TITLE/DRAG/STATUS bar
  156.  
  157. At the top left is your standard 'QUIT' gadget.  Click on it and LAZi
  158. will go away.  To its right is the TITLE/DRAG/STATUS  bar.  Information
  159. about  LAZi's current operation, error messages, and brief prompts will
  160. appear there.  To the right of the TITLE/DRAG/STATUS bar are standard
  161. window to  back/front gadget(s).  The leftmost gadget moves LAZi behind
  162. all other windows  on the Workbench, the rightmost moves LAZi to the
  163. front for Workbench v1.3.  The Front/Back gadgets are combined in
  164. Workbench v2.04; there is also a Zoom gadget for expanding and shrinking
  165. the Main window for v2.04 users.
  166.  
  167. *** SRC:/DST: buttons and string gadgets
  168.  
  169. Below the TITLE/DRAG/STATUS bar is a BUTTON titled 'SRC:' and to the
  170. right of that a string gadget.  A single click on the SRC: button will
  171. update and load the CURRENT SRC directory into the list display. The
  172. string gadget will show the current SRC directory.  Depending on
  173. certain actions it may be blank.  If so, it usually indicates that the
  174. list displays contents are the DST directory.  The TITLE/DRAG/STATUS
  175. bar should contain a description.  If you click in the string gadget,
  176. clear out its contents - either by deleting or using 'RAMIGA-X'  - then
  177. enter a VALID pathname (DH0:foobar, DF2:foo/bar/bar, FOOBAR:  - an
  178. INVALID pathname would be :foobar) - that will become your current SRC
  179. directory for all subsequent operations.  The contents of the path you
  180. enter will be shown in the list display.
  181.  
  182. The 'DST:' button and string gadget at the bottom of the window will
  183. behave in the same manner EXCEPT that the DST directory contents will
  184. not be shown in the list display when a path is entered in the string
  185. gadget. A single click on the DST: button will show the  DST
  186. directory's contents in the list display.  The TITLE/DRAG/STATUS bar
  187. will indicate that the listing is the DST directory.
  188.  
  189. *** "«" button (reset to default SRC & DST)
  190.  
  191. The "«" button will reset the SRC and DST directories to default.  In
  192. previous versions clicking the RMB would move you to the Main window
  193. and reset your current SRC directory to default.  This was a pain if
  194. you were 3 directories down in the Options window and just wanted to
  195. return to the Main window with the current directory.  Now clicking the
  196. RMB will still return you to the Main window but your current SRC and
  197. DST directories will not change.
  198.  
  199. *** Available Memory (stealth button)
  200.  
  201. Clicking to the right of the Help!  button  (somewhere below the window
  202. to front gadget) will show the available chip and fast  memory  in  the
  203. title bar.
  204.  
  205.  
  206. *** Iconify!
  207.  
  208. A single click on this button will iconify LAZi.  LAZi will shrink to a
  209. 115x10 pixel icon located at position 0,0 or the last position you left
  210. it.  When iconified LAZi has a expand gadget (the quit gadget) on the
  211. left, a drag bar with the letters "LAZi" in it, and front/back
  212. gadget(s).  You can drag LAZi to a new position by pointing to the
  213. letters "LAZi" depressing the left mouse button and dragging the icon.
  214. Now whenever you iconify LAZi it will shrink and position itself at
  215. that position. You can permanently save its iconified position by
  216. saving your configuration after setting the icon's position.
  217.  
  218. *** Directory List Display
  219.  
  220. The list display will show the contents of the SRC directory, DST
  221. directory, or an archive.  There are a several of ways to list a
  222. directory: you can double click on the directory entry in the list
  223. display, type the directory's name in the string gadget, or click on
  224. the 'SRC' or 'DST' button.
  225.  
  226. Double clicking in the list or typing in the string gadget will make the
  227. directory you choose your CURRENT directory.  All subsequent operations
  228. will use this SRC directory. Clicking on the 'SRC' or 'DST' buttons will
  229. display your current SRC or DST in the list display.  The string gadgets
  230. will always show your current directory, except in certain instances
  231. which are explained later.
  232.  
  233. Double clicking on an archive entry will display a listing of the
  234. contents of that archive.  Directories and archives are clearly marked.
  235.  
  236. LAZi cannot parse filenames, directories, or archives with "-"(hyphen)
  237. or spaces in them.  If you use them it may not be able to determine what
  238. type of entry it is and may not be able to operate on it.
  239.  
  240. Double click on a filename in the list to view a text file.  The
  241. LAZiViewer is primitive, just a scroll  bar  and up/down gadgets.
  242. Double (or triple) clicking on the up or down gadget will scroll the
  243. text faster. If a line is longer than the viewing area click in the
  244. viewing area and use the cursor keys to navigate.  You can type in the
  245. file you are viewing and print it out (to PRT:).  LAZiViewer has no
  246. save option.  The view has the only menus in LAZi (more space for
  247. reading) its choices are:
  248.  
  249. Iconify - will iconify LAZi.  Click the 'close' gadget to de-iconify.
  250. Main - will return to the Main window.
  251. Options - will take you to the options menu, if your default paths are
  252.           set.
  253. Print - obviously prints out the file to PRT:
  254. Quit - does what it says; quit LAZi (not just the viewer).
  255.  
  256. *** FILES buttons
  257.  
  258. Under the heading of FILES are 3 buttons.
  259.  
  260. PARENT - sets as current SRC and displays the parent of the directory
  261.          listed in the SRC string gadget.
  262.  
  263. DEVICES - will display your system's Physical devices.  Double clicking on
  264.           a device name will select the  root directory of that device as
  265.           the current SRC directory and list its contents in the list
  266.           display.
  267.  
  268. DEFAULTS - will open a requestor that allows you to enter and save
  269.            default SRC and DST directories, the paths to your archive
  270.            utilities (ALL utility paths must be filled or LAZi will not
  271.            allow you to enter the Options window), and, as a side effect,
  272.            save your icon and Main window positions.
  273.  
  274.            While the defaults requestor is open you cannot use the main
  275.            window.  The pointer will notify you of this.  You  must choose
  276.            either SAVE, CANCEL, or USE to close the defaults requestor.
  277.            If you choose SAVE the config file will be stored in "
  278.            S:LAZi.config" and the directories you save will be used
  279.            whenever you start LAZi.
  280.  
  281.            To save the ICON POSITION, iconify LAZi and drag the icon to the
  282.            position you desire then use the SAVE option in the defaults
  283.            requestor.  The icon position will not be saved unless LAZi has
  284.            been iconified before the save.
  285.  
  286.            If you wish to save the Main window position, reposition the
  287.            window, go to any other window (like the iconified window), then
  288.            use the SAVE option in the Defaults requestor.
  289.  
  290.            USE will bring you back to the main window using the directories
  291.            and file paths you chose in the  defaults requestor.
  292.  
  293.            CANCEL closes the defaults requestor with no action taken.
  294.  
  295. *** ARCHIVES buttons
  296.  
  297. PATHNAMES - This is a toggle button; each button press toggles its state.
  298.             Once selected it will STAY selected unless you deselect it,
  299.             it is deselected by an error, or you press CLEAR in the
  300.             Options window.
  301.  
  302.             If selected, LAZi will will add, update, or    extract the entry
  303.             using its full path creating directories as needed when
  304.             extracting.  If the archive type is Lharc or LZ the switch
  305.             used is "-r" and/or "-x".  If Zoo, the switch is ".//"  See
  306.             the archiver's documentation for more information.
  307.  
  308. OPTIONS - will take you to the Options Window if default pathnames were
  309.           set in the defaults requestor.  You cannot go to Options
  310.           without ALL archive default pathnames set. i.e. even it you do
  311.           not possess 'arc' you must place a pathname in the defaults
  312.           requestor.
  313.  
  314. EXTRACT ALL - will extract all the files in the selected archive and place
  315.               them in the DST directory then list the DST directory's
  316.               contents in the list display.  To select an archive, click
  317.               on it.  If 'pathnames' is set LAZi will extract to pathnames,
  318.               that is, create directories as needed, if they exists in the
  319.               archive.  Click the RMB to return to the SRC listing.
  320.  
  321. TEST - will test the selected archive and show you the results in the list
  322.        display (not implemented with "arc" archives).
  323.  
  324.  
  325.  
  326.  
  327. @ Options Window - RMB returns you to Main
  328.  
  329.  
  330. ******Clicking the RMB in any window, except the 'defaults' and LAZiView
  331. windows, will return you to the Main Window with your current SRC and DST
  332. directories.******
  333.  
  334.  
  335.  
  336.      *READ*          *READ*             *READ*             *READ*
  337.      *READ*          *READ*             *READ*             *READ*
  338.  
  339. LAZi ALWAYS modifies or creates its archive in the DST directory. Before
  340. updating, deleting, extracting, or adding to an archive LAZi checks the
  341. DST dir to see if it is there.  If it isn't it copies the archive from
  342. the SRC directory to the DST directory then does whatever it needs to do.
  343. If is already in the DST directory then LAZi does it to THAT archive.
  344. This can cause you problems if you have different archives of the SAME
  345. name in the SRC and DST directories.  I suggest that you ALWAYS move
  346. (using the "m" button explained below) a modified archive from the DST
  347. directory to the SRC after modification.  If your SRC and DST directories
  348. are the same, the point is moot.
  349.  
  350. The Options window has two list displays; various buttons and gadgets
  351. that allow you to create and modify archives.  When first opened it will
  352. show the current SRC directory in the UPPER display and the DST directory
  353. name in the DST DIR: string gadget.
  354.  
  355. *** SRC: button and string gadget
  356.  
  357. Functions the same as in the Main Window.
  358.  
  359. *** PARENT button
  360.  
  361. Same as Main
  362.  
  363. *** "«" button (reset to default SRC & DST)
  364.  
  365. Will reset the SRC and DST directories to default and display the SRC
  366. contents in the upper display.
  367.  
  368. *** HELP!
  369.  
  370. Same as Main
  371.  
  372. *** Available Memory
  373.  
  374. Same as Main
  375.  
  376. *** ICONIFY!
  377.  
  378. Same as Main
  379.  
  380. *** UPPER DISPLAY
  381.  
  382. The UPPER display functions almost exactly like the list display in the
  383. Main Window.  I say *almost* because there are two buttons to the right
  384. of the UPPER display, one of which modifies the UPPER display's usage.
  385.  
  386. Double clicking on an ASCII file while the DST directory is displayed
  387. will allow you to read a text file in the LAZiViewer.  You cannot read
  388. text files from the SRC listing.
  389.  
  390. Almost: I will start with the "Pick" button.
  391.  
  392. Pick:
  393.      The Pick button is a  toggle  button.  If activated it will stay
  394.      activated until you deactivate it by clicking it again or it is
  395.      deactivated by another button or error condition.
  396.  
  397.      ACTIVATED - the UPPER display is in select or pick mode.  Clicking
  398.      an entry (file, directory, or archive file) in the UPPER display
  399.      will duplicate that entry in the LOWER display.  That entry will be
  400.      SELECTED for adding, deleting, extracting, or updating.
  401.  
  402.      To UNPICK an entry just click on the entry in the LOWER display.
  403.  
  404.      You can pick from any directory you wish by entering its name in the
  405.      string gadget then selecting the entry.  LAZi will prepend the path
  406.      to the selected entry and display it in the lower list.  If
  407.      pathnames is not set only the filename will be entered into the
  408.      archive.
  409.  
  410.      Pathnames MUST be set to archive a subdirectory.  When Pathnames is
  411.      set and a directory entry is selected, LAZi will enter into the
  412.      sub-directory(s) and archive all files found there.  When you pick a
  413.      directory for archiving the directory name will be shown in the lower
  414.      display with a "/#?" (wildcard) appended.
  415.  
  416.      DEACTIVATED - the UPPER display functions similarly to the list
  417.      display in the Main window except that text files must be in the DST
  418.      directory to be read.
  419.  
  420. a:
  421.      This button stands for 'ALL'.  When clicked ALL entries listed in
  422.      the UPPER display will become SELECTED.  They will be listed in
  423.      the LOWER display.
  424.  
  425.      To UNPICK an entry just click on the entry in the LOWER display.
  426.  
  427. X:
  428.      This is the 'EXCHANGE' button.  When clicked, the current SRC
  429.      directory becomes the current DST and vice versa.  This is useful
  430.      for descending the DST directory tree, among other things.
  431.  
  432.  
  433.                   SELECTING FILES IN AN EXISTING ARCHIVE
  434.  
  435. To select individual files in an archive:
  436.  
  437. Double click on the archive's name in the UPPER display (pick/select
  438. mode OFF) to get the archive's listing, then enter PICK mode and click
  439. on the files you wish to manipulate. They will be become SELECTED and
  440. will be shown in the LOWER display.
  441.  
  442.  
  443. *** LOWER DISPLAY
  444.  
  445. The LOWER display lists the SELECTED entries from the SRC or ANY OTHER
  446. directory that you wish to operate on when using the "Options" buttons.
  447.  
  448. The LOWER display will also list the modified archive after an operation
  449. has sucessfully completed.
  450.  
  451. Clicking on an entry in the LOWER display UNSELECTS that entry and
  452. clears it from the display.  The lower display has a special button
  453. attached to it:
  454.  
  455. Clear:
  456.       This button will clear the lower display, clear the current
  457.       archive name shown in the archive string gadget, and reset all
  458.       buttons.
  459.  
  460.       Use this button to:
  461.                    ABORT an option command;
  462.                    after manipulating AND moving an archive;
  463.                    reset the Options window to a known state.
  464.  
  465.       The SRC listing will NOT be up-dated after using the Clear button.
  466.  
  467.  
  468.  
  469. *** Archive Type
  470.  
  471. Informs LAZi of the type of archive you want to work with.  These are
  472. exclusive buttons; only one can be chosen at any given time.
  473.  
  474. Lharc - selects either 'LZ' or 'LHarc' depending on whether they exists
  475.         in your default path. There is only one path for this archiver.
  476.         If LZ exists in the default path LAZi will use it exclusively.
  477.         If you wish to use LHarc, temporarily rename "lz" to something
  478.         other than "lz" and LAZi will search for and use "lharc".
  479.  
  480. Arc - selects 'ARC' if it exists in your default path.
  481.  
  482. Zoo - selects 'ZOO' if it exists in your default path.
  483.  
  484. Pathnames - Same as Main window.  It will inherit its setting from the
  485.             main window (and vice versa).
  486.  
  487. *** DST DIR button and string gadget
  488.  
  489. Clicking on this button will list the DST directory in the UPPER
  490. display. You must use this button when you want to VIEW a file while in
  491. the Options window.  The TITLE/DRAG/STATUS bar will indicate that the
  492. display is the DST directory and the SRC string gadget will be empty.
  493.  
  494. Entering a valid directory in the DST DIR string gadget will make it
  495. your current DST directory.
  496.  
  497. *** ARCHIVE string gadget
  498.  
  499. This gadget will show the current archive if you double clicked on an
  500. archive's name in the UPPER display or allow you to select an archive to
  501. work with.  When you want to Create (add button) an archive this is where
  502. you give LAZi its name.
  503.  
  504. When entering an archive name in the string gadget you MUST include its
  505. extension (.lzh, .arc, or .zoo).  LAZi will not process the archive without
  506. it.
  507.  
  508. If this gadget is blank LAZi will not allow you to modify an archive.
  509.  
  510. *** "m" (move) button
  511.  
  512. This button will MOVE the archive from the DST directory to the SRC
  513. directory OVERWRITING any archive of the same name in the SRC directory.
  514. i.e. it will copy the archive to the SRC directory then DELETE the
  515. archive in the DST directory.
  516.  
  517. After modifying or creating an archive LAZI will place the archive in the
  518. DST directory.  It is strongly suggested that you use this button to move
  519. the archive from the DST to the SRC (or somewhere else).
  520.  
  521. IF SRC = DST, LAZi will not allow a move.
  522.  
  523. *** OPTIONS
  524.  
  525. The TITLE/DRAG/STATUS bar will notify you if all is not well.
  526.  
  527. ADD -  adds the selected entries to an existing archive or CREATES an
  528.        archive if one is not found in the SRC or DST directory.  LAZi
  529.        will list the archive in the lower display if all is well.
  530.  
  531. DELETE -  deletes the selected files from the chosen archive.  LAZi
  532.           will list the archive in the lower display if all is well.
  533.  
  534.  
  535.  
  536. EXTRACT - extracts the selected files from your chosen archive to the
  537.           DST directory.  LAZi will list the DST directory, which will
  538.           contain the extracted files, in the upper display.
  539.  
  540. UPDATE - adds the selected files if they are not contained in the
  541.          archive or are newer than files existing in the archive.
  542.          The archive will be listed in the lower display.
  543.  
  544. *** PERFORM!
  545.  
  546. Perform! will start your chosen operation the "conditions" are right.
  547. What conditions?  a) there is an archive to work with;
  548.                   b) there are selected entries to work with;
  549.                   c) archive types match for the modification commands
  550.                   d) the operation is support.  Adding to an 'arc'
  551.                      archive is not supported.
  552.                   e) the archive utility exists;
  553.                   f) the SRC & DST exists;
  554.                   g) there are no error flags set;
  555.                   h) etc...
  556.  
  557. Once again, the TITLE/DRAG/STATUS bar will notify you of problems.
  558.  
  559.  
  560. LAZiViewer
  561.  
  562. I think a simple viewer should show as much text as possible thus the
  563. menus rather than buttons.  If you click in the text display (a cursor
  564. becomes visible) you can use the cursor keys to navigate your text.
  565. Also a quick double (or triple) click while using the scroll gadgets
  566. will speed up scrolling.
  567.  
  568.                                   misc.
  569.  
  570. Remember that MOVE ("m") will OVERWRITE  an existing archive in the SRC
  571. directory AND delete the copy in  the DST directory.  I suggest using
  572. different directories as  your  SRC  and DST but the choice is yours.
  573. LAZi will not  allow  you to MOVE an archive when SRC = DST.
  574.  
  575. Hope LAZi is useful to you.
  576.  
  577.  
  578.                                 Mark W. Davis
  579.                                 P.O. Box 84321
  580.                                 Seattle, WA. 98112
  581.                                 mwd@cup.portal.com
  582.  
  583.