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

  1.  
  2.                         Documentation for BrowserII V2.13
  3.  
  4.  
  5. Copyright:
  6. ----------
  7.  
  8. ParM  and  BrowserII  are copyrighted; they may not be sold in or together
  9. with  commercial  software  without written approval by the authors.  They
  10. may  be  freely distributed for a fee which will not exceed the equivalent
  11. of  French  Francs  15.-  (this  includes the cost of the diskette and the
  12. postage);  they  cannot  be  made  available for downloading from a server
  13. which  is  a  commercial  operation.   The general principle is that it is
  14. forbidden  to  make  a  profit  through  the  use or distribution of these
  15. programs without our written consent.
  16.  
  17. ParM  V3.5 (or higher) and BrowserII V2.0 (or higher) may NOT be duplicate
  18. for  other  things  than backup.  Only Authors are autorized to give it to
  19. other persons.
  20.  
  21. DISCLAIMER:
  22. -----------
  23.  
  24.     We  accept  no responsability for the use or misuse of these programs,
  25. and   for  the  damage  they  could  produce.   Use  at  your  own  risks.
  26. Nevertheless,  we  think that after several month of intensive use by four
  27. persons, thay have been tested enough to say they are safe.
  28.  
  29.  
  30. History:
  31. --------
  32.  
  33. We  wrote  BrowserII  after  having  used for 2 years the original Browser
  34. (version  1.6A)  written  by  Peter Da Silva.  We were not fully satisfied
  35. because  of  some  of  its  limitations  so, as soon as we felt capable of
  36. writing  a  program  which  would  overcome  those  limitations, we made a
  37. decision to do it.  So BrowserII was born ...  The Return !
  38.  
  39. We  felt the overall layout and display mode of Browser were very good, so
  40. we  decided  to  keep  them,  as well as the name, so that actual users of
  41. Browser would immediately feel home with BrowserII.
  42.  
  43. As  we  never  had  the  sources  of  Browser  at hand, we rewrote it from
  44. scratch.
  45.  
  46. Beginners  claimed many times that BrowserII was difficult to use and very
  47. complicated.   Really,  we  don't  understand  that  since BrowserII works
  48. exactly  like  workbench.  To copy files, you just have to select them and
  49. to drag them over the destination directory.  It's power is far from other
  50. file  manager tools which are able to display only to directories, and are
  51. full  of  useless gadgets which cluter up more than the half of the screen
  52. display.  We think that menus are more adapted to commands not often used,
  53. and keyboard shortcuts quicker than gadgets for regular operations.
  54. Any  way,  a  special  window with parametrable gadgets will be taken into
  55. consideration in a next release using gadtools.library of new OS 2.0.
  56. Another  advantage of BrowserII is that it is small (60 KBytes !).  It has
  57. the  most  powerfull  copy  process,  and  doesn't  include  text viewers,
  58. editors,  or  any IFF viewers.  With this phylosophy, you can use the best
  59. tools  of  each kind, text viewer (we use the great MuchMorePoPa 2.7 which
  60. can  be made resident), IFF viewer (we use Mostra which is pure too).  You
  61. are not limited with the number of parametrable menus...
  62. Finally, BrowserII is the best file manager ! Don't you think so ?
  63.  
  64. Another  positive thing because other don't do it, is that all disk errors
  65. are  properly  reported with a message (not an error number), files can be
  66. individually skipped, or opération aborted.  (some tools continue to write
  67. files after a 'disk full' error.  Nice isn't it!).
  68.  
  69.  
  70. Installation:
  71. -------------
  72.  
  73. While  you  can put BrowserII in any directory, you must copy parm.library
  74. and req.library in LIBS:.  You must have arp.library V39 too.  If you want
  75. to  take advantage of the parametrable menus of BrowserII, don't forget to
  76. build a BrowserII.menu file, and to put it in S:.
  77. Since  V2.10,  BrowserII  will  recognize  file  types  if  you  have  the
  78. whatis.library in your LIBS:  directory. (See doc for this library).
  79.  
  80.  
  81. Demo Version:
  82. -------------
  83.  
  84. There  is  a demo version of BrowserII (you can see which version you have
  85. with  the  About  menu).   In  demo  version,  the About requester appears
  86. regularly, where the registered version doesn't.
  87.  
  88.  
  89. Tutorial:
  90. ---------
  91.  
  92. Some  friends made a tutorial for unexperimented user.  The french version
  93. makes  use  of  a  lot  of  pictures.   have a look at them, they are very
  94. atractive.  Note that both tutorials are about using Version 2.04. A few
  95. things were added since then but the mind didn't change!
  96.  
  97.  
  98. Gadgets:
  99. --------
  100.  
  101. BrowserII  windows  now  have  three  more  gadgets.  The first one is the
  102. iconification  gadget,  just  below  the  close gadget.  If you press this
  103. gadget,  two  things can happen:
  104.  
  105. 1.
  106. If  it  is  the  main  window (the one where appears devices, volumes, and
  107. assigns),  BrowserII will be iconified, that is to say that a small window
  108. in  workbench  screen will open, and all BrowserII windows and screen will
  109. be closed.  This small window has a close gadget which enables you to quit
  110. BrowserII  without  uniconifying BrowserII.  To uniconify BrowserII, press
  111. right  mouse  button.
  112. Note:  For now, you cannot iconify BrowserII if it has it's own screen and
  113. if  some  background  BrowserII  processes  are running.  (This is because
  114. processes are initialised to put thier requesters in BrowserII screen).
  115. 2.
  116. If  it is a directory window, the window will be closed, and an entry will
  117. be  added in Alien Window, whether it is open or not.  Alien Window can be
  118. open  using  F5  or  menu  'Window->Open->Alien  Window'.  To uniconify an
  119. iconified  window,  just  double click on the corresponding entry in alien
  120. window.   You  can  uniconify  several windows sumultaneously by selecting
  121. several entries in alien window, and double clicking on one of them.
  122. If  one  entry  only  is  selected  in  Alien Window, the full path of the
  123. directory is displayed in the bottom border of this window.
  124.  
  125. The other two gadgets are invisible.  The first one is the ZOOM gadget and
  126. is  the  top half of the jauges, while the second one is the UNZOOM gadget
  127. and  is  the bottom half of the jauges.  If you ask for a zoom while a the
  128. directory  to  be zoomed is currently scanning, the zoom is defered at the
  129. end of scan.
  130.  
  131.  
  132. Menus:
  133. ------
  134.  
  135. * BrowserII
  136.  
  137.   BrowserII -> Update menus
  138.  
  139. Reloads  the  parametrable menus file "S:BrowserII.menu".  This file is an
  140. ASCII  file  with  the same syntax as the configuration file of ParM. Some
  141. option  has  been added:  the selected files in BrowserII will be inserted
  142. at the [] if any, with full path calculated from current window.
  143.  
  144. Example:    you have selected "S:" in the main window of BrowserII
  145.             you have defined a menu item as follows:
  146.  
  147.             ITEM Sizer SHELL Sizer [] ; WaitReturn
  148.  
  149.             activating the menu item Sizer will be equivalent to
  150.             executing the following script:
  151.  
  152.             Sizer S:
  153.             WaitReturn
  154.             Endcli  >  Nil:
  155.  
  156. If  there  are  no  [],  then  the  names of the selected files are simply
  157. appended to the end of the command line.
  158. Have  a  look  at  ParM.doc  for the special BrowserII option WBTF in menu
  159. items to bring workbench to front when running commands.
  160.  
  161.  
  162.     Now  you  can specify Automatic commands.  For that, you must have the
  163. whatis.library  in your LIBS:  directory.  When you DoubleClick on a file,
  164. BrowserII  search  for  an automatic command (AUTOCMD) associated with the
  165. type of the file.  If it founds one, it will be executed.
  166.  
  167.     AUTOCMDs  must  be  specified  in  the  S:BrowserII.menu file with the
  168. following syntax:
  169.  
  170. AUTOCMD <file type> [WBTF] <run mode> [STACK] [PRI] [WIN] <command>
  171.         <file type> : the id string you can see when you ask "Window->File
  172. Info->Type"  (  i.e:   "Text",  "Exe",  etc...)
  173.         <run mode> : (WB, RUN,...) See ParM.doc
  174.         <command> : The command you want to execute for this type of file.
  175.                     Same syntax as ParM's menu items.
  176.  
  177. Example:
  178.         AUTOCMD "Text" WBTF RUN SYS:Utilities/More []
  179.         If you DoubleClick on a file and this file is a  text  then
  180.         "SYS:Utilities/More" will be run with the file as argument.
  181.  
  182.     If  you want AUTOCMD for types which are not built-in, don't forget to
  183. create  the  new  type (managed by WhatIs.library) in "S:FileTypes" before
  184. putting an AUTOCMD.
  185.  
  186.     We strongly recommand to have a look at the complete examples given in
  187. BrowserII.menu, since the file is easy to understand.
  188.  
  189.   BrowserII -> Last Error
  190.  
  191. This will show you the last message which appeared in screen title bar
  192.  
  193.  
  194.   BrowserII -> Cmd Mode -> Simple
  195.   BrowserII -> Cmd Mode -> Shell
  196.   BrowserII -> Command
  197.  
  198. Same usage as with ParM.
  199. Command  is  executed  in the directory of the current window.  To see the
  200. influence  of  the  current window on file path, select a file, and select
  201. 'Command'  from  the  BrowserII  menu.   As BrowserII does a CD in current
  202. window before running commands, you will see in the requester the selected
  203. file,  without  path.   Now  cancel  the requester, make another window of
  204. another  volume the active one, and select 'Command' again.  Now, you will
  205. see the full path name of the selected file.
  206.  
  207.  
  208.   BrowserII -> Screen -> Workbench
  209.  
  210. BrowserII opens its windows in the Workbench screen
  211.  
  212.   BrowserII -> Screen -> Custom Hi-Res
  213.   BrowserII -> Screen -> Custom Interlace
  214.  
  215. BrowserII  opens  its own screen and opens all its windows in that screen.
  216. Under  workbench  2.0, the screen is made public and is named "BrowserII".
  217. Take  care,  public screen names are case-sensitive.  For example, you can
  218. open a console in the BrowserII screen with the following syntax:
  219.  
  220.     "CON:0/11/640/100/Window Title/CLOSE/WAIT/AUTO/SCREEN BrowserII"
  221.  
  222. This  console  has  defered  open  (AUTO),  will  also have a close gadget
  223. (CLOSE),  and will wait for you to hit close gadget before closing (WAIT).
  224. Note  that  if  another public screen with the same name exists, BrowserII
  225. will make its screen private (this can happen if you have the strange idea
  226. to  run  BrowserII  twice)!   For now, you cannot change screen if browser
  227. background processes are running.
  228.  
  229.   BrowserII -> Screen -> WorkBench Colors
  230.   BrowserII -> Screen -> Custom Colors
  231.  
  232. Do you need an explanation ?
  233.  
  234.  
  235.   BrowserII -> Screen Font -> Default Font
  236.   BrowserII -> Screen Font -> Topaz 80 column
  237.   BrowserII -> Screen Font -> Custom Font
  238.  
  239.     This  enables  you  to  choose your prefered screen font.  Screen Font
  240. appears  in  title  bars and in menus.  This menu is disabled in workbench
  241. screen.   For now, you cannot change it while browser background processes
  242. are  running  since screen must be closed then reopen.  Here Default Fonts
  243. clones workbench screen font.
  244.  
  245.  
  246.   BrowserII -> Window Font -> Default Font
  247.   BrowserII -> Window Font -> Topaz 80 column
  248.   BrowserII -> Window Font -> Custom Font
  249.  
  250. This enables you to choose your prefered window font.  We recommend use of
  251. fixed-width fonts here for optimal display.
  252.  
  253. Note:   In  this  release,  big  and/or  proportionnal fonts are not fully
  254. supported.   The  select/filters  requester  assumes 8 pixels width fonts.
  255. This will be solved in next release, special for OS 2.0, since 1.3 doesn't
  256. support  proportionnal  fonts in string gadgets.  Any way, even if display
  257. is not nice, everything works ok.
  258.  
  259.  
  260.   BrowserII -> Run Mode
  261.  
  262. The  submenu items of this item will determine the mode according to which
  263. the  files  on which you double-click will be opened.  If other files were
  264. selected  at  the  time of the double-click, their names become parameters
  265. for the double-clicked file.
  266.  
  267. If the file has an icon, it will automatically be run in Workbench mode.
  268.  
  269. Also  note  that BrowserII does a CD to the active window before running a
  270. command,  whether  you  have  double-clicked  on  a  file, or activated it
  271. through a menu selection.  This is often VERY useful.
  272.  
  273.  
  274.   BrowserII -> Run Mode -> RunBack
  275.  
  276. Launches  the  program  on  which  you have double-clicked as a background
  277. Process.  This mode is 100% safe only if you use the NULL:  device (as you
  278. know  there  is  a  well  known  limitation  in  the  NIL:  handler, which
  279. BrowserII  will use anyway if it can't find NULL:).  (You don't need NULL:
  280. under 2.0.
  281.  
  282.   BrowserII -> Run Mode -> Shell
  283.  
  284. Launches  the  program on which you have double-clicked, via a SHELL which
  285. BrowserII  opens  for  you.   This  mode is 100% safe but it requires that
  286. BrowserII can have access to your favorite shell, as well as to the EndCli
  287. command  ;  you  have to specify this in your "S:BrowserII.menu" file (see
  288. the  sample  BrowserII.menu  file).   We  recommend  that  you  make these
  289. commands resident.
  290.  
  291.   BrowserII -> Run Mode -> Request
  292.  
  293. If   this  option  is  activated,  a  requester  will  appear  before  the
  294. double-clicked program is actually launched, so you can confirm or cancel.
  295. (except for Workbench)
  296.  
  297. Remember  though, that a program which has an icon, will be launched in WB
  298. mode il all cases.
  299.  
  300.  
  301.   BrowserII -> Copy Mode
  302.  
  303.   BrowserII -> Copy Mode -> Context
  304.  
  305. If  you move a file, BrowserII will in fact perform a rename if the source
  306. and  destination  files are on the same volume.  Across volumes, BrowserII
  307. will perform a copy.
  308.  
  309.  
  310.   BrowserII -> Copy Mode -> Allways Copy
  311.  
  312. BrowserII will systematically make a copy of the file.
  313.  
  314.  
  315.   BrowserII -> Copy Mode -> Allways Move
  316.  
  317. BrowserII  will copy the file to the destination directory and then delete
  318. the source file.
  319.  
  320.  
  321.   BrowserII -> Copy Mode -> Update
  322.  
  323. BrowserII  will  copy the file only if the source file is more recent than
  324. the destination file, or if the destination file does not exist.
  325.  
  326.  
  327.   BrowserII -> Copy Mode -> Don't overwrite files
  328.  
  329. BrowserII  will  not  overwrite  an  existing  file.   If  there  exists a
  330. destination file with the name you gave for the destination, the copy will
  331. not be performed.
  332.  
  333.  
  334.   BrowserII -> Copy Mode -> Ask before Overwrite
  335.  
  336. BrowserII  asks  for  confirmation  before  overwriting.   This  option is
  337. naturally mutually exclusive with the former one.
  338.  
  339.  
  340.   BrowserII -> Copy Mode -> Copy Empty Dirs
  341.  
  342. This  option will enable to re-create empty directories in the destination
  343. directory.   It  is  particularly  useful  in  its disabled mode, so empty
  344. directories are not copied.
  345.  
  346.  
  347.  
  348.   BrowserII -> Copy Flags
  349.  
  350.  
  351.   BrowserII -> Copy Flags -> Clone
  352.  
  353. All  attributes  of  the  file  will  be copied (date, comment, protection
  354. bits).
  355.  
  356.  
  357.   BrowserII -> Copy Flags -> Date
  358.  
  359. The destination file inherits the date of the source file.
  360.  
  361.  
  362.   BrowserII -> Copy Flags -> Protect
  363.  
  364. The destination file inherits the protection bits of the source file.
  365.  
  366.  
  367.   BrowserII -> Copy Flags -> Comment
  368.  
  369. The destination file inherits the comment of the source file.
  370.  
  371.  
  372.  
  373.   BrowserII -> Display
  374.  
  375.  
  376.   BrowserII -> Display -> Devices
  377.   BrowserII -> Display -> Volumes
  378.   BrowserII -> Display -> Assigns
  379.  
  380.   BrowserII 's main window shows the appropriate list.
  381.  
  382.  
  383.   BrowserII -> Options -> Keep Selected
  384.  
  385. After  an  action  (  copy,  delete,  etc  )  the  selected  entry  is not
  386. automatically deselected.
  387.  
  388.  
  389.   BrowserII -> Options -> Toggle selection
  390.  
  391. If  this  option  is activated, clicking on a name will alternately select
  392. and deselect it.  If this option is not activated, the selected entry will
  393. not be deselected.
  394.  
  395.  
  396.   BrowserII -> Options -> Move files into subdirectories
  397.  
  398. Once  this  option  is set, BrowserII will put the selected entries in the
  399. subdirectory  un  which  you  release the left mouse button.  Otherwise it
  400. will put them in the window which contains this directory.
  401.  
  402.  
  403.   BrowserII -> Options -> Ask before moving into subdirectories
  404.  
  405. BrowserII asks for confirmation before moving the entries.
  406.  
  407.  
  408.   BrowserII -> Options -> Asynchronous Actions
  409.  
  410. You  will  love that one or I'll eat my tie (as I never wear one, the risk
  411. is limited).  When this option in on, any action requested executes in the
  412. background,  and the next action can be started without a delay.  Like for
  413. the  multitasking,  you  will wonder how you could live without it before!
  414. Switching it off has been made possible mainly for debug purpose.
  415.  
  416.  
  417.   BrowserII -> Options -> Open process status window
  418.  
  419. This is not yet implemented.
  420. In  a  future  release,  each  process will be able to open its own window
  421. telling  what  it  is  currently  doing, and giving you the possibility to
  422. pause or cancel the process.
  423.  
  424.  
  425.   BrowserII -> AutoCmds override icons's default tool
  426.  
  427. BrowserII  will  not look at the tools types of the icon of the file if an
  428. AUTOCMD is defined for this type of file.
  429.  
  430.  
  431.   BrowserII -> Examine file on DoubleClick (for AutoCmd)
  432.  
  433. BrowserII  will  ask  WhatIs.library  for  a  deep  scan  (the  most sure)
  434. regardless  you  specify  in  "Window->Options->Find Type by scan" or not,
  435. before  searching  an  AutoCmd.  We encourage you to use this option since
  436. in fact, it will not slow down operation because the tool will open this
  437. file too will already be in the drive's buffers.
  438.  
  439.  
  440.   BrowserII -> Option -> Install backdrop pattern
  441.  
  442. This  is  only  for  2.x user (but useless in 1.3).  Put a backdrop window
  443. with a pleasent pattern, for your eyes only !  In a future release, you'll
  444. be  able  to  change  this  pattern.   It  is  currently  implemented as a
  445. smart-refresh  backdrop window, so uses a lot of chip memory.  If somebody
  446. know how to use Layer-Hooks, please, send us source code. Thanks.
  447.  
  448.  
  449.   BrowserII -> Window Options -> Display directory disk usage.
  450.   BrowserII -> Window Options -> Display proportion of visible data.
  451.  
  452. See documentation for jauges at the end of this file.
  453.  
  454.   BrowserII -> Window Options -> Windows AutoZoom
  455.  
  456. At  the  end of directory scan, the window will be automatically zoomed to
  457. show as many entries as possible.
  458.  
  459.  
  460.   BrowserII -> Window Options -> Windows AutoZoom dirs only
  461.  
  462. Same as before but show only directories.  (You must have the option "Sort
  463. by Type" set).
  464.  
  465.  
  466.   BrowserII -> Window Options -> Main Window AutoZoom
  467.  
  468. Now Main window can be AutoZoom.
  469.  
  470.  
  471.   BrowserII -> Window Options -> Zoom Main Window on startup
  472.  
  473. Main window will be zoomed only on BrowserII startup.
  474.  
  475.  
  476.   BrowserII -> Window Options -> Save Main Window size
  477.  
  478. Size  and  position will be saved on every "Save Config".  We recommend to
  479. save  your  preferences  once,  then turn off this option, then save again
  480. your  config.   This way, you'll be able to save next config, keeping your
  481. prefered size and position.
  482.  
  483.  
  484.   BrowserII -> Save Config
  485.  
  486. Saves  all your options in the file "DEVS:BrowserII.cfg" (don't confuse it
  487. with  the  file  "S:BrowserII.menu"  which contains the definition of your
  488. personal  menus).   Saves  the contents of the selection requester and the
  489. options of the current window as well.
  490.  
  491.  
  492.   BrowserII -> About
  493.  
  494. A  little  word  about  the  phantastic,  Mega-Super-Extra authors of this
  495. wonderfull piece of software.
  496.  
  497.  
  498.   BrowserII -> Quit
  499.  
  500. We  did  not  plan  for  implementing  this  option,  but a few crazy guys
  501. screamed for it, so here it is...   Anyway, you won't be surprised to read
  502. that  you  won't  be  able  to  quit  BrowserII  as  long  as  one  of the
  503. Asynchronous Actions is still running.
  504.  
  505.  
  506.  
  507. * Window
  508.  
  509.   Window -> Rescan
  510.  
  511. BrowserII  rescans  the  content of the directory which corresponds to the
  512. active   window.    Since   version   2.0,   BrowserII  scans  directories
  513. asynchronously.  You can iconify a directory while scanning.  If you close
  514. a window while directory is being scanned, scan is aborted.
  515.  
  516.  
  517.   Window -> Open
  518.  
  519.   Window -> Open -> Open Parent
  520.  
  521. Opens a window for the parent directory (if any).
  522.  
  523.   Window -> Open -> Open Dir...
  524.  
  525. Opens a particular directory, for which you type the full pathname.
  526.  
  527.   Window -> Open -> Open Alien
  528.  
  529. Opens  Alien Window.  This window is called Alien and not (Iconify Window)
  530. because  in  a futur release, this window will receive other entries, such
  531. as LeaveOut and Aliases, to have easy access to most often used files.
  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 -> Touch
  677.  
  678. Changes the date of the selected entry (entries) to the actual date.
  679.  
  680.  
  681.   Actions -> Set Comment
  682.  
  683. Will  enable  you  to  write  a  new  comment for the entry.  If there was
  684. already  a  comment,  it  will  be  displayed.   80  chars only, this is a
  685. limitation of AmigaDos.
  686.  
  687.  
  688.   Actions -> Set Protect
  689.  
  690. Enables you to change the protection bits of the selected entry.
  691.  
  692. You  cannot  set  the C bit, as it is not really a protection bit, it just
  693. tells  you  that  the  selected  entry has a comment, but you can set this
  694. pseudo-C bit to " - ", this will delete the comment.  Handle with care, it
  695. is easy to get a lot of comments gone forever in no time.
  696.  
  697.   Action -> Add Icon
  698.  
  699. Add  an  icon  to  file(s)  you  have selected.  The Icon name is given by
  700. WhatIs.library  depending  on  file  type.   BrowserII will search default
  701. icons files in ENV:Sys/ like WorkBench 2.0.  Need WhatIs.library to work.
  702.  
  703.   Action -> Check Size
  704.  
  705. Scans selected files and dirs to compute total size in bytes and blocks of
  706. all of them.  If you choose to reselect entries, context of selection will
  707. be  restored (including 'Affect subdirs') so that next action will be done
  708. on  same  files and dirs.  Directories will get their size set, until next
  709. deselection.   This way, it makes it possible, using rightmost main window
  710. jauge,  to  determine  if a list of files and dirs will fit on destination
  711. volume.
  712.  
  713.   Actions -> Delete
  714.  
  715. Deletes  the selected entries.  You will (fortunately) be asked to confirm.
  716. If  at  least  one  directory  is selected, "Delete" will delete only empty
  717. dirs,  while  "Delete  All"  will  delete non-empty selected directories as
  718. well.
  719.  
  720.  
  721.  
  722. The Requesters:
  723. ---------------
  724.  
  725. * Filters:
  726.  
  727. BrowserII tests all files against the criteria set in this requesters, and
  728. shows those for which the test is positive.
  729.  
  730.  
  731.     Files: if Y is shown, if an entry is a file, the result is
  732.            positive and the entry is displayed. If N is shown, the
  733.            files will not be displayed. If ? is shown the result
  734.            will depend on the pattern defined.
  735.  
  736.     Dirs: same thing for directories.
  737.  
  738.     Pattern: you can use ARP and/or AmigaDos conventions.
  739.              examples:
  740.              *.doc      shows only the xxxx.doc files
  741.              ~*.(o|dbg) hides the xxx.o  and xxx.dbg files
  742.  
  743.     Min Size: if the file is smaller, it is hidden
  744.  
  745.     Max Size: if the file is bigger, it is hidden
  746.  
  747.     Newer Than: shows files with more recent date than the date
  748.                 entered ( Amigados Date format )
  749.  
  750.     Older Than: same thing in the other direction
  751.  
  752.     Protection bits: shows only the files with the specified bits.
  753.  
  754.           Example:
  755.  
  756.           C H S P A R W E D
  757.  
  758.             -                hides files which have the hide bit set
  759.  
  760.                   +          shows only files with the archive bit set
  761.  
  762.  
  763. * Select Match:
  764.  
  765.     This  requester is the same as precedent one, but with one gadget more,
  766. "Affect  subdirs".   This enables you to virtually select files in selected
  767. directories.
  768.     As  we  say  in  french,  a  good example is better than a long speech.
  769. Suppose you want to clear archive bit of all files you have in a disk.
  770.     1.  Open volume's window.
  771.     2.  Call Select Match.
  772.     3.  Put Files to ? and Dirs to N.
  773.     4.  Clear all protection bits and set A to +.
  774.     5.  Switch on Affect subdirs.
  775.     6.  Validate the requester.
  776. Result: All files which have their archive bit set are selected, but any
  777. directories are selected since you set Dirs to N. Now:
  778.     7.  Hold <Shift> key while selecting all dirs of this window.
  779.     8.  Call Set Protect.
  780.     9.  Switch protection bits to:
  781.             C H S P A R W E D
  782.             _ _ _ _ - _ _ _ _
  783.     10. Validate.
  784. Et voilà!
  785.  
  786.     Each  time  you click left mouse button over a BrowserII window, if you
  787. DON'T  hold  <Shift> at the same time, the file under the mouse pointer, if
  788. any, becomes selected, all others are deselected, and Affect subdirs bit is
  789. cleared.   That  is  to  say after each operation with affect subdirs, this
  790. option  is  reset  (except  if you allways hold shift key), and must be set
  791. again if you want to do another action with this option.
  792.     Within  actions  with  affect  subdirs, if a directory pass through the
  793. filters,  the  action  will take place also on the directory itself once it
  794. has  been  examined.   But  even  if the directory doesn't pass through the
  795. filters,  it  will be entered, and files within this dir may be affected by
  796. the action.
  797.     This  is  a bit different for Copy action.  If a directory doesn't pass
  798. through  the  filters,  it won't be entered, and files within this dir will
  799. never  be copied.  But read carefully:  Empty directories may be considered
  800. useless.   So you can decide not to copy them by switching off this option.
  801. But Copy process is even more powerfull.  If for example, you decide not to
  802. copy  empty  dirs,  if  you  copy  a  directory with affect subdirs and any
  803. entries  of  this  dir  pass  through  the  filters,  the directory will be
  804. considered  as  empty and won't be created in destination path.  This makes
  805. it  possible  to  make  selective  backups,  without useless directories in
  806. destination volume.
  807.  
  808.  
  809. Jauges:
  810. -------
  811.  
  812. All windows except Alien has two jauges on their left border. The leftmost
  813. one  allways  displays  the  disk  percentage  of occupied space.  And the
  814. second  one,  to  the  right,  displays  the  directory  disk usage or the
  815. percentage  of  visible  data depending on the option you choose (See menu
  816. BrowserII->Options).
  817.  
  818. 1. Directory disk usage
  819. If this option is selected, the rightmost jauge displays the proportion of
  820. used disk space used by this directory.  For example, is you have a volume
  821. with no directories (all files are in the root directory), this jauge will
  822. say that the directory contains 100% of data present on this disk.
  823.  
  824. 2. Percentage of visible data.
  825. If this option is selected, the rightmost jauge displays the proportion of
  826. visible  data  (in blocks) in this window (If filters hide some entries of
  827. this dir, not all entries are visible !). This is usefull for example when
  828. you hide .info files, a quick look at this jauge help you remembering that
  829. some files are not visible and you should not forget them.
  830.  
  831. Jauges of main window:
  832. ----------------------
  833.  
  834. The  leftmost  jauge  of main window is a copy of the same jauge of active
  835. window.   If  the  active  window  is  the main or alien, both main window
  836. jauges are empty.
  837. The  other jauge will help you to determine if selected files would fit on
  838. active  volume  (volume  of  active  window) if a copy/duplicate operation
  839. would be performed.  Imagine you want to copy some files on a floppy disk,
  840. and  you  don't  know  if there is enough free space on this disk for your
  841. selected  files.  You can examine informations in bottom border of windows
  842. of  course  but  there  is an easier way.  Activate the destination window
  843. (without deselecting your files), and the second jauge of main window will
  844. tell  you everything:  The leftmost jauge shows the actual disk usage, and
  845. the  other  one  what  it  will  become after the copy.  Then there is two
  846. possibilities.   Your  files fit on the disk:  no problem.  Or there's not
  847. enough  free  space:   then,  the  second jauge shows of how much selected
  848. files  exceeds  disk  space  by  displaying  a dash (-).  The jauge height
  849. allways means the disk size.
  850.  
  851. Note:   In  this  release,  selected  directories  are  not  entrered,  so
  852.         BrowserII knows size of selected files only.
  853.         Block  size  between source and destination volumes are assumed to
  854.         be the same.
  855.  
  856.  
  857. Function Keys:
  858. --------------
  859.  
  860. The first five function keys have the following effects:
  861.  
  862. F1 :    UnZoom current window.
  863. F2 :    Zoom current window to see all files and dirs.
  864. F3 :    Zoom current window to see all directories only.
  865. F4 :    Iconify current window, or BrowserII if main window is active.
  866. F5 :    Opens Alien Window.
  867.  
  868.  
  869. Buffer size for copy:
  870. ---------------------
  871.  
  872. BrowserII will test wether destination and one of source concerned volumes
  873. are mounted, i.e.  one of source and destination volume are simultaneously
  874. present to the system (a diskette with a given volume name may not be in a
  875. drive), in which case BrowserII will make use of a 200 K max buffer.
  876.  
  877. If  any  source  or destination volume is mounted (you have only one drive
  878. for  instance),  BrowserII will use 880 K max for buffers if enough memory
  879. is  available.  This way, in order to copy some files from a diskette into
  880. another  one,  you  don't  need  to  go through the RAM DISK.  Buffers are
  881. allocated  during  copy,  and in any case BrowserII will not use more than
  882. 80% of the available memory for its buffers.
  883.  
  884.  
  885.  
  886. Hints and tips:
  887. ---------------
  888.  
  889. * If you hold the shift key down while closing the window corresponding to
  890.   a  volume,  all windows corresponding to directories of that volume will
  891.   close  at  once,  except  iconified  windows.   If  you  want to get rid
  892.   of iconified windows too, press SHIFT-ALT while closing window.
  893.  
  894. * In the same way, you can iconify all directories of the same volume by
  895.   'shift iconifying' a window.
  896.  
  897. * You can uniconify multiple windows at once with extended selection.
  898.  
  899. * To validate and quit a filter/select requester, press shift-return.
  900.  
  901. * The unmounted volumes appear in boldface.
  902.  
  903. * The write-protected volumes appear in italic.
  904.  
  905. * Files which have just been deleted appear in italic and are unselectable
  906.  
  907. * Simple requesters are standard req.library requesters and keyboard short
  908.   cuts are as follows:
  909.  
  910.         Left gadget     :   Y, V.
  911.         Middle gadget   :   M
  912.         Right gadget    :   N, B, Q, or ESC
  913.  
  914. * Icons  are  directories  like any other directories in standard windows,
  915.   that  is  to  say  they  support  all actions.  You can select icons and
  916.   release  them over directories, you can also use icons as destination of
  917.   a copy, or even rename or why not protect an icon.
  918.  
  919.  
  920. External command BD:
  921. --------------------
  922.  
  923. An  external  command  named  BD  is  given  with  BrowserII.   This is an
  924. interface between shells and BrowserII.  Running BD with no arguments will
  925. run  BrowserII  if it is not yet running, and make BrowserII open and scan
  926. your   current  shell  directory.   You  can  also  specify  one  or  more
  927. directories as argument to BD.
  928. BD has now 3 optional argument:
  929.   Note:   BrowserII  must  be in your shell Path if it is not yet running.
  930. BD  can  also  be run from workbench.  If you double-click on the Tool BD,
  931. BrowserII  will  open  the directory containing BD.  But you can also have
  932. project  icons with BD as default Tool.  In this case, if your project has
  933. no  Tool-Types, the current dir will be open, otherwise, you can edit your
  934. project  Tool-Types,  and  specify  as  many directories as you want.  You
  935. should  also specify in the BD Tool Tool-Types the full path to BrowserII,
  936. that is to say in which directory you have BrowserII.
  937.  
  938. In example given, BrowserII should be in SYS:Utilites directory.
  939.  
  940. Now, BD has 3 more flags.
  941.  
  942.     Template:   Dirs/...,RESCAN/s,ZOOMALL/s,ZOOMDIRS/s
  943.  
  944.     RESCAN:  Allways scans dir. Even if already open.
  945.     ZOOMALL: Zoom window, even with AutoZoom is not active.
  946.     ZOOMDIRS: Same as ZOOMALL, but for dirs only.
  947.  
  948.  
  949. Release notes:
  950. --------------
  951.  
  952.     1.0:    First Release   (30-jul-91)
  953.  
  954.     1.1:    Bug fixes.
  955.             Added DiskCopy ability.
  956.             Moving a device over another device calls SYS:System/DiskCopy,
  957.             and Duplicate a single device too.
  958.             Cli arguments are now quoted only when needed.
  959.             A lot of little invisible improvements.
  960.  
  961.     1.11:   Bug fixes.
  962.             With parm.library 3.4 and higher, RUN modes work under 2.0. 
  963.  
  964.     2.0:    Iconification, Zoom, Jauges, Workbench 2.0 look (under 2.0),
  965.             Parametrable Fonts, ASynchronous dir scan, and bug fixes.
  966.             External command BD.
  967.  
  968.     2.03:   Minor bug fix.
  969.  
  970.     2.04:   "Copy->Move" bug fix. (won't delete source file)
  971.  
  972.     2.05:   Bug Fix: A CurrentDir was missing which can cause crash,
  973.                      bug in copy when skiping big file. Removed trash of
  974.                      prop gadget with autozoom under 2.0
  975.  
  976.     2.10:   29/5/1992
  977.             Optional  WhatIs capability:  reconized some file (ILBM, PPDATA,
  978.             doc,...), You can define new type ( see docs of WhatIs.library).
  979.             Auto command (custom command for each filetype ).
  980.             BrowserII   can   work   without  WhatIs.library.
  981.             AddIcon  and  CheckSize  action added, Back pattern option added
  982.             (KS2.x  only),  should  be custom in future.  Optional automatic
  983.             main Zoom.  Optional save Main window size/position
  984.             BD has now 3 new option.
  985.  
  986.     2.11    RunMode was not printed in GetString() title bar when double
  987.             clicking on a file. fixed.
  988.             When changing Sort mode for a window, window was not updated.
  989.             fixed.
  990.  
  991.     2.12    RunMode on double-click was always Shell with WB 2.0. fixed.
  992.             After closing a window, check-marks for new current window
  993.             was not udated. fixed.
  994.             WBToFront now supported for WBRun too.
  995.             A TAG_DONE was missing for backdrop window open (Pattern Option)
  996.  
  997.     2.13    Minor bug fix (discovered while debugging V2.20).
  998.             Do not expect something more under 1.3.
  999.             V2.20 is now ready, and we will never get back to 1.3.
  1000.             1.3 is dead for us now.
  1001.  
  1002.             ****************************************************************
  1003.             *           THIS IS THE LAST KICKSTART 1.3 VERSION !           *
  1004.             ****************************************************************
  1005.  
  1006.  
  1007. Futur Plans:
  1008. ------------
  1009.  
  1010.     Have a look at special KS 2.04 or higher version.
  1011.  
  1012.  
  1013. ShareWare / distribution :
  1014. --------------------------
  1015.  
  1016. BrowserII  and ParM are both shareware.  If you use them consistently, you
  1017. ought to send us a contribution or your conscience will itch.
  1018.  
  1019. Any  contributor  for at least 100 French Francs (about $20) will become a
  1020. registered user and will automatically receive one non-demo update.  Don't
  1021. fail  to  mention  the  version number of your copy.  If there is no newer
  1022. version,  you  will  be  put  on a list and receive one update whenever it
  1023. becomes  available.   For US people, please, send banknotes, no checks nor
  1024. mandats.
  1025.  
  1026.  
  1027. Many thanks to:
  1028.  
  1029. ASDG for CED (a fantastic editor)
  1030. W.S. Hawes for ARexx.
  1031. Pierre Ardichvili for his kindness and his support to the Amiga
  1032.  
  1033.  
  1034.  
  1035.                                     Sylvain Rougier and Pierre Carrette.
  1036.  
  1037.  
  1038.  
  1039. Send donnations and bug reports to:
  1040. -----------------------------------
  1041.  
  1042.         Sylvain Rougier
  1043.         39 rue Carnot
  1044.         86000 Poitiers
  1045.         France.
  1046.  
  1047.  
  1048. Don't forget to give your version of BrowserII and system 1.3 or 2.0.
  1049.  
  1050.