@database "RO Documentation" @author "Oliver Rummeyer" @(c) "Copyright © 1994 Oliver Rummeyer" @$VER: RO Documentation 0.82 (16-Oct-94) @node main "RO User Documentation" @toc contents @next introduction RO --- A MUI-Based FileManager, Shareware Version 0.82 User Documentation Copyright ©1994 by Oliver Rummeyer ---- @{b}1. Introduction@{ub} 1.1 @{" Short description " link introduction}..............What is 'RO'? 1.2 @{" System Requirements " link requirements}..............What you need to use RO 1.3 @{" Unregistered Version " link unregistered}..............Is RO crippled shareware? @{b}2. Installation@{ub} 2.1 @{" How to install RO " link installation}..............How is RO installed? @{b}3. How to use RO@{ub} 3.1 @{" Main Window " link mainwindow}..............How is RO controlled 3.2 @{" Menus " link menus}..............RO's Pull-Down Menus 3.3 @{" Configuration " link configuration}..............Setting up RO 3.4 @{" ARexx Interface " link arexxinterface}..............How to control RO via ARexx 3.5 @{" Discussion " link discussion}..............Questions and Answers. (Q&A) @{b}4. Registration@{ub} 4.1 @{" How to register for RO " link registration}..............How to become a registered user 4.2 @{" The Registration Form " link registrationform}..............I need your name, address, ... @{b}5. Other Topics@{ub} 5.1 @{" Updates " link updates}..............Where to get updates 5.2 @{" Support " link support}..............How to reach the author 5.3 @{" Acknowledgments " link acknowledgments}..............The author wishes to thank... 5.4 @{" History " link history}..............The RO history 5.5 @{" Future " link future}..............If you register... @{b}6. Distribution Politics@{ub} 6.1 @{" Disclaimer " link disclaimer}..............Warranty? No warranty! 6.2 @{" License " link license}..............License agreement 6.3 @{" Installer " link installer}..............About the installer program. 6.4 @{" Magic User Interface " link magicuserinterface}..............About Magic User Interface @endnode @node introduction "Introduction" @prev main @next requirements @{b}@{u}Short description@{ub}@{uu} RO is a new intuition-controlled, fully user-configurable file manager for OS 2.04 and newer. RO's mighty features will assist and help you on your daily work with your Amiga. With RO there is no need to learn those cryptic shell commands, because you have the complete power of your Amiga in one hand. Due to the usage of MUI you are able to configure the look and feel of this tool as you like it. MUI is the @{" Magic User Interface " link magicuserinterface} developed by Stefan Stuntz which should be installed on every Amiga. It is an object oriented system to create and maintain graphical user interfaces. Users of MUI based applications have the ability to customize nearly every pixel of a programs interface according to their personal taste. The RO archive should contain the following files: RO/Binary/RO RO/Binary/RO.prefs RO/Docs/RO.guide RO/Icons/4col/Drawer.info RO/Icons/4col/RO.guide.info RO/Icons/4col/RO.info RO/Icons/8col/Drawer.info RO/Icons/8col/RO.guide.info RO/Icons/8col/RO.info RO/Install.info RO/Install/Installer RO/Install/RO-Install RO/Install/RO-Install.info RO/LiesMichZuerst RO/LiesMichZuerst.info RO/Locale/Catalogs/Deutsch/ro.catalog RO/Locale/RO.cd RO/Locale/RO.ct RO/ReadMeFirst RO/ReadMeFirst.info RO.info MUI is not included in the RO archive, but you should get it in every mailbox or at your local aminet-mirror. @endnode @node requirements "System Requirements" @next unregistered @prev introduction @{b}@{u}System Requirements@{ub}@{uu} RO requires version 2.04 of the Amiga operating system or newer. RO also requires version 2.2 or newer of the "Magic User Interface" by Stefan Stuntz. Kickstart 1.3 is not supported; Neither by the "Magic User Interface" nor by RO; this operating system is obsolete. Upgrade to 2.04 or, even better, to 3.1 of the Amiga OS. RO does not require a special processor, but of course the faster CPUs make life easier. Many complex calculations are needed for the management and layout of the objects, so a "base" 68000 based machine could be slow. If you want RO to automatically decrunch XPK & PowerPacker packed files, you have to install xpkmaster.library, powerpacker.library and at least one XPK compressor library. If you want RO to treat archives just like directories you also need ARCHandler. XPK is Copyright © Urban Mueller, Bryan Ford & Christian Schneider. PowerPacker is Copyright © Nico François. ARCHandler is Copyright © Rafael D'Halleweyn. @endnode @node unregistered "Unregistered Version" @next installation @prev requirements @{b}@{u}Unregistered Version@{ub}@{uu} I decided to release RO as crippled shareware. RO is fully functional but in the unregistered version the about requester appears regulary to remind you to pay the shareware fee. RO has been and will be a time-consuming work for me. If you like this product you should support me with the registration fee. Thank You. @{" How to register for RO " Link registration} @endnode @node installation "Installation" @next mainwindow @prev unregistered @{b}@{u}Installation@{ub}@{uu} RO comes with an installer script which helps you to install all required files. If you are an 'expert user' you might want to do it manually. Just take the RO icon and drop it into the directory where you want to install it. You might want to copy the file 'RO.prefs' into the same directory or to 'S:'. If you have a keyfile, copy it to 'S:','L:' or in the same directory where you copied the executable. If you use Workbench 2.1 or better then you may copy the file ro.catalog to your 'LOCALE:Catalogs/' directory. @endnode @node mainwindow "Main Window" @prev installation @next registergroup @{b}@{u}Main Window@{ub}@{uu} After the installation procedure you may start RO, and the main window should open. It contains the following control objects... @{" Register " link registergroup} Changes the listview type @{" Information Textfield " link dirinformation} Displays information about loaded dir @{" Listview " link listview} Displays the directory @{" Path Gadget " link pathgadget} For manual directory browsing @{" Drive Buttons " link drivebutton} Fast access of often used devices @{" Command Buttons " link commandbutton} Performing actions on selected entries @{" Status Bar " link statusbar} Displays general information @endnode @node registergroup "Register Group" @prev mainwindow @next dirinformation @{b}@{u}Register@{ub}@{uu} The register at the top of the window lets you change the type of the listview below. You may choose between Directory, Buffers and Volumes. According to your MUI settings the register group might look like a register or like a normal cycle gadget. The three different listview types are discribed in the @{" Listview " link listview} section. @endnode @node dirinformation "Information Textfield" @prev registergroup @next listview @{b}@{u}Information Textfield@{ub}@{uu} There is a textfield above each directory listview where several informations are displayed: the free disk space in percent and KBytes, and the used disk space in KBytes. It looks similar to the information displayed in the title bar of a standard Workbench window so you should be familiar with it. If there is currently no directory loaded you will see 'No Directory'. The information text changes if you select some entries. You can see how many files, dirs and bytes currently selected, if you unselect all the text changes back to the disk space display. The Textfield is also used to indicate which listview is currently active. It is very important to know which one of the listviews is active, because it is considered as the source listview and it is the one which is affected by all operations you start via command button or via user menu. If you select a file in a listview the active side changes but you may also change the active side via '`' (The key above 'tab') which cycles through the listviews or via 'tab' which cycles through the string gadgets. The textfield above the activated listview is filled with a 'Fillback' raster which could be configured in the 'Pens' section in MUI prefs by changing the according pens. Last but not least the Textfield is also used as a hidden 'Parent' button. If you click on it the parent directory of the current directory is loaded into the according listview. If there is no parent directory RO will just reload the current loaded directory @endnode @node listview "Listview" @prev dirinformation @next pathgadget @{b}@{u}Listview@{ub}@{uu} RO supplies three different listviews... The 'Directory' listview is RO's most important listview. It is used to display the directory. You may select files and directories there and doubleclick on them. If you doubleclick on a directory it is loaded immediately into the listview, but if you doubleclick on a file RO tries to determine what kind of file it is and will start the according command. About 50 filetypes are recognized and in addition if you use Kick 3.0 or better RO supports Datatypes. For a detailed description how to configure these fileactions consult the @{" Configuration " link configuration} chapter. The 'Buffers' listview is a kind of history where RO remembers a specific number of paths. You may also insert paths upon startup as described in the @{" Configuration " link configuration} section. You may get to any of the displayed paths just by doubleclicking them. This is one way of fast directory access supported by RO. The 'Volumes' listview displays a list of all available AmigaDOS volumes currently mounted. You can load a volume into the directory listview by doubleclicking on it. @endnode @node pathgadget "Path Gadget" @prev listview @next drivebutton @{b}@{u}Path Gadget@{ub}@{uu} The path gadgets are below the two directory listviews and contain the path string of the current loaded directory. You may enter any path here and the according directory will be loaded immediately. RO extends all path names e.g. if you enter 'Libs:' you get something like 'System:Libs/' The path gadgets are just another fast way to access directories because of the bulid-in path name completer. If you enter 'SYS:Devs/DOS' you get an extended path which should look like 'System:Devs/DOSDrivers'. You may also enter more complex things like 'System:Devs/DataTypes///L/File' and what you get should look like that 'System:L/FileSystem_Trans/'. The path name completion works only for the last part of the path string. @endnode @node drivebutton "Drive Buttons" @prev pathgadget @next commandbutton @{b}@{u}Drive Buttons@{ub}@{uu} Below the path gadgets RO normally has 16 drive buttons but their number is automatically increased to 32 if you specify more buttons. In general you click on a drive button and the specified path name for the button is loaded into a listview. Into which one depends on the current operation mode of the drive buttons. Currently there are two modes supported: The so called 'Active Mode' and the 'Normal Mode'. In 'Normal Mode' the drive button only affects the listview which is directly above it. In 'Active Mode' the drive button loads a path into the activated listview. @endnode @node commandbutton "Command Buttons" @prev drivebutton @next statusbar @{b}@{u}Command Buttons@{ub}@{uu} Below the drive buttons are 3 x 8 command buttons. These gadgets are used to perform actions for the selected files in the active directory listview. 24 buttons are not enough for over 50 internal functions so I implemented a button bank switch mechanism. You can switch between the banks by clicking the 'Status Bar' below the command buttons. Currently RO supports 5 button banks which results in 120 buttons but this might change in a future version. Most internal commands open a progress window. If you close it the operation is aborted but if you hit its iconify gadget RO continues the function in background. Currently supported are the following internal functions... @{" About " link About } Show about information. @{" Action " link Action } Perform fileaction on selected files. @{" AddArc " link AddArc } Add files to archives using 'Arc'. @{" AddArj " link AddArc } Add files to archives using 'Arj'. @{" AddLhA " link AddArc } Add files to archives using 'LhA'. @{" AddZip " link AddArc } Add files to archives using 'Zip'. @{" AddZoo " link AddArc } Add files to archives using 'Zoo'. @{" AddXArc " link AddArc } Add files to archives using 'xArc'. @{" All " link All } Select all entries in active listview. @{" Assign " link Assign } Create an assign for active directory. @{" ByName " link ByName } Select files by name. @{" Bytes " link Bytes } Count bytes of selected entries. @{" Change " link Change } Change sorttype of active listview. @{" Command " link Command } Execute a command. @{" Copy " link Copy } Copy files and directories. @{" CopyAs " link Copy } Copy files and directories and change name. @{" CopyDev " link CopyDev } Copy files to a device. @{" Delete " link Delete } Delete files and directories. @{" Disk " link Disk } Show information about active disk. @{" Dup " link Dup } Duplicate entries. @{" Execute " link Execute } Execute a batch file. @{" Expand " link Expand } Expand a path to its ARCHandler equivalent. @{" Fit " link Fit } Check if entries fit on destination. @{" Help " link Help } Show online help. @{" Icon " link Icon } Select corresponding .info files. @{" Info " link Info } Show quick information for all devices. @{" LActive " link Active } Activate left listview. @{" LCopy " link LCopy } Copy active listview to inactive. @{" LSwap " link LSwap } Swap active and inactive listview @{" ListArc " link ListArc } List contents of archives. @{" LParent " link Parent } Load parent directory of left path. @{" LReload " link Reload } Refresh left directory. @{" LRoot " link Root } Load root directory of left path. @{" MakeDir " link MakeDir } Create directories. @{" MDLoad " link MakeDir } Create a directory and load it. @{" Move " link Move } Move files and directories. @{" MoveAs " link MoveAs } Move files and directories and change name. @{" None " link None } Deselect all entries. @{" Note " link Note } Modify filenotes. @{" Parent " link Parent } Load parent directory. @{" Protect " link Protect } Modify protection flags. @{" Quit " link Quit } Quit 'RO' @{" RActive " link Active } Activate right listview. @{" Reboot " link Reboot } Reboot your system. @{" Relabel " link Relabel } Relabel volumes. @{" Reload " link Reload } Refresh active directory. @{" Rename " link Rename } Rename entries. @{" Rexx " link Rexx } Execute a rexx file. @{" Root " link Root } Load root directory. @{" RParent " link Parent } Load parent directory of right path. @{" RReload " link Reload } Refresh left directory. @{" RRoot " link Root } Load root directory of right path. @{" SetDate " link SetDate } Modify date of a file or directory. @{" Shrink " link Shrink } Shrink an ARCHandler path to normal. @{" Toggle " link Toggle } Toggleselect all entries. @{" Touch " link Touch } Set date or create file. @{" UnArc " link UnArc } Extract files from archives. ...and you may specify any AmigaDOS executable here but consult the @{" Configuration " link configuration} chapter for further information. @endnode @node statusbar "Status Bar" @prev commandbutton @next menus @{b}@{u}Status Bar@{ub}@{uu} RO's status bar is the textfield at the bottom of the main window, it is used to display all general informations about what is currently going on or why a certain operation failed. As described in the Command Buttons section the status bar is also needed to switch between the different command button banks. You can also show a clock and/or a memory display there but this is total under user control so I advice you to check out the @{" Configuration " link configuration} chapter. @endnode @node menus "Menus" @prev statusbar @next configuration @{b}@{u}Menus@{ub}@{uu} RO has the following menus: o Project - About... Opens the about requester. This is the same requester which pops up regulary if you are an unregistered user. - Iconify Iconifies RO and adds an app icon to your Workbench. You can use it as a multifunctional drop icon because every file dropped on it will invoke a action according to its filetype. If you start RO you may force an iconified startup by using the command line argument or the tooltype 'ICONIFY'. - Quit Quits the program and removes RO from memory. o Options - Copy o Flags Toggles whether you want to clone the protection bits while copying a file or not. It has the same effect as the @{" COPYFLAGS " link variable} option in the preference file. o Date Toggles whether you want to clone the date & time of a file while copying or not. It has the same effect as the @{" COPYDATE " link variable } option in the preference file. o Comment Toggles whether you want to clone the file note while copying a file or not. It has the same effect as the @{" COPYNOTE " link variable} option in the preference file. o Check Diskspace Switch this option on if you want to automatically check if the selected files will fit on the destination device before copying them. Due to the fact that 'RAM:' is always 100% full it is excluded from checking. You can also set this option in the preference file with the @{" CHECKFIT " link variable} keyword. - Delete o Verify Toggles the @{" DELVERIFY " link variable} option. This means that if you turn it on a warning requester pops up before deleting files. o Force If you switch this option on RO unprotects protected files before deleting them. This has the same effect as the @{" DELFORCE " link variable} keyword in RO.prefs file. - Overwrite Here you may choose one of the four values 'Always', 'Never', 'Older' or 'Verify'. They have the same effect as the 'ALWAYS', 'NEVER', 'OLDER' and 'VERIFY' value for the @{" OVERWRITE " link variable} keyword. As you might have guessed these entries are mutual exclusive. - Drop icons With this menu entry you can change the behaviour of RO if you drop icons on one of the directory listviews. You may set it to 'Load' or 'Copy'. If you use 'Load' the directory of the dropped icon is loaded in the listview and if you select Copy the file is directly copied into the current loaded directory, so be careful what you choose here. This option can also be set via the @{" APPWINDOW " link variable} keyword in the configuration file. @endnode @node configuration "Configuration" @prev menus @next filetype @{b}@{u}Configuration@{ub}@{uu} RO is configured via a text file which should be copied to 'S:'. It may also be located in the same directory as the executable but it must be called 'RO.prefs'. If you used the install script all files are installed correct. At the current state of development you have to use a standard text editor to modify the config file. RO supports the following configuration keywords... @{" FILETYPE " link filetype} @{" ARCHIVE " link archive} @{" VARIABLE " link variable} @{" MENU " link menu} @{" BUFFER " link buffer} @{" HOTDIR " link hotdir} @{" DRIVE " link drive} @{" BUTTON " link button} Note: Window size and other layout things are configured with the MUI prefs program and I really advice you to read MUI's documentation. @endnode @node filetype "Filetype Configuration" @prev configuration @next archive @{b}@{u}FILETYPE@{ub}@{uu} @{u}SYNOPSIS@{uu} FILETYPE "TypeID" "Command" @{u}DESCRIPTION@{uu} With this keyword you can set commands which should be executed according to the file type of the selected file. Currently it is impossible to add your own file types but RO's built-in file recognition knows about 50 file types. If the recognition fails MultiView will be invoked and if MultiView fails the file is considered as binary file. XPK & PP files are decrunched before checking the file type. TypeID must be one of the Ids listed below and command is a CLI command which should contain a '%s' where the file name should be inserted. (The file name is already in quotes so don't specify them again!) Currently the following 'TypeID's are supported: ASCII ASCII standard text file BINARY A not recognized binary file BMP Windows 3.x BitMap Picture COMPRESS Compressed file DMS DMS Disk Archive (.dms) DVI TeX DVI file FLI FLI animation file FREEZE Freezed file GDM GoldDisk movie file GIF GIF v87a & GIF v89a Picture (.gif) GUIDE AmigaGuide file GZIP GZipped file HTML Html file ICON Amiga Icon file JPEG JPeg Picture (Type 1 & Type 2,JFIF) MOD Noise- & Protracker, StarTrekker, MED, OctaMed, Octalyzer, FTM, FutureComposer 1.3&1.4, TFMX, ScreamTracker, SoundMon, S3M, JamCracker, PlaySID (OneFile) Modules OBJ Amiga linkable object file PCX PCX Picture PS PostScript file SUN Sun Raster Image RAS (.RAS) TGA Targa Image (.TGA) TIFF Tiff Picture Type 1 & 2 (.TIF) 24BI Iff: 24bit picture 8SVX Iff: 8-bit sample voice ANIM Iff: Anim file CPFM Iff: Personal FontManager Charset/Font CDVR Iff: Can Do Variable File DECK Iff: Can Do Deck File DMCS Iff: General Music Score (DeluxeMusicConKit) DR2D Iff: Vector Picture (ArtExpression) FAXX Iff: GPFax File FTXT Iff: Formatted Text HEAD Iff: Flow File ILBM Iff: Interleaved Bit Map (Picture) OFNT Iff: ProVector Font PENV Iff: PenPal Document SC3D Iff: Sculpt 3d SMUS Iff: Simple Music Score SPAB Iff: SpAB School Data File SWRT Iff: FinalCopy II / FinalWriter Document TEXT Iff: Plain unformatted Ascii Text VDEO Iff: Deluxe Video WORD Iff: Document (ProWrite) WOWO Iff: Word Worth Document @{u}ARGUMENTS@{uu} "TypeID" file type identifier. "Command" CLI command to be executed. @{u}DEFAULT@{uu} Command is set to "MultiView >NIL: %s" for all supported file types. @{u}EXAMPLE@{uu} FILETYPE GUIDE "MultiView >NIL: %s" @endnode @node archive "Archive Configuration" @prev filetype @next variable @{b}@{u}ARCHIVE@{ub}@{uu} @{u}SYNOPSIS@{uu} ARCHIVE "ArcID" "Command" @{u}DESCRIPTION@{uu} With this keyword you can set commands which should be executed according to the archive type of the selected files. There are three commands for each archive type: a normal arc command, an unarc command and a listarc command. ArcID is one of the archive type identifiers listed below and command is a CLI command which should contain one or two '%s'. Listing archives and extracting archives needs only one '%s' for the file name but adding files to archive requires two '%s'. The first one for the name of the archive which should be generated and the second one for the file name to add. Currently the following 'ArcID's are supported: ARC Arc archive add ARJ Arj archive add LHA LhA archive add ZIP Zip archive add ZOO Zoo archive add XARC Xpk archive add LISTARC Arc archive list LISTARJ Arj archive list LISTLHA LhA archive list LISTZIP Zip archive list LISTZOO Zoo archive list LISTXARC Xpk archive list UNARC Arc archive extract UNARJ Arj archive extract UNLHA LhA archive extract UNZIP Zip archive extract UNZOO Zoo archive extract UNXARC Xpk archive extract @{u}ARGUMENTS@{uu} "ArcID" archive type identifier. "Command" CLI command to execute. @{u}DEFAULT@{uu} ARCHIVE ARC "Arc a %s %s" ARCHIVE ARJ "Arj a %s %s" ARCHIVE LHA "LhA -x -r a %s %s" ARCHIVE ZIP "Zip a %s %s" ARCHIVE ZOO "Zoo a %s %s" ARCHIVE XARC "xArc %s %s" ARCHIVE UNARC "Arc x %s %s" ARCHIVE UNARJ "Arj x %s %s" ARCHIVE UNLHA "LhA x %s %s" ARCHIVE UNZIP "Zip x %s %s" ARCHIVE UNZOO "Zoo x %s %s" ARCHIVE UNXARC "xArc x %s %s" ARCHIVE LISTARC "Arc v %s" ARCHIVE LISTARJ "Arj v %s" ARCHIVE LISTLHA "LhA v %s" ARCHIVE LISTZIP "Zip v %s" ARCHIVE LISTZOO "Zoo v %s" ARCHIVE LISTXARC "xArc -l %s" @{u}EXAMPLE@{uu} ARCHIVE LhA "c:LhA a %s %s" @endnode @node variable "General Configuration" @prev archive @next menu @{b}@{u}VARIABLE@{ub}@{uu} @{u}SYNOPSIS@{uu} VARIABLE "VarID" "Value" @{u}DESCRIPTION@{uu} This keyword is needed to set some important options. 'VarID' is one of the variable names listed below and value is a parameter string for the variable. Currently the following 'VarID's are supported: Global: - APPWINDOW Here you can specify what happens when you drop an icon on a listview. If you set it to 'LOAD' the directory of the dropped icon will be loaded into the listview, if you use 'COPY' the dropped file or directory will be copied into it the current loaded directory. Example: VARIABLE APPWINDOW "LOAD" - ARCHANDLER Here you can switch ON or OFF whether you like to want RO to support ARCHandler. If you switch it ON and you doubleclick on a .lha file the path will be expanded to its ARCHandler equivalent and RO will load the directory corresponding to the selected archive. Example: VARIABLE ARCHANDLER "ON" - COMPLETED Here you can specify what should happen if RO finished an operation while it is iconified. You may set it to 'NOTHING', 'FLASH' or 'POPUP'. Example: VARIABLE COMPLETED "NOTHING" - CHECKFIT Here you can switch ON or OFF whether you like to check the filesize if it fits on the destination disk or not. RO counts the bytes and checks how many blocks are needed for organisation etc. on the destination device. So don't get confused by values which seem to be wrong. Example: VARIABLE CHECKFIT "ON" - CREATEICONS If you want RO to create a directory icon if you use makedir or to create a project icon if you create a file set this option ON, if not switch it OFF. Example: VARIABLE CREATEICONS "OFF" - DRIVEBUTTONS It is a bit difficult to explain... there are two different types of Drivebutton handling. The first one is called 'Normal' and the second one is called 'Active'. In normal mode you have eight Drivebuttons for every side, so if you click on a Drivebutton below the left side the directory is loaded in the left side. In active mode you have sixteen Drivebuttons for both sides. If you click on a Drivebutton it affects the active Listview and not the one according to the side where you clicked. Example: VARIABLE DRIVEBUTTONS "Active" - FLUSHMEMORY If you want RO to flush memory on exit, switch this option ON. This will remove MUI from memory if no other application using it is currently running. Example: VARIABLE FLUSHMEMORY "ON" - FOLLOWSCROLL This keyword is needed to switch ON or OFF whether you like to scroll the directory window to follow operations or not. Example: VARIABLE FOLLOWSCROLL "OFF" - HISTORY Here you can set the number of buffers RO should remember. Example: VARIABLE HISTORY "42" - HOTDIRS Exactly the same as DRIVEBUTTONS but for HotDirs. Function keys F1 to F5 affect the left side, F6 to F10 affect the right side. Example: VARIABLE HOTDIRS "Active" - OUTPUT Specify the default output window for all commands launched by RO. Example: VARIABLE OUTPUT "CON:0/0/640/400/Output/CLOSE/AUTO" - OVERWRITE You can specify what should happen if you write to a file which already exists perhaps if you want to copy another one over it. You may choose between 'ALWAYS', 'NEVER', 'OLDER' and 'VERIFY'. ALWAYS will quietly overwrite the file without further information, NEVER will break the operation if a file already exists, OLDER will only replace older files and VERIFY will pop up a 'Do you really want...' requester. Example: VARIABLE OVERWRITE "ALWAYS" - PATHEXPAND This switch controls the path extension. If you switch it ON all paths are 'expanded'. E.g. if you enter LIBS: it is expanded to something like "System:Libs/". Some older filesystems like ParNet, SerNet or MessyDOS may cause problems with it, so if you use one of them turn this switch OFF. - QUITVERIFY Switches the 'Do you really want to quit RO?' requester ON or OFF, where you can select Quit, Iconify or Cancel. Hitting the Close Gadget equals clicking the Cancel Gadget. Example: VARIABLE QUITVERIFY "ON" - TEMPDIR Here you can specify a temporary directory which is needed for some special actions like decrunching files or listing archives. Example: VARIABLE TEMPDIR "TEMP:" Copy: - COPYBUF Here you can set the maximum buffer RO will use for copying files. Example: VARIABLE COPYBUF "50000" - COPYDATE Here you can switch ON or OFF whether you like to copy the date of a file or not. Otherwise the date will be set to the actual date. Example: VARIABLE COPYDATE "OFF" - COPYFLAGS Here you can switch ON or OFF whether you like to copy the protection bits or not. If not, RO sets the default protection (RWED). Example: VARIABLE COPYFLAGS "OFF" - COPYNOTE Here you can switch ON or OFF whether you like to copy the note of a file or not. If not, RO clears the note field. Example: VARIABLE COPYNOTE "OFF" - COPYSTAT Here you can switch ON or OFF whether you like to see the currently copied file or not. This could be useful if you copy many small files because displaying every copied file in the status bar could mean a heavy cpu load. Example: VARIABLE COPYSTAT "OFF" Delete: - DELDELAY Here you can specify a delay in ticks (50 ticks = 1 second) to wait before deleting a temporary generated file (e.g. while listing an archive or decrunching a XPK packed file). This could be useful if you have a text viewer which detaches from CLI and is not fast enough to load the temp file before it is deleted. Warning: There might be problems deleting the file if the command locks the temp file. So its better to use a command that does not detach from CLI. Example: VARIABLE DELDELAY "50" - DELFORCE Here you can switch ON or OFF whether you want to force deleting of protected files. This setting also affects overwriting protected files. If you switch it ON the files are quietly deleted/overwritten. Example: VARIABLE DELFORCE "ON" - DELSTAT Here you can switch ON or OFF whether you like to see the currently deleted file in the status bar or not. This might be useful for the same reasons as COPYSTAT. Example: VARIABLE DELSTAT "OFF" - DELVERIFY Switches the 'Are you sure you want to delete these entries ?' requester ON or OFF. Example: VARIABLE DELVERIFY "OFF" Listview: - LOADLEFT/LOADRIGHT You can specify a path which is automatically loaded in the according Listview on startup Example: VARIABLE LOADRIGHT "RAM:" - PAGELEFT/PAGERIGHT This variable sets the page which is in front if you start RO. There are three pages: 'Directory', 'Buffers' and 'Volumes'. Example: VARIABLE PAGERIGHT "Volumes" - FIRSTLEFT/FIRSTRIGHT Adjust the place which type of directory entries is displayed first. Possible settings are "Dirs", "Files" and "Mixed". Example: VARIABLE FIRSTLEFT "Mixed" - SORTLEFT/SORTRIGHT Indicate which field should be used as sort criteria. Possible settings are "Name", "Date" and "Size". Example: VARIABLE SORTRIGHT "Size" Clock: - CLOCKPRI You can specify the priority of the 'RO Clock' Task here. I suggest to use the default value. The value must be between -128 and 127 Example: VARIABLE CLOCKPRI "0" - CLOCKREFRESH Here you should specify the ticks (50 ticks = 1 second) between two clock updates. This value should be choosen carefully, because if you specify a very small value the clock starts flashing. Example: VARIABLE CLOCKREFRESH "50" - SHOWDATE Here You may specify if you want to display a date string in the status bar not. Example: VARIABLE SHOWDATE "OFF" - SHOWDAY Here you may specify if a day string like 'Sunday' or 'Monday' should be displayed. Example: VARIABLE SHOWDAY "ON" - SHOWTIME Switch this variable 'ON' if you want RO's Clock to display the time. Example: VARIABLE SHOWTIME "OFF" - SHOWSECONDS Specifies if RO's Clock should display seconds. This variable takes only affect if SHOWTIME is set to 'ON'. I suggest to turn this option off to avoid heavy cpu loads. Example: VARIABLE SHOWSECONDS "ON" - SHOWMEMORY Here you can switch the Workbench-Style Memory display 'ON' and 'OFF' Example: VARIABLE SHOWMEMORY "ON" @{u}DEFAULT@{uu} VARIABLE TEMPDIR "T:" VARIABLE OUTPUT "CON:0/0/640/200/Output/CLOSE/AUTO" VARIABLE HISTORY "50" VARIABLE COMPLETED "Flash" VARIABLE DRIVEBUTTONS "Normal" VARIABLE HOTDIRS "Normal" VARIABLE ARCHANDLER "OFF" VARIABLE CHECKFIT "ON" VARIABLE QUITVERIFY "ON" VARIABLE FLUSHMEMORY "OFF" VARIABLE OVERWRITE "VERIFY" VARIABLE APPWINDOW "LOAD" VARIABLE CREATEICONS "ON" VARIABLE FOLLOWSCROLL "ON" VARIABLE PATHEXPAND "ON" VARIABLE COPYBUF "1048576" VARIABLE COPYDATE "ON" VARIABLE COPYFLAGS "ON" VARIABLE COPYNOTE "ON" VARIABLE COPYSTAT "ON" VARIABLE DELDELAY "0" VARIABLE DELFORCE "OFF" VARIABLE DELVERIFY "ON" VARIABLE DELSTAT "ON" VARIABLE LOADLEFT "" VARIABLE LOADRIGHT "" VARIABLE PAGELEFT "Directory" VARIABLE PAGERIGHT "Directory" VARIABLE FIRSTLEFT "Dirs" VARIABLE FIRSTRIGHT "Dirs" VARIABLE SORTLEFT "Name" VARIABLE SORTRIGHT "Name" VARIABLE CLOCKREFRESH "500" VARIABLE CLOCKPRI "-10" VARIABLE SHOWDAY "ON" VARIABLE SHOWDATE "ON" VARIABLE SHOWTIME "ON" VARIABLE SHOWSECONDS "OFF" VARIABLE SHOWMEMORY "ON" @endnode @node menu "Menu Configuration" @prev variable @next buffer @{b}@{u}MENU@{ub}@{uu} @{u}SYNOPSIS@{uu} MENU "MenuText" "Command" @{u}DESCRIPTION@{uu} With this keyword you can create a user menu with up to 20 entries, the command may contain a '%s' if you want to use your menu entry to perform a action on the selected files. If you just want to start a general utility like a disk copier or a calculator do not specify a '%s' within the command string otherwise a selected entry is needed to start the command. @{u}ARGUMENTS@{uu} "MenuText" 40 characters as menu text "Command" CLI command to execute @{u}DEFAULT@{uu} MENU "" "" @{u}EXAMPLE@{uu} MENU "Calculator" "SYS:Tools/Calculator" @endnode @node buffer "Buffer Configuration" @prev menu @next hotdir @{b}@{u}BUFFER@{ub}@{uu} @{u}SYNOPSIS@{uu} BUFFER "PathName" @{u}DESCRIPTION@{uu} With this keyword it is possible to fill the 'Buffer' page with directories you often need. The number of buffers is only limited by the amount of memory you have. @{u}ARGUMENTS@{uu} "PathName" directory name to insert @{u}DEFAULT@{uu} BUFFER "" @{u}EXAMPLE@{uu} BUFFER "DH1:Comm/Term/Uploads" @endnode @node hotdir "HotDir Configuration" @prev buffer @next drive @{b}@{u}HOTDIR@{ub}@{uu} @{u}SYNOPSIS@{uu} HOTDIR "Number" "PathName" @{u}DESCRIPTION@{uu} Here you can specify up to ten Hotdirs. These Hotdirs can be accessed via the function keys F1-F10. 'Number' must between 1 and 10. @{u}ARGUMENTS@{uu} "Number" function key number between 1 and 10 "PathName" directory name to load @{u}DEFAULT@{uu} HOTDIR 1 "" HOTDIR 2 "" HOTDIR 3 "" HOTDIR 4 "" HOTDIR 5 "" HOTDIR 6 "" HOTDIR 7 "" HOTDIR 8 "" HOTDIR 9 "" HOTDIR 10 "" @{u}EXAMPLE@{uu} HOTDIR 5 "DH1:Comm/Term/Uploads" @endnode @node drive "Drive Configuration" @prev hotdir @next button @{b}@{u}DRIVE@{ub}@{uu} @{u}SYNOPSIS@{uu} DRIVE "Number" "GadgetText" "PathName" @{u}DESCRIPTION@{uu} Here you can specify up to 32 drive buttons, if you specify 16 buttons you will get only one row of gadgets if you specify more, a second row will be added. The GadgetText is limited to 10 characters this should be enough and more would need a really high resolution. It might happen that RO does not fit on your screen even with 5 characters per button. It would be best if you play around with it but I suggest to use 3 characters. @{u}ARGUMENTS@{uu} "Number" number of drive button between 1 and 32 "GadgetText" 10 characters as gadget text "PathName" directory name to load @{u}DEFAULT@{uu} DRIVE 1 "DF0" "DF0:" DRIVE 2 "DF1" "DF1:" DRIVE 3 "DH0" "DH0:" DRIVE 4 "DH1" "DH1:" DRIVE 5 "DH2" "DH2:" DRIVE 6 "DH3" "DH3:" DRIVE 7 "CD0" "CD0:" DRIVE 8 "RAM" "RAM:" DRIVE 9 "DF0" "DF0:" DRIVE 10 "DF1" "DF1:" DRIVE 11 "DH0" "DH0:" DRIVE 12 "DH1" "DH1:" DRIVE 13 "DH2" "DH2:" DRIVE 14 "DH3" "DH3:" DRIVE 15 "CD0" "CD0:" DRIVE 16 "RAM" "RAM:" @{u}EXAMPLE@{uu} DRIVE 2 "INBOUND" "Work:News/Inbound/" @endnode @node button "Button Configuration" @prev drive @next arexxinterface @{b}@{u}BUTTON@{ub}@{uu} @{u}SYNOPSIS@{uu} BUTTON "Number" "ButtonType" "GadgetText" "Command" @{u}DESCRIPTION@{uu} This is the most important keyword in the RO's configuration, here you can specify which text appears on which button and which command is executed if you click on a button. After the Keyword you have to supply a number of the button you want to set. It must be between 1 and 120. Currently RO supports two types of Buttons: A command button and a function button. A command button is a button where you can implement a standard CLI command. All you have to do is to supply a command string with a '%s' at the position where the file name should be inserted. The function button is a button where you call internal functions. You must also supply a gadget string for the button which may not be longer than 10 characters. If you specify a gadget string like '_Copy' or 'R_ename' then you are able to access the gadget via keys, but beware of dupes like '_Delete' & '_Disk'. Currently supported are the following internal functions: @{" About " link About } Show about information. @{" Action " link Action } Perform fileaction on selected files. @{" AddArc " link AddArc } Add files to archives using 'Arc'. @{" AddArj " link AddArc } Add files to archives using 'Arj'. @{" AddLhA " link AddArc } Add files to archives using 'LhA'. @{" AddZip " link AddArc } Add files to archives using 'Zip'. @{" AddZoo " link AddArc } Add files to archives using 'Zoo'. @{" AddXArc " link AddArc } Add files to archives using 'xArc'. @{" All " link All } Select all entries in active listview. @{" Assign " link Assign } Create an assign for active directory. @{" ByName " link ByName } Select files by name. @{" Bytes " link Bytes } Count bytes of selected entries. @{" Change " link Change } Change sorttype of active listview. @{" Command " link Command } Execute a command. @{" Copy " link Copy } Copy files and directories. @{" CopyAs " link Copy } Copy files and directories and change name. @{" CopyDev " link CopyDev } Copy files to a device. @{" Delete " link Delete } Delete files and directories. @{" Disk " link Disk } Show information about active disk. @{" Dup " link Dup } Duplicate entries. @{" Execute " link Execute } Execute a batch file. @{" Expand " link Expand } Expand a path to its ARCHandler equivalent. @{" Fit " link Fit } Check if entries fit on destination. @{" Help " link Help } Show online help. @{" Icon " link Icon } Select corresponding .info files. @{" Info " link Info } Show quick information for all devices. @{" LActive " link Active } Activate left listview. @{" LCopy " link LCopy } Copy active listview to inactive. @{" LSwap " link LSwap } Swap active and inactive listview @{" ListArc " link ListArc } List contents of archives. @{" LParent " link Parent } Load parent directory of left path. @{" LReload " link Reload } Refresh left directory. @{" LRoot " link Root } Load root directory of left path. @{" MakeDir " link MakeDir } Create directories. @{" MDLoad " link MakeDir } Create a directory and load it. @{" Move " link Move } Move files and directories. @{" MoveAs " link MoveAs } Move files and directories and change name. @{" None " link None } Deselect all entries. @{" Note " link Note } Modify filenotes. @{" Parent " link Parent } Load parent directory. @{" Protect " link Protect } Modify protection flags. @{" Quit " link Quit } Quit 'RO' @{" RActive " link Active } Activate right listview. @{" Reboot " link Reboot } Reboot your system. @{" Relabel " link Relabel } Relabel volumes. @{" Reload " link Reload } Refresh active directory. @{" Rename " link Rename } Rename entries. @{" Rexx " link Rexx } Execute a rexx file. @{" Root " link Root } Load root directory. @{" RParent " link Parent } Load parent directory of right path. @{" RReload " link Reload } Refresh left directory. @{" RRoot " link Root } Load root directory of right path. @{" SetDate " link SetDate } Modify date of a file or directory. @{" Shrink " link Shrink } Shrink an ARCHandler path to normal. @{" Toggle " link Toggle } Toggleselect all entries. @{" Touch " link Touch } Set date or create file. @{" UnArc " link UnArc } Extract files from archives. @{u}ARGUMENTS@{uu} "Number" number of drive button between 1 and 120 "ButtonType" command or function button "GadgetText" up to ten chars as gadget text "Command" command to execute @{u}DEFAULT@{uu} BUTTON 1 COMMAND "Read" "Most >NIL: %s" BUTTON 2 COMMAND "Run" "Run >NIL: %s" BUTTON 3 FUNCTION "_Delete" DELETE BUTTON 4 FUNCTION "_Move" MOVE BUTTON 5 FUNCTION "_Copy" COPY BUTTON 6 FUNCTION "_Bytes" BYTES BUTTON 7 FUNCTION "All" ALL BUTTON 8 FUNCTION "Arc" ADDLHA BUTTON 9 COMMAND "View" "MultiView >NIL: %s" BUTTON 10 COMMAND "_Edit" "Ed >NIL: %s" BUTTON 11 FUNCTION "Touch" TOUCH BUTTON 12 FUNCTION "Move As" MOVEAS BUTTON 13 FUNCTION "Copy As" COPYAS BUTTON 14 FUNCTION "Fit" FIT BUTTON 15 FUNCTION "None" NONE BUTTON 16 FUNCTION "ListArc" LISTARC BUTTON 17 FUNCTION "_Action" ACTION BUTTON 18 COMMAND "XEdit" "FileX >NIL: %s" BUTTON 19 FUNCTION "MakeDir" MAKEDIR BUTTON 20 FUNCTION "_Rename" RENAME BUTTON 21 FUNCTION "Dup" DUP BUTTON 22 FUNCTION "Refresh" RELOAD BUTTON 23 FUNCTION "_Pattern" BYNAME BUTTON 24 FUNCTION "UnArc" UNARC BUTTON 25 COMMAND "Music" "DeliTracker >NIL: MODULE %s" BUTTON 26 FUNCTION "Assign" ASSIGN BUTTON 27 FUNCTION "Command" COMMAND BUTTON 28 FUNCTION "_Comment" NOTE BUTTON 29 FUNCTION "Change" CHANGE BUTTON 30 FUNCTION "Parent" PARENT BUTTON 31 FUNCTION "Reverse" TOGGLE BUTTON 32 FUNCTION "About" ABOUT BUTTON 33 FUNCTION "LSwap" LSWAP BUTTON 34 FUNCTION "_Relabel" RELABEL BUTTON 35 FUNCTION "Execute" EXECUTE BUTTON 36 FUNCTION "_Protect" PROTECT BUTTON 37 FUNCTION "_Expand" EXPAND BUTTON 38 FUNCTION "Root" ROOT BUTTON 39 FUNCTION "Icon" ICON BUTTON 40 FUNCTION "Help" HELP BUTTON 41 FUNCTION "LCopy" LCOPY BUTTON 42 FUNCTION "CopyDev" COPYDEV BUTTON 43 FUNCTION "Rexx" REXX BUTTON 44 FUNCTION "SetDate" SETDATE BUTTON 45 FUNCTION "_Shrink" SHRINK BUTTON 46 FUNCTION "_Disk" DISK BUTTON 47 FUNCTION "_Info" INFO BUTTON 48 FUNCTION "Quit" QUIT @{u}EXAMPLE@{uu} BUTTON 98 COMMAND "DirTree" "c:DirTree %s" @endnode @{b}@{u}BUTTON@{ub}@{uu} @node About @prev UnArc @next Action @{b}@{u}About@{ub}@{uu} This function opens the requester which contains my address and other information about the registration. @endnode @node Action @prev About @next AddArc @{b}@{u}Action@{ub}@{uu} This function performs a command on every selected file according to its file type. You have to specify a command for each file type if you want to use this function otherwise MultiView will be started for all file types. Consult the @{" FILETYPE " link filetype} section in the configuration chapter for further information. You can abort this option by closing the progress indication window. @endnode @node AddArc @prev Action @next All @{b}@{u}AddArc@{ub}@{uu} This function adds all selected files to an archive file. The archive file will be created on the destination device and a requester will pop up to ask you for a name. There exists a function for every archive type e.g. 'AddLhA' or 'AddArj'. You can abort this option by closing the progress indication window. @endnode @node All @prev AddArc @next Assign @{b}@{u}All@{ub}@{uu} This function selects all entries in the active directory listview. @endnode @node Assign @prev All @next ByName @{b}@{u}Assign@{ub}@{uu} This function creates an assign for the path currently loaded in the active listview. A requester will pop up to ask you for a device name. You should enter something like 'foobar:' here. The colon is optional and may be left out. @endnode @node ByName @prev Assign @next Bytes @{b}@{u}ByName@{ub}@{uu} This function selects all entries matching a specified pattern in the active directory listview. A requester pops up and asks you for a pattern. You may specify all standard AmigaDOS wildcards such as '#?' or '*' here. @endnode @node Bytes @prev ByName @next Change @{b}@{u}Bytes@{ub}@{uu} This function counts all bytes of the selected entries and their sub directories in the active listview. After that an information is displayed in the status bar which should look like '64728 Bytes in 109 Files and 15 Directories'. You can abort this option by closing the progress indication window. @endnode @node Change @prev Bytes @next Command @{b}@{u}Change@{ub}@{uu} With this function you can change the current sort type of the active listview. This works analog to the @{" SORTLEFT " link variable}, @{" SORTRIGHT " link variable} and @{" FIRSTLEFT " link variable}, @{" FIRSTRIGHT " link variable} keywords in the configuration file. A requester opens where you can select the sort criterias. @endnode @node Command @prev Change @next Copy @{b}@{u}Command@{ub}@{uu} This function lets you start a standard CLI command. @endnode @node Copy @prev Command @next CopyDev @{b}@{u}Copy@{ub}@{uu} This function copies all selected files and/or directories from the source listview to the destination path. If you use CopyAs a requester pops up which asks you for a new name of the currently copied file. You can abort the operation by hitting the 'Cancel' gadget or you may skip the current file by clicking on 'Skip'. If you set the according options in the preference file or you selected them from menu, the flags, comment and date of the copied files are cloned. Refer to the @{" VARIABLE " link variable} configuration chapter. You can abort this option by closing the progress indication window. @endnode @node CopyDev @prev Copy @next Delete @{b}@{u}CopyDev@{ub}@{uu} This function copies all selected files of the active listview to a specified device. A requester pops up which asks you where the entries should be copied to. This is useful if you have a couple of ascii text files and want to print them. All you have to do is 'CopyDev' them to 'PRT:'. @endnode @node Delete @prev CopyDev @next Disk @{b}@{u}Delete@{ub}@{uu} This function deletes all entries currently selected in the active directory. A requester might pop up which asks you if you are really sure that you want to delete the selected entries but this depends on your configuration or on the @{" DELVERIFY " link variable} settings in the menu. You can abort this option by closing the progress indication window. @endnode @node Disk @prev Delete @next Dup @{b}@{u}Disk@{ub}@{uu} This function opens a requester which shows all information about the device currently loaded in the active listview. You can obtain things like free bytes or block size of the device here. To close the requester just click on okay or use the close gadget. @endnode @node Dup @prev Disk @next Execute @{b}@{u}Dup@{ub}@{uu} This function duplicates all selected entries in the active listview. You will be asked at each entry how to call the copy. You may abort this function by hitting the 'Cancel' gadget or you may skip a single file by clicking on the 'Skip' gadget. @endnode @node Execute @prev Dup @next Expand @{b}@{u}Execute@{ub}@{uu} This function lets you execute a standard batch file. @endnode @node Expand @prev Execute @next Fit @{b}@{u}Expand@{ub}@{uu} If you use ARCHandler this might be useful for you. This function expands the path name of the actual loaded directory of the active listview. e.g. System:Devs/ to Archives:System/Devs/ @endnode @node Fit @prev Expand @next Help @{b}@{u}Fit@{ub}@{uu} This function calculates the number of bytes the selected enties will need on the destination device. RO also cares about the blocks needed for directory organisation. After that an information is displayed in the status bar which tells you if the selected entries fit on the destination device or not. You can abort this option by closing the progress indication window. @endnode @node Help @prev Fit @next Icon @{b}@{u}Help@{ub}@{uu} This function opens the online help main page. You can also get this by pressing the HELP key. When the HELP key is pressed RO tries to obtain the help node from the current object (the one under the mouse pointer) and shows the according help page. Make sure that you set the environement 'ENV:AmigaGuide/Path' correct so RO can find the helpfile if it's not in the same directory as the executable. @endnode @node Icon @prev Help @next Info @{b}@{u}Icon@{ub}@{uu} This function selects all corresponding '.info' files for the current selected entries in the active listview. @endnode @node Info @prev Icon @next Active @{b}@{u}Info@{ub}@{uu} This function opens a requester which shows all information about the currently selected entries of the active listview. You can obtain things like file type and protection bits here. To get to the next file close the requester just by clicking on okay. The function may be aborted by hitting the 'Cancel' gadget or by closing the window via close gadget. @endnode @node Active @prev Info @next LCopy @{b}@{u}Active@{ub}@{uu} This function lets you activate a certain Listview. LActive activates the left one and RActive activates the right one. @endnode @node LCopy @prev Active @next LSwap @{b}@{u}LCopy@{ub}@{uu} This function copies the active listview path to the other listview. @endnode @node LSwap @prev LCopy @next ListArc @{b}@{u}LSwap@{ub}@{uu} This function swaps the active and inactive listview paths. @endnode @node ListArc @prev LSwap @next Parent @{b}@{u}ListArc@{ub}@{uu} This function lists all selected archive files using the matching archive lister and the ascii file type command. You can abort this option by closing the progress indication window. @endnode @node Parent @prev ListArc @next Reload @{b}@{u}Parent@{ub}@{uu} This function loads the parent directory of the active listview. If you use 'LParent' it performs a Parent function on the left listview if you use 'RParent' it uses the right listview. If RO can't find a parent directory for the path it just updates the directory. @endnode @node Reload @prev Parent @next Root @{b}@{u}Reload@{ub}@{uu} The functions Reload, LReload and RReload update the active, left or right directory currently loaded in the directory listview. @endnode @node Root @prev Reload @next MakeDir @{b}@{u}Root@{ub}@{uu} This function loads the root directory of the active listview. If you use LRoot or RRoot this function applies to the left or right side. @endnode @node MakeDir @prev Root @next Move @{b}@{u}MakeDir@{ub}@{uu} If you use this function a requester appears which asks you for a name. The name you enter will be used as name for a directory which is created in the active listview. If you use 'MDLoad' instead the directory is also loaded into the source listview. @endnode @node Move @prev MakeDir @next None @{b}@{u}Move@{ub}@{uu} This function moves all selected files and/or directories from the source listview to the destination path. If you use MoveAs a requester pops up which asks you for a new name of the currently copied file. You can abort the operation by hitting the 'Cancel' gadget or you may skip the current file by clicking on 'Skip'. RO notices if you move files from a device to the same device. It just renames the files which is propably much faster than copying and deleting them. If you set the according options in the preference file or you selected them from menu the flags, comment and date of the moved files are cloned. Refer to the @{" VARIABLE " link variable} configuration chapter. You can abort this option by closing the progress indication window. @endnode @node None @prev Move @next Note @{b}@{u}None@{ub}@{uu} This function deselects all entries in the active directory listview. @endnode @node Note @prev None @next Protect @{b}@{u}Note@{ub}@{uu} This function lets you change the file comment of all selected entries in the active listview. A requester pops up which contains the old comment and you may change it there. The operation can be aborted by hitting the 'Cancel' gadget or you may skip the current file by clicking the 'Skip' gadget. To proceed just press return or use the 'Okay' button. @endnode @node Protect @prev Note @next Quit @{b}@{u}Protect@{ub}@{uu} This function opens a requester where you may change the protection bits for the selected entries. For each protection flag you may choose 'Ignore', 'Set' or 'UnSet'. 'Ignore' means that this bit is not changed, 'Set' means that this bit is set and 'UnSet' means that this bit is cleared. You may change these bits step by step for each entry by using the 'Okay' gadget or you may change them all at once by clicking the 'All' button. The operation may be aborted by hitting the 'Cancel' gadget or by closing the progress indication window. @endnode @node Quit @prev Protect @next Reboot @{b}@{u}Quit@{ub}@{uu} Quits the program and removes RO from memory. @endnode @node Reboot @prev Quit @next Relabel @{b}@{u}Reboot@{ub}@{uu} Reboots your computer without any warning requester. :) @endnode @node Relabel @prev Reboot @next Rename @{b}@{u}Relabel@{ub}@{uu} With this function you can change the device name of the directory loaded in the active listview. A requester pops up and you may modify the name there. If you want to abort the operation use the 'Cancel' button. @endnode @node Rename @prev Relabel @next Rexx @{b}@{u}Rename@{ub}@{uu} This function is needed to rename the selected entries. A requester pops up for every entry and you may change its name. If you want to abort the operation click on 'Cancel' but if you just want to skip the current entry select 'Skip'. After you have changed the name press return to proceed or hit the 'Okay' Button. @endnode @node Rexx @prev Rename @next SetDate @{b}@{u}Rexx@{ub}@{uu} This function lets you start a standard rexx script. @endnode @node SetDate @prev Rexx @next Shrink @{b}@{u}SetDate@{ub}@{uu} This function lets you set the date and time of all entries currently selected in the active listview. A requester pops up with the old date and time of the entry as string gadget contents and you may modify it. The input must be in standard AmigaDOS format. You may abort the function by using the 'Cancel' gadget or you may skip the current file by hitting the 'Skip' button. @endnode @node Shrink @prev SetDate @next Toggle @{b}@{u}Shrink@{ub}@{uu} If you use ARCHandler this might be useful for you. This function shrinks the path name of the actual loaded directory of the active listview. e.g. Archives:System/Devs/ to System:Devs/ but it works only if the currently loaded directory is no archive file. @endnode @node Toggle @prev Shrink @next Touch @{b}@{u}Toggle@{ub}@{uu} This function toggle selects all entries in the active directory listview. @endnode @node Touch @prev Toggle @next UnArc @{b}@{u}Touch@{ub}@{uu} If you have one or more entries selected this function updates the date and time, otherwise a requester asks you for a file name and this file will be created in the active path. If you are updating dates you may abort the operation by closing the progress indication window otherwise just press the 'Cancel' button. @endnode @node UnArc @prev Touch @next About @{b}@{u}UnArc@{ub}@{uu} This function extracts all selected archives to the destination listview using an archive extracter according to the file type. You can abort this option by closing the progress indication window. @endnode @node arexxinterface "Arexx Interface" @prev button @next discussion @{b}@{u}ARexx Interface@{ub}@{uu} RO has a built-in ARexx port, but in this version RO understands only the standard MUI application arexx commands. - QUIT Ends the application. - HIDE Hides (iconifies) the application - SHOW Shows (pops up) an iconified application. - INFO ITEM/A According to the given parameter the result string is filled with the following contents: - "title" Title of the application - "author" Author of the application - "copyright" Copyright message - "description" Short description - "version" Version string - "base" Name of the ARexx port - "screen" Name of the public screen - HELP FILE/A A list of all ARexx commands available for the application is written into the given file. In addition to the default commands an MUI application can (and of course should) support many application specific commands. The help list will contain these commands as well. ...this is a small extract from the MUI documentation and you should consult the according part there for further information. @endnode @node discussion "Discussion" @prev arexxinterface @next registration Q: Sometimes RO does not recognize that I have a file selected. Why? A: No there is another problem. It is sometimes really difficult to see if a file is selected or not because the cursor which is normally needed for keyboard control has nearly the same color as a selected file with the cursor on it. You can 'fix' this problem if you set the 'BG Listview Selected+Cursor' image to another color. Q: How can I change the active side without selecting a file? A: You may also cycle the listviews via 'tab' or you may activate a path gadget either by pressing the '`' key or via mouse. Q: I start RO and nothing happens. What's the problem? A: Your screen resolution might be too low especially the screen width so RO doesn't fit on your screen. Try using a smaller font or use the Overscan Prefs to gain some pixels. The minimum RO needs to work are 640 x 200 and topaz 8 font. @endnode @node registration "Registration" @prev discussion @next registrationform @{b}@{u}Registration@{ub}@{uu} If you register you will recieve a disk with the newest public release of RO and a personalized, so-called "keyfile" that turns the crippled version into a full functional and powerful Directory Tool! With the keyfile you can unlock all future versions of RO. The price for a RO registration is 20.- DM (D-Mark), 15.- US$ (US Dollar) or an equivalent amount of US$ 20.- (twenty!) in any other currency. "Twenty" because I have to visit my bank and sell your foreign currency which is some kind of expensive here in Germany. If you think your bank does it cheaper, feel free to get some 15.- US$ at home and send them. The fastest, cheapest and easiest way to register is put the money together with the filled registration form into a letter and send it to: Oliver Rummeyer Hochbergstraße 49/1 D-88213 Ravensburg Germany/Europe Euro cheques (in DM) are also welcome, but please do not send any kind of foreign cheques since the bank charges outrageous fees from both the sender and the receiver. If you really feel you must use such cheques, please include extra $10. You can also transfer the money directly to my bank account, but beware: international transfers via banks are very expensive. Kreissparkasse Ravensburg, BLZ 650 501 10, Konto 48-276999 In any case, be sure to provide me with your name, address, phone number and e-mail address for filing purposes. You can send this information via electronic mail, if you wish. If you don't mind, this data will be stored and processed in electronic form. You may use the sample @{" Registration Form " link registrationform } included in the documentation. Thank you for supporting Shareware! @endnode @node registrationform "Registration Form" @prev registration @next updates ------------------------ Oliver Rummeyer Hochbergstraße 49/1 D-88213 Ravensburg Germany/Europe ------------------------ Dear Oliver, I would like to become a registered user of "RO". Please send the disk containing the latest release and my keyfile to Name: _________________________________________________________ Address: _________________________________________________________ _________________________________________________________ _________________________________________________________ Country: __________________ Phone: __________________ E-Mail: _________________________________________________________ I am sending the shareware fee via (please mark as appropriate) o DM 20.- in bills, coming with this letter. o SFr 20.- in bills, coming with this letter. o US$ 15.- in bills, coming with this letter. o eurocheque in DM, coming with this letter. o foreign cheque in US$, coming with this letter (including extra $10 for cashing). o Bank transfer. I have read the license and distribution details and agree. _____________________ ___________________________________________ (Date) (Signature) @endnode @node updates "Updates" @prev registrationform @next support @{b}@{u}Updates@{ub}@{uu} Whenever a new version of RO gets released, I will post some information in the appropriate newsgroups of some electronic networks. The new archive will soon be available on many bulletin boards and on all `aminet' FTP servers. The RO Support Mailbox `Uplink BBS' Sysop Alexander Abt always offers the most recent release for Fido file request at these nodes: Node 1: +49-0751-96217 2:246/2320 USR 28.8 DS Node 2: +49-0751-97522 2:246/2321 USR 16.8 DS Node 3: +49-0751-97251 2:246/2322 USR 14.4 DS Node 4: +49-0751-97261 2:246/2323 USR 14.4 Node 5: +49-0751-97376 2:246/2324 Zyx E+ Use the magic name `RO'. Alternatively you can login with a user name of `RO' and a password of `RO'. As mentioned above, registered users will neither need a new keyfile nor a special personalized program version. They can use all new features immediately. @endnode @node support "Support" @prev updates @next history @{b}@{u}Support@{ub}@{uu} If you have suggestions, questions, critics or bugreports or you simply like my program, the write to: SMail: Oliver Rummeyer Hochbergstraße 49/1 D-88213 Ravensburg Germany/Europe EMail: Internet oliver.rummeyer@student.uni-ulm.de oliver@rumor.rv.sub.org Fidonet 2:246/2320.1@fidonet @endnode @node history "History" @prev support @next future @{b}@{u}History@{ub}@{uu} - Version 0.80 (26.8.94) Initial Release. - Version 0.81 (7.9.94) o Fixed some minor bugs. o Added a configuration switch to toggle path extension. - Version 0.82 (16.10.94) o Fixed some bugs. o Uses the CLI command path if started from Workbench. o Added some Filetypes. o Added command line option 'ICONIFY'. o Added config variable 'FLUSHMEMORY'. o Removed config variable 'HELPFILE' use 'ENV:AmigaGuide/Path' instead. o Fully localized (german catalog included). o Command buttons support keyboard shortcuts o Many other minor changes. @endnode @node future "Future Enhancments" @prev history @next acknowledgments @{b}@{u}Future Enhancments@{ub}@{uu} o Improved command interpreter o Improved arexx port o User configurable filetypes o Configuration Editor @endnode @node acknowledgments "Acknowledgments" @prev future @next disclaimer @{b}@{u}Acknowledgments@{ub}@{uu} The author wishes to thank his beta testers... - Alexander Abt ...for his great 'Recog' filetype recognition and for beta testing on Kickstart 2.04. - Frank Schlichting ...for being my first beta tester, for his great suggestions and for reworking the documentation. - Juergen Schubert ...for his ingenious suggestions and for writing the installer script. ...and... - Martin "XEN" Hutteloher ...for his MagicWB package and his permission to use some icons within this package. - Stefan Stuntz ...for his "Magic User Interface" @endnode @node disclaimer "Disclaimer" @prev acknowledgments @next license @{b}@{u}Disclaimer@{ub}@{uu} 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 @node license "License" @prev disclaimer @next installer @{b}@{u}License@{ub}@{uu} - You may use RO for a period of up to 14 days of evaluation. After that you have to register. - You may copy and distribute verbatim copies of the program's executable code and documentation as you receive it, in any medium, provided that you conspicuously and appropriately publish only the original, unmodified program, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original. - Except when otherwise stated in this documentation, you may not copy and/or distribute this program without the accompanying documentation and other additional files that came with the original. You may not copy and/or distribute modified versions of this program. - You may not copy, modify, sublicense, distribute or transfer the program except as expressly provided under this license. Any attempt otherwise to copy, modify, sublicense, distribute or transfer the program is void, and will automatically terminate your rights to use the program under this license. However, parties who have received copies, or rights to use copies, from you under this license will not have their licenses terminated so long as such parties remain in full compliance. - By copying, distributing and/or using the program you indicate your acceptance of this license to do so, and all its terms and conditions. - Each time you redistribute the program, the recipient automatically receives a license from the original licensor to copy, distribute and/or use the program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. - You may not disassemble, decompile, re-source or otherwise reverse engineer the program. - You agree to cease distributing the program and data involved if requested to do so by the author. @endnode @node installer "Installer" @prev "license" @next "magicuserinterface" @{b}@{u}Installer@{ub}@{uu} Along with RO comes the `Installer' from Commodore: Installer and Installer project icon (c) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and distributed under license from Commodore. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. @endnode @node magicuserinterface "Magic User Interface" @prev installer This application uses MUI - MagicUserInterface (c) Copyright 1993/94 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @endnode @index Index @node Index @{"About" link About } @{"License" link license} @{"Acknowledgments" link acknowledgments} @{"ListArc" link ListArc } @{"Action" link Action } @{"Listview" link listview} @{"AddArc" link AddArc } @{"LParent" link Parent } @{"AddArj" link AddArc } @{"LReload" link Reload } @{"AddLhA" link AddArc } @{"LRoot" link Root } @{"AddXArc" link AddArc } @{"LSwap" link LSwap } @{"AddZip" link AddArc } @{"Magic User Interface" link magicuserinterface} @{"AddZoo" link AddArc } @{"Main Window" link mainwindow} @{"All" link All } @{"MakeDir" link MakeDir } @{"Archive" link archive} @{"MDLoad" link MakeDir } @{"ARexx Interface" link arexxinterface} @{"Menu" link menu} @{"Assign" link Assign } @{"Menus" link menus} @{"Buffer" link buffer} @{"Move" link Move } @{"Button" link button} @{"MoveAs" link MoveAs } @{"ByName" link ByName } @{"None" link None } @{"Bytes" link Bytes } @{"Note" link Note } @{"Change" link Change } @{"Parent" link Parent } @{"Command Buttons" link commandbutton} @{"Path Gadget" link pathgadget} @{"Command" link Command } @{"Protect" link Protect } @{"Configuration" link configuration} @{"Quit" link Quit } @{"Copy" link Copy } @{"RActive" link Active } @{"CopyAs" link Copy } @{"Reboot" link Reboot } @{"CopyDev" link CopyDev } @{"Register" link registergroup} @{"Delete" link Delete } @{"Registration Form" link registrationform } @{"Disclaimer" link disclaimer} @{"Relabel" link Relabel } @{"Discussion" link discussion} @{"Reload" link Reload } @{"Disk" link Disk } @{"Rename" link Rename } @{"Drive Buttons" link drivebutton} @{"Rexx" link Rexx } @{"Drive" link drive} @{"Root" link Root } @{"Dup" link Dup } @{"RParent" link Parent } @{"Execute" link Execute } @{"RReload" link Reload } @{"Expand" link Expand } @{"RRoot" link Root } @{"Filetype" link filetype} @{"SetDate" link SetDate } @{"Fit" link Fit } @{"Short description" link introduction} @{"Future" link future} @{"Shrink" link Shrink } @{"Help" link Help } @{"Status Bar" link statusbar} @{"History" link history} @{"Support" link support} @{"Hotdir" link hotdir} @{"System Requirements" link requirements} @{"How to install RO" link installation} @{"The Registration Form" link registrationform} @{"How to register for RO" link registration} @{"Toggle" link Toggle } @{"Icon" link Icon } @{"Touch" link Touch } @{"Info" link Info } @{"UnArc" link UnArc } @{"Information Textfield" link dirinformation} @{"Unregistered Version" link unregistered} @{"Installer" link installer} @{"Updates" link updates} @{"LActive" link Active } @{"Variable" link variable} @{"LCopy" link LCopy } @endnode