home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD5.iso / workbench / dir / browserii / 2.0 / browserii.doce.pp / browserii.doce
Encoding:
Text File  |  1993-03-30  |  39.6 KB  |  1,110 lines

  1.  
  2.                    Documentation for BrowserII V2.30
  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 (70 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. There  is  a demo version of BrowserII (you can see which version you have
  103. in the copyright and About ). In demo version, the About requester appears
  104. regularly, where the registered version doesn't.
  105.  
  106.  
  107. Tutorial:
  108. ---------
  109.  
  110. Some  friends made a tutorial for unexperimented user.  The french version
  111. makes  use  of  a  lot  of  pictures.   have a look at them, they are very
  112. atractive.  Note that both tutorials are about using Version 2.04. A few
  113. things were added since then but the mind didn't change!
  114.  
  115.  
  116. Gadgets:
  117. --------
  118.  
  119. BrowserII  windows  now  have  three  more  gadgets.  The first one is the
  120. iconification  gadget,  just  below  the  close gadget.  If you press this
  121. gadget,  two  things can happen:
  122.  
  123. 1.
  124. If  it  is  the  main  window (the one where appears devices, volumes, and
  125. assigns),  BrowserII will be iconified, that is to say that a small window
  126. in  workbench  screen will open, and all BrowserII windows and screen will
  127. be closed.  This small window has a close gadget which enables you to quit
  128. BrowserII  without  uniconifying BrowserII.  To uniconify BrowserII, press
  129. right  mouse  button.
  130. 2.
  131. If  it is a directory window, the window will be closed, and an entry will
  132. be  added in Alien Window, whether it is open or not.  Alien Window can be
  133. open  using  F5  or  menu  'Window->Open->Alien  Window'.  To uniconify an
  134. iconified  window,  just  double click on the corresponding entry in alien
  135. window.   You  can  uniconify  several windows sumultaneously by selecting
  136. several entries in alien window, and double clicking on one of them.
  137. If  one  entry  only  is  selected  in  Alien Window, the full path of the
  138. directory is displayed in the bottom border of this window.
  139.  
  140. The other two gadgets are invisible.  The first one is the ZOOM gadget and
  141. is  the  top half of the jauges, while the second one is the UNZOOM gadget
  142. and  is  the  bottom half  of the jauges.  If you ask for a zoom while the
  143. directory  to  be zoomed is currently scanning, the zoom is defered at the
  144. end of scan.
  145.  
  146.  
  147. Menus:
  148. ------
  149.  
  150. * BrowserII
  151.  
  152.   BrowserII -> Update menus
  153.  
  154. Reloads  the  parametrable menus file "S:BrowserII.menu".  This file is an
  155. ASCII  file  with  the same syntax as the configuration file of ParM. Some
  156. option  has  been added:  the selected files in BrowserII will be inserted
  157. at the [] if any, with full path calculated from current window.
  158.  
  159. Example:    you have selected "S:" in the main window of BrowserII
  160.             you have defined a menu item as follows:
  161.  
  162.             ITEM Sizer SHELL Sizer [] ; WaitReturn
  163.  
  164.             activating the menu item Sizer will be equivalent to
  165.             executing the following script:
  166.  
  167.             Sizer S:
  168.             WaitReturn
  169.  
  170. If  there  are  no  [],  then  the  names of the selected files are simply
  171. appended to the end of the command line.
  172. Have  a  look  at  ParM.doc  for  the  WBTF  option in menu items to bring
  173. workbench to front when running commands.
  174.  
  175. Note:
  176.     This is an old example. The command WaitReturn is no more given, made
  177. obsolete with new 2.0 console option /Wait.
  178.  
  179.     Now  you  can specify Automatic commands.  For that, you must have the
  180. whatis.library  in your LIBS:  directory.  When you DoubleClick on a file,
  181. BrowserII  search  for  an automatic command (AUTOCMD) associated with the
  182. type of the file.  If it founds one, it will be executed.
  183.  
  184.     AUTOCMDs  must  be  specified  in  the  S:BrowserII.menu file with the
  185. following syntax:
  186.  
  187. AUTOCMD <file type> [WITHSUBTYPES][WBTF][REQUEST] <run mode> [STACK] [PRI] [WIN] <command>
  188.         <file type>  : the id string you can see when you ask "Window->File
  189.                        Info->Type"  (i.e:   "Text",  "Exe",  etc...)
  190.         <run mode>   : (WB, RUN,...) See ParM.doc
  191.         <command>    : The command you want to execute for this type of file.
  192.                        Same syntax as ParM's menu items.
  193.         WITHSUBTYPES : AUTOCMD is inherited by subtypes of the type given.
  194.                        If an AUTOCMD exists for a subtype of the given
  195.                        type, it takes precedence over it.
  196.                     
  197.  
  198. Example:
  199.         AUTOCMD "Text" WITHSUBTYPES WBTF RUN More []
  200.         AUTOCMD "Source C" RUN Ed []
  201.         If  you DoubleClick on a file and this file is a text file but not
  202.         C Source file (which is a subtype of Text) then "More" will be run
  203.         with the file as argument.  If you DoubleClick on a C Source file,
  204.         then "Ed" will be run instead of "More".
  205.  
  206.     If  you want AUTOCMD for types which are not built-in, don't forget to
  207. create  the  new  type (managed by whatis.library) in "S:FileTypes" before
  208. putting an AUTOCMD.
  209.  
  210.     We strongly recommand to have a look at the complete examples given in
  211. BrowserII.menu, since the file is easy to understand.
  212.  
  213.   BrowserII -> Last Error
  214.  
  215. This will show you the last message which appeared in screen title bar
  216.  
  217.  
  218.   BrowserII -> Screen -> Workbench
  219.  
  220. BrowserII opens its windows in the Workbench screen
  221.  
  222.   BrowserII -> Screen -> Custom
  223.  
  224. BrowserII  opens  its own screen and opens all its windows in that screen.
  225. The  screen  is  made  public and is named "BrowserII".  Take care, public
  226. screen  names  are case-sensitive.  For example, you can open a console in
  227. the BrowserII screen with the following syntax:
  228.  
  229.     "CON:0/11/640/100/Window Title/CLOSE/WAIT/AUTO/SCREEN BrowserII"
  230.  
  231. This  console  has  defered  open  (AUTO),  will  also have a close gadget
  232. (CLOSE),  and will wait for you to hit close gadget before closing (WAIT).
  233. Note  that  if  another public screen with the same name exists, BrowserII
  234. will  name its screen BrowserII0, then BrowserII1,...  (this can happen if
  235. you  have  the  strange idea to run BrowserII twice)!
  236.  
  237.   BrowserII -> Screen -> WorkBench Colors
  238.   BrowserII -> Screen -> Custom Colors      (needs reqtools.library)
  239.  
  240. Do you need an explanation ?
  241.  
  242.  
  243.   BrowserII -> Screen Font -> Default Font
  244.   BrowserII -> Screen Font -> Custom Font
  245.  
  246.     This  enables  you  to  choose your prefered screen font.  Screen Font
  247. appears  in  title  bars and in menus.  This menu is disabled in workbench
  248. screen.
  249.  
  250.  
  251.   BrowserII -> Window Font -> Default Font
  252.   BrowserII -> Window Font -> Custom Font
  253.  
  254. This enables you to choose your prefered window font.
  255.  
  256.  
  257.   BrowserII -> Run Mode
  258.  
  259. The  submenu items of this item will determine the mode according to which
  260. the  files  on which you double-click will be opened.  If other files were
  261. selected  at  the  time of the double-click, their names become parameters
  262. for the double-clicked file.
  263.  
  264. If the file has an icon, it will automatically be run in Workbench mode.
  265.  
  266. Also  note  that BrowserII does a CD to the active window before running a
  267. command,  whether  you  have  double-clicked  on  a  file, or activated it
  268. through a menu selection.  This is often VERY useful.
  269.  
  270.  
  271.   BrowserII -> Run Mode -> RunBack
  272.  
  273. Launches  the  program  on  which  you have double-clicked as a background
  274. Process.
  275.  
  276.   BrowserII -> Run Mode -> Shell
  277.  
  278. Same  as  RunBack  except BrowserII will open the default SHELLWIN console
  279. for the program output. If this console has defered open, you wont see it
  280. immediately if program does not output anything.
  281.  
  282.   BrowserII -> Run Mode -> Request
  283.  
  284. If   this  option  is  activated,  a  requester  will  appear  before  the
  285. double-clicked program is actually launched, so you can confirm or cancel.
  286. (except for Workbench)
  287.  
  288. Remember  though, that a program which has an icon, will be launched in WB
  289. mode il all cases.
  290.  
  291.   BrowserII -> Run Mode -> WBToFront
  292.  
  293. WorkBench screen is brought to front after running the program.
  294.  
  295.  
  296.   BrowserII -> Copy Mode
  297.  
  298.   BrowserII -> Copy Mode -> Context
  299.  
  300. If  you move a file, BrowserII will in fact perform a rename if the source
  301. and  destination  files are on the same volume.  Across volumes, BrowserII
  302. will perform a copy.
  303.  
  304.  
  305.   BrowserII -> Copy Mode -> Always Copy
  306.  
  307. BrowserII will systematically make a copy of the file.
  308.  
  309.  
  310.   BrowserII -> Copy Mode -> Always Move
  311.  
  312. BrowserII  will copy the file to the destination directory and then delete
  313. the source file.
  314.  
  315.  
  316.   BrowserII -> Copy Mode -> Update
  317.  
  318. BrowserII  will  copy the file only if the source file is more recent than
  319. the destination file, or if the destination file does not exist.
  320.  
  321.  
  322.   BrowserII -> Copy Mode -> Don't overwrite files
  323.  
  324. BrowserII  will  not  overwrite  an  existing  file.   If  there  exists a
  325. destination file with the name you gave for the destination, the copy will
  326. not be performed.
  327.  
  328.  
  329.   BrowserII -> Copy Mode -> Ask before Overwrite
  330.  
  331. BrowserII  asks  for  confirmation  before  overwriting.   This  option is
  332. naturally mutually exclusive with the former one.
  333.  
  334.  
  335.   BrowserII -> Copy Mode -> Copy Empty Dirs
  336.  
  337. This  option will enable to re-create empty directories in the destination
  338. directory.   It  is  particularly  useful  in  its disabled mode, so empty
  339. directories are not copied.
  340.  
  341.  
  342.  
  343.   BrowserII -> Copy Flags
  344.  
  345.  
  346.   BrowserII -> Copy Flags -> Clone
  347.  
  348. All  attributes  of  the  file  will  be copied (date, comment, protection
  349. bits).
  350.  
  351.  
  352.   BrowserII -> Copy Flags -> Date
  353.  
  354. The destination file inherits the date of the source file.
  355.  
  356.  
  357.   BrowserII -> Copy Flags -> Protect
  358.  
  359. The destination file inherits the protection bits of the source file.
  360.  
  361.  
  362.   BrowserII -> Copy Flags -> Comment
  363.  
  364. The destination file inherits the comment of the source file.
  365.  
  366.  
  367.  
  368.   BrowserII -> Display
  369.  
  370.  
  371.   BrowserII -> Display -> Devices
  372.   BrowserII -> Display -> Volumes
  373.   BrowserII -> Display -> Assigns
  374.  
  375.   BrowserII 's main window shows the appropriate list.
  376.  
  377.  
  378.   BrowserII -> Options -> Keep Selected
  379.  
  380. After  an  action  (  copy,  delete,  etc  )  the  selected  entry  is not
  381. automatically deselected.
  382.  
  383.  
  384.   BrowserII -> Options -> Toggle selection
  385.  
  386. If  this  option  is activated, clicking on a name will alternately select
  387. and deselect it.  If this option is not activated, the selected entry will
  388. not be deselected.
  389.  
  390.  
  391.   BrowserII -> Options -> Move files into subdirectories
  392.  
  393. Once  this  option  is set, BrowserII will put the selected entries in the
  394. subdirectory  un  which  you  release the left mouse button.  Otherwise it
  395. will put them in the window which contains this directory.
  396.  
  397.  
  398.   BrowserII -> Options -> Ask before moving into subdirectories
  399.  
  400. BrowserII asks for confirmation before moving the entries.
  401.  
  402.  
  403.   BrowserII -> Options -> Asynchronous Actions
  404.  
  405. You  will  love that one or I'll eat my tie (as I never wear one, the risk
  406. is limited).  When this option in on, any action requested executes in the
  407. background,  and the next action can be started without a delay.  Like for
  408. the  multitasking,  you  will wonder how you could live without it before!
  409. Switching it off has been made possible mainly for debug purpose.
  410.  
  411.  
  412.   BrowserII -> Options -> Open process status window
  413.  
  414. Each  process will open its own window telling what it is currently doing,
  415. and giving you the possibility to pause or cancel the process.
  416.  
  417.  
  418.   BrowserII -> AutoCmds override icons's default tool
  419.  
  420. BrowserII  will  not look at the tools types of the icon of the file if an
  421. AUTOCMD is defined for this type of file.
  422.  
  423.  
  424.   BrowserII -> Examine file on DoubleClick (for AutoCmd)
  425.  
  426. BrowserII  will  ask  whatis.library  for  a  deep  scan  (the  most sure)
  427. regardless  you  specify  in  "Window->Options->Find Type by scan" or not,
  428. before  searching  an  AutoCmd.  We encourage you to use this option since
  429. in fact, it will not slow down operation because the tool will open this
  430. file too will already be in the drive's buffers.
  431.  
  432.  
  433.   BrowserII -> Option -> Install backdrop pattern
  434.  
  435. Put  a backdrop window with a pleasent pattern, for your eyes only !  In a
  436. future  release,  you'll  be able to change this pattern.
  437.  
  438.   BrowserII -> Option -> Use window font in requesters
  439.  
  440. By  default,  Screen  font  are used in requesters.  You may prefer to use
  441. your window font for requesters.  This option is done for that.
  442.  
  443.  
  444.   BrowserII -> Window Options -> Display directory disk usage.
  445.   BrowserII -> Window Options -> Display proportion of visible data.
  446.  
  447. See documentation for jauges at the end of this file.
  448.  
  449.   BrowserII -> Window Options -> Windows AutoZoom
  450.  
  451. At  the  end of directory scan, the window will be automatically zoomed to
  452. show as many entries as possible.
  453.  
  454.  
  455.   BrowserII -> Window Options -> Windows AutoZoom dirs only
  456.  
  457. Same as before but show only directories.  (You must have the option "Sort
  458. by Type" set).
  459.  
  460.  
  461.   BrowserII -> Window Options -> Main Window AutoZoom
  462.  
  463. Now Main window can be AutoZoom.
  464.  
  465.  
  466.   BrowserII -> Window Options -> Zoom Main Window on startup
  467.  
  468. Main window will be zoomed only on BrowserII startup.
  469.  
  470.  
  471.   BrowserII -> Window Options -> Capture Main Window position
  472.   BrowserII -> Window Options -> Capture Main Window size
  473.   BrowserII -> Window Options -> Capture Alien Window position
  474.   BrowserII -> Window Options -> Capture Alien Window size
  475.  
  476. Size or position are stored so they will be saved on next "Save Config".
  477.  
  478.  
  479.   BrowserII -> Save Config
  480.  
  481. Saves  all your options in the file "DEVS:BrowserII.cfg" (don't confuse it
  482. with  the  file  "S:BrowserII.menu"  which contains the definition of your
  483. personal  menus).   Saves  the contents of the selection requester and the
  484. options of the current window as well.
  485.  
  486.  
  487.   BrowserII -> About
  488.  
  489. A  little  word  about  the  fantastic,  Mega-Super-Extra  authors of this
  490. wonderfull piece of software.
  491.  
  492.  
  493.   BrowserII -> Quit
  494.  
  495. We  did  not  plan  for  implementing  this  option,  but a few crazy guys
  496. screamed for it, so here it is...   Anyway, you won't be surprised to read
  497. that  you  won't  be  able  to  quit  BrowserII  as  long  as  one  of the
  498. Asynchronous Actions is still running.
  499.  
  500.  
  501.  
  502. * Window
  503.  
  504.   Window -> Rescan
  505.  
  506. BrowserII  rescans  the  content of the directory which corresponds to the
  507. active   window.    Since   version   2.0,   BrowserII  scans  directories
  508. asynchronously.  You can iconify a directory while scanning.  If you close
  509. a window while directory is being scanned, scan is aborted.
  510.  
  511.  
  512.   Window -> Open
  513.  
  514.   Window -> Open -> Open Parent
  515.  
  516. Opens a window for the parent directory (if any).
  517.  
  518.   Window -> Open -> Open Dir...
  519.  
  520. Opens a particular directory, for which you type the full pathname.
  521.  
  522.   Window -> Open -> Open Alien
  523.  
  524. Opens  Alien Window.  This window is called Alien and not (Iconify Window)
  525. because  in  a futur release, this window will receive other entries, such
  526. as LeaveOut and Aliases, to have easy access to most often used files.
  527.  
  528.   Window -> Open -> Open Status
  529.  
  530. Tells background processes to open their status window. This will display
  531. a message in title bar if no processes are currently running.
  532.  
  533.  
  534.   Window -> Select Match
  535.  
  536. Selects, in the current window, the entries which match criteria which you
  537. have given.  See below the paragraph on the Requesters.
  538.  
  539.  
  540.   Window -> Select all
  541.  
  542. Selects all entries in the active window.
  543.  
  544.  
  545.   Window -> Filters
  546.  
  547. Another  important  feature  of BrowserII.  Only the files which match the
  548. criteria  you  set will be displayed, but all will be counted (look at the
  549. bottom string on the lower border of the window).
  550.  
  551.  
  552.   Window -> Filters -> Set...
  553.  
  554. Calls the filters requester and enables you to set your filters.
  555.  
  556.  
  557.   Window -> Filters -> Prefs
  558.  
  559. Set the filter that was saved in "DEVS:BrowserII.cfg" .
  560.  
  561.  
  562.   Window -> Filters -> No .info
  563.  
  564. Hides the icon files. This filter comes on top of the other filters.
  565.  
  566.  
  567.  Window -> Filters -> Clear
  568.  
  569. Removes all filters, all files and dirs will be visible.
  570.  
  571.  
  572.   Window -> Filters -> Invert
  573.  
  574. Reverses  the  action  of all filters, so all visible files will be hidden
  575. and  vice-versa.  Useful for checking wether a file which you expect to be
  576. there has not been hidden through the action of one of the filters.
  577.  
  578.  
  579.   Window -> File info
  580.  
  581.   Window -> File Info -> Size in Bytes
  582.  
  583.     Gives file sizes in bytes.
  584.  
  585.  
  586.   Window -> File Info -> Size in blocks
  587.  
  588.     Gives file sizes in blocks.
  589.  
  590.  
  591.   Window -> File Info -> Protection
  592.  
  593.     Shows protection bits.
  594.  
  595.  
  596.   Window -> File Info -> Date
  597.  
  598.     Shows date according to Amigados idiosyncrasies.
  599.  
  600.  
  601.   Window -> File Info -> Disk Key
  602.  
  603.     Shows the disk key of the entry (i.e. the block number of the file
  604.     header block).
  605.  
  606.  
  607.   Window -> File Info -> Type
  608.  
  609.     Show the file type. (Need whatis.library)
  610.  
  611.   Window -> Sort by ->
  612.  
  613.   Window -> Sort by -> Name
  614.   Window -> Sort by -> Date
  615.   Window -> Sort by -> Size
  616.   Window -> Sort by -> Key
  617.  
  618. Sorts  entries  by  name (alpha), date (most recent first), size (smallest
  619. first), disk key.
  620.  
  621.  
  622.   Window -> Sort by -> Entry Type
  623.  
  624. This  does  not really refer to a sort type.  If this option is set, files
  625. and directories are listed separately (directories first).
  626.  
  627.   Window -> Sort by -> FileType
  628.  
  629. Sort  by  file  type  !   (dir,  ilbm,  text, exe, etc...).  You must have
  630. whatis.library.
  631.  
  632.   Window -> Options -> Find type by name
  633.  
  634.   whatis.libray  try  to detect the type of file (exe, ilbm, text, etc...)
  635. only  by  scanning  the  name.  Fast but not very safe since names are not
  636. allways meaningfull for file types.
  637.     Disabled when whatis.library couldn't be opened.
  638.  
  639.   Window -> Options -> Find type by scan
  640.  
  641.     whatis.library  opens  and  scan  the  first few bytes of each file to
  642. discover  what  type of file is this.  Much powerfull than previous option
  643. but slow down directory scan.
  644.     Disabled when whatis.library couldn't be opened.
  645.  
  646.   Window -> Affect all
  647.  
  648. The preferences set for the active window will be active for all windows.
  649.  
  650.  
  651. * Actions
  652.  
  653.   Actions -> Rename
  654.  
  655. Renames  the  selected  entry.   If  several entries are selected, you can
  656. rename  them  with  jokers "à la ARP".  If you are not familiar with this,
  657. exercise on some files of no value before using this action for good.
  658.  
  659.  
  660.   Actions -> Makedir
  661.  
  662. Creates  subdirectories  in  the active window.  You can create several of
  663. them by separating the names with a space.
  664.  
  665. Example: Work Games Work/Src
  666.  
  667. Warning:   Games  Work/Src  Work would not be valid because you attempt to
  668. create a subdirectory of Work before having created Work itself.
  669.  
  670.  
  671.   Actions -> Duplicate
  672.  
  673. Makes a copy of a file, you will be prompted for a new name.
  674.  
  675.  
  676.   Actions -> Set Date
  677.  
  678. Changes the date of the selected entry (entries) to the actual date.
  679. Since 2.20, date can be modified.
  680.  
  681.  
  682.   Actions -> Set Comment
  683.  
  684. Will  enable  you  to  write  a  new  comment for the entry.  If there was
  685. already  a  comment,  it  will  be  displayed.   80  chars only, this is a
  686. limitation of AmigaDOS.
  687.  
  688.  
  689.   Actions -> Set Protect
  690.  
  691. Enables you to change the protection bits of the selected entry.
  692.  
  693. You  cannot  set  the C bit, as it is not really a protection bit, it just
  694. tells  you  that  the  selected  entry has a comment, but you can set this
  695. pseudo-C bit to " - ", this will delete the comment.  Handle with care, it
  696. is easy to get a lot of comments gone forever in no time.
  697.  
  698.   Action -> Add Icon
  699.  
  700. Add  an  icon  to  file(s)  you  have selected.  The Icon name is given by
  701. whatis.library  depending  on  file  type.   BrowserII will search default
  702. icons files in ENV:Sys/ like WorkBench 2.0.  Need whatis.library to work.
  703.  
  704.   Action -> Check Size
  705.  
  706. Scans selected files and dirs to compute total size in bytes and blocks of
  707. all of them.  If you choose to reselect entries, context of selection will
  708. be  restored (including 'Affect subdirs') so that next action will be done
  709. on  same  files and dirs.  Directories will get their size set, until next
  710. deselection.   This way, it makes it possible, using rightmost main window
  711. jauge,  to  determine  if a list of files and dirs will fit on destination
  712. volume.
  713.  
  714.   Actions -> WB Info
  715.  
  716. Brings up Workbench's info requester. (AmigaDOS 3.0 and higher).
  717. Note that currently, workbench must be loaded or nothing will happen.
  718.  
  719.   Actions -> Delete
  720.  
  721. Deletes the selected entries.  You will (fortunately) be asked to confirm.
  722. If  at  least  one  directory is selected, "Delete" will delete only empty
  723. dirs,  while  "Delete  All"  will delete non-empty selected directories as
  724. well.
  725.  
  726.  
  727.  
  728. The Requesters:
  729. ---------------
  730.  
  731. * Filters:
  732.  
  733. BrowserII tests all files against the criteria set in this requesters, and
  734. shows those for which the test is positive.
  735.  
  736.  
  737.     Files: Can be set to Yes, No or Match.
  738.            If Match is selected, files will checked against
  739.            the following criteria.
  740.  
  741.     Dirs: same thing for directories.
  742.  
  743.     Pattern: This must be a valid AmigaDOS pattern.
  744.              examples:
  745.              #?.doc        shows only the xxxx.doc files
  746.              ~(#?.(o|dbg)) hides the xxx.o  and xxx.dbg files
  747.  
  748.     Since   : shows files with more recent date than the date
  749.               entered ( AmigaDOS Date format )
  750.  
  751.     Before  : same thing in the other direction
  752.  
  753.     Min Size: if the file is smaller, it is hidden
  754.  
  755.     Max Size: if the file is bigger, it is hidden
  756.  
  757.     Protection bits: shows only the files with the specified bits.
  758.  
  759.  
  760.           Example:
  761.  
  762.           L C H S P A R W E D
  763.  
  764.               -                hides files which have the hide bit set
  765.  
  766.                     +          shows only files with the archive bit set
  767.  
  768.  
  769.     If  you  have  installed  the  whatis.library, you'll be able to match
  770.     files  by  type.   If  one  or  more  positive file types are selected
  771.     (without  the  exclude option), entries must match one of them.  If no
  772.     positive  file  types  are  selected, all files types are valid except
  773.     excluded  file  types.   For each file type, you can select associated
  774.     subtypes.
  775.  
  776.  
  777. * Select Match:
  778.  
  779.     This requester is the same as precedent one, but with one gadget more,
  780. "Affect  subdirs".  This enables you to virtually select files in selected
  781. directories.
  782.     As  we  say  in  french,  a good example is better than a long speech.
  783. Suppose you want to clear archive bit of all files you have in a disk.
  784.     1.  Open volume's window.
  785.     2.  Call Select Match.
  786.     3.  Put Files to ? and Dirs to N.
  787.     4.  Clear all protection bits and set A to +.
  788.     5.  Switch on Affect subdirs.
  789.     6.  Validate the requester.
  790. Result: All files which have their archive bit set are selected, but any
  791. directories are selected since you set Dirs to N. Now:
  792.     7.  Hold <Shift> key while selecting all dirs of this window.
  793.     8.  Call Set Protect.
  794.     9.  Switch protection bits to:
  795.             L C H S P A R W E D
  796.             _ _ _ _ _ - _ _ _ _
  797.     10. Validate.
  798. Et voilà!
  799.  
  800.     Each  time you click left mouse button over a BrowserII window, if you
  801. DON'T  hold <Shift> at the same time, the file under the mouse pointer, if
  802. any,  becomes  selected, all others are deselected, and Affect subdirs bit
  803. is cleared.  That is to say after each operation with affect subdirs, this
  804. option  is  reset  (except if you allways hold shift key), and must be set
  805. again if you want to do another action with this option.
  806.     Within  actions  with  affect subdirs, if a directory pass through the
  807. filters,  the  action will take place also on the directory itself once it
  808. has  been  examined.   But  even if the directory doesn't pass through the
  809. filters,  it will be entered, and files within this dir may be affected by
  810. the action.
  811.     This  is a bit different for Copy action.  If a directory doesn't pass
  812. through  the  filters, it won't be entered, and files within this dir will
  813. never be copied.  But read carefully:  Empty directories may be considered
  814. useless.  So you can decide not to copy them by switching off this option.
  815. But  Copy  process is even more powerfull.  If for example, you decide not
  816. to  copy  empty  dirs, if you copy a directory with affect subdirs and any
  817. entries  of  this  dir  pass  through  the  filters, the directory will be
  818. considered  as empty and won't be created in destination path.  This makes
  819. it  possible  to  make  selective  backups, without useless directories in
  820. destination volume.
  821.  
  822.  
  823. Jauges:
  824. -------
  825.  
  826. All windows except Alien has two jauges on their left border. The leftmost
  827. one  allways  displays  the  disk  percentage  of occupied space.  And the
  828. second  one,  to  the  right,  displays  the  directory  disk usage or the
  829. percentage  of  visible  data depending on the option you choose (See menu
  830. BrowserII->Options).
  831.  
  832. 1. Directory disk usage
  833. If this option is selected, the rightmost jauge displays the proportion of
  834. used disk space used by this directory.  For example, is you have a volume
  835. with no directories (all files are in the root directory), this jauge will
  836. say that the directory contains 100% of data present on this disk.
  837.  
  838. 2. Percentage of visible data.
  839. If this option is selected, the rightmost jauge displays the proportion of
  840. visible  data  (in blocks) in this window (If filters hide some entries of
  841. this dir, not all entries are visible !). This is usefull for example when
  842. you hide .info files, a quick look at this jauge help you remembering that
  843. some files are not visible and you should not forget them.
  844.  
  845. Jauges of main window:
  846. ----------------------
  847.  
  848. The  leftmost  jauge  of main window is a copy of the same jauge of active
  849. window.   If  the  active  window  is  the main or alien, both main window
  850. jauges are empty.
  851. The  other jauge will help you to determine if selected files would fit on
  852. active  volume  (volume  of  active  window) if a copy/duplicate operation
  853. would be performed.  Imagine you want to copy some files on a floppy disk,
  854. and  you  don't  know  if there is enough free space on this disk for your
  855. selected  files.  You can examine informations in bottom border of windows
  856. of  course  but  there  is an easier way.  Activate the destination window
  857. (without deselecting your files), and the second jauge of main window will
  858. tell  you everything:  The leftmost jauge shows the actual disk usage, and
  859. the  other  one  what  it  will  become after the copy.  Then there is two
  860. possibilities.   Your  files fit on the disk:  no problem.  Or there's not
  861. enough  free  space:   then,  the  second jauge shows of how much selected
  862. files  exceeds  disk  space  by  displaying  a dash (-).  The jauge height
  863. allways means the disk size.
  864.  
  865. Note:   In  this  release,  selected  directories  are  not  entrered,  so
  866.         BrowserII knows size of selected files only.
  867.         Block  size  between source and destination volumes are assumed to
  868.         be the same.
  869.  
  870.  
  871. Function Keys:
  872. --------------
  873.  
  874. The first five function keys have the following effects:
  875.  
  876. F1 :    UnZoom current window.
  877. F2 :    Zoom current window to see all files and dirs.
  878. F3 :    Zoom current window to see all directories only.
  879. F4 :    Iconify current window, or BrowserII if main window is active.
  880. F5 :    Opens Alien Window.
  881. F6 :    Opens status window of prcesses currently running.
  882. ESC:    Pauses all processes and open their status window.
  883.  
  884.  
  885. Buffer size for copy:
  886. ---------------------
  887.  
  888. BrowserII will test wether destination and one of source concerned volumes
  889. are mounted, i.e.  one of source and destination volume are simultaneously
  890. present to the system (a diskette with a given volume name may not be in a
  891. drive), in which case BrowserII will make use of a 200 K max buffer.
  892.  
  893. If  any  source  or destination volume is mounted (you have only one drive
  894. for  instance),  BrowserII will use 880 K max for buffers if enough memory
  895. is  available.  This way, in order to copy some files from a diskette into
  896. another  one,  you  don't  need  to  go through the RAM DISK.  Buffers are
  897. allocated  during  copy,  and in any case BrowserII will not use more than
  898. 80% of the available memory for its buffers.
  899.  
  900.  
  901.  
  902. Hints and tips:
  903. ---------------
  904.  
  905. * If you hold the shift key down while closing the window corresponding to
  906.   a  volume,  all windows corresponding to directories of that volume will
  907.   close  at  once,  except  iconified  windows.   If  you  want to get rid
  908.   of iconified windows too, press SHIFT-ALT while closing window.
  909.  
  910. * In the same way, you can iconify all directories of the same volume by
  911.   'shift iconifying' a window.
  912.  
  913. * You can uniconify multiple windows at once with extended selection.
  914.  
  915. * To validate and quit a filter/select requester, press shift-return.
  916.  
  917. * The unmounted volumes appear in boldface.
  918.  
  919. * The write-protected volumes appear in italic.
  920.  
  921. * Files which have just been deleted appear in italic and are unselectable
  922.  
  923. * Icons  (in  Alien  Window) are directories like any other directories in
  924.   standard  windows,  that  is  to  say they support all actions.  You can
  925.   select  icons  and release them over directories, you can also use icons
  926.   as destination of a copy, or even rename or why not protect an icon.
  927.  
  928. * BrowserII defines two more customs protection bits named C and L.
  929.   If bit C is set, file/dir has a comment.
  930.   If bit L is set, file/dir is a link.
  931.  
  932.  
  933. External command BD:
  934. --------------------
  935.  
  936. An  external  command  named  BD  is  given  with  BrowserII.   This is an
  937. interface between shells and BrowserII.  Running BD with no arguments will
  938. run  BrowserII  if it is not yet running, and make BrowserII open and scan
  939. your   current  shell  directory.   You  can  also  specify  one  or  more
  940. directories as argument to BD.
  941. BD has now 3 optional argument:
  942.   Note:   BrowserII  must  be in your shell Path if it is not yet running.
  943. BD  can  also  be run from workbench.  If you double-click on the Tool BD,
  944. BrowserII  will  open  the directory containing BD.  But you can also have
  945. project  icons with BD as default Tool.  In this case, if your project has
  946. no  Tool-Types, the current dir will be open, otherwise, you can edit your
  947. project  Tool-Types,  and  specify  as  many directories as you want.  You
  948. should  also specify in the BD Tool Tool-Types the full path to BrowserII,
  949. that is to say in which directory you have BrowserII.
  950.  
  951. In example given, BrowserII should be in SYS:Utilites directory.
  952.  
  953. BD has 6 flags.
  954.  
  955.     Template:   Dirs/M,RESCAN/S,ZOOMALL/S,ZOOMDIRS/S,QUIET/S,SCANDEVS/S,SYNC/S
  956.  
  957.     Dirs:     Several dirs can be asked to be (re)scanned
  958.     RESCAN:   Allways scans dir. Even if already open.
  959.     ZOOMALL:  Zoom window, even with AutoZoom is not active.
  960.     ZOOMDIRS: Same as ZOOMALL, but for dirs only.
  961.     QUIET:    Do not activate window, nor bring screen to front.
  962.     SCANDEVS: Rescan main window (the one with devices/volumes/assigns)
  963.     SYNC:     Operate synchronously to prevent disk trashing if more than
  964.               one dir asked on the same device unit.
  965.  
  966.  
  967. Release notes:
  968. --------------
  969.  
  970.     1.0:    First Release   (30-jul-91)
  971.  
  972.     1.1:    Bug fixes.
  973.             Added DiskCopy ability.
  974.             Moving a device over another device calls SYS:System/DiskCopy,
  975.             and Duplicate a single device too.
  976.             Cli arguments are now quoted only when needed.
  977.             A lot of little invisible improvements.
  978.  
  979.     1.11:   Bug fixes.
  980.             With parm.library 3.4 and higher, RUN modes work under 2.0. 
  981.  
  982.     2.0:    Iconification, Zoom, Jauges, Workbench 2.0 look (under 2.0),
  983.             Parametrable Fonts, ASynchronous dir scan, and bug fixes.
  984.             External command BD.
  985.  
  986.     2.03:   Minor bug fix.
  987.  
  988.     2.04:   "Copy->Move" bug fix. (won't delete source file)
  989.  
  990.     2.05:   Bug Fix: A CurrentDir was missing which can cause crash,
  991.                      bug in copy when skiping big file. Removed trash of
  992.                      prop gadget with autozoom under 2.0
  993.  
  994.     2.10:   29/5/1992
  995.             Optional  whatis capability:  reconized some file (ILBM, PPDATA,
  996.             doc,...), You can define new type ( see docs of whatis.library).
  997.             Auto command (custom command for each filetype ).
  998.             BrowserII   can   work   without  whatis.library.
  999.             AddIcon  and  CheckSize  action added, Back pattern option added
  1000.             (KS2.x  only),  should  be custom in future.  Optional automatic
  1001.             main window Zoom.  Optional save Main window size/position
  1002.             BD has now 3 new option.
  1003.  
  1004.     2.11    RunMode was not printed in GetString() title bar when double
  1005.             clicking on a file. fixed.
  1006.             When changing Sort mode for a window, window was not updated.
  1007.             fixed.
  1008.  
  1009.     2.12    RunMode on double-click was always Shell with WB 2.0. fixed.
  1010.             After closing a window, check-marks for new current window
  1011.             was not udated. fixed.
  1012.             WBToFront now supported for WBRun too.
  1013.             A TAG_DONE was missing for backdrop window open (Pattern Option)
  1014.             
  1015.             ****************************************************************
  1016.             *           THIS WAS THE LAST KICKSTART 1.3 VERSION !          *
  1017.             ****************************************************************
  1018.  
  1019.  
  1020.     2.20:   For KS 2.0 only, sorry.
  1021.             arp and req libraries no more needed.
  1022.             New lovely requesters (Underscored chars are shortcuts).
  1023.                 Bold gadget is default response (Return key).
  1024.                 ESC cancels all requesters.
  1025.             Processes status windows.
  1026.             New screen modes available.
  1027.             Virtual autoscroll screens.
  1028.             New wonderful Select/Filters requester with file types criteria.
  1029.             New look in menus.
  1030.             FileInfo options for alien window entries saved in config file.
  1031.             OpenDir done relative to current dir (enables opening
  1032.             of // for example)
  1033.             ShortCuts available when pattern's backdrop window is active.
  1034.             BrowserII can be iconified even when processes are running.
  1035.             Touch action changed in SetDate (like AmigaDOS command). You
  1036.             can then modify the date.
  1037.             Added new internal protection bit L to identify links.
  1038.             Size/Position of main and alien windows made easier.
  1039.  
  1040.     2.21:   No more truncate french dates.
  1041.             Works fine with 4000 bytes of stack. (2.20 needed 4500 bytes).
  1042.             Uses new asl.library V38 screen mode requester.
  1043.  
  1044.     2.22:   New look menus under AmigaDOS 3.0.
  1045.             New action 'WB Info' under AmigaDOS 3.0.
  1046.             Bug fix: Mem jauge layout was not correctly handled under V39.
  1047.             Backdrop pattern now implemented as a layer hook, and no more
  1048.             uses precious chip memory.
  1049.  
  1050.     2.23:   Bug fix. Replaced ExNext() with MatchNext() to fix problems
  1051.             with new V39 DirCache FileSystem.
  1052.  
  1053.     2.30:   Localized.
  1054.             Screen's bitmap made Interleaved under 3.0 (scrolling much nicer)
  1055.             Bug fix in WB Info. Not handle properly icons (when selecting .info)
  1056.             You can now run a tool by double-clicking on it's icon. Makes
  1057.             it possible to run projects made of only an icon (for example:
  1058.             clicking on English.info to run software install in english).
  1059.             Uses system busy pointer under WB3.0.
  1060.             Bug fix in LoadConfig(). Config revisions were not properly handled.
  1061.  
  1062.     2.31:   Pooled memory under WB3.0
  1063.             BrowserII's screen now inherits Workbench3.0's properties.
  1064.             (Your prefered pens,...)
  1065.  
  1066.  
  1067. Futur Plans:
  1068. ------------
  1069.  
  1070.     LeaveOut,  Aliases,  parametrable  Fast Menu for gadget lovers, Tree
  1071.     window, help using amigaguide, and more.
  1072.  
  1073.  
  1074. ShareWare / distribution :
  1075. --------------------------
  1076.  
  1077. BrowserII  and ParM are both shareware.  If you use them consistently, you
  1078. ought to send us a contribution or your conscience will itch.
  1079.  
  1080. Any  contributor  for  at least $25 will become a registered user and will
  1081. automatically  receive  one  non-demo  update.   Don't fail to mention the
  1082. version  number  of  your copy.  If there is no newer version, you will be
  1083. put  on  a list and receive one update whenever it becomes available.
  1084.  
  1085.  
  1086. Many thanks to:
  1087.  
  1088. Michel Jouanne for the tutorial and guide (in progress...).
  1089. ASDG for CED (a fantastic text editor).
  1090. W.S. Hawes for ARexx.
  1091. Pierre Ardichvili for his kindness and his support to the Amiga.
  1092. Cedric Beust, and all other contributors.
  1093.  
  1094.  
  1095.                                     Sylvain Rougier and Pierre Carrette.
  1096.  
  1097.  
  1098.  
  1099. Send donnations and bug reports to:
  1100. -----------------------------------
  1101.  
  1102.         Sylvain Rougier
  1103.         39 rue Carnot
  1104.         86000 Poitiers
  1105.         France.
  1106.  
  1107.  
  1108. Don't forget to give your version of BrowserII and System.
  1109.  
  1110.