@database "BrowserII.guide" @author Pierre Carrette & Sylvain Rougier #$VER: BrowserII.guide V3.3 (04.03.95) @node Main "BrowserII V3.0 Documentation" Welcome to @{b} BrowserII @{ub} The @{i}other@{ui} File Manager! Version 3.03 Copyright © 1991-94 Pierre Carrette & Sylvain Rougier. Icons & Graphics by Walter Dörwald. @{" READ THIS FIRST! " Link "Read this first" } @{" System requirements " Link "System requirements"} @{" Installation " Link "Install" } @{" Introduction " Link "Introduction" } Start reading this. @{" Features " Link "Features" } Most important features @{" The history " Link "History" } Why did we rewrite the original Browser @{b}Using BrowserII@{ub} @{" Running BrowserII " Link "Running" } Tooltypes and WBStartup drawer support. @{" Basic knowledge " Link "BasicKnowledge" } You MUST know that. @{" Common problems " Link "CommonProblems" } Frequently asked questions. @{" Directory Tree " Link "Tree" } Opening and using tree windows. @{" Archive Support " Link "ArchiveSupport" } Displaying archive contents. @{" Zooming windows " Link "Zoom" } Maximize window size. @{" Snapshoting windows " Link "Snapshots" } Saving window properties. @{" Iconify " Link "Iconify" } How works iconification in BrowserII. @{" Network / Multiuser " Link "Network" } Network and MuliuserFS support. @{" Standard Menus " Link "Menus" } Builtin menus usage. @{" Mouse and Keyboard " Link "Keyboard" } Summurize important keys/qualifiers. @{" Jauges " Link "Jauges" } Windows' jauges usage. @{" Select Requester " Link "SelectRequester" } Criteria file selection/filtering. @{" FileExist Requester " Link "FileExistsRequester"} Important and often used requester. @{" Commodity " Link "Commodity" } Poping up BrowserII with a hotkey. @{" Workbench Support " Link "WorkbenchSupport" } AppIcon & AppWindows. @{" External Command BD " Link "ExternalCommandBD" } Opens dirs from a shell. @{b}Configuration@{ub} @{" User Menus " Link "BrowserII.menu" } Creating user menus. @{" Command Hot keys " Link "CmdHotKeys" } Running commands by hot keys. @{" Auto Commands " Link "AutoCmds" } Commands associated to File Types. @{" File Types " Link "whatis.library" } Creating new File Types. @{b}Miscellaneous@{ub} @{" Changes since v2.x " Link "Changes" } v2.x users MUST read this. @{" Release Notes " Link "Release Notes" } Features history since v1.0. @{" Future Plans " Link "Future Plans" } What will be the next versions... @{" Getting Updates " Link "Updates" } Where and how to get new versions. @{" Copyright " Link "Copyright" } Pierre Carrette & Sylvain Rougier! @{" Registration " Link "Registration" } Why registering and how. @{" Bug reports " Link "Bug reports" } Found some bugs ? @{" Acknowledgements " Link "Acknowledgements" } We wish to thank... @{" Disclaimer " Link "Disclaimer" } Be warned! @endnode @node "Read this first" "BrowserII.guide/Read this first" Please read this ~~~~~~~~~~~~~~~~ Please, even if you hate reading documentations, read at least the following pages, @{"Introduction" Link Introduction}, @{"Features" link Features} and @{"Basic knowledge" link BasicKnowledge} or you will miss some important things in BrowserII. These chapters are small. It will take you just a few minutes to read them. For users of BrowserII v2.x, read important @{Changes link Changes} from v2.x to v3.0. @endnode @node "System requirements" "BrowserII.guide/System requirements" System requirements =================== BrowserII requires version 2.0 of the Amiga operating system or higher. To get a full featured BrowserII, you should also install the @{"whatis.library" link "whatis.library"}, and the @{"ObjectArchive" link ArchiveSupport} package. @endnode @node Install "BrowserII.guide/Install" Installation ============ BrowserII is distributed together with an Installer script, therefore making installation a breeze! Just double-click on the 'Install-BrowserII' icon and the installation procedure is on it's way. @endnode @node Introduction "BrowserII.guide/Introduction" Introduction ============ BrowserII is a multi-window file manager, ie it is not limited to two scrolling lists! This also means that you can see ALL informations about a file (several files), size, date, time, protection, file type, comment,... without horizontal scrolling! No need to select a file to follow it horizontaly! It works like Workbench. Copy files by dragging and dropping them over the destination directory. But BrowserII is not only a usual file manager. Most people use both a shell and a file manager depending on the work they are doing. BrowserII is also a tool making life easier in a shell-like environement. Where to you spend most of your time in a shell ? Typing file names ? You then think than file completion is the best help ? YOU ARE WRONG! Imagine that BrowserII is a shell. In each window, you have a directory displayed, so that all files are immediately selectable. You then want to execute a command in one of these. In a shell, what would do ? Change the current dir, by CD'ing several times ? How long does it take ? Now consider your directory is here, just in front of you. Activate the window, your 'CD' is done. Select the desired file(s), and then press 'E' key. A requester appears asking you to complete the command. Press return... Quick no ? Even better: You use some commands quite often ? Create a menu with a shortcut or a more sophisticated hotkey. Select the files, press your hotkey, et voila! For example, I have, Make, BumpRev, CPR, Diff, Indent,... menus, making my developpement environement a dream! I can work on different developpement directories at the same time, without typing even a single shell command! See the last menu named "C" of my @{"BrowserII.menu" link //BrowserII.menu-example/Main} configuration file subset. As a last word for this introduction, know that we use BrowserII all the time, for every thing. We (Sylvain and I) even don't load Workbench at boot time! Funny isn't it? ;-) That's why one of the next BrowserII features will be icon display, the only reason why we (sometimes!) run Workbench. See the @{"Features" link Features} page for a complete detailed list of features. @endnode @node Features "BrowserII.guide/Features" Features ======== Some features of BrowserII makes it a different and powserfull file manager. - It is @{b}Asynchronous@{ub}. Several (unlimited) operations can be performed at the same time. Copying files, deleting others, running tools, scanning directories, all at the same time! - It has a finder-like @{"directory tree" link Tree}. Examine the whole contents of a floppy disk by just a double click! - Powerfull copy and other dos operations. - Full @{"Network / MultiuserFileSystem" link Network} support. - It has the most powerfull @{"archive support" link ArchiveSupport} using @{b}ObjectArchive@{ub} system. - Hard and soft links support. - Proportionnal font support allowing to nicely display lots of informations about files in less space. - Device list with volume statistics. - And it is @{b}small@{ub}. About 150 KBytes including its libraries. @endnode @node "History" "BrowserII.guide/History" History ======= We wrote BrowserII after having used for 2 years the original Browser (version 1.6a) written by Peter Da Silva. We were not fully satisfied because of some of its limitations so, as soon as we felt capable of writing a program which would overcome those limitations, we made a decision to do it. So BrowserII was born... The Return ! We felt the overall layout and display mode of Browser were very good, so we decided to keep them, as well as the name, so that actual users of Browser would immediately feel home with BrowserII. As we never had the sources of Browser at hand, we rewrote it from scratch. A few months ago, I had a chat with Peter, who discovered our piece of work. It was really exciting to speak (by email) with our spiritual father ;-) So, if you read this, Hello Peter! @endnode @node Running "BrowserII.guide/Running BrowserII" Running BrowserII ================= BrowserII can of course be run just like any other tool. But you should take care to run it from an environnement that makes it inherit your defaut shell Path, so that it can run commands without problems. It can also be run through the @{"BD" link ExternalCommandBD} separate command. If you want to start browser from your WBStartup drawer, you may create a Project icon with default tool set to BrowserII if browser is in your path, or to the full path to browser. The installation procedure will do it for you if you want. There are some optionnal tooltypes: APPICON (default is "BrowserII") ICONXPOS (default is 'NOICONPOSITION') ICONYPOS (default is 'NOICONPOSITION') If you set APPICON=NONE, the only way to uniconify is to use {"hotkey" link Commodity} or Commodities Exchange utility. See {"Commodity" link Commodity} for other tooltypes. @endnode @node BasicKnowledge "BrowserII.guide/Basic knowledge" Basic knowledge =============== First of all, you should read the @{"Introduction" link Introduction} chapter. When you first start BrowserII, you get just a simple window, called the @{b}Main@{ub} window, which contains the dos device list, ie, by default, the list of mounted volumes and assigns. To adapt the contents of this window, use the BrowserII/@{"Device List" link DeviceListSub} submenu. Window bottom border informations ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Main window ~~~~~~~~~~~ When the active window is a directory or @{"tree" link Tree}, volume informations appear in the bottom border of the main window. If the volume is write protected, thoses informations appear in italic. If the main window or alien window is active, the bottom border of the main window contains the statistics about selected files. Directories / Trees ~~~~~~~~~~~~~~~~~~~ In the bottom border of windows appear: - If no entries are selected The total statistics about window contents - If some entries are selected The selection statistics for that window BrowserII makes a heavy usage of menus. It is the best way to preserve most of the screen space available to display directories contents. Compared to other files managers, BrowserII does not have button panels. This will change in a next release as docks are planned using toolmanager. A lot of people complains that BrowserII opens too many windows. Now, the directories have the @{"Auto-Iconify" link WindowOptionsSub} feature set by default. Then, you get new windows only when you open a new volume. Reset this option to @{"Keep Window" link WindowOptionsSub} if you prefer the old method which consists in opening a new window each time you open a directory. Selecting files ~~~~~~~~~~~~~~~ File selection in BrowserII works like in Workbench. Selecting a file by default deselects all other selected files. To perform extended selection, you must hold the shift key while selecting files. See also @{"drag selection" link DragSelection}. For those of you, lucky owners of a @{"3 Buttons Mouse" link ThreeButtonMouse}, there is a special support in BrowserII. Copying files ~~~~~~~~~~~~~ File Copying works like Workbench too. Select your files, and while holding the left mouse button (LMB) pressed, release the shift key, drag the files over the target directory, and release the LMB. The @{"copy process" link CopyProcess} is run in the background living BrowserII available for other operations. Current Directory ~~~~~~~~~~~~~~~~~ The notion of current directory is one of the most important things you must know about BrowserII. It is the base knowledge for a powerfull usage. The current directory only has meaning when running shell commands. Shell commands can be run either with the BrowserII/@{"Execute..." link ExecuteItem} menu item, or with a @{"user configured menu" link BrowserII.menu} in RUN or SHELL mode, or by double-click'ing on an executable file that has no associated icon. See the @{"Extract example" link CommonProblems} for an example usage of the current dir notion. @endnode @node DragSelection "BrowserII.guide/Drag selection" Drag selection ============== To quickly select a list of files, press the shift key, select the first file by pressing the left mouse button (LMB) over it, and then, without releasing the LMB, move the mouse over the other files. Reaching the bottom or the top of the window will scroll the list. Once the files are selected, you may then want to drag them over the target directory. Release the shift key (but not the LMB). The mouse pointer then change to a crosshair. Drag the mouse, and release the LMB. There is another possible method to drag select files if you have a @{"3 Buttons Mouse" link ThreeButtonMouse}. The MMB then replaces the shift key. It works the same way. @endnode @node ThreeButtonMouse "BrowserII.guide/3 Buttons Mouse Support" 3 Buttons Mouse =============== For lucky owners of a 3 button mouse, some goodies are available. For most of the features, the mid button acts like the shift key, so it may not conflict with utilities that does MMB-Shift. By the way, some of those commodities are not programmed with care and may disable or conflicts with some MMB features of BrowserII. You'll have to make choice! - Extended Selection hitting MMB or LMB with MMB Pressed. - Pressing MMB then LMB enables drag selection. - MMB DoubleClick on a dir toggles @{"Auto-Iconify" link WindowOptionsSub} mode: - if AutoIconify is on, MMB DoubleClick opens a new window - if AutoIconify is off, MMB DoubleClick opens the new dir in the same window. - Dragging files with MMB toggle the copy/move mode. (If 'Always Copy' on, MMB always move, else MMB always copy) - Pressing MMB & Hit Close-Gadget closes all directories for the volume - The same for Iconify Gadget. @endnode @node CopyProcess "BrowserII.guide/Copy Process" Copy Process ============ When copying files, BrowserII will check wether destination and one of the source concerned volumes are mounted, i.e. one of source and destination volumes are simultaneously present in their drives (a diskette with a given volume name may not be in a drive). When copying several files and/or directories, BrowserII always copy icons first, so that further Workbench directory scans will be faster. If any source or destination volume is mounted (if you have only one drive for instance), BrowserII will use a maximum of 1024 KBytes for copy buffers if enough memory is available. This way, in order to copy some files from a diskette to another one, you don't need to go through the RAM Disk. Buffers are allocated during copy, and in any case BrowserII will not use more than 80% of the available memory at copy startup time for its buffers. This size of 1024 KBytes allows to copy a single DD diskette in a single step, even in PFS format. If both destination and source directories are mounted, the buffer size will not exceed 512 KBytes. @endnode @node MenusColors3.0 "BrowserII.guide/Note about menus colors with WB 3.0" Note about menus colors with WB 3.0 =================================== For people who have AmigaOS 3.0 or 3.1 and have 8 or more colors in their Workbench Screen, you should read this note. In WB 3.x preferences, you can edit the color pens of the screen's titlebar and menus. If you have a 8 or more color workbench, then you edit these pens using the MultiColored palette. If you don't use standard pens, (Black text on white background), and you run BrowserII in it's own screen, you won't get the same colors for BrowserII's menu. To get the same colors, you have to edit the pens in the system preferences in 4 color mode, since until now, BrowserII screen is a 4 color screen. THERE IS 2 INDEPENDENT PREFERENCES IN THE SYSTEM FOR PENS. Modifying the 4 color pens will not modify the layout of your 8+ color workbench, but will modify BrowserII's. @endnode @node CommonProblems "BrowserII.guide/Common problems" Common problems =============== This chapter summerize the most frequently asked questions. @{b}Extracting Archives@{ub} in a particular directory. BrowserII comes with a shell script named "Extract" which detects the format of an archive and then calls the appropriate archiver to extract the archive. Usage of this script in BrowserII is straight forward. @{"Create a Menu Item" link BrowserII.menu} like follows: ITEM {Z} Extract RUN Extract [] It is a good idea to put a shortcut for this menu as it is often used. Here, it is Amiga-Z, or just 'Z' if you set your @{"SHORTCUTQUAL" link BrowserII.menu} to "". Then, select the archive to extract, activate the target directory window, and press Amiga-Z, or 'Z'. That's it! See the @{"BrowserII.menu example" link //BrowserII.menu-example/Main} for a more featured Extract menu item. @{b}Giving several arguments to a shell command that accept only one@{ub} Use the shell command @{"For" link For.doc/Main} given with BrowserII. Example: ITEM {Z} Extract RUN For [] DO Extract %% @{b}The colors of my title bar is not the same as Workbench's@{ub} See @{"Menu colors under AmigaOS 3.0" link MenusColors3.0}. @endnode @node Tree "BrowserII.guide/Directory Tree" Directory Tree ============== BrowserII can display a whole directory hierarchy in a single window. It has a finder-like layout, with little arrows allowing to fold directories. You can also @{"(un)fold all" link TreeSub} directories in a single keystroke. Scan is reasonably fast in @{"turbo mode" link WindowOptionsSub}, depending on the filesystem. You can open trees with only the directories, or all directories and files. Note that you can open a tree with files and filter out files from display using the appropriate window filters settings. But opening a directory tree without files uses much less memory and system overhead. Trees are not limited in the files and directories they can display. I could open a tree with files on a cdrom with 2000 directories and over 36000 files without problems. By the way, it used about 4 MBytes of RAM !!! Opening Trees ~~~~~~~~~~~~~ Tree with files: Ctrl-Double-LMB MMB-Double-LMB Tree without files: Shift-Ctrl-Double-LMB Future ~~~~~~ In a future release, it will be possible the convert a directory window in a tree window, using "Window/Open/Make Tree" menu. As only the first level directory will be read, subdirectory scan will be performed on directory unfold. Selecting files in directory trees ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Imagine the following directory structure: include (dir) dos (dir) dos.h dosextens.h libraries (dir) gadtools.h iffparse.h intuition.h Selecting "iffparse.h" and dropping it in another directory would just copy it as usual. But now, select both "iffparse.h" and "include", and drop them in the target directory. This will create the following structure: include (dir) libraries (dir) iffparse.h This makes it possible to copy only a part of a directory structure with keeping the structure. Selection rule ~~~~~~~~~~~~~~ When a directory in a tree is selected, two situations are possible. - The directory contains selected subentries Then only the selected subentries will be processed on next action. - The directory @{b}does not@{ub} contains selected subentries The whole directory (with its contents) will be processed if the action is naturally recursive, such as copy or delete. @endnode @node "ArchiveSupport" "BrowserII.guide/Archive Support" Archive Support =============== BrowserII can automagically display the contents of an archive in a window, just like if it was a normal directory. To make this feature functionnal, you must get the separate @{b}ObjectArchive@{ub} package. BrowserII then mounts the archive, and opens a directory or directory tree window, depending on the qualifiers used, just like for standards directories. If you want to override this mechanism for some archive types (in case your have another better archive handler ;-), you can use an @{"autocmd" link Autocmds}. This also means that if you want an archive type to supported by ObjectArchive feature in BrowserII, you must remove the autocommand for this type. @endnode @node Zoom "BrowserII.guide/Zoom" Zoom ==== Zooming a window consists in showing as much information as possible about window contents. Priority is always given to height first. If it is not possible to display all files in one column, then BrowserII will attempt to display the less possible columns to show all files. If it is not possible within the bounds of the screen, window size will be rounded to the nearest width and height so there's no screen space lost. Zoom can be performed automaticaly in response to some events in BrowserII. See the @{"AutoZoom" link AutoZoomSub} submenu in "Window" menu. It can also be performed upon user request: by a menu selection or shortcut or by the two zoom gadgets. These gadgets are invisible. The first one is the Zoom gadget and is the top half of the jauges, while the second one is the UnZoom gadget and is the bottom half of the jauges. Note: ~~~~ If you ask for a zoom while the directory to be zoomed is currently scanning, the zoom is defered at the end of scan. Constraints ~~~~~~~~~~~ Window zoom can be size constrained. Maximum size ~~~~~~~~~~~~ If you don't want your windows to fill most of the screen, you may want to limit the maximum window size for a zoom operation. Maximum Width and Height can be set separatly. Minimum size ~~~~~~~~~~~~ Some of your windows are too small, or you want more columns... Capture a minimum window size. Example: You want your main window (the one with the device list) to be displayed with three columns, but you want it to be autozoom. Enlarge it to 3 columns manualy or by using the @{"Window/Zoom/Wider" link ZoomSub} menu item, and snapshot the @{b}Min Width@{ub} of the window. Then, next zooms will keep at least the captured width, making the window wider and less high. To capture the sizes of a window, use the @{"Window/Properties/Snapshot" link Snapshots} menu item. Wether a window has size contraints or no, the zoom window sizing method explained before apply. In fact, the default size constraints of a window is the size of the screen. Limiting the window size to the visible part of a virtual screen ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you use BrowserII in a virtual screen, the zoomed windows may be larger than the size of the visible part of the screen. To prevent this, size a window to the size of the screen visible part, and @{"snapshot" link Snapshots} the window width and height as default for Directories, Trees, and Trees with files. Overriding Constraints ~~~~~~~~~~~~~~~~~~~~~~ Sometimes, you want to override the default contraints you set to window. To do that, Control-Click on the Zoom Gagdet of the window (hidden in the top half of the jauges). This will zoom the window with the screen size as bounds limits. As a more general usage, Ctrl-«Zoom» overrides contraints. This is true for zoom function keys,... WARNING: ~~~~~~~~ Do not snapshot a default position or all windows will open at the same place! @endnode @node Snapshots "BrowserII.guide/Snapshots" Snapshots ========= The concept of window snapshot is well known as it exists in the Workbench. But Window snapshot in browserII is even more powerfull. You can not only snapshot the size and position of the window, but also other local properties. Preferences may not be limited to the window, but to a whole volume, device, or as default preferences for all windows. Using snapshot ~~~~~~~~~~~~~~ When asking a window snapshot, a big requester appears, with lots of options. You are then prompted to select the information you want to freeze. @{b}Important:@{ub} You may save @{u}only the options that differs@{uu} from the default settings. When you open a window, BrowserII follow these rules to get window settings: Opening of a root directory: - Obtain default settings. - Obtain device settings that overrides previous ones. - Obtain volume settings that overrides previous ones. - Obtain directory settings that overrides previous ones. Opening of a window subdirectory: * If the @{b}parent window@{ub} has the @{"local properties" link WindowOptionsSub} option set, the rule is the same as for root directories. * Else: - Obtain settings of the parent directory. - Obtain directory settings that overrides previous ones. Example: You may want to set default values for a particular device and/or volume so that each directory open relative to it would get those settings. Then, imagine you want to snapshot a particular directory on this volume. You should snapshot only the properties that defers from default values (checked by default). This way, if you change one of the volume defaults, even snapshoted directories will inherit the new defaults. Snapshots databases ~~~~~~~~~~~~~~~~~~~ The snapshot files are created in the BrowserII's home directory, in the subdirectory "Snapshots". They all have a file comment that summerize their contents. No data is written into the directory. This won't fill your disks of annoying files, and allows to snapshot directories in write protected disks and cdroms. The default preferences for all windows (dirs, trees, alien and main window) are stored in "Snapshot-0". All other files are numbered from 1 to .... There is one file for each device defaults (includes dir, and trees defaults), and one file for each volume (includes dirs default, trees defaults, and local dir/trees snapshots). The file comments then says for example "Snapshots for device DF0:" Note that volumes are remembered by name and datestamp. This makes impossible to snapshot variable datestamp volumes, since they will always be identified as different volumes. This is the case of RAM Disk for example. To remove a snapshot, you may 'UnSnapshot' using the menu item in the Window/Properties submenu. Then, you get again the snapshot requester with, by default, the local directory snapshotted settings set. If you did snapshot a directory that no more exists, you are not actually able to remove it from browserII's snapshot databases. This will be possible with the future preference editor. The only way to remove old snapshots is to delete a snapshot file! It's not so silly, it's sometimes usefull and easy. @endnode @node Iconify "BrowserII.guide/Iconify" Iconify ======= BrowserII Iconification ~~~~~~~~~~~~~~~~~~~~~~~ BrowserII can be iconified, so that it closes all its windows, and its screen if it has its own custom screen. However, there must not be any visitors window open in BrowserII's custom screen, if any. Otherwise, it will complain about. But it is possible to iconify BrowserII while some background jobs are active. The status windows, if open, will be closed, and will continue to process silently. To iconify BrowserII, hit the little arrow in the left border of the main window, just below the title bar. You can also activate the main window, and hit 'F4' key. Uniconifying ~~~~~~~~~~~~ Several methods are possible to uniconify BrowserII. - Double click on it's @{"AppIcon" link Running} if any. - Hit it's @{"hotkey" link Commodity}. - Use Commodities Exchange. - Run @{"BD" link ExternalCommandBD}. Directory/Tree windows Iconification ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BrowserII directory and directory tree windows can be iconified too. Using window iconification, you keep directory contents in memory, then preventing reading them again on next access. To iconify a directory, hit the little arrow in the left border of the window, just below the close gadget, of hit 'F4' key after activating the window. You can iconify all directories of the same volume by 'shift iconifying' a window. Once iconified, directories appear in the Alien window. Let's call @{i}icons@{ui} the entries of the alien window. Alien Window can be open using F5 or menu "Window/Open/Alien Window". Icons are directories like any other directories in standard windows, that is to say they support all actions. You can select icons and release them over directories, you can also use icons as destination of a copy, or even rename or why not protect an icon. Note ~~~~ The Alien window is called Alien because it was intended to contain different kinds of entries such as leave-outs and aliases. At this moment, it is not yet implemented. @endnode @node Network "BrowserII.guide/Network and MultiuserFileSystem support" Network and MultiuserFileSystem support ======================================= BrowserII supports all multiuser / network packages that provides a standard accounts.library. This actually the case for Envoy, MultiUserFileSystem, and AS225. This support means ability to display file Owner/Group names, and protection bits, as well as modifing these attributes. For display, select from the menu Window/File Infos, Protection, Owner, and Group. Protections bits are composed of owner bits, and, if "Group" is on, group protection bits as well as group name, and, if "Owner" is on, 'others' protection bits as well as Owner name. To modify protection bits, use the Set Protect action. To change owner, use Set Owner action. @endnode @node Menus "BrowserII.guide/Menus" @{"BrowserII " link "BrowserIIMenu" } @{"Window " link "WindowMenu" } @{"Actions " link "ActionsMenu"} @{"Update menus " link "UpdateMenusItem" } @{"Rescan " link "RescanItem" } @{"Rename " link "RenameItem"} @{"Last Error " link "LastErrorItem" } @{"Open >>" link "OpenSub" } @{"Make Dir " link "MakeDirItem"} @{"Execute " link "ExecuteItem" } @{"Zoom >>" link "ZoomSub" } @{"Duplicate " link "DuplicateItem"} @{"Screen >>" link "ScreenSub" } @{"Tree >>" link "TreeSub" } @{"Set Date " link "SetDateItem"} @{"Screen Font >>" link "Fonts" } @{"Select Match " link "SelectMatchItem" } @{"Set Comment " link "SetCommentItem"} @{"Window Font >>" link "Fonts" } @{"Select All " link "SelectAllItem" } @{"Set Protect " link "SetProtectItem"} @{"Run Mode >>" link "RunModeSub" } @{"Filters >>" link "FiltersSub" } @{"Set Owner " link "SetOwnerItem"} @{"Copy Mode >>" link "CopyModeSub" } @{"File Infos >>" link "FileInfoSub" } @{"Add Icon " link "AddIconItem"} @{"Copy Flags >>" link "CopyFlagsSub" } @{"Sort By >>" link "SortSub" } @{"Check Size " link "CheckSizeItem"} @{"Device List >>" link "DeviceListSub" } @{"AutoZoom >>" link "AutoZoomSub" } @{"Information " link "InformationItem"} @{"Options >>" link "OptionsSub" } @{"Options >>" link "WindowOptionsSub"} @{"Delete " link "DeleteItem"} @{"Save Config >>" link "SaveConfig" } @{"Properties >>" link "PropertiesSub" } @{"Quit " link "QuitItem" } @endnode @node BrowserIIMenu "BrowserII.guide/BrowserII Menu" BrowserII Menu ============== All the options set in this menu can be saved using the "Save Config" item. The options set in the "Window" menu are discussed later in this chapter. @endnode @node UpdateMenusItem "BrowserII.guide/Update Menus" Update Menus ============ Reloads the @{b}User Menus@{ub} @{"configuration file" link "BrowserII.menu"}. @endnode @node LastErrorItem "BrowserII.guide/Last Error" Last Error ========== This will show you the last message which appeared in screen title bar. @endnode @node ExecuteItem "BrowserII.guide/Execute..." Execute... ========== Pops up a requester allowing to enter a shell command. The command is initialised with the selected files (if any), else it will be the last executed command using this menu item. Important: ~~~~~~~~~~ The command is executed in the directory of the active window. For example, entering the command "Dir" (silly! ;-), the output will be different depending on the active window. @endnode @node ScreenSub "BrowserII.guide/Screen Options" Screen Options ============== @{b}Public Screen @{ub} BrowserII opens its windows in the selected public screen @{b}Custom Screen @{ub} BrowserII opens its own screen (which is @{"public" link PublicScreen} too) @{b}Workbench Colors @{ub} Clones the colors of the Workbench screen. @{b}Custom Colors @{ub} Adjust colors with a color requester. @{b}Backdrop pattern @{ub} Install a grey pattern in the screen. @{b}Backdrop image @{ub} Not yet implemented! @{b}Public Screen@{ub} pops up a requester showing the list of available public screens. If you plan to save this preference, you must choose a screen which may be available each time you run BrowserII. Else, il will fall back to Workbench screen. There is a special public screen which is called «frontmost» screen. Used in conjonction with a @{"hotkey" link Commodity}, browser will popup in the current screen. @endnode @node PublicScreen "BrowserII.guide/Public Screen" Public Screen ============= BrowserII's own screen is made public and is named "BrowserII". Take care, public screen names are case-sensitive. For example, you can open a console in the BrowserII screen with the following syntax: "CON:0/11/640/100/Window Title/CLOSE/WAIT/AUTO/SCREEN BrowserII" This console has defered open (AUTO), will also have a close gadget (CLOSE), and will wait for you to hit close gadget before closing (WAIT). Note that if another public screen with the same name exists, BrowserII will name its screen BrowserII0, then BrowserII1,... (this can happen if you have the strange idea to run BrowserII twice)! @endnode @node Fonts "BrowserII.guide/Fonts" Fonts ===== @{b}Default Font@{ub} Use the defaut font @{b}Custom Font@{ub} Selects a special font for screen and or windows Proportional fonts are handled for both screen and window text. @endnode @node RunModeSub "BrowserII.guide/Run Mode" Run Mode ======== This submenu determine the mode to use to run the file you double-clicked. If other files were selected at the time of the double-click, their names become parameters for the double-clicked file. If the file has an icon, and is not filtered out by an auto-command or mounted as an archive, it will automatically be run in Workbench mode. Also note that BrowserII does a CD into the active window before running a command, whether you have double-clicked on a file, or activated it through a menu selection. This is often VERY useful. @{b}RunBack @{ub} Run in background (input and ouput set to "NIL:") @{b}Shell @{ub} Use SHELLWIN console for program input/ouput @{b}Request @{ub} Pop up a requester to modify/confirm operation. @{b}WBToFront@{ub} Brings Workbench screen to front when running program. @endnode @node CopyModeSub "BrowserII.guide/Copy Mode" Copy Mode ========= @{"Context " link ContextItem} @{"Always Copy " link AlwaysCopyItem} @{"Always Move " link AlwaysMoveItem} @{"Link " link LinkItem} @{"As... " link AsItem} @{"Request " link CopyRequestItem} @{"Update " link CopyUpdateItem} @{"Don't overwrite files " link DontOverwriteFilesItem} @{"Ask before Overwrite " link AskBeforeOverwriteItem} @{"Backup replaced files " link BackupFilesItem} @{"Copy Empty Dirs " link CopyEmptyDirsItem} @{"Copy Hierarchy " link CopyHierarchyItem} @endnode @node ContextItem "BrowserII.guide/Context" "Context" Copy Mode =================== If destination and source directory are located one the same volume, the file (or directory) will be moved. Else, it will be copied. @endnode @node AlwaysCopyItem "BrowserII.guide/Always Copy" "Always Copy" Copy Mode ======================= BrowserII will systematically make a copy of the file. @endnode @node AlwaysMoveItem "BrowserII.guide/Always Move" "Always Move" Copy Mode ======================= BrowserII will always move the file. If destination and source directory are on different volumes, the file will be copied to the destination directory and the source file deleted if the whole copy is successfull. @endnode @node LinkItem "BrowserII.guide/Link" "Link" Copy Mode ================ Rather than copying/moving a file or directory, this will create a link. If destination and source directory are on different volumes, BrowserII will create a soft link, else, a hard link. Note 1: ~~~~~~~ Links are an advanced features of an operating system and should be used with care. Note 2: ~~~~~~~ Soft links are not officialy supported by the actual AmigaOS (even 3.1). So, be prepared to encounter problems using some. @endnode @node AsItem "BrowserII.guide/[...] As..." "[...] As..." Copy Mode ======================= "As..." is an attribute for all previous choices in this submenu. If set, you will be prompted to enter a new file name for every files. @endnode @node CopyRequestItem "BrowserII.guide/Request Copy Mode" "Request" Copy Mode =================== You'll asked if you want to move, move as, copy, copy as, or create a link before the drop operation takes place. If you don't want to be requested each time you want to copy / move some files, you may use the Context or Always Copy or Always Move option. Then, if you want to perform a different operation as the default, your can press the Control key before dropping the files. This will force the request mode, and then allow to chose Copy As or Move As for example. @endnode @node CopyUpdateItem "BrowserII.guide/Update" "Update" Copy Mode ================== BrowserII will copy the file only if the source file is more recent than the destination file, or if the destination file does not exist. @endnode @node DontOverwriteFilesItem "BrowserII.guide/Don't overwrite files" "Don't overwrite files" Copy Mode ================================= BrowserII will not overwrite an existing file. If there exists a destination file with the name you gave for the destination, the copy will not be performed. @endnode @node AskBeforeOverwriteItem "BrowserII.guide/Ask before Overwrite" "Ask before Overwrite" Copy Mode ================================ BrowserII asks for confirmation before overwriting. This option is naturally mutually exclusive with the former one. @endnode @node BackupFilesItem "BrowserII.guide/Backup Replaced Files" "Backup Replaced Files" Copy Mode ================================= Each time a file to be copied/moved already exists, the existing file will be renamed to ~. If ~ already exists, it is deleted first. @endnode @node CopyEmptyDirsItem "BrowserII.guide/Copy Empty Dirs" "Copy Empty Dirs" Copy Mode =========================== This option will enable to re-create empty directories in the destination directory. It is particularly useful in its disabled mode, so empty directories are not copied. @endnode @node CopyHierarchyItem "BrowserII.guide/Copy Hierarchy" "Copy Hierarchy" Copy Mode ========================== This option is set by default. If not, the contents of source directories and subdirectories will be copied in the destination directory all together. @endnode @node CopyFlagsSub "BrowserII.guide/Copy Flags" Copy Flags ========== @{b}Clone @{ub} Identical sum of the 3 following options. @{b}Date @{ub} Copy the date of the source file. @{b}Protect@{ub} Copy the protection bits of the source file (reset 'adw'). @{b}Comment@{ub} Copy the comment of the source file. @endnode @node DeviceListSub "BrowserII.guide/Device List" Device List =========== The options below affect the contents of the main window. The term device always means here DOS device, and not an exec device. @{b}Devices (Volume) @{ub} Show devices with their mounted volume. @{b}Devices @{ub} Show all devices. @{b}Volumes (Device) @{ub} Show mounted volumes with their associated device. @{b}Mounted Volumes @{ub} Show mounted volumes (mutually exclusive with previous option). @{b}Unmounted Volumes @{ub} Show volumes that are not currently inserted in a device. @{b} @{ub} They are displayed in boldface. @{b}Standard Assigns @{ub} Show Assigns. @{b}Defered Assigns @{ub} Assigns created with the DEFER flag of the C:Assign command. @{b}Path Assigns @{ub} Assigns created with the PATH flag of the C:Assign command. @{b}Volume Size @{ub} Show size of mounted volumes. @{b}Volume Free Space @{ub} Show available free space in mounted volumes. @{b}Volume Used Space @{ub} Show space used on mounted volumes. @{b}Volume % Used @{ub} Show space used on mounted volumes in %. @{b}Alternate @{ub} Switch between the @{"2 possible configurations" link AlternateDeviceList}. @{b}Zip Window @{ub} Zip the main window on Alternate. @{b} @{ub} The 'Zipped' size can be @{"snapshotted" link Snapshots} too. @endnode @node AlternateDeviceList "BrowserII.guide/Alternate Device List" Alternate Device List ===================== You can store two prefered Device List configurations in you want. To switch between the two configurations, use the menu short cut. To edit the alternate configuration, select "Alternate" menu, and then set the preferences as usual. They will take effect immediately. The next time you "Alternate", you will turn back to the other device list configuration, and so on... The default configuration is the one which is active when you save your configuration. The other one is saved as "Alternate". @endnode @node OptionsSub "BrowserII.guide/General Options" General Options =============== @{b}Keep selected @{ub} Keep the selected entries after an action @{b}Toggle selections @{ub} Clicking a selected entry deselects it. @{b}ASynchronous actions @{ub} Let this option ON. This is for debug purpose. @{b}Open process status window @{ub} Open an information window for copy, delete... @{b}AutoCmds override icon's default tool@{ub} Give priority to @{"AutoCmds" link AutoCmds} rather than default tool. @{b}Auto-select associated .info files @{ub} NOT YET IMPLEMENTED @{b}Use window font in requesters @{ub} By default, requesters use screen font. @{b}Quiet CheckSize @{ub} Don't request at the end of Check Size action. @{b}Display directory disk usage @{ub} See @{"Jauges" link Jauges} @{b}Display proportion of visible data @{ub} See @{"Jauges" link Jauges} @endnode @node SaveConfig "BrowserII.guide/Save Config" Save Config =========== Saves all options relative to first menu 'BrowserII', as well as the contents of the @{"select requester" link SelectRequester}. Note to v2.x users: ~~~~~~~~~~~~~~~~~~~ This no more saves preferences about the Current and Alien window. Use @{"snapshot" link Snapshots} for that. @endnode @node QuitItem "BrowserII.guide/Leaving BrowserII" Leaving BrowserII ================= We did not plan for implementing this option, but a few crazy guys screamed for it, so here it is... Anyway, you won't be surprised to read that you won't be able to quit BrowserII as long as one (or several) of the Asynchronous actions are still running, or if another application has a window open in BrowserII's custom screen. By the way, @{"iconifying" link Iconify} BrowserII is possible while some actions are in progress. @endnode @node WindowMenu "BrowserII.guide/Window Menu" Window Menu =========== All items and relative options in this menu are relative to the active (current) window. Some items are specialised to some kind of windows, and may be disabled depending on the active window. @endnode @node RescanItem "BrowserII.guide/Rescan" Rescan ====== Rescans the content of the directory which corresponds to the active window. Since version 2.0, BrowserII scans directories asynchronously. You can iconify a directory while scanning. If you close a window while directory is being scanned, scan is aborted. Except for Alien Window that has no rescan method, this is valid for all other windows, including trees: the whole directory tree is rescanned. @endnode @node ZoomSub "BrowserII.guide/Zoom SubMenu" Zoom SubMenu ============ @{b}UnZoom @{ub} Sizes the window to it's smallest size. @{b}Zoom All @{ub} @{"Zoom" link Zoom} the window to show all files. @{b}Zoom Dirs @{ub} @{"Zoom" link Zoom} the window to show dirs only. @{b}Taller @{ub} Makes the window Taller. @{b}Wider @{ub} Display the window with one more column. @{b}Thiner @{ub} Remove a column but keep window height. @{b}Show MaxSize@{ub} Sizes window to it's @{"maximum size" link Zoom}. @{b}Show MinSize@{ub} Sizes window to it's @{"minimum size" link Zoom}. @endnode @node TreeSub "BrowserII.guide/Tree SubMenu" Tree SubMenu ============ @{b}Fold All @{ub} Folds all directories in a @{"tree window" link Tree}. @{b}Unfold All@{ub} Unfolds all directories in a tree window. @endnode @node OpenSub "BrowserII.guide/Open SubMenu" Open SubMenu ============ @{b}Open Parent@{ub} Opens the parent directory of the active window (if any). @{b}Open Dir...@{ub} Open a directory by entering it's pathname, relative to current window. For example "//" to go back 2 levels. @{b}Open Alien @{ub} Opens Alien Window where are listed @{"iconified" link Iconify} windows. @{b}Open Status@{ub} Opens the status window of all background processes. @{b}Make Tree @{ub} NOT YET IMPLEMENTED (Will convert a dir in tree window). @endnode @node SelectMatchItem "BrowserII.guide/Select Match" Select Match ============ Opens the @{"selection requester" link SelectRequester}, and selects, in the current window, the entries matching the criteria you have given. @endnode @node SelectAllItem "BrowserII.guide/Select All" Select All ========== Selects all entries in the active window! @endnode @node FiltersSub "BrowserII.guide/Filters" Filters ======= Another important feature of BrowserII. Only the files which match the criteria you set will be displayed, but all will be counted (look at the information displayed at the bottom of the window). @{b}Set... @{ub} Calls the filters requester. @{b}No .info@{ub} Hide .info files. This filter comes on top of the other filters. @{b}Clear @{ub} Removes all filters, all files and dirs will be visible. @{b}Invert @{ub} Reverses the action of all filters, so all visible files will be hidden and vice-versa. Useful for checking wether a file which you expect to be there has not been hidden through the action of one of the filters. In a directory tree, directories cannot be hidden. @endnode @node FileInfoSub "BrowserII.guide/File Infos" File Infos ========== @{b}Size in Bytes @{ub} Show file size in bytes. @{b}Size in blocks@{ub} Show file size in blocks. @{b}Protection @{ub} Show protection bits. See @{"MultiUser" Link Network} support. BrowserII defines two more customs bits named C and L. If bit C is set, file/dir has a comment. If bit L is set, file/dir is a link. @{b}Owner @{ub} Show file owner. Requires @{"accounts.library" Link Network}. @{b}Group @{ub} Show file owner group. Requires @{"accounts.library" Link Network}. @{b}Date @{ub} Show file date in AmigaDOS format. @{b}Time @{ub} Show file time. @{b}File Type @{ub} Show @{"file type" link "whatis.library"}. Requires whatis.library. @{b}Comment @{ub} Show file comment. @{b}Link @{ub} Show link if file is a link. (Not if @{"Turbo Scan" link WindowOptionsSub} is on). @{b}Drawer Arrow @{ub} Put an arrow to the left of directories in tree windows. @{b}Drawer Jauge @{ub} Display a directory size jauge for each directory in trees. @endnode @node SortSub "BrowserII.guide/Sort" Sort ==== @{b}Name @{ub} Sort entries by name. @{b}Date @{ub} Sort entries by date/time. @{b}Size @{ub} Sort entries by size. @{b}Entry Type@{ub} Directories are displayed first. @{b}File Type @{ub} Sort by @{"file type" link whatis.library} and then by name/date/size. @endnode @node AutoZoomSub "BrowserII.guide/Auto Zoom" Auto Zoom ========= This sub menu concerns the automatic @{zoom link Zoom} feature. When some events occurs, it is possible to automatically zoom a window. Just like everything in the "Windows" menu, these options are relative to the current window. @{b}Zoom All @{ub} Maximum zoom at the end of the @{b}first@{ub} scan. @{b}Zoom Dirs @{ub} Like previous but show only directories. @{b}Rescan @{ub} Zoom window after each directory rescan. @{b}Update @{ub} Zoom window after copying/deleting files. @{b}New File Infos@{ub} Zoom window when changing file infos. @{b}Tree Folding @{ub} Zoom window when (un)folding dirs in a tree. @{b}Only 1 Column @{ub} Constraint the zoom to a single column. @{b}Only if Zoomed@{ub} Re-Zoom the window only if it was already before. @endnode @node WindowOptionsSub "BrowserII.guide/Window Options" Window Options ============== @{b}- Find type by name@{ub} The @{"file type" link whatis.library} is identified only by pattern matching on the filename. Fast but not very safe since names are not allways meaningfull for file types. Requires whatis.library. @{b}- Find type by scan@{ub} The @{"file type" link whatis.library} is not only identified by pattern matching but also by reading the first few bytes of the file. This is much more powerfull than the previous option but slows down directory scan. Requires whatis.library. @{b}- Turbo Scan@{ub} Scans the directory using dos.library/ExAll() instead of Examine/ExNext. This is faster, and minimize disk trashing for concurent accesses. I presume it should be even more faster on remote network directories. The dark side: - You don't get size in blocks for files. (ExAll() limitation) (So you get a computed size using size in bytes) - You don't get file types. (For speed condition). Anyway, types are examined at double-click time. - Links are not recognized/read actually. This an AmigaDOS and/or FFS bug. It may be fixed in a future release of the OS...! @{b}- Keep Window@{ub} A new window is open when you double-click on a directory. This mode is forced if you SHIFT-double-click or MMB-double-click while the default 'keep mode' is 'Auto Iconify' or 'Auto Close'. @{b}- Auto Iconify@{ub} When you Double-Click on a subdirectory, the current directory is iconified and the new one is open in the same window. This mode is forced if you SHIFT-double-click or MMB-double-click while the default 'keep mode' is 'Keep Window'. @{b}- Auto Close@{ub} When you Double-Click on a subdirectory, the current directory is flushed from memory and the new one is open in the same window. @{b}- Auto Disk Load@{ub} @{b}This is not yet implemented.@{ub} The window will be associated to a dos device such as DF0:, and will load the directory of the inserted disk in this device automatically. @{b}- Local Properties@{ub} When set, this option prevents sub directories to inherit this directory properties. This is to be used in conjunction with @{"snapshots" link Snapshots}. @endnode @node PropertiesSub "BrowserII.guide/Properties" Window Properties ================= The properties of a window are the set of local window attributes: Filters, File Infos, Sort, AutoZoom and Options. @{b}Copy @{ub} Stores the properties of current window in an internal buffer for a later Paste operation. @{b}Paste @{ub} Pastes the last copied properties to the current window. @{b}Affect Volume@{ub} Copies the properties of the current window to all the windows belonging to the same volume. @{b}Affect All @{ub} Copies the properties of the current window to all the windows. @{b}Restore Prefs@{ub} Restores the @{"preferences for this window" link Snapshots}. @{b}Snapshot @{ub} Saves this window settings as @{"preferences..." link Snapshots}. @{b}UnSnapshot @{ub} UnSaves window preferences. @endnode @node ActionsMenu "BrowserII.guide/Actions" Actions ======= This menu gives access to all basic file operations, except drag and drop ones, ie copy/move/link. They are all executed in the background. This means that even when they pop up a requester, BrowserII is not busy. You can perform some other things if you need before answering the requester. @endnode @node RenameItem "BrowserII.guide/Rename" Rename ====== Renames the selected entries. If several entries are selected, you can rename them with jokers "à la ARP". If you are not familiar with this, exercise on some files of no value before using this action for good. For example, you can rename "mod.#?" to "#?.mod", or more generally, "x#?y" to "z#?t". There is a "Capitalize" option, also available for "Copy As" and "Move As" operations which converts file names to lower case, except for the first letter to upper case. Usefull when copying files from MSDOS disks. @endnode @node MakeDirItem "BrowserII.guide/Make Dir" Make Dir ======== Creates subdirectories in the active window. You can create several of them by separating names with spaces. Example: Work Games Work/Src Warning: Games Work/Src Work would not be valid because you attempt to create a subdirectory of Work before having created Work itself. @endnode @node DuplicateItem "BrowserII.guide/Duplicate" Duplicate ========= Makes copy of file(s), you will be prompted for new names. The requester is the same as for @{"rename" link RenameItem}, and same rules apply. @endnode @node SetDateItem "BrowserII.guide/Set Date" Set Date ======== Changes the date stamp of the selected entry (entries) to the actual date. Since v2.20, date can be modified. @endnode @node SetCommentItem "BrowserII.guide/Set Comment" Set Comment =========== Modify/Create a file comment for the selected entries. If file already has a comment, it is displayed as default in the requester. File comments are limited to 80 characters. @endnode @node SetProtectItem "BrowserII.guide/Set Protect" Set Protect =========== Change the protection bits of the selected entries. You cannot set the pseudo C bit, as it is not real a protection bit, it just tells you that the selected entry has a comment. But you can reset it, this will delete the comment. Use with care, it is easy to get a lot of comments gone forever in no time. The pseudo L bit is not available for the same reason. You can also set the Other/Group protection bits but has no meaning outside a @{"Mutliuser / Network" link Network} environnement. FFS just ignores them. @endnode @node SetOwnerItem "BrowserII.guide/Set Owner" Set Owner ========= Changes the owner of the file. This has sense only within a @{"Multiuser" link Network} or @{"network" link Network} environnement. You must have the rights to do it. See your Network / Multiuser documentation. Requires accounts.library. @endnode @node AddIconItem "BrowserII.guide/Add Icon" Add Icon ======== Add an icon to selected file(s) and directories. The Icon is a default icon relative to the file type, and configured in whatis.library database. BrowserII will first search default icons in an assign ICONS:, and in standard ENV:Sys directory. The ICONS: is a workaround the prevent copying KBytes of default icons in ENV:Sys which is by default located in RAM:. The same rule apply to given separate shell command AddIcon. Of course, requires whatis.library. @endnode @node CheckSizeItem "BrowserII.guide/Check Size" Check Size ========== Scans selected files and dirs to compute total size in bytes and blocks of all of them. If you choose to reselect entries, context of selection will be restored (including 'Enter subdirs') so that next action will be done on same files and dirs. Directories will get their size set. This way, it makes it possible, using rightmost main window @{"jauge" link Jauges}, to determine if a list of files and dirs will fit on destination volume. In the menu BrowserII/Options, there is an option "Quiet CheckSize" which disable the requester at the end of the scan. Only directories then get their sizes updated. @endnode @node InformationItem "BrowserII.guide/Information" Information =========== Brings up Workbench's info requester. (AmigaDOS 3.0 and higher). Note that currently, workbench must be loaded or nothing will happen. @endnode @node DeleteItem "BrowserII.guide/Delete" Delete ====== Deletes the selected entries. You will (fortunately) be asked to confirm. If at least one directory is selected, "Delete" will delete only empty dirs, while "Delete All" will delete non-empty selected directories as well. If the delete process encounter deletion protected files, you will be prompted if you want to override the protection. @endnode @node Keyboard "BrowserII.guide/Mouse and Keyboard" Mouse and Keyboard ================== Function keys ~~~~~~~~~~~~~ F1 : UnZoom current window. F2 : Zoom current window to see all files and dirs. F3 : Zoom current window to see all directories only. F4 : Iconify current window, or BrowserII if main window is active. F5 : Opens Alien Window. F6 : Opens status window of processes currently running. F7 : Folds all directories in a tree window F8 : Unfolds all directories of a tree S-F1: Zoom taller S-F2: Zoom wider S-F3: Zoom thiner ESC: Pauses all processes and open their status window. DEL: Deletes selected files and directories HELP: Displays the about requester. General mouse with qualifiers usage ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Pressing CTRL while selecting files forces Toggle-Select mode. This is important if you do not use the 'Toggle Selections' option. This allow to de-select an entry without de-selecting all. I use this because the toggle-selections mode makes me turn mad! ;-) - Pressing CTRL for a zoom operations (gadgets & function keys) overrides zoom contraints. - Pressing SHIFT before dropping files toggles copy/move mode. - Pressing CTRL before dropping files forces the "Request" copy mode. - Shift-DoubleClick on multiple assigns opens a list of assign components. - If you hold the shift key down while hitting a window close gadget, all windows belonging to directories of the same volume will be closed too, except iconified windows. If you want to get rid of iconified windows too, press CTRL key while closing window. - Shift-DoubleClick on directories toggles @{"auto-iconify" link WindowOptionsSub} mode. - Ctrl-DoubleClick on directories/volumes open a @{"tree with files" link Tree}. - Shift-Ctrl-DoubleClick on directories/volumes open a @{"tree without files" link Tree}. - See also @{"3 Button Mouse Support" link ThreeButtonMouse}. @endnode @node Jauges "BrowserII.guide/Jauges" Jauges ====== All windows but Alien have two jauges on their left border. The leftmost one allways displays the disk percentage of occupied space. And the second one, to the right, displays the directory disk usage or the percentage of visible data depending on the option you choose (See menu BrowserII/Options). 1. Directory disk usage If this option is selected, the rightmost jauge displays the proportion of used disk space used by this directory. For example, is you have a volume with no directories (all files are in the root directory), this jauge will say that the directory contains 100% of data present on this disk. 2. Percentage of visible data. If this option is selected, the rightmost jauge displays the proportion of visible data (in blocks) in this window (If filters hide some entries of this dir, not all entries are visible !). This is usefull for example when you hide .info files, a quick look at this jauge help you remembering that some files are not visible and you should not forget them. Jauges of the main window ========================= The leftmost jauge of main window is a copy of the same jauge of active window. If the active window is the main or alien, both main window jauges are empty. The other jauge will help you to determine if selected files would fit on active volume (volume of active window) if a copy/duplicate operation would be performed. Imagine you want to copy some files on a floppy disk, and you don't know if there is enough free space on this disk for your selected files. You can examine informations in bottom border of windows of course but there is an easier way. Activate the destination window (without deselecting your files), and the second jauge of main window will tell you everything: The leftmost jauge shows the actual disk usage, and the other one what it will become after the copy. Then there is two possibilities. Your files fit on the disk: no problem. Or there's not enough free space: then, the second jauge shows of how much selected files exceeds disk space by displaying a dash (-). The jauge height allways means the disk size. Note: Block size between source and destination volumes are assumed to be the same. @endnode @node SelectRequester "BrowserII.guide/Select Requester" Select and Filters Requesters ============================= Filters ~~~~~~~ BrowserII tests all files against the criteria set in this requesters, and shows those for which the test is positive. @{b}Files@{ub} Can be set to Yes, No or Match. If Match is selected, files will checked against the following criteria. @{b}Dirs@{ub} The same for directories. @{b}Pattern@{ub} This must be a valid AmigaDOS pattern. examples: #?.doc shows only the xxxx.doc files ~(#?.(o|dbg)) hides the xxx.o and xxx.dbg files @{b}Since@{ub} Shows files with more recent date than the date entered (AmigaDOS Date format) @{b}Before@{ub} The same in the other direction. @{b}Min Size@{ub} If the file is smaller, it is hidden @{b}Max Size@{ub} If the file is bigger, it is hidden @{b}Protection bits@{ub} Shows only the files with the specified bits. Example: L C H S P A R W E D - hides files which have the script bit set + shows only files with the archive bit set If you have installed the whatis.library, you'll be able to match files by type. If one or more positive file types are selected (without the exclude option), entries must match one of them. If no positive file types are selected, all files types are valid except excluded file types. For each file type, you can select associated subtypes. Select Match ~~~~~~~~~~~~ This requester is the same as precedent one, but with one gadget more, "Enter subdirs". This enables you to virtually select files in selected directories. As we say in french, a good example is better than a long speech. Suppose you want to clear archive bit of all files you have in a disk. 1. Open volume's window. 2. Call Select Match. 3. Put Files to ? and Dirs to N. 4. Clear all protection bits and set A to +. 5. Switch on "Enter subdirs". 6. Validate the requester. Result: All files which have their archive bit set are selected, but any directories are selected since you set Dirs to N. Now: 7. Hold key while selecting all dirs of this window. 8. Call Set Protect. 9. Switch protection bits to: L C H S P A R W E D _ _ _ _ _ - _ _ _ _ 10. Validate. Et voilà! Each time you click left mouse button over a BrowserII window, if you DON'T hold at the same time, the file under the mouse pointer, if any, becomes selected, all others are deselected, and Enter subdirs bit is cleared. That is to say after each operation with enter subdirs, this option is reset (except if you allways hold shift key), and must be set again if you want to do another action with this option. Within actions with enter subdirs, if a directory pass through the filters, the action will take place also on the directory itself once it has been examined. But even if the directory doesn't pass through the filters, it will be entered, and files within this dir may be affected by the action. This is a bit different for Copy action. If a directory doesn't pass through the filters, it won't be entered, and files within this dir will never be copied. But read carefully: Empty directories may be considered useless. So you can decide not to copy them by switching off this option. But Copy process is even more powerfull. If for example, you decide not to copy empty dirs, if you copy a directory with enter subdirs and any entries of this dir pass through the filters, the directory will be considered as empty and won't be created in destination path. This makes it possible to make selective backups, without useless directories in destination volume. @endnode @node FileExistsRequester "BrowserII.guide/File Exists Requester" File Exists Requester ===================== When attempting to copy (or move) a file over an already existing one, BrowserII will pop up a sophisticated requester. A lot of choices are then available, from the simple 'Cancel' to more complicated options combinations. The requester is composed of several parts: The buttons, the checkmarks, the string gadgets, and the requester text. The string gadgets are present only once "New Name" button has been pressed. Buttons ~~~~~~~ @{b}Retry @{ub} Retry operation (You may have changed checkmark states). @{b}Open Dir @{ub} Opens the directory where the problem happened. @{b}Version @{ub} Reads both files versions (using C:Version command). @{b}Update @{ub} Replace file only if newer than existing one. @{b}Overwrite@{ub} Overwrite the file. @{b}NewName @{ub} Enter new name for the file to create. @{b}Skip @{ub} Ignore the file and skip to next one. @{b}Cancel @{ub} Cancels the whole operation. Checkmarks: ~~~~~~~~~~~ Backup replaced files ~~~~~~~~~~~~~~~~~~~~~ If "Backup replaced files" is checked, each existing file will be renamed to ~. If ~ already exists, it is deleted first. Repeat action to all existing files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This option, when on, affects the following buttons: Update, Overwrite, NewName, Skip. BEWARE: this option is on by default, then selecting "Skip" will skip all existing files. You must remember to uncheck this option before hitting "Skip" if you want to perform a 'by file' skip operation. Note: for "NewName" to work with the 'all' option, you must also perform a pattern rename. (Ex: "#?" -> "#?.new") @endnode @node Commodity "BrowserII.guide/Commodity" Commodity ========= BrowserII is a commodity. It supports the standard tooltypes: CX_POPUP (default is YES) Set to NO or FALSE to start browser iconified state. Can be set in the (eventual) project icon in the SYS:WBStartup drawer. CX_POPKEY (default is »control esc«) CX_PRIORITY (default is 0) CX_UNIQUE (default is FALSE) Set to YES or TRUE if you do not want to run BrowserII several times. If set to true, running BrowserII while it is already running will bring its screen to front. There is a new mode for BrowserII's screen which is the frontmost screen, if public. Used with hotkey, you can now pop up browser in the current screen when it is @{"iconified" link Iconify}, if you like to! Hitting hotkey while BrowserII is running but not iconified will bring its screen to front. @endnode @node WorkbenchSupport "BrowserII.guide/Workbench Support" Workbench Support ================= If Workbench is loaded when you start BrowserII, an @{"AppIcon" link Running} is installed. This icon can be used to uniconify BrowserII. You can also drop icons over it, and the corresponding directory will be open in BrowserII. When BrowserII is used in Workbench screen, directory windows, as well as Alien and Devices windows are AppWindows. If you release an icon over a BrowserII window, the corresponding directory will be open in that window, and the preceding directory will be iconified. @endnode @node ExternalCommandBD "BrowserII.guide/External command BD" External command BD =================== An external command named BD is provided with BrowserII. This is an interface between shells and BrowserII. Running BD with no arguments will run BrowserII if it is not yet running, and make BrowserII open and scan your current shell directory. You can also specify one or more directories as argument to BD. Note: BrowserII must be in your shell Path if it is not yet running. BD can also be run from workbench. If you double-click on the Tool BD, BrowserII will open the directory containing BD. But you can also have project icons with BD as default Tool. In this case, if your project has no Tool-Types, the current dir will be open, otherwise, you can edit your project Tool-Types, and specify as many directories as you want. You should also specify in the BD Tool Tool-Types the full path to BrowserII, that is to say in which directory you have BrowserII. In example given, BrowserII should be in SYS:Utilites directory. Template: Dirs/M,TREE/S,TREEWITHFILES/S,RESCAN/S,ZOOMDIRS/S,ZOOMALL/S,QUIET/S,SCANDEVS/S,SYNC/S @{b}Dirs@{ub} Several dirs can be asked to be (re)scanned @{b}TREE@{ub} Tells to open Trees rather than dirs. @{b}TREEWITHFILES@{ub} Tells to open Trees with files rather than dirs. @{b}RESCAN@{ub} Always scans dir. Even if already open. @{"ZOOMALL" link ZOOM} Zoom window, even with AutoZoom is not active. @{"ZOOMDIRS" link ZOOM} Same as ZOOMALL, but for dirs only. @{b}QUIET@{ub} Do not activate window, nor bring screen to front. @{b}SCANDEVS@{ub} Rescan main window (the one with devices/volumes/assigns) @{b}SYNC@{ub} Operate synchronously to prevent disk trashing if more than one dir asked on the same device unit. @endnode @node BrowserII.menu "BrowserII.guide/User Configured Menus" User configured menus ===================== BrowserII.menu file format ~~~~~~~~~~~~~~~~~~~~~~~~~~ You will best understand what follows if you have in front of you a printout of the @{"example config file" link //BrowserII.menu-example/Main} supplied. A configuration file looks like a structured program. You should indent your lines to make the file as readable as possible. The configuration file is named BrowserII.menu and must be in the same place as BrowserII. The configuration file defines the menus you want, and what commands they will run. Comments begin with a #, and continue until the end of the line. Upper and lowercase do not make a difference. Keywords: ~~~~~~~~~ CMDWIN console_name This will override the default console used for Command output which is "CON:0000/0011/0640/0100/Command window/AUTO/CLOSE/WAIT". This should be placed anywhere in the file but better be at top of it. This console will in 2.0 have a close gadget, a defered open, and wait user to hit close gadget before closing window. Under 2.0, if you use Command in Simple mode, you MUST specify the /WAIT option for your console, or it will close before you could read it. SHELLWIN console_name This will override the default console used for SHELL commands which is "CON:0000/0011/0640/0100/Shell/Auto/Close/Wait". This should be placed anywhere in the file but better be at top of it. SHORTCUTQUAL This can be used to add keys to access menus short-cuts. For example, you can use Left-Amiga, ALT, SHIFT or Ctrl. In fact usefull values are "lcommand" or "" (nothing). The first one allow the left amiga key to work as well as standard right amiga key, while "" allow to short cut menus with the single letter key. Any way, all commodities keywords are working, like: lshift rshift lalt ralt control ... COLOR n This will set the foreground pen color for new items. You can change this as often as you want. The arguments is the pen number to use. The default is window detail pen. This feature is active only under AmigaOS 2.x, as NewLookMenus of AmigaOS 3.x resets all the pens to system default values. MENU menu_name Creates a new menu. Each menu must have at least one item or submenu. SUBMENU submenu_name Creates a new submenu. Each submenu must have at least one item and can't have submenus. Each SUBMENU must end with an ENDSUBMENU ENDSUBMENU See SUBMENU. ITEM [{short-cut}] [KEY ] [KEYTEXT ] [WBTF] [REQUEST] Defines a new menu item. Each item definition must have an item_name and an associated command. Each item is linked to the current menu or submenu. An ENDSUBMENU statement tells BrowserII to attach next items to the current menu rather than to the current submenu. If any of the menu, submenu and item names may contain whitespaces. In this case, enclose the name in double quotes. A command character may be defined for the menu item by putting the character after the ITEM keyword and surround it with {}'s. KEY Allows more extensive short-cuts for menus. is a commodities string, such as "control x", "f10", or anything you want. KEYTEXT (AmigaOS 3.x only) Maybe be any text you want, but intended to help remember menu extended short-cuts. You may for example use KEYTEXT "^x" for previous KEY "control x". This text will be right aligned in the menu strip. WBTF Brings workbench to front just after running the command. REQUEST Opens a requester enabling you to modify the command before running it. Not available for WB mode. Command syntax is decribed below. command_def Programs can be run in three ways: RUN, SHELL, and WB. For all modes, STACK and PRI are optionnal. If STACK is less than 4000 bytes, or if no stack is specified, the stack will be set to the ParM task Stack. That is to say the stack size at time ParM was run. There's an exception: If ParM is resident, ParM stack will allways be 4000 bytes. 1) RUN syntax RUN [WIN console_window] [STACK n] [PRI n] command [args][;command [args]]... This mode creates a background shell. This mode should be used for scripts. If the bit s of your script file is set, it is automaticaly sourced (No need of the execute command). Redirection can be done in this mode. You can specify several commands separated with semicolons ;. If you want selected files to be passed as arguments, you may place square brackets [] at insertion position. There is an alternative to get arguments with a full pathname, rather than a path relative to the current directory (active window). Just put [:] instead of [] in the command line. But be warned. In most cases, @{b}this is not necessary@{ub}, and dangerous! Because volume names may not be unique, files passed as parameters may not be the ones you selected. Current directory is a lock and IS unique. Anyway, it can be usefull when giving file names to and already loaded process with a current dir different from the selected files' directory. For example, you get two ARexx examples in this archive that need full path argument, View.adpro, and DeliPlay.rexx. There is another drawback: arguments have longer names, and as a command line is limited to 512 bytes long, you cannot give as many arguments to a command as with current-dir relative path. 2) SHELL syntax SHELL [WIN console_window] [STACK n] [PRI n] command [args][;command [args]]... This mode now does the same as RUN, but if no window is given, the default shell window is taken. 3) WB syntax WB [STACK n] [PRI n] command or WB [STACK n] [PRI n] command [] # to take arguments Execute command in WorkBench mode. To get arguments, add [] to the command. Warning: If STACK is specified here, it will override the stack specified in the icon of the command. Your command may crash if you ask a smaller stack than in the icon. Do it at your own risk. BARLABEL Adds a bar between last item and next one. For all modes but WB, your command is searched first in resident list and then in CLI Path at time ParM was run. To know the path in which ParM search its commands, just issue the Path command in the requester of ParM Command command, or open a newcli or shell from ParM and issue the Path command. A config file is given as an example. Limitations: ~~~~~~~~~~~~ If a command in RUN or SHELL mode can't be started, you will never know, except you won't see it working. Known bugs: ~~~~~~~~~~~ See notes for external commands. RUN PRI 1 NewShell does not work. Pri is allways 0. Not a ParM bug. Tutorial: ~~~~~~~~~ Now you read about all ParM was able to do, I think you'd like to know which mode you should use to run your favorite tools. First, when you want to add a manu item, you should know: 1) Does your tool support workbench run ? 2) Do you want your tool to inherit ParM's current dir, or have its own ? 3) Do you want your tool to inherit ParM's CLI Path ? 4) Do you want your tool to use a console window for its output ? SHELL mode is now the same as RUN but with a default console if not specified. So, choice between RUN and WB is easy. If you need a console or the Path, use RUN mode. Else, you can use WB mode. @endnode @node CmdHotKeys "BrowserII.guide/Command Hot-keys" Command Hot-keys ================ You can run commands using hot keys. But BrowserII is not a background commodity to run or pop up various utilities. Use special tools to do that such as Yak, or others. Hot keys in browserII are active only when a Browser window is active. In fact, hot keys are configured as menu short cuts, so you may consult @{"menu configuration" link BrowserII.menu}, especialy the KEY and KEYTEXT keywords. @endnode @node AutoCmds "BrowserII.guide/Auto Commands" Auto Commands ============= AutoCommands are commands that are run when you double click on a file depending on the file type. File types are recognised by @{"whatis.library" link whatis.library} so this feature is available only if you have it in your system. File Types configuration is done via @{"whatis.library" link whatis.library} configuration. AUTOCMDs are configured in the @{"BrowserII.menu" link BrowserII.menu} file with the following syntax: AUTOCMD [WITHSUBTYPES][WBTF][REQUEST] [STACK] [PRI] [WIN] [] : The file type name (you can see it by setting "File Infos/File Type") (i.e: "Text", "Exe", etc...) : Same as for @{"menu items" link BrowserII.menu} (WB, RUN,...) : The command you want to execute for this type of file. Same syntax as BrowserII's @{"menu items" link BrowserII.menu}. WITHSUBTYPES : AUTOCMD is inherited by subtypes of the type given. If an AUTOCMD exists for a subtype of the given type, it takes precedence over it. Example: AUTOCMD "Text" WITHSUBTYPES WBTF RUN More [] AUTOCMD "Source C" RUN Ed [] If you DoubleClick on a file and this file is a text file but not C Source file (which is a subtype of Text) then "More" will be run with the file as argument. If you DoubleClick on a C Source file, then "Ed" will be run instead of "More". It is strongly recommanded to have a look at the complete example given in BrowserII.menu. The file is easy to understand. @endnode @node whatis.library "BrowserII.guide/File Types and whatis.library" File Types and whatis.library ============================= This library is responsible of file type identification in BrowserII. It now quite know as some other PD software uses it. The whatis.library comes as a separate package, even though the library itself and a simple configuration file comes with it. The complete distribution can be downloaded from aminet, and makes part of our install disk. Read @{"whatis.library documentation" link "whatis.doc/Main"} for more information about configuration. @endnode @node "Changes" "BrowserII.guide/Changes" Changes from versions 2.x ========================= BrowserII.menu ~~~~~~~~~~~~~~ The menus configuration file "S:BrowserII.menu" has moved BrowserII's home directory. The installation script detects an existing file in S: and moves it to the new location of browserII. The crappy ACTIVATEKEY has gone from BrowserII.menu (and ParM.cfg). You must remove it. It has definitely been made obsolete by CX_POPKEY. You must modify your SHORTCUTQUAL (if any). It now uses commodities syntax. For 'left Amiga' key to work as well as standard right amiga for menu shortcuts: SHORTCUTQUAL "lcommand" For direct shortcuts (without any qualifier) SHORTCUTQUAL "" Browser now requires that each command (either RUN, SHELL or WB) that may take arguments include square brakets [] or [:] where to insert arguments. Commands that don't have [] won't have selected files passed as arguments, and selected files won't be unselected once the command has been run. Save Config ~~~~~~~~~~~ The config file DEVS:BrowserII.cfg has also moved to the same location. Although the file format has changed, you will start back from default options when first installing version 3 of BrowserII. This way, BrowserII has now all its files in a single directory, making easier copying, and ready to use floppy disk based installation. Note that now, @{"Save Config" link SaveConfigItem} only saves the attributes set in the "BrowserII" menu. Saving default directory window options ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Some global window attributes are now local to each window such as autozoom features for example. These attributes are no more saved with the @{"Save Config" link SaveConfigItem} menus. You must now use the @{"Window/Properties/Snapshot" link Snapshots} menu item, which allow to save the active window properties as local or default configuration. Note to those who had beta 2.9 versions: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The MMB-Double-Click feature is back to it's original 2.41 function which is "toggle Auto-Iconify" feature. Directory tree opening is now available with Control-Double-Click or MMB-Double-LMB, because in fact, auto iconify it is much used than opening directory trees, and it's easier this way. See the @{"release notes" link "Release Notes"} for new features. @endnode @node "Release Notes" "BrowserII.guide/Release Notes" Release Notes ============= 1.0: First Release (30-jul-91) 1.1: Bug fixes. Added DiskCopy ability. Moving a device over another device calls SYS:System/DiskCopy, and Duplicate a single device too. Cli arguments are now quoted only when needed. A lot of little invisible improvements. 1.11: Bug fixes. With parm.library 3.4 and higher, RUN modes work under 2.0. 2.0: Iconification, Zoom, Jauges, Workbench 2.0 look (under 2.0), Parametrable Fonts, ASynchronous dir scan, and bug fixes. External command BD. 2.03: Minor bug fix. 2.04: "Copy->Move" bug fix. (won't delete source file) 2.05: Bug Fix: A CurrentDir was missing which can cause crash, bug in copy when skiping big file. Removed trash of prop gadget with autozoom under 2.0 2.10: 29/5/1992 Optional whatis capability: recognize some files (ILBM, PPDATA, doc,...), You can define new type ( see docs of whatis.library). Auto command (custom command for each filetype ). BrowserII can work without whatis.library. AddIcon and CheckSize action added, Back pattern option added (KS2.x only), should be custom in future. Optional automatic main window Zoom. Optional save Main window size/position BD has now 3 new option. 2.11 RunMode was not printed in GetString() title bar when double clicking on a file. fixed. When changing Sort mode for a window, window was not updated. fixed. 2.12 RunMode on double-click was always Shell with WB 2.0. fixed. After closing a window, check-marks for new current window was not udated. fixed. WBToFront now supported for WBRun too. A TAG_DONE was missing for backdrop window open (Pattern Option) **************************************************************** * THIS WAS THE LAST KICKSTART 1.3 VERSION ! * **************************************************************** 2.20: For KS 2.0 only, sorry. arp and req libraries no more needed. New lovely requesters (Underscored chars are shortcuts). Bold gadget is default response (Return key). ESC cancels all requesters. Processes status windows. New screen modes available. Virtual autoscroll screens. New wonderful Select/Filters requester with file types criteria. New look in menus. FileInfo options for alien window entries saved in config file. OpenDir done relative to current dir (enables opening of // for example) ShortCuts available when pattern's backdrop window is active. BrowserII can be iconified even when processes are running. Touch action changed in SetDate (like AmigaDOS command). You can then modify the date. Added new internal protection bit L to identify links. Saving Size/Position of main and alien windows made easier. 2.21: No more truncate french dates. Works fine with 4000 bytes of stack. (2.20 needed 4500 bytes). Uses new asl.library V38 screen mode requester. 2.22: New look menus under AmigaDOS 3.0. New action 'WB Info' under AmigaDOS 3.0. Bug fix: Mem jauge layout was not correctly handled under V39. Backdrop pattern now implemented as a layer hook, and no more uses precious chip memory. 2.23: Bug fix. Replaced ExNext() with MatchNext() to fix problems with new V39 DirCache FileSystem. 2.30: Localized. Screen's bitmap made Interleaved under 3.0 (scrolling much nicer) Bug fix in WB Info. Did not handle properly .info files. You can now run a tool by double-clicking on it's icon. Makes it possible to run projects made of only an icon (for example: clicking on English.info to run software install in english). Uses system busy pointer under WB3.0. Bug fix in LoadConfig(). Config revisions were not properly handled. 2.31: Pooled memory under WB3.0 BrowserII's screen now inherits Workbench3.0's properties. (Your prefered pens,...) See note about pens for 3.0 users. 2.32 Fixed a MungWall hit. Added 'Keep Window' features, asked by Gilles Soulet. 2.33 Bug Fixes. Files where not unghosted on unmounted volumes. Memory pools semaphore protected. Deleting directories in RAM: was not possible under V37 since version 2.23 (due to modif for DCFS). Worked under V39. Fixed. 2.34 Pooled memory under all system versions, including 2.0! 2.35 Font & ScreenMode requesters resized. Added DEL key as a short-cut for Delete. 2.36 Deleting links to dirs no more deletes dir contents. Only the link is removed. Added 'Update' button when asking before overwriting a file. BD 'file' now opens file's parent dir. Added Affect Volume possibility. You can now make a directory (MakeDir) with an icon. Turbo directory scan. 2.37 Drag Selection. (release Shift key to copy/move files). Menus available when backdrop window is active. Keep modes now keep the same window rather than opening a new one and then closing parent. 2.38 Middle button handling. New request mode for copying/moving files (Copy Mode/Request) Colors saved in 32 bits under V39 for AGA machines. This is usefull only if you edit the palette with a special utility. We'll soon release a palette.library which will edit colors in 24 bits, using the colorwheel. Command line length increased to 512. (You can select more files for External Commands in RUN/SHELL mode). Added an AppIcon in Workbench. 2.39 AppWindows. (See 'Workbench Support'). Keeps window size after checksize. (will become optional) Enhanced (faster) scrolling for big windows. Added a safety check. If you drag a file and you release it less than 350 ms after selecting it, you will be asked a confirmation for the copy/move operation. You must be a zombie to be faster! Arrows associated with scrollbar. Not yet functionnal. Another bug fix in LoadConfig(). 2.40 New iconify gadget image. Page scrolling (jump) now keeps one common entry between pages. Scrolling with new arrows. Menu layout no more locks backgroung actions when status windows are open. When started from WB, BrowserII's process get a copy of the WB Path, just like if it were started from a shell. Scrolling support in drag-selection. Added '[:]' to get full path arguments. Pressing MMB while holding LMB no more forces toggle-selection. Uses palette.library under V39 if available. Better window placement for big screens. Added Doc for CTRL key usage. (never been documented before!). Bug fix in realtime scroll. (window top and/or bottom borders might be trashed). Fixed several bugs WB Info. Various other optimisations/bug fixes. Code cleanup. 2.41 Little fixes. Bumped revision because a lot of 2.40 beta were distributed. 2.42 - Not released. - Modification of the about requester for registered users. - Support for different kinds of assigns in the device list. - Support for Multiple Assings. - Standard Assigns are now unique. If you have an assign and a volume with the same names and you double-click on the assign, you'll get the assign directory, not the volume. This is also true when you drop files over an assign. - BrowserII may now run on any public screen. Not only Workbench. 2.43 - Not released. - Keep prop gadget position between directory rescan. 2.44 - Not released. - Jauges a bit wider under SuperHires screen modes. - New standard 3D scrollbars - Delete & Write protection bits no more copied. 2.9 - 3.0 pre-release. Reserved to beta testers. 3.0 - Directory Tree. - Window snapshots. - File comments display. - Links support and display. - Network / MultiuserFileSystem support. - Archive support (Get separate ObjectArchive package) - Proportional font in windows. - Improved device list display. - Delete when dropping files out of a window. - Deletion of delete-protected files request - Extended menu shortcuts (some kind of hot keys). - Enhanced actions and copy requesters. - Now a commodity (can start in iconified state) - Finds default tools in path. - Removed the title bar memory jauge. Use TitleClock or other. - And more!... 3.01 - Added CX_UNIQUE tooltype. - Defered ScanDevs() - Shilt-Alt-Close_Window replaced by easier Ctrl-Close - Background image (under 3.x only) (code by Walter Dörwald) 3.02 - Improved Background image display speed. (Walter Dörwald) - Changed NOAPPICON tooltype to APPICON= - 'Move As' on same volume was not working!! - New guide (AmigaOS 3.1 and above only) (Walter Dörwald) - New set of MagicWB icons. Thanks again Walter! - Added all available tooltypes in icons as comments. - New Italian & Spanish catalogs. - Linked with fixed pools.lib from Mike Sinz. 3.03 - Fixed bugs/enforcer hits in date decoding (select requester). - Added support for Lzx in "Extract" script. - Added missing information for copy process in guide file. @endnode @node "Future Plans" "BrowserII.guide/Future Plans" Future Plans ============ The next step in BrowserII is a separate preferences editor for lots of new options, color settings, menus, auto-commands, and... docks! We plan to use toolmanager.library for this feature. This version has some new features hidden, disabled, or not finished because I'm a bit fed up with BrowserII, after more than one year working on the same tool. Don't blame me please! Anyway, I will try to make more regular updates than before, mainly on Aminet. @endnode @node "Updates" "BrowserII.guide/Updates" Updates ======= To get the lastest version of BrowserII, download it from an aminet site in directory /pub/aminet/util/dir. If you do not have an aminet access, you'll then have to wait for Fred Fish disks/cdroms, or other diskette collections. @endnode @node "Copyright" "BrowserII.guide/Copyright" Copyright ========= BrowserII is copyrighted by @{b}Sylvain Rougier@{ub} and @{b}Pierre Carrette@{ub}. It may not be sold in or together with commercial software without written approval by the authors. It may be freely distributed on usual Fish disks and cdroms, Aminet servers and CDROM, Pearl, CAM,... It cannot be made available for downloading from a server which is a commercial operation. The general principle is that it is forbidden to make a profit through the use or distribution of this program without our written consent. Distribution by "France Festival Distribution" after any sort of translation is definitely ILLEGAL. @endnode @node "Registration" "BrowserII.guide/Registration" Registration ============ BrowserII is shareware. If you use it consistently, you ought to send us a contribution or your conscience will itch. Shareware fee is $25. You will then get a so called key file, which will stay valid for ever. You will continue to get updates from usual fish disks and aminet download. When you are not registered, the About requester appears from time to time. To become a registered user, fill in the @{"Registration Form" LINK "Registration Form/Main"} and send it to the address below. If you have an email, we will be able to send you your keyfile very fast. Send registration order form to (except U.S. users): ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sylvain Rougier 39 rue Carnot 86000 Poitiers France. EMail: rougier@ss3.univ-poitiers.fr IRC on channel #AmigaFr: Nickname "Un" North American registration and support site for BrowserII is now available from: Jon Peterson P.O. Box 2661 San Angelo, TX 76902 Email: FidoNet 1:383/25 or 26 or 30 InterNet jon.peterson@twisted.com j.peterson22@genie.geis.com You can always FREQ the latest versions of and BrowserII at Dark Knights (915)944-9283 in the Amiga files section as BrowserII_v3.lha. @endnode @node "Bug reports" "BrowserII.guide/Bug reports" Bug reports =========== If you have an internet access, the best way to send bug reports and enhancement requests is to send an e-mail to: bvme@chasseneuil.em.slb.com (Pierre Carrette) rougier@ss3.univ-poitiers.fr (Sylvain Rougier) Otherwise, send it by postmail to @{"Sylvain Rougier" LINK "Registration"}. Several people reported troubles with MFS & CrossDos. It sometimes happened that closing a PCx: directory while removing an MSDOS disk crash the machine with old version of CrossDos. With version 40.19 of CrossDosFileSystem, this bug has gone. This definitely is *not* a bug of BrowserII. If you encounter a bug we can't reproduce, please send us a bootable floppy disk and describe how to get it. You will in turn get a free registration for BrowserII. @endnode @node "Acknowledgements" "BrowserII.guide/Acknowledgments" Special thanks to: ================== Walter Dörwald for creating a set of MagicWB icons, new nice formated guide, and screen backfill hook with datatypes image loading. Cedric Beust, Philippe Brand, Gilles Soulet, Gaël Marziou, Jean-Baptiste Yunes, Eric Totel, Olaf Gschweng, Alessandro Galassi, and all other translators, registered users, and beta testers. @endnode @Node "Disclaimer" "BrowserII.guide/Disclaimer" Disclaimer ========== THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. @endnode