home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / amigalibdisks / d995 / browserii / browserii.doce < prev    next >
Text File  |  1994-04-05  |  49KB  |  1,298 lines
  1.  
  2.                    Documentation for BrowserII V2.41
  3.  
  4.  
  5. **************************************************************************
  6. *****************************             ********************************
  7. *****************************   WARNING   ********************************
  8. *****************************             ********************************
  9. **************************************************************************
  10.  
  11.     If  you  use  a  previous release of ParM, and tools that makes use of
  12. parm.library  (BrowserII),  you _MUST_ replace ALL theses with those given
  13. in  this  release.   The new parm.library version 7 is not compatable with
  14. previous  ones.   It  was  just  not  possible  to  do it.  As promised in
  15. previous  release,  this  new  ParM only works with AmigaDOS version 37 or
  16. higher.   ParM  no  more  needs  arp  nor  req  libraries.  OS 2.0 made it
  17. possible.
  18.  
  19. **************************************************************************
  20. **************************************************************************
  21.  
  22. Copyright:
  23. ----------
  24.  
  25. ParM  and  BrowserII  are copyrighted; they may not be sold in or together
  26. with  commercial  software  without written approval by the authors.  They
  27. may  be  freely distributed for a fee which will not exceed the equivalent
  28. of  French  Francs  15.-  (this  includes the cost of the diskette and the
  29. postage);  they  cannot  be  made  available for downloading from a server
  30. which  is  a  commercial  operation.   The general principle is that it is
  31. forbidden  to  make  a  profit  through  the  use or distribution of these
  32. programs without our written consent.
  33.  
  34. ParM V3.5 (or higher) and BrowserII V2.0 (or higher) may NOT be duplicated
  35. for  other  things  than backup.  Only Authors are autorized to give it to
  36. other people.
  37.  
  38. DISCLAIMER:
  39. -----------
  40.  
  41.     We  accept  no responsability for the use or misuse of these programs,
  42. and   for  the  damage  they  could  produce.   Use  at  your  own  risks.
  43. Nevertheless,  we  think that after several month of intensive use by four
  44. persons, they have been tested enough to say they are safe.
  45.  
  46.  
  47. History:
  48. --------
  49.  
  50. We  wrote  BrowserII  after  having  used for 2 years the original Browser
  51. (version  1.6A)  written  by  Peter Da Silva.  We were not fully satisfied
  52. because  of  some  of  its  limitations  so, as soon as we felt capable of
  53. writing  a  program  which  would  overcome  those  limitations, we made a
  54. decision to do it.  So BrowserII was born ...  The Return !
  55.  
  56. We  felt the overall layout and display mode of Browser were very good, so
  57. we  decided  to  keep  them,  as well as the name, so that actual users of
  58. Browser would immediately feel home with BrowserII.
  59.  
  60. As  we  never  had  the  sources  of  Browser  at hand, we rewrote it from
  61. scratch.
  62.  
  63. Beginners  claimed many times that BrowserII was difficult to use and very
  64. complicated.   Really,  we  don't  understand  that  since BrowserII works
  65. exactly  like  workbench.  To copy files, you just have to select them and
  66. to drag them over the destination directory.  It's power is far from other
  67. file  manager tools which are able to display only to directories, and are
  68. full  of  useless gadgets which cluter up more than the half of the screen
  69. display.  We think that menus are more adapted to commands not often used,
  70. and keyboard shortcuts quicker than gadgets for regular operations.
  71. Any  way,  a  special  window with parametrable gadgets will be taken into
  72. consideration in a next release using gadtools.library of new OS 2.0.
  73. Another  advantage of BrowserII is that it is small (80 KBytes !).  It has
  74. the  most  powerfull  copy  process,  and  doesn't  include  text viewers,
  75. editors,  or  any IFF viewers.  With this phylosophy, you can use the best
  76. tools  of  each kind, text viewer (we use the great MuchMorePoPa 2.7 which
  77. can  be made resident), IFF viewer (we use Mostra which is pure too).  You
  78. are not limited with the number of parametrable menus...
  79. Finally, BrowserII is the best file manager ! Don't you think so ?
  80.  
  81. Another  positive thing because other don't do it, is that all disk errors
  82. are  properly  reported with a message (not an error number), files can be
  83. individually skipped, or operation aborted.  (some tools continue to write
  84. files after a 'disk full' error.  Nice isn't it!).
  85.  
  86.  
  87. Installation:
  88. -------------
  89.  
  90. While  you  can put BrowserII in any directory, you must copy parm.library
  91. and  in LIBS:.  If you want to take advantage of the parametrable menus of
  92. BrowserII,  don't  forget to build a BrowserII.menu file, and to put it in
  93. S:.
  94. Since  V2.10,  BrowserII  will  recognize  file  types  if  you  have  the
  95. whatis.library in your LIBS:  directory. (See doc for this library).
  96. The reqtools.library is required for customising screen colors.
  97.  
  98.  
  99. Demo Version:
  100. -------------
  101.  
  102. The registered version and demo version are indentical.  When you become a
  103. registered user, you get a key file, and you'll be registered forever.  So
  104. you  can  get  updates from fish disks, or BBS, without asking directly to
  105. us.  When you are not registered, the About requester appears from time to
  106. time.
  107.  
  108.  
  109. Tutorial:
  110. ---------
  111.  
  112. Some  friends made a tutorial for unexperimented user.  The french version
  113. makes  use  of  a  lot  of  pictures.   have a look at them, they are very
  114. atractive.  Note that both tutorials are about using Version 2.04. A few
  115. things were added since then but the mind didn't change!
  116.  
  117.  
  118. Gadgets:
  119. --------
  120.  
  121. BrowserII  windows  now  have  three  more  gadgets.  The first one is the
  122. iconification  gadget,  just  below  the  close gadget.  If you press this
  123. gadget,  two  things can happen:
  124.  
  125. 1.
  126. If  it  is  the  main  window (the one where appears devices, volumes, and
  127. assigns),  BrowserII will be iconified, that is to say that a small window
  128. in  workbench  screen will open, and all BrowserII windows and screen will
  129. be closed.  This small window has a close gadget which enables you to quit
  130. BrowserII  without  uniconifying BrowserII.  To uniconify BrowserII, press
  131. right  mouse  button.
  132. 2.
  133. If  it is a directory window, the window will be closed, and an entry will
  134. be  added in Alien Window, whether it is open or not.  Alien Window can be
  135. open  using  F5  or  menu  'Window->Open->Alien  Window'.  To uniconify an
  136. iconified  window,  just  double click on the corresponding entry in alien
  137. window.   You  can  uniconify  several windows sumultaneously by selecting
  138. several entries in alien window, and double clicking on one of them.
  139. If  one  entry  only  is  selected  in  Alien Window, the full path of the
  140. directory is displayed in the bottom border of this window.
  141.  
  142. The other two gadgets are invisible.  The first one is the ZOOM gadget and
  143. is  the  top half of the jauges, while the second one is the UNZOOM gadget
  144. and  is  the  bottom half  of the jauges.  If you ask for a zoom while the
  145. directory  to  be zoomed is currently scanning, the zoom is defered at the
  146. end of scan.
  147.  
  148.  
  149. Menus:
  150. ------
  151.  
  152. * BrowserII
  153.  
  154.   BrowserII -> Update menus
  155.  
  156. Reloads  the  parametrable menus file "S:BrowserII.menu".  This file is an
  157. ASCII  file  with  the same syntax as the configuration file of ParM. Some
  158. option  has  been added:  the selected files in BrowserII will be inserted
  159. at the [] or [:] if any, with full path calculated from current window.
  160.  
  161. Example:    you have selected "S:" in the main window of BrowserII
  162.             you have defined a menu item as follows:
  163.  
  164.             ITEM Sizer RUN WIN CON:0/11/400/100/Sizer/Close/Wait Sizer []
  165.  
  166.             activating the menu item Sizer will be equivalent to
  167.             executing the following command in a shell:
  168.  
  169.             Sizer S:
  170.  
  171. If  there  are  no  [],  then  the  names of the selected files are simply
  172. appended to the end of the command line.
  173. Have  a  look  at  ParM.doc  for  the  WBTF  option in menu items to bring
  174. workbench to front when running commands.
  175.  
  176. There is an alternative to get arguments with a full pathname, rather than
  177. a  path  relative  to the current directory (active window).  just put [:]
  178. instead of [] in the command line.
  179. But  be  warned.   In  most cases, _this is not necessary_, and dangerous!
  180. Because volume names may not be unique, files passed as parameters may not
  181. be  the  ones  you  selecte