home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 13 / amigaformatcd13.iso / -seriously_amiga- / shareware / misc / ro / docs / ro.guide,english (.txt) < prev    next >
Amigaguide Document  |  1997-03-06  |  106KB  |  2,252 lines

  1. @database "RO Documentation"
  2. @author "Oliver Rummeyer"
  3. @(c) "Copyright 
  4.  1994-1997 Oliver Rummeyer"
  5. @$VER: RO Documentation 1.25 (20-Feb-97)
  6. @node main "RO User Documentation"
  7. @toc contents
  8. @next introduction
  9.                  RO --- A MUI-Based FileManager, Shareware
  10.                                Version 1.25
  11.                             User Documentation
  12.                   Copyright 
  13.  1994-1997 by Oliver Rummeyer
  14.                                    ----
  15.  @{b}1.  Introduction@{ub}
  16.   1.1  @{" Short description      " link introduction}..............What is 'RO'?
  17.   1.2  @{" System Requirements    " link requirements}..............What you need to use RO
  18.   1.3  @{" Unregistered Version   " link unregistered}..............Is RO crippled shareware?
  19.  @{b}2.  Installation@{ub}
  20.   2.1  @{" How to install RO      " link installation}..............How is RO installed?
  21.  @{b}3.  How to use RO@{ub}
  22.   3.1  @{" Main Window            " link mainwindow}..............How is RO controlled
  23.   3.2  @{" Menus                  " link menus}..............RO's Pull-Down Menus
  24.   3.3  @{" Configuration          " link configuration}..............Setting up RO
  25.   3.4  @{" ARexx Interface        " link arexxinterface}..............How to control RO via ARexx
  26.   3.5  @{" Discussion             " link discussion}..............Questions and Answers. (Q&A)
  27.  @{b}4.  Registration@{ub}
  28.   4.1  @{" How to register for RO " link registration}..............How to become a registered user
  29.   4.2  @{" Registration Form      " link registrationform}..............I need your name, address, ...
  30.  @{b}5.  Other Topics@{ub}
  31.   5.1  @{" Updates                " link updates}..............Where to get updates
  32.   5.2  @{" Support                " link support}..............How to reach the author
  33.   5.3  @{" Acknowledgments        " link acknowledgments}..............The author wishes to thank...
  34.   5.4  @{" History                " link history}..............The RO history
  35.   5.5  @{" Future                 " link future}..............If you register...
  36.  @{b}6.  Distribution Politics@{ub}
  37.   6.1  @{" Disclaimer             " link disclaimer}..............Warranty? No warranty!
  38.   6.2  @{" License                " link license}..............License agreement
  39.   6.3  @{" Installer              " link installer}..............About the installer program.
  40.   6.4  @{" Magic User Interface   " link magicuserinterface}..............About Magic User Interface
  41. @endnode
  42. @node introduction "Introduction"
  43. @prev main
  44. @next requirements
  45.  @{b}@{u}Short description@{ub}@{uu}
  46.  RO is a new intuition-controlled, fully user-configurable file manager for
  47.  OS  2.04 and newer.  RO's mighty features will assist and help you on your
  48.  daily  work  with  your  Amiga.   With  RO there is no need to learn those
  49.  cryptic  shell commands, because you have the complete power of your Amiga
  50.  in  one  hand.
  51.  Due  to  the  usage  of MUI you are able to configure the look and feel of
  52.  this tool  as you like it. MUI is the @{" Magic User Interface " link magicuserinterface} developed by
  53.  Stefan  Stuntz  which should be installed on every Amiga.  It is an object
  54.  oriented  system  to create and maintain graphical user interfaces.  Users
  55.  of MUI based applications have the ability to customize nearly every pixel
  56.  of a programs interface according to their personal taste.
  57.  The RO archive should contain the following files:
  58.    RO/ARexx/Action.RO             RO/Icons/8col/Drawer.info
  59.    RO/ARexx/AddArc.RO             RO/Icons/8col/RegForm.info
  60.    RO/ARexx/ArcHandler.RO         RO/Icons/8col/RO.guide.info
  61.    RO/ARexx/Deiconify.RO          RO/Icons/8col/RO.info
  62.    RO/ARexx/Iconify.RO            RO/Icons/8col/ROPrefs.info
  63.    RO/ARexx/LoadDir.RO            RO/Install.info
  64.    RO/ARexx/LoadOther.RO          RO/Install/Installer
  65.    RO/ARexx/PlayModule.RO         RO/Install/RO-Install
  66.    RO/ARexx/ShowHtml.RO           RO/Install/RO-Install.info
  67.    RO/Binary/RO,binary            RO/LiesMichZuerst
  68.    RO/Binary/ROPrefs,binary       RO/LiesMichZuerst.info
  69.    RO/Config/RO.prefs,default     RO/LisezMoiDabord
  70.    RO/Config/RO.prefs,example1    RO/LisezMoiDabord.info
  71.    RO/Config/RO.prefs,example2    RO/Locale/Catalogs/Deutsch/ro.catalog
  72.    RO/Config/RO.prefs,example3    RO/Locale/Catalogs/Fran
  73. ais/ro.catalog
  74.    RO/Config/RO.prefs,example4    RO/Locale/Catalogs/Svenska/ro.catalog
  75.    RO/Docs/RegForm,deutsch        RO/Locale/RO.cd
  76.    RO/Docs/RegForm,english        RO/Locale/RO.ct
  77.    RO/Docs/RegForm,francais       RO/Previews.info
  78.    RO/Docs/RegForm,svenska        RO/Previews/Preview1
  79.    RO/Docs/RO.guide,deutsch       RO/Previews/Preview1.info
  80.    RO/Docs/RO.guide,english       RO/Previews/Preview2
  81.    RO/Docs/RO.guide,francais      RO/Previews/Preview2.info
  82.    RO/Docs/RO.guide,svenska       RO/Previews/Preview3
  83.    RO/Icons/4col/Drawer.info      RO/Previews/Preview3.info
  84.    RO/Icons/4col/RegForm.info     RO/ReadMeFirst
  85.    RO/Icons/4col/RO.guide.info    RO/ReadMeFirst.info
  86.    RO/Icons/4col/RO.info          RO/RO_v125.Announce
  87.    RO/Icons/4col/ROPrefs.info     RO/RO_v125.ReadMe
  88.    RO.info
  89.  MUI is not included in the RO archive, but you should get it in every
  90.  mailbox or at your local aminet-mirror.
  91. @endnode
  92. @node requirements "System Requirements"
  93. @next unregistered
  94. @prev introduction
  95.  @{b}@{u}System Requirements@{ub}@{uu}
  96.  RO  requires version 2.04 of the Amiga operating system or newer.  RO also
  97.  requires  version  3.6  or  newer of  the "Magic User Interface" by Stefan
  98.  Stuntz.   Kickstart  1.3  is  not supported;  Neither  by  the "Magic User
  99.  Interface"  nor by RO; this operating system is obsolete.  Upgrade to 2.04
  100.  or,  even  better,  to 3.1 of the Amiga OS.  RO does not require a special
  101.  processor,  but  of course the faster CPUs make life easier.  Many complex
  102.  calculations are needed for the management and layout of the objects, so a
  103.  "base" 68000 based machine could be slow.
  104.  If  you  want RO to automatically decrunch XPK & PowerPacker packed files,
  105.  you  have  to  install xpkmaster.library, powerpacker.library and at least
  106.  one  XPK  compressor  library.  If you want RO to treat archives just like
  107.  directories you also need ARCHandler.
  108.  XPK is Copyright 
  109.  Urban Mueller, Bryan Ford & Christian Schneider.
  110.  PowerPacker is Copyright 
  111.  Nico Fran
  112.  ARCHandler is Copyright 
  113.  Rafael D'Halleweyn.
  114. @endnode
  115. @node unregistered "Unregistered Version"
  116. @next installation
  117. @prev requirements
  118.  @{b}@{u}Unregistered Version@{ub}@{uu}
  119.  I decided to release RO as crippled shareware.  RO is fully functional but
  120.  in the unregistered version the about requester appears regulary to remind
  121.  you  to  pay  the  shareware fee.  If you use the unregistered version the
  122.  save  button  of  RO  Prefs is disabled.  You have to use a text editor to
  123.  modify  your  settings.  RO has been and will be a time-consuming work for
  124.  me.   If you like this product and you want me to continue its development
  125.  you should support me with the registration fee.  Thank You.
  126.  @{" How to register for RO " Link registration}
  127. @endnode
  128. @node installation "Installation"
  129. @next mainwindow
  130. @prev unregistered
  131.  @{b}@{u}Installation@{ub}@{uu}
  132.  RO  comes with an installer script which helps you to install all required
  133.  files.  If you are an 'expert user' you might want to do it manually.
  134.  Copy the files  'RO,binary'  and  'ROPrefs,binary' to a  directory of your
  135.  choice  with the names  'RO'  and  'ROPrefs'.  You may copy the preference
  136.  program to SYS:Prefs with the name 'RO' or 'ROPrefs' if you  like. Now you
  137.  just have to copy the icons to the according directories. You  might  want
  138.  to  copy the file 'RO.prefs' into 'ENVARC:RO/' and 'ENV:RO/'. If you  have
  139.  a keyfile, copy it to 'S:', 'L:' or in the same directory where you copied
  140.  the  executable.   You  may  also  set  the environment variable 'KEYPATH'
  141.  to a path where you store your Keyfile. If you use Workbench 2.1 or better
  142.  then you may copy the file ro.catalog to your 'LOCALE:Catalogs/<language>'
  143.  directory.
  144. @endnode
  145. @node mainwindow "Main Window"
  146. @prev installation
  147. @next registergroup
  148.  @{b}@{u}Main Window@{ub}@{uu}
  149.  After  the  installation procedure you may start RO, and the main window
  150.  should open. It contains the following control objects...
  151.  @{" Register              " link registergroup}       Changes the listview type
  152.  @{" Information Textfield " link dirinformation}       Displays information about loaded dir
  153.  @{" Listview              " link listview}       Displays the directory
  154.  @{" Path Gadget           " link pathgadget}       For manual directory browsing
  155.  @{" Drive Buttons         " link drivebutton}       Fast access of often used devices
  156.  @{" Command Buttons       " link commandbutton}       Performing actions on selected entries
  157.  @{" Status Bar            " link statusbar}       Displays general information
  158. @endnode
  159. @node registergroup "Register Group"
  160. @prev mainwindow
  161. @next dirinformation
  162.  @{b}@{u}Register@{ub}@{uu}
  163.  The  register  at  the  top  of the window lets you change the type of the
  164.  listview  below.   You  may choose between Directory, Buffers and Volumes.
  165.  According  to  your  MUI  settings  the  register  group might look like a
  166.  register  or  like  a  normal  cycle gadget.  The three different listview
  167.  types are discribed in the @{" Listview " link listview} section.
  168.  If  you  own  a  mouse with three buttons it's also possible to change the
  169.  listview type by clicking the middle mouse button above a listview.
  170. @endnode
  171. @node dirinformation "Information Textfield"
  172. @prev registergroup
  173. @next listview
  174.  @{b}@{u}Information Textfield@{ub}@{uu}
  175.  There   is  a  textfield  above  each  directory  listview  where  several
  176.  informations  are  displayed:   the free disk space in percent and KBytes,
  177.  and  the  used  disk space in KBytes.  It looks similar to the information
  178.  displayed in the title bar of a standard Workbench window so you should be
  179.  familiar  with it.  If there is currently no directory loaded you will see
  180.  'No  Directory'.  The information text changes if you select some entries.
  181.  You  can  see  how  many  files, dirs and bytes currently selected, if you
  182.  unselect all the text changes back to the disk space display.
  183.  The  Textfield  is  also  used  to  indicate  which  listview is currently
  184.  active.   It  is  very  important  to  know  which one of the listviews is
  185.  active,  because it is considered as the source listview and it is the one
  186.  which  is  affected  by all operations you start via command button or via
  187.  user menu.  If you select a file in a listview the active side changes but
  188.  you  may  also  change the active side via '`' (The key above 'tab') which
  189.  cycles  through the listviews. Via 'tab' you may cycles through the string
  190.  gadgets.   The  textfield  above  the  activated listview is filled with a
  191.  'Fillback'  raster  which could be configured in the 'Pens' section in MUI
  192.  prefs by changing the according pens.
  193.  Last but not least the Textfield is also used as a hidden 'Parent' button.
  194.  If you click on it the parent directory of the current directory is loaded
  195.  into the according listview.  If there is no parent directory RO will just
  196.  reload the current loaded directory
  197. @endnode
  198. @node listview "Listview"
  199. @prev dirinformation
  200. @next pathgadget
  201.  @{b}@{u}Listview@{ub}@{uu}
  202.  You can  change the size of the listviews by  dragging  the balance gadget
  203.  between them. Simply click on it and move it to the left or right. RO also
  204.  features  a  drag&drop mechansim.  You  can copy  files by  dragging  them
  205.  from one  listview to another.
  206.  RO supplies three different listviews...
  207.  The  'Directory'  listview is RO's most important listview.  It is used to
  208.  display  the  directory.   You  may select files and directories there and
  209.  doubleclick  on  them.   If  you  doubleclick  on a directory it is loaded
  210.  immediately  into  the listview, but if you doubleclick on a file RO tries
  211.  to determine what kind of file it is and will start the according command.
  212.  You may define filetypes in RO.prefs and in addition if you use OS  3.0 or
  213.  better RO supports Datatypes.  For a detailed description how to configure
  214.  these  fileactions  consult  the  @{" Configuration " link configuration} chapter.
  215.  The  'Buffers' listview is a kind of history where RO remembers a specific
  216.  number  of  paths.  You may also insert paths upon startup as described in
  217.  the  @{" Configuration " link configuration}  section.  You may get to any of the displayed paths
  218.  just  by  doubleclicking  them.   This is one way of fast directory access
  219.  supported by RO.
  220.  The  'Volumes'  listview displays a list of all available AmigaDOS volumes
  221.  currently  mounted.   You can load a volume into the directory listview by
  222.  doubleclicking on it.
  223. @endnode
  224. @node pathgadget "Path Gadget"
  225. @prev listview
  226. @next drivebutton
  227.  @{b}@{u}Path Gadget@{ub}@{uu}
  228.  The  path  gadgets  are  below the two directory listviews and contain the
  229.  path  string of the current loaded directory.  You may enter any path here
  230.  and  the  according  directory will be loaded immediately.  RO extends all
  231.  path   names   e.g.    if   you  enter  'Libs:'  you  get  something  like
  232.  'System:Libs/'  The  path  gadgets  are  just  another  fast way to access
  233.  directories  because  of  the  bulid-in path name completer.  If you enter
  234.  'SYS:Devs/DOS<RETURN>'  you  get  an  extended path which should look like
  235.  'System:Devs/DOSDrivers'.   You  may  also  enter more complex things like
  236.  'System:Devs/DataTypes///L/File<RETURN>' and what you get should look like
  237.  that  'System:L/FileSystem_Trans/'.   The  path name completion works only
  238.  for  the last part of the path string.
  239. @endnode
  240. @node drivebutton "Drive Buttons"
  241. @prev pathgadget
  242. @next commandbutton
  243.  @{b}@{u}Drive Buttons@{ub}@{uu}
  244.  Below  the  path gadgets RO normally has 16 drive buttons but their number
  245.  is  automatically increased to 32 if you specify more buttons.  In general
  246.  you  click on a drive button and the specified path name for the button is
  247.  loaded  into  a listview.  Into which one depends on the current operation
  248.  mode  of the drive buttons.  There are two modes supported:  The so called
  249.  'Active  Mode'  and  the 'Normal Mode'.  In 'Normal Mode' the drive button
  250.  only  affects  the  listview which is directly above it.  In 'Active Mode'
  251.  the drive button loads a path into the activated listview.
  252. @endnode
  253. @node commandbutton "Command Buttons"
  254. @prev drivebutton
  255. @next statusbar
  256.  @{b}@{u}Command Buttons@{ub}@{uu}
  257.  Below the drive buttons are 3 x 8 command buttons.  These gadgets are used
  258.  to  perform  actions  for  the  selected  files  in  the  active directory
  259.  listview.   24  buttons are not enough for over 50 internal functions so I
  260.  implemented  a  button  bank switch mechanism.  You can switch between the
  261.  banks  by clicking the 'Status Bar' below the command buttons.  If you own
  262.  a  three-button-mouse  you  may  also flip the button bank by pressing the
  263.  middle  mouse button above the bank.
  264.  Currently RO supports 5 button banks which results in 120 buttons but this
  265.  might  change in a future version.  Most internal commands open a progress
  266.  window.   If  you  close  it  the  operation is aborted but if you hit its
  267.  iconify gadget RO continues the function in background.
  268.  Currently supported are the following internal functions...
  269.     @{" About     " link About}              Show about information.
  270.     @{" Action    " link Action}              Perform fileaction on selected files.
  271.     @{" All       " link All}              Select all entries in active listview.
  272.     @{" Assign    " link Assign}              Create an assign for active directory.
  273.     @{" Buffers   " link Buffers}              Brings the buffers page to front.
  274.     @{" ByName    " link ByName}              Select files by name.
  275.     @{" Bytes     " link Bytes}              Count bytes of selected entries.
  276.     @{" Change    " link Change}              Change sorttype of active listview.
  277.     @{" Copy      " link Copy}              Copy files and directories.
  278.     @{" CopyAs    " link Copy}              Copy files and directories and change name.
  279.     @{" CopyDev   " link CopyDev}              Copy files to a device.
  280.     @{" Current   " link Current}              Load current directory.
  281.     @{" Delete    " link Delete}              Delete files and directories.
  282.     @{" Directory " link Directory}              Brings the directory page to front.
  283.     @{" Disk      " link Disk}              Show information about active disk.
  284.     @{" Dup       " link Dup}              Duplicate entries.
  285.     @{" Expand    " link Expand}              Expand a path to its ARCHandler equivalent.
  286.     @{" Fit       " link Fit}              Check if entries fit on destination.
  287.     @{" Help      " link Help}              Show online help.
  288.     @{" Icon      " link Icon}              Select corresponding .info files.
  289.     @{" Info      " link Info}              Show information for selected files.
  290.     @{" LActive   " link Active}              Activate left listview.
  291.     @{" LCopy     " link LCopy}              Copy active listview to inactive.
  292.     @{" LFold     " link LFold}              Fold right listview.
  293.     @{" LSwap     " link LSwap}              Swap active and inactive listview
  294.     @{" ListArc   " link ListArc}              List contents of archives.
  295.     @{" LParent   " link Parent}              Load parent directory of left path.
  296.     @{" LReload   " link Reload}              Refresh left directory.
  297.     @{" LRoot     " link Root}              Load root directory of left path.
  298.     @{" MakeDir   " link MakeDir}              Create directories.
  299.     @{" MDLoad    " link MakeDir}              Create a directory and load it.
  300.     @{" Move      " link Move}              Move files and directories.
  301.     @{" MoveAs    " link MoveAs}              Move files and directories and change name.
  302.     @{" None      " link None}              Deselect all entries.
  303.     @{" Note      " link Note}              Modify filenotes.
  304.     @{" Parent    " link Parent}              Load parent directory.
  305.     @{" Protect   " link Protect}              Modify protection flags.
  306.     @{" Quit      " link Quit}              Quit 'RO'
  307.     @{" RActive   " link Active}              Activate right listview.
  308.     @{" Reboot    " link Reboot}              Reboot your system.
  309.     @{" Relabel   " link Relabel}              Relabel volumes.
  310.     @{" Reload    " link Reload}              Refresh active directory.
  311.     @{" Rename    " link Rename}              Rename entries.
  312.     @{" Root      " link Root}              Load root directory.
  313.     @{" RParent   " link Parent}              Load parent directory of right path.
  314.     @{" RReload   " link Reload}              Refresh right directory.
  315.     @{" RRoot     " link Root}              Load root directory of right path.
  316.     @{" SetDate   " link SetDate}              Modify date of a file or directory.
  317.     @{" Shrink    " link Shrink}              Shrink an ARCHandler path to normal.
  318.     @{" Toggle    " link Toggle}              Toggleselect all entries.
  319.     @{" Touch     " link Touch}              Set date or create file.
  320.     @{" UnArc     " link UnArc}              Extract files from archives.
  321.     @{" Update    " link Update}              Select files for update.
  322.     @{" Volumes   " link Volumes}              Brings the volumes page to front.
  323.  ...and  you  may specify any AmigaDOS executable here but consult the
  324.     @{" Configuration " link configuration} chapter for further information.
  325. @endnode
  326. @node statusbar "Status Bar"
  327. @prev commandbutton
  328. @next menus
  329.  @{b}@{u}Status Bar@{ub}@{uu}
  330.  RO's  status  bar is the textfield at the bottom of the main window, it is
  331.  used  to display all general informations about what is currently going on
  332.  or  why  a  certain operation failed.  As described in the Command Buttons
  333.  section  the  status  bar  is  also needed to switch between the different
  334.  command  button  banks.  You can also show a clock and/or a memory display
  335.  there  but this is total under user control so I advice you to  check  out
  336.  the @{" Configuration " link configuration} chapter.
  337. @endnode
  338. @node menus "Menus"
  339. @prev statusbar
  340. @next configuration
  341.  @{b}@{u}Menus@{ub}@{uu}
  342.  RO has the following menus:
  343.  o Project
  344.    - Update All
  345.      Reloads left and right directory
  346.    - Last Message
  347.      Redisplays the last message in the status bar.
  348.    - About...
  349.      Opens  the  about requester.  This is the same requester which pops up
  350.      regulary if you are an unregistered user.
  351.    - About MUI...
  352.      Opens the about requester of mui.
  353.    - Iconify
  354.      Iconifies  RO  and adds an app icon to your Workbench.  You can use it
  355.      as  a  multifunctional drop icon because every file dropped on it will
  356.      invoke  a  action  according to its filetype.  If you start RO you may
  357.      force  an  iconified startup by using the command line argument or the
  358.      tooltype 'ICONIFY'.
  359.    - Quit
  360.      Quits the program and removes RO from memory.
  361.  o Options
  362.    - Copy
  363.      o Flags
  364.        Toggles  whether you want to clone the protection bits while copying
  365.        a file or not. It has the same effect as the @{" COPYFLAGS " link variable} option  in
  366.        the preference file.
  367.      o Date
  368.        Toggles whether  you  want  to clone the date & time of a file while
  369.        copying or not. It has the same effect as the @{" COPYDATE " link variable} option in
  370.        the preference file.
  371.      o Comment
  372.        Toggles whether you want to clone the file note while copying a file
  373.        or  not.  It  has  the same  effect as the @{" COPYNOTE " link variable} option in the
  374.        preference file.
  375.      o Check Files
  376.        Using  this  option  you may specify if RO should verify files after
  377.        copy.   You can also set this option in the preference file with the
  378.        @{" COPYVERIFY " link variable} keyword.
  379.      o Check Diskspace
  380.        Switch  this  option  on  if  you want to automatically check if the
  381.        selected  files  will  fit  on the destination device before copying
  382.        them.   Due  to  the  fact  that  'RAM:'  is  always 100% full it is
  383.        excluded  from  checking.   You  can  also  set  this  option in the
  384.        preference file with the @{" CHECKFIT " link variable} keyword.
  385.    - Delete
  386.      o Force
  387.        If  you  switch  this option on RO unprotects protected files before
  388.        deleting them.  This  has the same effect as the @{" DELFORCE " link variable} keyword
  389.        in RO.prefs file.
  390.      o Verify
  391.        Toggles  the @{" DELVERIFY " link variable} option.  This means that if you turn it on
  392.        a warning requester pops up before deleting files.
  393.    - Replace
  394.      Here you may choose one of the four  values 'Always', 'Never', 'Older'
  395.      or  'Verify'.   They  have  the  same effect as the 'ALWAYS', 'NEVER',
  396.      'OLDER' and  'VERIFY' value for the @{" OVERWRITE " link variable} keyword. As you might
  397.      have guessed these entries are mutual exclusive.
  398.  o Settings
  399.    - Setup...
  400.      With this entry you can start the RO-Prefs  program.  You can completly
  401.      configure  RO here.  If you quit the preference program using 'Save' or
  402.      'Use' your settings are used by RO immediately.
  403.    - MUI settings...
  404.      With this entry you can start the MUI-Prefs program. You can change all
  405.      MUI specific settings of RO here.
  406. @endnode
  407. @node configuration "Configuration"
  408. @prev menus
  409. @next filetype
  410.  @{b}@{u}Configuration@{ub}@{uu}
  411.  RO  is configured via a text file which must be copied to 'ENVARC:RO/' and
  412.  'ENV:RO/' and has to be called 'RO.prefs'.  If you used the install script
  413.  all  files  are  installed correct.  You may use a standard text editor to
  414.  modify  the  config file.  I included some examples, so have a look in the
  415.  'Config'  directory.   If  you  like  you  could  use the prefs program by
  416.  calling the menu entry 'RO...' to configure RO. RO supports the  following
  417.  configuration keywords...
  418.  @{" FILETYPE    " link filetype}
  419.  @{" CUSTOMTYPE  " link customtype}
  420.  @{" ARCHIVETYPE " link archive}
  421.  @{" VARIABLE    " link variable}
  422.  @{" MENU        " link menu}
  423.  @{" BUFFER      " link buffer}
  424.  @{" HOTKEY      " link hotkey}
  425.  @{" HOTDIR      " link hotdir}
  426.  @{" DRIVE       " link drive}
  427.  @{" BUTTON      " link button}
  428.  Note: Window  size  and  other things like layout or keyboard settings are
  429.        configured  with  the  MUI  prefs program and I really advice you to
  430.        read MUI's documentation.  Thanks.
  431. @endnode
  432. @node filetype "Filetype Configuration"
  433. @prev configuration
  434. @next customtype
  435.  @{b}@{u}FILETYPE@{ub}@{uu}
  436.  @{u}SYNOPSIS@{uu}
  437.     FILETYPE "TypeID" "Command"
  438.  @{u}DESCRIPTION@{uu}
  439.     With  this  keyword you can set commands for the three basic filetypes.
  440.     TypeID must be one of the Ids listed below and command is a CLI command
  441.     which  has  to  contain  a '%f' where the file name should be inserted.
  442.     (The  file  name  is  already  in  quotes so don't specify them again!)
  443.     ASCII        ASCII standard text file
  444.     DEFAULT      Files not regcognized by CUSTOMTYPE's
  445.     BINARY       A not recognized binary file
  446.  @{u}ARGUMENTS@{uu}
  447.     "TypeID"     file type identifier.
  448.     "Command"    CLI command to be executed.
  449.     You may specify these '%' and '&' parameters for 'Command':
  450.     %a           arexx portname
  451.     %f           source filename with path in quotes
  452.     %F           source filename with path without quotes
  453.     %n           only the source filename in quotes
  454.     %N           only the source filename without quotes
  455.     %p           source path in quotes
  456.     %P           source path without quotes
  457.     %t           target path in quotes
  458.     %T           target path without quotes
  459.     %s           source device in quotes
  460.     %S           source device without quotes
  461.     %d           destination device in quotes
  462.     %D           destination device without quotes
  463.     %r           request a string from user for every file
  464.     %R           request a string from user only once
  465.     &b           do not break command processing on command failure.
  466.     &c           change current directory to source path
  467.     &C           change current directory to target path
  468.     &d           do not deselect entries after processing
  469.     &r           reloads the source directory
  470.     &R           reloads the destination directory
  471.     &w           output window must be closed by user
  472.     %%           percent sign
  473.     &&           and sign
  474.  @{u}DEFAULT@{uu}
  475.     Command is set to "MultiView >NIL: %f" for all supported file types.
  476.  @{u}EXAMPLE@{uu}
  477.     FILETYPE BINARY "FileX >NIL: %f"
  478. @endnode
  479. @node customtype "Custom Filetype Configuration"
  480. @prev filetype
  481. @next archive
  482.  @{b}@{u}CUSTOMTYPE@{ub}@{uu}
  483.  @{u}SYNOPSIS@{uu}
  484.     CUSTOMTYPE "Pattern" "Hex" "Desc" "Command"
  485.  @{u}DESCRIPTION@{uu}
  486.     With  this  keyword  you  can  set  commands  which  should be executed
  487.     according to the file type of the selected file.  Since version 1.00 of
  488.     RO it is possible to add your own file types.  If the recognition fails
  489.     the  @{" DEFAULT " link filetype}  command  will  be executed and if it fails as well the
  490.     file is considered as binary file and the @{" BINARY " link filetype} command ist used to
  491.     display  it.   XPK  &  PP files are decrunched before checking the file
  492.     type.   'Command'  has  to contain a '%f' where the file name should be
  493.     inserted. (The file  name  is  already in  quotes so don't specify them
  494.     again!) 'Pattern' is an AmigaDOS filename pattern which is used to find
  495.     the  matching file.  'Hex' is a string of ASCII characters also used to
  496.     determine the filetype.  You may specify a normal string like '??-lh?-'
  497.     or  a  hex string like "$????2D6C68??2D".  So if the first character of
  498.     the  string  is a '$' sign RO translates it into a normal string.  This
  499.     might  get  useful  if you need non-printable chars.  As you might have
  500.     guessed  '?'  is a wildcard but don't forget to specify '??' if you are
  501.     using a "$"-Hex string.
  502.  @{u}ARGUMENTS@{uu}
  503.     "Pattern"    AmigaDOS filename pattern to match
  504.     "Hex"        Hex string to match
  505.     "Desc"       Filetype description string
  506.     "Command"    CLI command to be executed.
  507.     You may specify these '%' and '&' parameters for 'Command':
  508.     %a           arexx portname
  509.     %f           source filename with path in quotes
  510.     %F           source filename with path without quotes
  511.     %n           only the source filename in quotes
  512.     %N           only the source filename without quotes
  513.     %p           source path in quotes
  514.     %P           source path without quotes
  515.     %t           target path in quotes
  516.     %T           target path without quotes
  517.     %s           source device in quotes
  518.     %S           source device without quotes
  519.     %d           destination device in quotes
  520.     %D           destination device without quotes
  521.     %r           request a string from user for every file
  522.     %R           request a string from user only once
  523.     &b           do not break command processing on command failure.
  524.     &c           change current directory to source path
  525.     &C           change current directory to target path
  526.     &d           do not deselect entries after processing
  527.     &r           reloads the source directory
  528.     &R           reloads the destination directory
  529.     &w           output window must be closed by user
  530.     %%           percent sign
  531.     &&           and sign
  532.  @{u}DEFAULT@{uu}
  533.     CUSTOMTYPE "#?" "FORM????8SVX" "Iff 8SVX File"     "MultiView >NIL: %f"
  534.     CUSTOMTYPE "#?" "FORM????ANIM" "Iff ANIM File"     "MultiView >NIL: %f"
  535.     CUSTOMTYPE "#?" "FORM????ILBM" "Iff ILBM File"     "MultiView >NIL: %f"
  536.     CUSTOMTYPE "#?" "GIF8?a"       "GIF Picture"       "MultiView >NIL: %f"
  537.     CUSTOMTYPE "#?" "DMS!"         "DMS Archive"       "MultiView >NIL: %f"
  538.     CUSTOMTYPE "#?" "??????JFIF"   "JPeg Picture"      "MultiView >NIL: %f"
  539.     CUSTOMTYPE "#?" "$0A050108"    "PCX Picture"       "MultiView >NIL: %f"
  540.     CUSTOMTYPE "#?" "$424D"        "BMP Picture"       "MultiView >NIL: %f"
  541.     CUSTOMTYPE "#?" "$59A66A95"    "SunRaster Picture" "MultiView >NIL: %f"
  542.     CUSTOMTYPE "#?" "$000002"      "Tga Picture"       "MultiView >NIL: %f"
  543.     CUSTOMTYPE "#?" "$00000A"      "Targa Picture"     "MultiView >NIL: %f"
  544.     CUSTOMTYPE "#?" "II*?"         "Intel Tiff"        "MultiView >NIL: %f"
  545.     CUSTOMTYPE "#?" "MM?*"         "Motorola Tiff"     "MultiView >NIL: %f"
  546.     CUSTOMTYPE "#?.dvi"   ""       "DVI File"          "MultiView >NIL: %f"
  547.     CUSTOMTYPE "#?.info"  ""       "Icon"              "MultiView >NIL: %f"
  548.     CUSTOMTYPE "#?.mpg"   ""       "MPeg Movie"        "MultiView >NIL: %f"
  549.     CUSTOMTYPE "#?.fli"   ""       "FLI Anim"          "MultiView >NIL: %f"
  550.     CUSTOMTYPE "#?.guide" ""       "AmigaGuide File"   "MultiView >NIL: %f"
  551.     CUSTOMTYPE "#?.html"  ""       "HTML File"         "MultiView >NIL: %f"
  552.     CUSTOMTYPE "#?.ps"    ""       "PostScript File"   "MultiView >NIL: %f"
  553.  @{u}EXAMPLE@{uu}
  554.     CUSTOMTYPE "#?" "@database" "AmigaGuide File" "MultiView >NIL: %f"
  555. @endnode
  556. @node archive "Archive Configuration"
  557. @prev customtype
  558. @next variable
  559.  @{b}@{u}ARCHIVETYPE@{ub}@{uu}
  560.  @{u}SYNOPSIS@{uu}
  561.     ARCHIVETYPE "Pattern" "Hex" "Desc" "ListArc" "UnArc"
  562.  @{u}DESCRIPTION@{uu}
  563.     With  this  keyword  you  can  set  commands  which  should be executed
  564.     according  to  the  archive  type of the selected files.  There are two
  565.     commands  for  each  archive  type:   a  listarc  command  and an unarc
  566.     command.   'Pattern'  and  'Hex'  are  needed  to  recognize  archives.
  567.     'Pattern'  is  an  AmigaDOS  filename pattern which is used to find the
  568.     matching  file.   'Hex'  is  a  string of ASCII characters also used to
  569.     determine the filetype.  You may specify a normal string like '??-lh?-'
  570.     or  a  hex string like "$????2D6C68??2D".  So if the first character of
  571.     the  string  is a '$' sign RO translates it into a normal string.  This
  572.     might  get  useful  if you need non-printable chars.  As you might have
  573.     guessed  '?'  is a wildcard but don't forget to specify '??' if you are
  574.     using  a  "$"-Hex  string.  'ListArc' and 'UnArc' should contain a '%f'
  575.     for the filename.  Since version 1.00 of RO adding files to archives is
  576.     handled by normal command buttons for example  using "LhA >NIL: -x -r a
  577.     %R %n &c" as command string.
  578.  @{u}ARGUMENTS@{uu}
  579.     "Pattern"    AmigaDOS filename pattern to match
  580.     "Hex"        Hex string to match
  581.     "Desc"       Filetype description string
  582.     "ListArc"    Command for listing archive
  583.     "UnArc"      Command for extracting archive
  584.     You may specify these '%' and '&' parameters for 'ListArc' & 'UnArc':
  585.     %a           arexx portname
  586.     %f           source filename with path in quotes
  587.     %F           source filename with path without quotes
  588.     %n           only the source filename in quotes
  589.     %N           only the source filename without quotes
  590.     %p           source path in quotes
  591.     %P           source path without quotes
  592.     %t           target path in quotes
  593.     %T           target path without quotes
  594.     %s           source device in quotes
  595.     %S           source device without quotes
  596.     %d           destination device in quotes
  597.     %D           destination device without quotes
  598.     %r           request a string from user for every file
  599.     %R           request a string from user only once
  600.     &b           do not break command processing on command failure.
  601.     &c           change current directory to source path
  602.     &C           change current directory to target path
  603.     &d           do not deselect entries after processing
  604.     &r           reloads the source directory
  605.     &R           reloads the destination directory
  606.     &w           output window must be closed by user
  607.     %%           percent sign
  608.     &&           and sign
  609.  @{u}DEFAULT@{uu}
  610.     ARCHIVETYPE "#?.lha" "" "LHA/LZH Archive" "LhA v %f" "LhA x %f &C &R"
  611.     ARCHIVETYPE "#?.lzx" "" "LZX Archive"     "LzX v %f" "LzX x %f &C &R"
  612.     ARCHIVETYPE "#?.arc" "" "ARC Archive"     "Arc v %f" "Arc x %f &C &R"
  613.     ARCHIVETYPE "#?.arj" "" "ARJ Archive"     "Arj v %f" "Arj x %f &C &R"
  614.     ARCHIVETYPE "#?.zip" "" "ZIP Archive"     "Zip v %f" "Zip x %f &C &R"
  615.     ARCHIVETYPE "#?.zoo" "" "ZOO Archive"     "Zoo v %f" "Zoo x %f &C &R"
  616.  @{u}EXAMPLE@{uu}
  617.     ARCHIVETYPE "#?" "$4C5A5800" "LZX Archive" "LzX v %f" "LzX x %f &C &R"
  618. @endnode
  619. @node variable "General Configuration"
  620. @prev archive
  621. @next menu
  622.  @{b}@{u}VARIABLE@{ub}@{uu}
  623.  @{u}SYNOPSIS@{uu}
  624.     VARIABLE "VarID" "Value"
  625.  @{u}DESCRIPTION@{uu}
  626.     This  keyword  is needed to set some important options.  'VarID' is one
  627.     of  the variable names listed below and value is a parameter string for
  628.     the variable.  Currently the following 'VarID's are supported:
  629.     Global:
  630.     - APPWINDOW
  631.       Here  you  can  specify  what  happens  when  you  drop  an icon on a
  632.       listview.   If you set it to 'LOAD' the directory of the dropped icon
  633.       will  be loaded into the listview, if you use 'COPY' the dropped file
  634.       or directory will be copied into it the current loaded directory.
  635.       Example: VARIABLE APPWINDOW "LOAD"
  636.     - COMPLETED
  637.       Here  you  can specify what should happen if RO finished an operation
  638.       while  it  is  iconified.   You  may  set  it  to 'QUIET', 'FLASH' or
  639.       'POPUP'.
  640.       Example: VARIABLE COMPLETED "QUIET"
  641.     - CHECKFIT
  642.       Here you  can switch ON or OFF whether you like to check the filesize
  643.       if  it  fits on the destination disk or not.  RO counts the bytes and
  644.       checks  how  many  blocks  are  needed  for organisation etc.  on the
  645.       destination device.  So don't get confused by values which seem to be
  646.       wrong.
  647.       Example: VARIABLE CHECKFIT "ON"
  648.     - CREATEICONS
  649.       If  you  want  RO to create a directory icon if you use makedir or to
  650.       create a project icon if you create a file set this option ON, if not
  651.       switch it OFF.
  652.       Example: VARIABLE CREATEICONS "OFF"
  653.     - DRIVEBUTTONS
  654.       It is a bit difficult to explain...  there are two different types of
  655.       Drivebutton  handling.   The  first  one  is  called 'Normal' and the
  656.       second  one  is  called  'Active'.   In  normal  mode  you have eight
  657.       Drivebuttons  for  every side, so if you click on a Drivebutton below
  658.       the  left  side  the directory is loaded in the left side.  In active
  659.       mode you have sixteen Drivebuttons for both sides.  If you click on a
  660.       Drivebutton  it affects the active Listview and not the one according
  661.       to the side where you clicked.
  662.       Example: VARIABLE DRIVEBUTTONS "Active"
  663.     - FLUSHMEMORY
  664.       If  you want RO to flush memory on exit, switch this option ON.  This
  665.       will  remove  MUI  from  memory  if  no other application using it is
  666.       currently running.
  667.       Example: VARIABLE FLUSHMEMORY "ON"
  668.     - FOLLOWSCROLL
  669.       This keyword is needed to switch ON or OFF whether you like to scroll
  670.       the directory window to follow operations or not.
  671.       Example: VARIABLE FOLLOWSCROLL "OFF"
  672.     - HISTORY
  673.       Here you can set the number of buffers RO should remember.
  674.       Example: VARIABLE HISTORY "42"
  675.     - HOTDIRS
  676.       Exactly  the  same as DRIVEBUTTONS but for HotDirs.  Function keys F1
  677.       to F5 affect the left side, F6 to F10 affect the right side.
  678.       Example: VARIABLE HOTDIRS "Active"
  679.     - MIDDLEMOUSE
  680.       Here  you  may  specify  how  the  middle mouse button  of your three
  681.       button  mouse  is  used.   You  may choose from four values:  'LIST',
  682.       'BANK', 'BOTH' and 'NONE'.  If you use LIST the listview page changes
  683.       if you click the middle button above a listview.  Setting this option
  684.       to  BANK  only  the buttonbank switches by clicking above it.  If you
  685.       specify  BOTH  as  option  string  the  mechanism works for both, the
  686.       listview  and  the  button  bank.   If  you use NONE the middle mouse
  687.       button support is switched off.
  688.       Example: VARIABLE MIDDLEMOUSE "NONE"
  689.     - OUTPUT
  690.       Specify the default output window for all commands launched by RO.
  691.       Example: VARIABLE OUTPUT "CON:0/0/640/400/Output/CLOSE/AUTO"
  692.     - OVERWRITE
  693.       You  can  specify  what  should  happen  if you write to a file which
  694.       already  exists perhaps if you want to copy another one over it.  You
  695.       may  choose  between 'ALWAYS', 'NEVER', 'OLDER' and 'VERIFY'.  ALWAYS
  696.       will  quietly  overwrite  the file without further information, NEVER
  697.       will  break  the  operation if a file already exists, OLDER will only
  698.       replace  older files and VERIFY will pop up a 'Do you really want...'
  699.       requester.
  700.       Example: VARIABLE OVERWRITE "ALWAYS"
  701.     - PATHEXPAND
  702.       This  switch  controls  the  path extension.  If you switch it ON all
  703.       paths  are  'expanded'.   E.g.  if you enter LIBS:  it is expanded to
  704.       something  like  "System:Libs/".  Some older filesystems like ParNet,
  705.       SerNet  or  MessyDOS may cause problems with it, so if you use one of
  706.       them turn this switch OFF.
  707.       Example: VARIABLE PATHEXPAND "ON"
  708.     - QUITVERIFY
  709.       Switches  the  'Do  you really want to quit RO?' requester ON or OFF,
  710.       where  you  can  select  Quit,  Iconify or Cancel.  Hitting the Close
  711.       Gadget equals clicking the Cancel Gadget.
  712.       Example: VARIABLE QUITVERIFY "ON"
  713.     - TEMPDIR
  714.       Here  you  can specify a temporary directory which is needed for some
  715.       special actions like decrunching files or listing archives.
  716.       Example: VARIABLE TEMPDIR "TEMP:"
  717.     Copy:
  718.     - COPYBUF
  719.       Here you can set the maximum buffer RO will use for copying files.
  720.       Example: VARIABLE COPYBUF "50000"
  721.     - COPYDATE
  722.       Here  you can switch ON or OFF whether you like to copy the date of a
  723.       file or not.  Otherwise the date will be set to the actual date.
  724.       Example: VARIABLE COPYDATE "OFF"
  725.     - COPYFLAGS
  726.       Here you can switch ON or OFF whether you like to copy the protection
  727.       bits or not.  If not, RO sets the default protection (RWED).
  728.       Example: VARIABLE COPYFLAGS "OFF"
  729.     - COPYNOTE
  730.       Here  you can switch ON or OFF whether you like to copy the note of a
  731.       file or not.  If not, RO clears the note field.
  732.       Example: VARIABLE COPYNOTE "OFF"
  733.     - COPYSTAT
  734.       Here  you  can switch ON or OFF whether you like to see the currently
  735.       copied  file  or  not.   This  could be useful if you copy many small
  736.       files  because  displaying  every copied file in the status bar could
  737.       mean a heavy cpu load.
  738.       Example: VARIABLE COPYSTAT "OFF"
  739.     - COPYVERIFY
  740.       Here  you can switch ON or OFF whether you like to verify files after
  741.       copy  or  not.   The  copy  procedure  might take a bit longer if you
  742.       switch it ON, but you know that the files are error free.
  743.       Example: VARIABLE COPYVERIFY "OFF"
  744.     Delete:
  745.     - DELDELAY
  746.       Here  you  can specify a delay in ticks (50 ticks = 1 second) to wait
  747.       before  deleting  a  temporary generated file (e.g.  while listing an
  748.       archive  or  decrunching a XPK packed file).  This could be useful if
  749.       you have a text viewer which detaches from CLI and is not fast enough
  750.       to load the temp file before it is deleted.  Warning:  There might be
  751.       problems deleting the file if the command locks the temp file. So its
  752.       better to use a command that does not detach from CLI.
  753.       Example: VARIABLE DELDELAY "50" 
  754.     - DELFORCE
  755.       Here  you  can switch ON or OFF whether you want to force deleting of
  756.       protected  files.   This  setting  also affects overwriting protected
  757.       files. If you switch it ON the files are quietly deleted/overwritten.
  758.       Example: VARIABLE DELFORCE "ON"
  759.     - DELSTAT
  760.       Here  you  can switch ON or OFF whether you like to see the currently
  761.       deleted file in the status bar  or not.  This might be useful for the
  762.       same reasons as COPYSTAT.
  763.       Example: VARIABLE DELSTAT "OFF"
  764.     - DELVERIFY
  765.       Switches  the  'Are  you  sure  you want to  delete  these entries ?'
  766.       requester ON or OFF.
  767.       Example: VARIABLE DELVERIFY "OFF"
  768.     Listview:
  769.     - FORMATLEFT/FORMATRIGHT
  770.       With  this  keyword you can specify which information is displayed in
  771.       the  listview  entries  You can choose a combination of the letters N
  772.       (Name), S (Size), F (Flags), D (Date), T (Time) and C (Comment).
  773.       Example: VARIABLE FORMATLEFT "NTSC"
  774.     - LOADLEFT/LOADRIGHT
  775.       You can specify a path which is automatically loaded in the according
  776.       Listview on startup
  777.       Example: VARIABLE LOADRIGHT "RAM:"
  778.     - PAGELEFT/PAGERIGHT
  779.       This variable sets the page which is in front if you start RO.  There
  780.       are three pages:  'Directory', 'Buffers' and 'Volumes'.
  781.       Example: VARIABLE PAGERIGHT "Volumes"
  782.     - FIRSTLEFT/FIRSTRIGHT
  783.       Adjust  which type of directory entries is displayed first.  Possible
  784.       settings are "Dirs", "Files" and "Mixed".
  785.       Example: VARIABLE FIRSTLEFT  "Mixed"
  786.     - SORTLEFT/SORTRIGHT
  787.       Indicate  which  field  should  be  used  as sort criteria.  Possible
  788.       settings are "Name", "Date" and "Size".
  789.       Example: VARIABLE SORTRIGHT "Size"
  790.     - ORDERLEFT/ORDERRIGHT
  791.       Here  you  can  set if you want the entries to be sorted from high to
  792.       low  (High)  or  vise  versa (Low).  Possible settings are "High" and
  793.       "Low".
  794.       Example: VARIABLE ORDERRIGHT "High"
  795.     - CHECKDUPES
  796.       Here  you can specify if you want to check for dupes on the 'Buffers'
  797.       Page  or  not.   If  you  set  this  Option  ON you will see no dupes
  798.       otherwise dupes are displayed.
  799.       Example: VARIABLE CHECKDUPES "OFF"
  800.     - PAGES
  801.       Here  you  can switch  ON or  OFF whether  you want  to  display  the
  802.       listview  pages  in register groups  or not. You  can only change the
  803.       pages by  using  the internal functions  @{" Buffers " link Buffers}, @{" Directory " link Directory} and
  804.       @{" Volumes " link Volumes}, or via the  middle mouse button. The main advantage using
  805.       OFF is that RO gets a more 'style guide' conform user interface.
  806.       Example: VARIABLE PAGES "OFF"
  807.     Clock:
  808.     - CLOCKPRI
  809.       You  can specify the priority of the 'RO Clock' Task here.  I suggest
  810.       to use the default value. The value must be between -128 and 127
  811.       Example: VARIABLE CLOCKPRI "0"
  812.     - CLOCKREFRESH
  813.       Here  you  should specify the ticks (50 ticks = 1 second) between two
  814.       clock  updates.   This  value should be choosen carefully, because if
  815.       you specify a very small value the clock starts flashing.
  816.       Example: VARIABLE CLOCKREFRESH "50"
  817.     - SHOWDATE
  818.       Here  You  may  specify  if  you want to display a date string in the
  819.       status bar not.
  820.       Example: VARIABLE SHOWDATE "OFF"
  821.     - SHOWDAY
  822.       Here you may specify if a day string like 'Sunday' or 'Monday' should
  823.       be displayed.
  824.       Example: VARIABLE SHOWDAY "ON"
  825.     - SHOWTIME
  826.       Switch this variable 'ON' if you want RO's Clock to display the time.
  827.       Example: VARIABLE SHOWTIME "OFF"
  828.     - SHOWSECONDS
  829.       Specifies  if RO's Clock should display seconds.  This variable takes
  830.       only  affect  if  SHOWTIME  is  set  to 'ON'.  I suggest to turn this
  831.       option off to avoid heavy cpu loads.
  832.       Example: VARIABLE SHOWSECONDS "ON"
  833.     - SHOWMEMORY
  834.       Here you can switch the Workbench-Style Memory display 'ON' and 'OFF'
  835.       Example: VARIABLE SHOWMEMORY "ON"
  836.  @{u}DEFAULT@{uu}
  837.     VARIABLE  APPWINDOW     "LOAD"
  838.     VARIABLE  FLUSHMEMORY   "OFF"
  839.     VARIABLE  CREATEICONS   "ON"
  840.     VARIABLE  FOLLOWSCROLL  "ON"
  841.     VARIABLE  PATHEXPAND    "ON"
  842.     VARIABLE  QUITVERIFY    "ON"
  843.     VARIABLE  COMPLETED     "Flash"
  844.     VARIABLE  DRIVEBUTTONS  "Normal"
  845.     VARIABLE  HOTDIRS       "Normal"
  846.     VARIABLE  MIDDLEMOUSE   "Both"
  847.     VARIABLE  TEMPDIR       "T:"
  848.     VARIABLE  HISTORY       "50"
  849.     VARIABLE  OUTPUT        "CON:0/0/640/200/Output/CLOSE/AUTO"
  850.     VARIABLE  COPYBUF       "524288"
  851.     VARIABLE  COPYDATE      "ON"
  852.     VARIABLE  COPYFLAGS     "ON"
  853.     VARIABLE  COPYNOTE      "ON"
  854.     VARIABLE  COPYSTAT      "ON"
  855.     VARIABLE  COPYVERIFY    "OFF"
  856.     VARIABLE  CHECKFIT      "ON"
  857.     VARIABLE  OVERWRITE     "VERIFY"
  858.     VARIABLE  DELDELAY      "0"
  859.     VARIABLE  DELFORCE      "OFF"
  860.     VARIABLE  DELVERIFY     "ON"
  861.     VARIABLE  DELSTAT       "ON"
  862.     VARIABLE  FORMATLEFT    "NSFDTC"
  863.     VARIABLE  FORMATRIGHT   "NSFDTC"
  864.     VARIABLE  LOADLEFT      ""
  865.     VARIABLE  LOADRIGHT     ""
  866.     VARIABLE  PAGELEFT      "Directory"
  867.     VARIABLE  PAGERIGHT     "Directory"
  868.     VARIABLE  FIRSTLEFT     "Dirs"
  869.     VARIABLE  FIRSTRIGHT    "Dirs"
  870.     VARIABLE  SORTLEFT      "Name"
  871.     VARIABLE  SORTRIGHT     "Name"
  872.     VARIABLE  ORDERLEFT     "High"
  873.     VARIABLE  ORDERRIGHT    "High"
  874.     VARIABLE  CHECKDUPES    "ON"
  875.     VARIABLE  PAGES         "ON"
  876.     VARIABLE  CLOCKREFRESH  "500"
  877.     VARIABLE  CLOCKPRI      "-10"
  878.     VARIABLE  SHOWDAY       "ON"
  879.     VARIABLE  SHOWDATE      "ON"
  880.     VARIABLE  SHOWTIME      "ON"
  881.     VARIABLE  SHOWSECONDS   "OFF"
  882.     VARIABLE  SHOWMEMORY    "ON"
  883. @endnode
  884. @node menu "Menu Configuration"
  885. @prev variable
  886. @next buffer
  887.  @{b}@{u}MENU@{ub}@{uu}
  888.  @{u}SYNOPSIS@{uu}
  889.     MENU "MenuText" "Command"
  890.  @{u}DESCRIPTION@{uu}
  891.      With  this  keyword  you can create a user menu with up to 20 entries,
  892.      the  command  may contain a '%f' if you want to use your menu entry to
  893.      perform  a  action on the selected files.  If you just want to start a
  894.      general  utility  like  a disk copier or a calculator do not specify a
  895.      '%f' within the command string otherwise a selected entry is needed to
  896.      start the command.
  897.  @{u}ARGUMENTS@{uu}
  898.     "MenuText"   40 characters as menu text
  899.     "Command"    CLI command to execute
  900.     You may specify these '%' and '&' parameters for 'Command':
  901.     %a           arexx portname
  902.     %f           source filename with path in quotes
  903.     %F           source filename with path without quotes
  904.     %n           only the source filename in quotes
  905.     %N           only the source filename without quotes
  906.     %p           source path in quotes
  907.     %P           source path without quotes
  908.     %t           target path in quotes
  909.     %T           target path without quotes
  910.     %s           source device in quotes
  911.     %S           source device without quotes
  912.     %d           destination device in quotes
  913.     %D           destination device without quotes
  914.     %r           request a string from user for every file
  915.     %R           request a string from user only once
  916.     &b           do not break command processing on command failure.
  917.     &c           change current directory to source path
  918.     &C           change current directory to target path
  919.     &d           do not deselect entries after processing
  920.     &r           reloads the source directory
  921.     &R           reloads the destination directory
  922.     &w           output window must be closed by user
  923.     %%           percent sign
  924.     &&           and sign
  925.  @{u}DEFAULT@{uu}
  926.     MENU "" ""
  927.  @{u}EXAMPLE@{uu}
  928.     MENU "Calculator" "SYS:Tools/Calculator"
  929. @endnode
  930. @node buffer "Buffer Configuration"
  931. @prev menu
  932. @next hotkey
  933.  @{b}@{u}BUFFER@{ub}@{uu}
  934.  @{u}SYNOPSIS@{uu}
  935.     BUFFER "PathName"
  936.  @{u}DESCRIPTION@{uu}
  937.     With  this  keyword  it  is  possible  to  fill  the 'Buffer' page with
  938.     directories you  often  need.  The number of buffers is only limited by
  939.     the amount of memory you have.
  940.  @{u}ARGUMENTS@{uu}
  941.     "PathName"   directory name to insert
  942.  @{u}DEFAULT@{uu}
  943.     BUFFER ""
  944.  @{u}EXAMPLE@{uu}
  945.     BUFFER "DH1:Comm/Term/Uploads"
  946. @endnode
  947. @node hotkey "HotKey Konfiguration"
  948. @prev buffer
  949. @next hotdir
  950.  @{b}@{u}HOTKEY@{ub}@{uu}
  951.  @{u}SYNOPSIS@{uu}
  952.     HOTKEY "RawKey" "Commandtype" "Command"
  953.  @{u}DESCRIPTION@{uu}
  954.     Here  you  may  specify  up  to  50  hotkeys.  With these hotkeys it is
  955.     possible to execute every internal function or cli command.  You should
  956.     care  that  you  use unique rawkeys for all Commodities and the hotkeys
  957.     only  work  if  the  main  window  of  RO  is  activated.  All internal
  958.     functions are described in the @{" BUTTON " link button} configuration chapter.
  959.  @{u}ARGUMENTS@{uu}
  960.     "RawKey"      standard AmigaDOS rawkey string
  961.     "CommandType" COMMAND or FUNCTION for a cli command or a function
  962.     "Command"     CLI command to execute
  963.     You may specify these '%' and '&' parameters for 'Command':
  964.     %a           arexx portname
  965.     %f           source filename with path in quotes
  966.     %F           source filename with path without quotes
  967.     %n           only the source filename in quotes
  968.     %N           only the source filename without quotes
  969.     %p           source path in quotes
  970.     %P           source path without quotes
  971.     %t           target path in quotes
  972.     %T           target path without quotes
  973.     %s           source device in quotes
  974.     %S           source device without quotes
  975.     %d           destination device in quotes
  976.     %D           destination device without quotes
  977.     %r           request a string from user for every file
  978.     %R           request a string from user only once
  979.     &b           do not break command processing on command failure.
  980.     &c           change current directory to source path
  981.     &C           change current directory to target path
  982.     &d           do not deselect entries after processing
  983.     &r           reloads the source directory
  984.     &R           reloads the destination directory
  985.     &w           output window must be closed by user
  986.     %%           percent sign
  987.     &&           and sign
  988.  @{u}DEFAULT@{uu}
  989.     HOTKEY  "" FUNCTION ""
  990.     HOTKEY  "" FUNCTION ""
  991.     HOTKEY  "" FUNCTION ""
  992.     HOTKEY  "" FUNCTION ""
  993.     HOTKEY  "" FUNCTION ""
  994.     HOTKEY  "" COMMAND ""
  995.     HOTKEY  "" COMMAND ""
  996.     HOTKEY  "" COMMAND ""
  997.     HOTKEY  "" COMMAND ""
  998.     HOTKEY  "" COMMAND ""
  999.  @{u}EXAMPLE@{uu}
  1000.     HOTKEY "ctrl alt del" FUNCTION "REBOOT"
  1001.     HOTKEY "shift c"      FUNCTION "COPYAS"
  1002.     HOTKEY "left"         FUNCTION "PARENT"
  1003. @endnode
  1004. @node hotdir "HotDir Configuration"
  1005. @prev hotkey
  1006. @next drive
  1007.  @{b}@{u}HOTDIR@{ub}@{uu}
  1008.  @{u}SYNOPSIS@{uu}
  1009.     HOTDIR "Number" "PathName"
  1010.  @{u}DESCRIPTION@{uu}
  1011.     Here  you can specify up to ten Hotdirs.  These Hotdirs can be accessed
  1012.     via the function keys F1-F10.  'Number' must between 1 and 10.
  1013.  @{u}ARGUMENTS@{uu}
  1014.     "Number"     function key number between 1 and 10
  1015.     "PathName"   directory name to load
  1016.  @{u}DEFAULT@{uu}
  1017.     HOTDIR  1 ""
  1018.     HOTDIR  2 ""
  1019.     HOTDIR  3 ""
  1020.     HOTDIR  4 ""
  1021.     HOTDIR  5 ""
  1022.     HOTDIR  6 ""
  1023.     HOTDIR  7 ""
  1024.     HOTDIR  8 ""
  1025.     HOTDIR  9 ""
  1026.     HOTDIR 10 ""
  1027.  @{u}EXAMPLE@{uu}
  1028.     HOTDIR  5 "DH1:Comm/Term/Uploads"
  1029. @endnode
  1030. @node drive "Drive Configuration"
  1031. @prev hotdir
  1032. @next button
  1033.  @{b}@{u}DRIVE@{ub}@{uu}
  1034.  @{u}SYNOPSIS@{uu}
  1035.     DRIVE "Number" "GadgetText" "PathName"
  1036.  @{u}DESCRIPTION@{uu}
  1037.     Here  you can specify up to 32 drive buttons, if you specify 16 buttons
  1038.     you  will get only one row of gadgets if you specify more, a second row
  1039.     will  be added.  The GadgetText is limited to 20 characters this should
  1040.     be  enough  and  more  would  need  a really high resolution.  It might
  1041.     happen  that  RO does not fit on your screen even with 5 characters per
  1042.     button.   It  would be best if you play around with it but I suggest to
  1043.     use 3 characters.
  1044.  @{u}ARGUMENTS@{uu}
  1045.     "Number"     number of drive button between 1 and 32
  1046.     "GadgetText" 20 characters as gadget text
  1047.     "PathName"   directory name to load
  1048.  @{u}DEFAULT@{uu}
  1049.     DRIVE  1 "DF0" "DF0:"
  1050.     DRIVE  2 "DF1" "DF1:"
  1051.     DRIVE  3 "DH0" "DH0:"
  1052.     DRIVE  4 "DH1" "DH1:"
  1053.     DRIVE  5 "DH2" "DH2:"
  1054.     DRIVE  6 "DH3" "DH3:"
  1055.     DRIVE  7 "CD0" "CD0:"
  1056.     DRIVE  8 "RAM" "RAM:"
  1057.     DRIVE  9 "DF0" "DF0:"
  1058.     DRIVE 10 "DF1" "DF1:"
  1059.     DRIVE 11 "DH0" "DH0:"
  1060.     DRIVE 12 "DH1" "DH1:"
  1061.     DRIVE 13 "DH2" "DH2:"
  1062.     DRIVE 14 "DH3" "DH3:"
  1063.     DRIVE 15 "CD0" "CD0:"
  1064.     DRIVE 16 "RAM" "RAM:"
  1065.  @{u}EXAMPLE@{uu}
  1066.     DRIVE 2 "INBOUND" "Work:News/Inbound/"
  1067. @endnode
  1068. @node button "Button Configuration"
  1069. @prev drive
  1070. @next arexxinterface
  1071.  @{b}@{u}BUTTON@{ub}@{uu}
  1072.  @{u}SYNOPSIS@{uu}
  1073.     BUTTON "Number" "ButtonType" "GadgetText" "Command"
  1074.  @{u}DESCRIPTION@{uu}
  1075.     This  is the most important keyword in the RO's configuration, here you
  1076.     can  specify  which  text  appears on which button and which command is
  1077.     executed  if  you  click  on  a  button.  After the Keyword you have to
  1078.     supply  a  number  of the button you want to set.  It must be between 1
  1079.     and 120.  Currently RO supports two types of Buttons:  A command button
  1080.     and  a  function  button.   A  command button is a button where you can
  1081.     implement  a  standard  CLI command.  All you have to do is to supply a
  1082.     command  string  with a '%f' at the position where the file name should
  1083.     be  inserted.   RO  supports  several  other  %  instructions which are
  1084.     described  below.   Of  course  RO also cares about the standard system
  1085.     path which means that you don't have to specify the complete path for a
  1086.     command  if it is in the AmigaDOS search path. The function button is a
  1087.     button  where  you  call  internal  functions.   You must also supply a
  1088.     gadget  string  for  the  button  which  may  not  be  longer  than  20
  1089.     characters.   If  you specify a gadget string like '_Copy' or 'R_ename'
  1090.     then  you  are  able to access the gadget via keys, but beware of dupes
  1091.     like  '_Delete'  &  '_Disk'.   Currently  supported  are  the following
  1092.     internal functions:
  1093.     @{" About     " link About}              Show about information.
  1094.     @{" Action    " link Action}              Perform fileaction on selected files.
  1095.     @{" All       " link All}              Select all entries in active listview.
  1096.     @{" Assign    " link Assign}              Create an assign for active directory.
  1097.     @{" Buffers   " link Buffers}              Brings the buffers page to front.
  1098.     @{" ByName    " link ByName}              Select files by name.
  1099.     @{" Bytes     " link Bytes}              Count bytes of selected entries.
  1100.     @{" Change    " link Change}              Change sorttype of active listview.
  1101.     @{" Copy      " link Copy}              Copy files and directories.
  1102.     @{" CopyAs    " link Copy}              Copy files and directories and change name.
  1103.     @{" CopyDev   " link CopyDev}              Copy files to a device.
  1104.     @{" Current   " link Current}              Load current directory.
  1105.     @{" Delete    " link Delete}              Delete files and directories.
  1106.     @{" Directory " link Directory}              Brings the directory page to front.
  1107.     @{" Disk      " link Disk}              Show information about active disk.
  1108.     @{" Dup       " link Dup}              Duplicate entries.
  1109.     @{" Expand    " link Expand}              Expand a path to its ARCHandler equivalent.
  1110.     @{" Fit       " link Fit}              Check if entries fit on destination.
  1111.     @{" Help      " link Help}              Show online help.
  1112.     @{" Icon      " link Icon}              Select corresponding .info files.
  1113.     @{" Info      " link Info}              Show information for selected files.
  1114.     @{" LActive   " link Active}              Activate left listview.
  1115.     @{" LCopy     " link LCopy}              Copy active listview to inactive.
  1116.     @{" LFold     " link LFold}              Fold right listview.
  1117.     @{" LSwap     " link LSwap}              Swap active and inactive listview
  1118.     @{" ListArc   " link ListArc}              List contents of archives.
  1119.     @{" LParent   " link Parent}              Load parent directory of left path.
  1120.     @{" LReload   " link Reload}              Refresh left directory.
  1121.     @{" LRoot     " link Root}              Load root directory of left path.
  1122.     @{" MakeDir   " link MakeDir}              Create directories.
  1123.     @{" MDLoad    " link MakeDir}              Create a directory and load it.
  1124.     @{" Move      " link Move}              Move files and directories.
  1125.     @{" MoveAs    " link MoveAs}              Move files and directories and change name.
  1126.     @{" None      " link None}              Deselect all entries.
  1127.     @{" Note      " link Note}              Modify filenotes.
  1128.     @{" Parent    " link Parent}              Load parent directory.
  1129.     @{" Protect   " link Protect}              Modify protection flags.
  1130.     @{" Quit      " link Quit}              Quit 'RO'
  1131.     @{" RActive   " link Active}              Activate right listview.
  1132.     @{" Reboot    " link Reboot}              Reboot your system.
  1133.     @{" Relabel   " link Relabel}              Relabel volumes.
  1134.     @{" Reload    " link Reload}              Refresh active directory.
  1135.     @{" Rename    " link Rename}              Rename entries.
  1136.     @{" Root      " link Root}              Load root directory.
  1137.     @{" RParent   " link Parent}              Load parent directory of right path.
  1138.     @{" RReload   " link Reload}              Refresh right directory.
  1139.     @{" RRoot     " link Root}              Load root directory of right path.
  1140.     @{" SetDate   " link SetDate}              Modify date of a file or directory.
  1141.     @{" Shrink    " link Shrink}              Shrink an ARCHandler path to normal.
  1142.     @{" Toggle    " link Toggle}              Toggleselect all entries.
  1143.     @{" Touch     " link Touch}              Set date or create file.
  1144.     @{" UnArc     " link UnArc}              Extract files from archives.
  1145.     @{" Update    " link Update}              Select files for update.
  1146.     @{" Volumes   " link Volumes}              Brings the volumes page to front.
  1147.  @{u}ARGUMENTS@{uu}
  1148.     "Number"     number of command button between 1 and 120
  1149.     "ButtonType" COMMAND or FUNCTION button
  1150.     "GadgetText" 20 chars as gadget text
  1151.     "Command"    CLI command to execute
  1152.     You may specify these '%' and '&' parameters for 'Command':
  1153.     %a           arexx portname
  1154.     %f           source filename with path in quotes
  1155.     %F           source filename with path without quotes
  1156.     %n           only the source filename in quotes
  1157.     %N           only the source filename without quotes
  1158.     %p           source path in quotes
  1159.     %P           source path without quotes
  1160.     %t           target path in quotes
  1161.     %T           target path without quotes
  1162.     %s           source device in quotes
  1163.     %S           source device without quotes
  1164.     %d           destination device in quotes
  1165.     %D           destination device without quotes
  1166.     %r           request a string from user for every file
  1167.     %R           request a string from user only once
  1168.     &b           do not break command processing on command failure.
  1169.     &c           change current directory to source path
  1170.     &C           change current directory to target path
  1171.     &d           do not deselect entries after processing
  1172.     &r           reloads the source directory
  1173.     &R           reloads the destination directory
  1174.     &w           output window must be closed by user
  1175.     %%           percent sign
  1176.     &&           and sign
  1177.  @{u}DEFAULT@{uu}
  1178.     BUTTON     1     COMMAND   "Read"        "Most >NIL: %f"
  1179.     BUTTON     2     COMMAND   "Run"         "Run >NIL: %f"
  1180.     BUTTON     3     FUNCTION  "_Delete"     DELETE
  1181.     BUTTON     4     FUNCTION  "_Move"       MOVE
  1182.     BUTTON     5     FUNCTION  "_Copy"       COPY
  1183.     BUTTON     6     FUNCTION  "_Bytes"      BYTES
  1184.     BUTTON     7     FUNCTION  "All"         ALL
  1185.     BUTTON     8     COMMAND   "Arc"         "LhA >NIL: -x -r a %R %n &c"
  1186.     BUTTON     9     COMMAND   "View"        "MultiView >NIL: %f"
  1187.     BUTTON    10     COMMAND   "_Edit"       "Ed >NIL: %f"
  1188.     BUTTON    11     FUNCTION  "Touch"       TOUCH
  1189.     BUTTON    12     FUNCTION  "Move As"     MOVEAS
  1190.     BUTTON    13     FUNCTION  "Copy As"     COPYAS
  1191.     BUTTON    14     FUNCTION  "Fit"         FIT
  1192.     BUTTON    15     FUNCTION  "None"        NONE
  1193.     BUTTON    16     FUNCTION  "ListArc"     LISTARC
  1194.     BUTTON    17     FUNCTION  "_Action"     ACTION
  1195.     BUTTON    18     COMMAND   "XEdit"       "FileX >NIL: %f"
  1196.     BUTTON    19     FUNCTION  "MakeDir"     MAKEDIR
  1197.     BUTTON    20     FUNCTION  "_Rename"     RENAME
  1198.     BUTTON    21     FUNCTION  "Dup"         DUP
  1199.     BUTTON    22     FUNCTION  "Refresh"     RELOAD
  1200.     BUTTON    23     FUNCTION  "_Pattern"    BYNAME
  1201.     BUTTON    24     FUNCTION  "UnArc"       UNARC
  1202.     BUTTON    25     COMMAND   "Music"       "DeliTracker >NIL: MODULE %f"
  1203.     BUTTON    26     FUNCTION  "Assign"      ASSIGN
  1204.     BUTTON    27     COMMAND   "Command"     "%r"
  1205.     BUTTON    28     FUNCTION  "_Comment"    NOTE
  1206.     BUTTON    29     FUNCTION  "Change"      CHANGE
  1207.     BUTTON    30     FUNCTION  "Parent"      PARENT
  1208.     BUTTON    31     FUNCTION  "Reverse"     TOGGLE
  1209.     BUTTON    32     FUNCTION  "_Disk"       DISK
  1210.     BUTTON    33     FUNCTION  "LSwap"       LSWAP
  1211.     BUTTON    34     FUNCTION  "_Relabel"    RELABEL
  1212.     BUTTON    35     COMMAND   "Execute"     "Execute %r"
  1213.     BUTTON    36     FUNCTION  "_Protect"    PROTECT
  1214.     BUTTON    37     FUNCTION  "_Expand"     EXPAND
  1215.     BUTTON    38     FUNCTION  "Root"        ROOT
  1216.     BUTTON    39     FUNCTION  "_Update"     UPDATE
  1217.     BUTTON    40     FUNCTION  "_Info"       INFO
  1218.     BUTTON    41     FUNCTION  "LCopy"       LCOPY
  1219.     BUTTON    42     FUNCTION  "CopyDev"     COPYDEV
  1220.     BUTTON    43     COMMAND   "Rexx"        "Rx %r"
  1221.     BUTTON    44     FUNCTION  "SetDate"     SETDATE
  1222.     BUTTON    45     FUNCTION  "_Shrink"     SHRINK
  1223.     BUTTON    46     FUNCTION  "Current"     CURRENT
  1224.     BUTTON    47     FUNCTION  "Icon"        ICON
  1225.     BUTTON    48     FUNCTION  "Help"        HELP
  1226.  @{u}EXAMPLE@{uu}
  1227.     BUTTON 98 COMMAND "DirTree" "DirTree %f"
  1228. @endnode
  1229. @node About
  1230. @prev Volumes
  1231. @next Action
  1232.  @{b}@{u}About@{ub}@{uu}
  1233.  This  function  opens  the  requester  which contains my address and other
  1234.  information about the registration.
  1235. @endnode
  1236. @node Action
  1237. @prev About
  1238. @next All
  1239.  @{b}@{u}Action@{ub}@{uu}
  1240.  This  function  performs a command on every selected file according to its
  1241.  file  type.   You have to specify a command for each file type if you want
  1242.  to  use  this  function  otherwise  MultiView will be started for all file
  1243.  types.   Consult  the @{" FILETYPE " link filetype} section in the configuration chapter for
  1244.  further information.
  1245.  You can abort this function by closing the progress indication window.
  1246. @endnode
  1247. @node All
  1248. @prev Action
  1249. @next Assign
  1250.  @{b}@{u}All@{ub}@{uu}
  1251.  This function selects all entries in the active directory listview.
  1252. @endnode
  1253. @node Assign
  1254. @prev All
  1255. @next Buffers
  1256.  @{b}@{u}Assign@{ub}@{uu}
  1257.  This  function  creates  an  assign  for  the path currently loaded in the
  1258.  active  listview.   A  requester will pop up to ask you for a device name.
  1259.  You should enter something like 'foobar:' here.  The colon is optional and
  1260.  may be left out.
  1261. @endnode
  1262. @node Buffers
  1263. @prev Assign
  1264. @next ByName
  1265.  @{b}@{u}Buffers@{ub}@{uu}
  1266.  This  function  brings the buffers page of the active side to front.
  1267. @endnode
  1268. @node ByName
  1269. @prev Buffers
  1270. @next Bytes
  1271.  @{b}@{u}ByName@{ub}@{uu}
  1272.  This  function  selects  all  entries  matching a specified pattern in the
  1273.  active  directory  listview.   A  requester  pops  up  and  asks you for a
  1274.  pattern.   You may specify all standard AmigaDOS wildcards such as '#?' or
  1275.  '*' here.
  1276. @endnode
  1277. @node Bytes
  1278. @prev ByName
  1279. @next Change
  1280.  @{b}@{u}Bytes@{ub}@{uu}
  1281.  This  function  counts  all  bytes  of  the selected entries and their sub
  1282.  directories  in  the  active  listview.   After  that  an  information  is
  1283.  displayed  in  the  status bar which  should look like '64728 Bytes in 109
  1284.  Files and 15 Directories'.
  1285.  You can abort this function by closing the progress indication window.
  1286. @endnode
  1287. @node Change
  1288. @prev Bytes
  1289. @next Copy
  1290.  @{b}@{u}Change@{ub}@{uu}
  1291.  With  this  function  you  can  change the current sort type of the active
  1292.  listview.  This works analog to the @{" SORTLEFT " link variable}, @{" SORTRIGHT " link variable} , @{" FIRSTLEFT " link variable},
  1293.  @{" FIRSTRIGHT " link variable}, @{" ORDERLEFT " link variable}  and  @{" ORDERRIGHT " link variable} keywords in the configuration
  1294.  file.  A requester opens where you can select the sort criterias.
  1295. @endnode
  1296. @node Copy
  1297. @prev Change
  1298. @next CopyDev
  1299.  @{b}@{u}Copy@{ub}@{uu}
  1300.  This function copies all selected files and/or directories from the source
  1301.  listview  to  the destination path.  If you use CopyAs a requester pops up
  1302.  which asks you for a new name of the currently copied file.  You can abort
  1303.  the  operation  by hitting the 'Cancel' gadget or you may skip the current
  1304.  file by clicking on 'Skip'.
  1305.  If  you  set  the according options in the preference file or you selected
  1306.  them  from  menu,  the  flags,  comment  and  date of the copied files are
  1307.  cloned. Refer to the @{" VARIABLE " link variable} configuration chapter.
  1308.  You can abort this function by closing the progress indication window.
  1309. @endnode
  1310. @node CopyDev
  1311. @prev Copy
  1312. @next Current
  1313.  @{b}@{u}CopyDev@{ub}@{uu}
  1314.  This  function  copies  all  selected  files  of  the active listview to a
  1315.  specified  device.   A  requester pops up which asks you where the entries
  1316.  should  be  copied  to.  This is useful if you have a couple of ascii text
  1317.  files  and  want  to  print them.  All you have to do is 'CopyDev' them to
  1318.  'PRT:'.
  1319. @endnode
  1320. @node Current
  1321. @prev CopyDev
  1322. @next Delete
  1323.  @{b}@{u}Current@{ub}@{uu}
  1324.  This  function loads the current directory of the active listview.
  1325. @endnode
  1326. @node Delete
  1327. @prev Current
  1328. @next Directory
  1329.  @{b}@{u}Delete@{ub}@{uu}
  1330.  This  function  deletes  all  entries  currently  selected  in  the active
  1331.  directory.  A requester might pop up which asks you if you are really sure
  1332.  that  you  want  to  delete  the selected entries but this depends on your
  1333.  configuration or on the @{" DELVERIFY " link variable} settings in the menu.
  1334.  You can abort this function by closing the progress indication window.
  1335. @endnode
  1336. @node Directory
  1337. @prev Delete
  1338. @next Disk
  1339.  @{b}@{u}Directory@{ub}@{uu}
  1340.  This  function  brings the directory page of the active side to front.
  1341. @endnode
  1342. @node Disk
  1343. @prev Directory
  1344. @next Dup
  1345.  @{b}@{u}Disk@{ub}@{uu}
  1346.  This  function  opens  a  requester  which shows all information about the
  1347.  device currently loaded in the active listview. You can obtain things like
  1348.  free  bytes or block size of the device here.  To close the requester just
  1349.  click on okay or use the close gadget.
  1350. @endnode
  1351. @node Dup
  1352. @prev Disk
  1353. @next Expand
  1354.  @{b}@{u}Dup@{ub}@{uu}
  1355.  This function duplicates all selected entries in the active listview.  You
  1356.  will  be  asked  at  each  entry how to call the copy.  You may abort this
  1357.  function  by  hitting the 'Cancel' gadget or you may skip a single file by
  1358.  clicking on the 'Skip' gadget.
  1359. @endnode
  1360. @node Expand
  1361. @prev Dup
  1362. @next Fit
  1363.  @{b}@{u}Expand@{ub}@{uu}
  1364.  If you use ARCHandler this might be useful for you.  This function expands
  1365.  the path name of the actual loaded directory of the active listview.  e.g.
  1366.  System:Devs/ to Archives:System/Devs/
  1367. @endnode
  1368. @node Fit
  1369. @prev Expand
  1370. @next Help
  1371.  @{b}@{u}Fit@{ub}@{uu}
  1372.  This function calculates the number of bytes the selected enties will need
  1373.  on  the  destination  device.   RO  also cares about the blocks needed for
  1374.  directory  organisation.   After  that  an information is displayed in the
  1375.  status  bar which tells you if the selected entries fit on the destination
  1376.  device or not.
  1377.  You can abort this function by closing the progress indication window.
  1378. @endnode
  1379. @node Help
  1380. @prev Fit
  1381. @next Icon
  1382.  @{b}@{u}Help@{ub}@{uu}
  1383.  This  function  opens the online help main page.  You can also get this by
  1384.  pressing  the  HELP  key.  When the HELP key is pressed RO tries to obtain
  1385.  the  help  node  from the current object (the one under the mouse pointer)
  1386.  and   shows  the  according  help  page.   Make  sure  that  you  set  the
  1387.  environement  'ENV:AmigaGuide/Path' correct so RO can find the helpfile if
  1388.  it's not in the same directory as the executable.
  1389. @endnode
  1390. @node Icon
  1391. @prev Help
  1392. @next Info
  1393.  @{b}@{u}Icon@{ub}@{uu}
  1394.  This  function  selects  all  corresponding  '.info' files for the current
  1395.  selected entries in the active listview.
  1396. @endnode
  1397. @node Info
  1398. @prev Icon
  1399. @next Active
  1400.  @{b}@{u}Info@{ub}@{uu}
  1401.  This  function  opens  a  requester  which shows all information about the
  1402.  currently  selected entries of the active listview.  You can obtain things
  1403.  like  file  type  and protection bits here.  To get to the next file close
  1404.  the  requester  just  by clicking on okay.  The function may be aborted by
  1405.  hitting the 'Cancel' gadget or by closing the window via close gadget.
  1406. @endnode
  1407. @node Active
  1408. @prev Info
  1409. @next LCopy
  1410.  @{b}@{u}Active@{ub}@{uu}
  1411.  This function lets you activate a certain Listview.  LActive activates the
  1412.  left one and RActive activates the right one.
  1413. @endnode
  1414. @node LCopy
  1415. @prev Active
  1416. @next LFold
  1417.  @{b}@{u}LCopy@{ub}@{uu}
  1418.  This function copies the active listview path to the other listview.
  1419. @endnode
  1420. @node LFold
  1421. @prev LCopy
  1422. @next LSwap
  1423.  @{b}@{u}LFold@{ub}@{uu}
  1424.  This function is used to hide/show the right listview.
  1425. @endnode
  1426. @node LSwap
  1427. @prev LFold
  1428. @next ListArc
  1429.  @{b}@{u}LSwap@{ub}@{uu}
  1430.  This function swaps the active and inactive listview paths.
  1431. @endnode
  1432. @node ListArc
  1433. @prev LSwap
  1434. @next Parent
  1435.  @{b}@{u}ListArc@{ub}@{uu}
  1436.  This  function lists all selected archive files using the matching archive
  1437.  lister and the ascii file type command.
  1438.  You can abort this function by closing the progress indication window.
  1439. @endnode
  1440. @node Parent
  1441. @prev ListArc
  1442. @next Reload
  1443.  @{b}@{u}Parent@{ub}@{uu}
  1444.  This  function  loads the parent directory of the active listview.  If you
  1445.  use  'LParent'  it  performs a Parent function on the left listview if you
  1446.  use  'RParent'  it  uses  the  right  listview.  If RO can't find a parent
  1447.  directory for the path it just updates the directory.
  1448. @endnode
  1449. @node Reload
  1450. @prev Parent
  1451. @next Root
  1452.  @{b}@{u}Reload@{ub}@{uu}
  1453.  The functions Reload, LReload and RReload update the active, left or right
  1454.  directory currently loaded in the directory listview.
  1455. @endnode
  1456. @node Root
  1457. @prev Reload
  1458. @next MakeDir
  1459.  @{b}@{u}Root@{ub}@{uu}
  1460.  This function loads the root directory of the active listview.  If you use
  1461.  LRoot or RRoot this function applies to the left or right side.
  1462. @endnode
  1463. @node MakeDir
  1464. @prev Root
  1465. @next Move
  1466.  @{b}@{u}MakeDir@{ub}@{uu}
  1467.  If  you  use  this function a requester appears which asks you for a name.
  1468.  The  name  you enter will be used as name for a directory which is created
  1469.  in the active listview.  If you use 'MDLoad' instead the directory is also
  1470.  loaded into the source listview.
  1471. @endnode
  1472. @node Move
  1473. @prev MakeDir
  1474. @next None
  1475.  @{b}@{u}Move@{ub}@{uu}
  1476.  This  function moves all selected files and/or directories from the source
  1477.  listview  to  the destination path.  If you use MoveAs a requester pops up
  1478.  which  asks you for a new name of the currently moved file.  You can abort
  1479.  the  operation  by hitting the 'Cancel' gadget or you may skip the current
  1480.  file by clicking on 'Skip'.  RO notices if you move files from a device to
  1481.  the  same device.  It just renames the files which is propably much faster
  1482.  than copying and deleting them.
  1483.  If  you  set  the according options in the preference file or you selected
  1484.  them from menu the flags, comment and date of the moved files are cloned.
  1485.  Refer to the @{" VARIABLE " link variable} configuration chapter.
  1486.  You can abort this function by closing the progress indication window.
  1487. @endnode
  1488. @node None
  1489. @prev Move
  1490. @next Note
  1491.  @{b}@{u}None@{ub}@{uu}
  1492.  This function deselects all entries in the active directory listview.
  1493. @endnode
  1494. @node Note
  1495. @prev None
  1496. @next Protect
  1497.  @{b}@{u}Note@{ub}@{uu}
  1498.  This  function lets you change the file comment of all selected entries in
  1499.  the  active  listview.  A requester pops up which contains the old comment
  1500.  and  you may change it there.  The operation can be aborted by hitting the
  1501.  'Cancel'  gadget  or  you may skip the current file by clicking the 'Skip'
  1502.  gadget.  To proceed just press return or use the 'Okay' button.
  1503. @endnode
  1504. @node Protect
  1505. @prev Note
  1506. @next Quit
  1507.  @{b}@{u}Protect@{ub}@{uu}
  1508.  This  function  opens a requester where you may change the protection bits
  1509.  for  the  selected  entries.   For  each  protection  flag  you may choose
  1510.  'Ignore',  'Set' or 'UnSet'.  'Ignore' means that this bit is not changed,
  1511.  'Set'  means  that  this  bit  is  set  and 'UnSet' means that this bit is
  1512.  cleared.   You  may change these bits step by step for each entry by using
  1513.  the 'Okay' gadget or you may change them all at once by clicking the 'All'
  1514.  button.  The operation may be aborted by hitting the 'Cancel' gadget or by
  1515.  closing the progress indication window.
  1516. @endnode
  1517. @node Quit
  1518. @prev Protect
  1519. @next Reboot
  1520.  @{b}@{u}Quit@{ub}@{uu}
  1521.  Quits the program and removes RO from memory.
  1522. @endnode
  1523. @node Reboot
  1524. @prev Quit
  1525. @next Relabel
  1526.  @{b}@{u}Reboot@{ub}@{uu}
  1527.  Reboots your computer without any warning requester. :)
  1528. @endnode
  1529. @node Relabel
  1530. @prev Reboot
  1531. @next Rename
  1532.  @{b}@{u}Relabel@{ub}@{uu}
  1533.  With  this function you can change the device name of the directory loaded
  1534.  in  the  active listview.  A requester pops up and you may modify the name
  1535.  there.  If you want to abort the operation use the 'Cancel' button.
  1536. @endnode
  1537. @node Rename
  1538. @prev Relabel
  1539. @next SetDate
  1540.  @{b}@{u}Rename@{ub}@{uu}
  1541.  This  function is needed to rename the selected entries.  A requester pops
  1542.  up  for every entry and you may change its name.  If you want to abort the
  1543.  operation click on 'Cancel' but if you just want to skip the current entry
  1544.  select 'Skip'.  After you have changed the name press return to proceed or
  1545.  hit the 'Okay' Button.
  1546. @endnode
  1547. @node SetDate
  1548. @prev Rename
  1549. @next Shrink
  1550.  @{b}@{u}SetDate@{ub}@{uu}
  1551.  This  function  lets  you  set  the date and time of all entries currently
  1552.  selected  in  the  active listview.  A requester pops up with the old date
  1553.  and  time  of  the  entry as string gadget contents and you may modify it.
  1554.  The input must be in standard AmigaDOS format.  You may abort the function
  1555.  by  using  the 'Cancel' gadget or you may skip the current file by hitting
  1556.  the 'Skip' button.
  1557. @endnode
  1558. @node Shrink
  1559. @prev SetDate
  1560. @next Toggle
  1561.  @{b}@{u}Shrink@{ub}@{uu}
  1562.  If you use ARCHandler this might be useful for you.  This function shrinks
  1563.  the path name of the actual loaded directory of the active listview.  e.g.
  1564.  Archives:System/Devs/  to  System:Devs/ but it works only if the currently
  1565.  loaded directory is no archive file.
  1566. @endnode
  1567. @node Toggle
  1568. @prev Shrink
  1569. @next Touch
  1570.  @{b}@{u}Toggle@{ub}@{uu}
  1571.  This function toggle selects all entries in the active directory listview.
  1572. @endnode
  1573. @node Touch
  1574. @prev Toggle
  1575. @next UnArc
  1576.  @{b}@{u}Touch@{ub}@{uu}
  1577.  If  you  have  one or more entries selected this function updates the date
  1578.  and  time,  otherwise  a  requester asks you for a file name and this file
  1579.  will  be  created  in the active path.  If you are updating  dates you may
  1580.  abort  the  operation  by closing the progress indication window otherwise
  1581.  just press the 'Cancel' button.
  1582. @endnode
  1583. @node UnArc
  1584. @prev Touch
  1585. @next Update
  1586.  @{b}@{u}UnArc@{ub}@{uu}
  1587.  This  function  extracts all selected archives to the destination listview
  1588.  using an archive extracter according to the file type.
  1589.  You can abort this function by closing the progress indication window.
  1590. @endnode
  1591. @node Update
  1592. @prev UnArc
  1593. @next Volumes
  1594.  @{b}@{u}Update@{ub}@{uu}
  1595.  This  function  selects  entries  in  the active listview which do already
  1596.  exist  in  the destination listview.  This is quiet useful if you update a
  1597.  software package.  If you want to select the entries which do not exist in
  1598.  the destination listview you should use 'Update' and 'Reverse'.
  1599. @endnode
  1600. @node Volumes
  1601. @prev Update
  1602. @next About
  1603.  @{b}@{u}Volumes@{ub}@{uu}
  1604.  This  function  brings the volumes page of the active side to front.
  1605. @endnode
  1606. @node arexxinterface "Arexx Interface"
  1607. @prev button
  1608. @next discussion
  1609.  @{b}@{u}ARexx Interface@{ub}@{uu}
  1610.  RO  has a built-in ARexx port, which understands the following commands:
  1611.    - QUIT
  1612.      Ends the application.
  1613.    - HIDE
  1614.      Hides (iconifies) the application
  1615.    - SHOW
  1616.      Shows (pops up) an iconified application.
  1617.    - INFO ITEM/A
  1618.      According to the given parameter the result string is filled with
  1619.      the following contents:
  1620.         - "title"       Title of the application
  1621.         - "author"      Author of the  application
  1622.         - "copyright"   Copyright message
  1623.         - "description" Short description
  1624.         - "version"     Version string
  1625.         - "base"        Name of the ARexx port
  1626.         - "screen"      Name of the public screen
  1627.      Example: 'Info "title"'
  1628.    - HELP FILE/A
  1629.      A list of all ARexx commands available for the application is
  1630.      written into the given file.
  1631.      Example: 'Help "RAM:RexxCommands"'
  1632.    - ACTIVE SIDE/A
  1633.      With  this  function  you  can make a certain listview the active one.
  1634.      'Active Left' activates the left one and 'Active Right' the right one.
  1635.      If you use 'Active Active' the active one gets activated which seems a
  1636.      bit  useless  but  as  the 'Active' command returns the last active as
  1637.      result,  you can obtain the currently active listview without changing
  1638.      it.   'Active  Inactive'  activates  the  listview  which is currently
  1639.      unselected.
  1640.      Example: 'Active Inactive'
  1641.    - CHOICEREQ STRING/A
  1642.      'ChoiceReq  String'  opens  a requester which may be answered clicking
  1643.      'Okay'  or  'Cancel'.   If  you use 'Okay' it returns '1' otherwise it
  1644.      returns '0'.
  1645.      Example: 'ChoiceReq "Are you sure?"'
  1646.    - CHANGE SIDE/A,SWITCH/A
  1647.      With  this  function you may change the sort flags of the listviews in
  1648.      the  same  way  as  you  may  change  them via the 'Change' Requester.
  1649.      SIDE/A  may be 'Left', 'Right', 'Active' or 'Inactive'.  Switch may be
  1650.      'Dirs', 'Files', 'Mixed', 'Name', 'Date', 'Size', 'High' and 'Low'.
  1651.      Example: 'Change Active Mixed'
  1652.    - COMMAND STRING/A,FILE/A
  1653.      This  function  starts  a  command.  All you have to do is to supply a
  1654.      parse  string  with the supported % parameters.  FILE/A is the name of
  1655.      the  file  which  replaces  the %f or %F in the command string.  If an
  1656.      error occured while executing the command RC is set to a value unequal
  1657.      zero.
  1658.      Example: 'Command "Delete %f" "S:User-Startup"'
  1659.    - FILEACTION FILE/A
  1660.      With  this function you could activate the file recognition of RO.  It
  1661.      happens  exactly  the same as if you double clicked the file specified
  1662.      by FILE/A.
  1663.      Example: 'FileAction "S:Startup-Sequence"'
  1664.    - FUNCTION NAME/A
  1665.      With this command you may call any internal function RO supports.
  1666.      Example: 'Function "COPYAS"'
  1667.    - GETENTRY SIDE/A,TYPE/A
  1668.      'GetEntry'  returns the first selected entry of the specified side and
  1669.      deselects  it.   Side  may be 'Left', 'Right', 'Active' or 'Inactive'.
  1670.      If  you  want  that  'GetEntry'  returns  only the selected files, use
  1671.      'Files'  for  the TYPE/A argument.  For drawers only use 'Dirs' and if
  1672.      you  want  all entries use 'Any'.  If there are no entries selected of
  1673.      the specified type 'GetEntry' sets 'Result=RESULT'.
  1674.      Example: 'GetEntry Active Files'
  1675.    - LOAD SIDE/A,DIR/A
  1676.      Loads a directory into the specified side.  As you have guessed SIDE/A
  1677.      may  be  'Left',  'Right',  'Active'  or  'Inactive'.   DIR/A  is  the
  1678.      directory to load.
  1679.      Example: 'Load Active "RAM:"'
  1680.    - MESSAGE STRING/A
  1681.      'Message  "This is a test"' writes the message 'This is a test' to the
  1682.      status  bar.   To  prevent  it from being overwritten by the Clock you
  1683.      should use 'Sleep' before and 'Wakeup' after it.
  1684.      Example: 'Message "Das ist ein Test"'
  1685.    - NUMENTRIES SIDE/A,TYPE/A
  1686.      Returns  the number of selected entries of the requested side.  SIDE/A
  1687.      may  be  'Left',  'Right',  'Active'  or  'Inactive'.   If you want to
  1688.      process  only  the selected files use 'Files' for TYPE/A.  For drawers
  1689.      only use 'Dirs' and otherwise use 'Any'.
  1690.      Example: 'NumEntries Active Dirs'
  1691.    - PATH SIDE/A
  1692.      With  this  function  you  will  get  the path currently loaded in the
  1693.      specified   side.    SIDE/A   may  be  'Left',  'Right',  'Active'  or
  1694.      'Inactive'.    If  there  is  no  directory  loaded  'Path'  will  set
  1695.      'Result=RESULT'.
  1696.      Example: 'Path Right'
  1697.    - REFRESH SIDE/A
  1698.      You  may refresh the specified side with this function.  SIDE/A may be
  1699.      'Left',  'Right',  'Active'  or  'Inactive'.  If there is no directory
  1700.      loaded 'Refresh' will set 'Result=RESULT'.
  1701.      Example: 'Refresh Inactive'
  1702.    - SLEEP
  1703.      With  this function you may put RO asleep, which means that it rejects
  1704.      all inputs and the Clock is frozen.  This function should be the first
  1705.      one  you call in every arexx program to prevent the Clock from erasing
  1706.      messages you wrote into the status bar using the 'Message' command.
  1707.    - STRINGREQ STRING/A
  1708.      Using  'StringReq  "PRT:' you will get a input requester where you may
  1709.      edit  the  string  'PRT:'.   If  you  press  'Cancel' Result is set to
  1710.      'RESULT'.
  1711.      Example: 'StringReq "T:__TEMPFILE__"'
  1712.    - WAKEUP
  1713.      With 'Wakeup' you are able to wake RO up.  Please make sure that every
  1714.      'Sleep'  is  followed  by an 'Wakeup' command otherwise RO is unusable
  1715.      until you call the 'Wakeup' function.
  1716.  If you call an arexx program within RO for example using a button to start
  1717.  a  script make sure that the command string contains 'Rx '.  RO needs this
  1718.  to  recognize that you are calling an arexx program.  This is necessary to
  1719.  prevent a deadlock.
  1720.  If you need the name of the selected file in your arexx script then do not
  1721.  use %f but %F otherwise you might get some problems with the quotes.
  1722. @endnode
  1723. @node discussion "Discussion"
  1724. @prev arexxinterface
  1725. @next registration
  1726. Q: Sometimes RO does not recognize that I have a file selected. Why?
  1727. A: No there is another problem.  It is sometimes really difficult to see if
  1728.    a  file  is  selected or not because the cursor which is normally needed
  1729.    for  keyboard  control has nearly the same color as a selected file with
  1730.    the  cursor  on  it.   You  can  'fix'  this  problem if you set the 'BG
  1731.    Listview Cursor' image to another color.
  1732. Q: I start RO and nothing happens. What's the problem?
  1733. A: Your screen resolution might be too low especially the screen  width  so
  1734.    RO  doesn't  fit  on  your  screen.  Try using a smaller font or use the
  1735.    Overscan  Prefs  to  gain some pixels.  The minimum RO needs to work are
  1736.    640 x 200 and topaz 8 font.
  1737. Q: I created a new button to start a cli command but it doesn't work. Why?
  1738. A: Make sure that you created a COMMAND button and no FUNCTION button.
  1739. @endnode
  1740. @node registration "Registration"
  1741. @prev discussion
  1742. @next registrationform
  1743.  @{b}@{u}Registration@{ub}@{uu}
  1744.  If  you register you will recieve a disk with the newest public release of
  1745.  RO and a personalized, so-called "keyfile" that turns the crippled version
  1746.  into  a full functional and powerful Directory Tool!  With the keyfile you
  1747.  can unlock all future versions of RO. If you've an e-mail address  you can
  1748.  get your keyfile uuencoded as e-mail.
  1749.  The minimum price for a RO registration is
  1750.       30.- DM  (D-Mark),
  1751.       20.- US$ (US Dollar)
  1752.  or  an  equivalent amount of US$ 25.- (twentyfive!) in any other currency.
  1753.  "Twentyfive"  because  I  have  to  visit  my  bank  and sell your foreign
  1754.  currency  which  is  some kind of expensive here in Germany.  If you think
  1755.  your bank does it cheaper, feel free to get some 20.- US$ at home and send
  1756.  them.
  1757.  The  fastest,  cheapest  and  easiest  way  to  register  is put the money
  1758.  together with the filled registration form into a letter and send it to:
  1759.         Oliver Rummeyer
  1760.         Hochbergstrasse 49/1
  1761.         D-88213 Ravensburg
  1762.         Germany/Europe
  1763.  Euro  cheques (in DM) are also welcome, but please do not send any kind of
  1764.  foreign  cheques  since  the  bank  charges  outrageous fees from both the
  1765.  sender  and  the  receiver.  If you really feel you must use such cheques,
  1766.  please include extra $10.
  1767.  You  can  also transfer the money directly to my bank account, but beware:
  1768.  international transfers via banks are very expensive.
  1769.   Oliver Rummeyer, Kreissparkasse Ravensburg, BLZ 65050110, Konto 48276999
  1770.  In  any  case, be sure to provide me with your name, address, phone number
  1771.  and e-mail address for filing purposes.  You can send this information via
  1772.  electronic mail, if you wish.  If you don't mind, this data will be stored
  1773.  and   processed   in   electronic   form.    You   may   use   the  sample
  1774.  @{" Registration Form " link registrationform} included in the documentation.
  1775.  Thank you for supporting Shareware!
  1776. @endnode
  1777. @node registrationform "Registration Form"
  1778. @prev registration
  1779. @next updates
  1780.      -------------------------
  1781.         Oliver Rummeyer
  1782.         Hochbergstrasse 49/1
  1783.         D-88213 Ravensburg
  1784.         Germany/Europe
  1785.      -------------------------
  1786.      Dear Oliver,
  1787.      I would like to become a registered user of "RO".
  1788.      Name:    _________________________________________________________
  1789.      Address: _________________________________________________________
  1790.               _________________________________________________________
  1791.               _________________________________________________________
  1792.      Country: __________________
  1793.      Phone:   __________________
  1794.      E-Mail:  _________________________________________________________
  1795.      I am sending the shareware fee via (please mark as appropriate)
  1796.            o   US$  20.- in bills, coming with this letter.
  1797.            o   DM   30.- in bills, coming with this letter.
  1798.            o   SFr  30.- in bills, coming with this letter.
  1799.            o   FFr 120.- in bills, coming with this letter.
  1800.            o   eurocheque in DM, coming with this letter.
  1801.            o   foreign cheque in US$, coming with this letter
  1802.                (including extra $10 for cashing).
  1803.            o   Bank transfer.
  1804.      Please send my personalized keyfile via (please mark as appropriate)
  1805.            o   e-mail (uuencode)
  1806.            o   regular mail (disk)
  1807.      I have read the license and distribution details and agree.
  1808.      _____________________  ___________________________________________
  1809.             (Date)                           (Signature)
  1810. @endnode
  1811. @node updates "Updates"
  1812. @prev registrationform
  1813. @next support
  1814.  @{b}@{u}Updates@{ub}@{uu}
  1815.  Whenever  a  new version of RO gets released, I will post some information
  1816.  in  the  appropriate  newsgroups  of  some  electronic  networks.  The new
  1817.  archive will soon be available on many bulletin boards and on all `aminet'
  1818.  FTP servers.
  1819.  The  RO Support Mailbox `Uplink BBS' Sysop Alexander Abt always offers the
  1820.  most recent release for Fido file request at these nodes:
  1821.   Node 1:  +49-0751-96217  2:246/2320 USR 33.6 DS
  1822.   Node 2:  +49-0751-793314 2:246/2321 USR 33.6 DS
  1823.   Node 3:  +49-0751-97376  2:246/2322 Zyx E+
  1824.   Node 4:  +49-0751-793314 2:246/2323 ISDN 16k
  1825.   Node 5:  +49-0751-793315 2:246/2324 ISDN 2k
  1826.  Use  the magic name `RO'.  Alternatively you can login with a user name of
  1827.  `RO' and a password of `RO'.
  1828.  As mentioned above, registered users will neither need a new keyfile nor a
  1829.  special  personalized  program  version.   They  can  use all new features
  1830.  immediately.
  1831. @endnode
  1832. @node support "Support"
  1833. @prev updates
  1834. @next acknowledgments
  1835.  @{b}@{u}Support@{ub}@{uu}
  1836.  If  you  have  suggestions, questions, critics or bugreports or you simply
  1837.  like my program, the write to:
  1838.  SMail: Oliver Rummeyer
  1839.         Hochbergstrasse 49/1
  1840.         D-88213 Ravensburg
  1841.         Germany/Europe
  1842.  Email:  oliver.rummeyer@student.uni-ulm.de
  1843.  Web:    http://www.uni-ulm.de/~s_orumme/
  1844. -----BEGIN PGP PUBLIC KEY BLOCK-----
  1845. Version: 2.6ui (Amiga)
  1846. mQBNAi9OUNkAAAECAMMunTdwFA+DX4SksnWNl0QqP4uAkrStXnHoVTb1Yaz59TMC
  1847. Nw/21MP0QOlG+4qIpIhZ6ayQFrkAeSWtkRG+r4EABRG0KU9saXZlciBSdW1tZXll
  1848. ciA8b2xpdmVyQHJ1bW9yLnJ2LnN1Yi5vcmc+
  1849. =iYz8
  1850. -----END PGP PUBLIC KEY BLOCK-----
  1851. @endnode
  1852. @node acknowledgments "Acknowledgments"
  1853. @prev support
  1854. @next history
  1855.  @{b}@{u}Acknowledgments@{ub}@{uu}
  1856.  The author wishes to thank his beta testers...
  1857.  - Alexander Abt
  1858.    ...for his 'Recog' filetype recognition.
  1859.  - Frank Schlichting
  1860.    ...for being my first beta tester, for his great suggestions
  1861.       and for reworking the documentation.
  1862.  - Juergen Schubert
  1863.    ...for his ingenious suggestions and for writing the installer
  1864.       script.
  1865.  ...and...
  1866.  - Jean-Francois Fabre
  1867.    ...for the french documentation and catalog file.
  1868. me Lovy
  1869.    ...for reworking the french catalog file and for enhancing
  1870.       the documentation.
  1871.  - Staffan Palmroos
  1872.    ...for the swedish documentation and catalog file.
  1873.  - Ignazzi Carmelo
  1874.    ...for the italian localization.
  1875.  - Teemu Valkeapaa
  1876.    ...for the finnish localization.
  1877.  ..and..
  1878.  - Rafael D'Halleweyn
  1879.    ...for his "ARCHandler".
  1880.  - Martin "XEN" Hutteloher
  1881.    ...for his MagicWB package and his permission to use some icons
  1882.       within this package.
  1883.  - Stefan Stuntz
  1884.    ...for his "Magic User Interface".
  1885.  ...and last but not least the registered users.
  1886. @endnode
  1887. @node history "History"
  1888. @prev acknowledgments
  1889. @next future
  1890.  @{b}@{u}History@{ub}@{uu}
  1891.  - Version 0.80 (26.8.94)
  1892.    Initial Release.
  1893.  - Version 0.81 (7.9.94)
  1894.    o Fixed some minor bugs.
  1895.    o Added a configuration switch to toggle path extension.
  1896.  - Version 0.82 (11.10.94)
  1897.    o Fixed some bugs.
  1898.    o Uses the CLI command path if started from Workbench.
  1899.    o Added some filetypes.
  1900.    o Added command line option @{" ICONIFY " link menus}.
  1901.    o Added config variable @{" FLUSHMEMORY " link variable}.
  1902.    o Removed config variable 'HELPFILE' use 'ENV:AmigaGuide/Path' instead.
  1903.    o Fully localized (german catalog included).
  1904.    o Command buttons support keyboard shortcuts.
  1905.    o Many other minor changes.
  1906.  - Version 0.83 (5.12.94)
  1907.    o Fixed some minor bugs.
  1908.    o Added some filetypes.
  1909.    o New internal Functions: @{" UPDATE " link Update} & @{" CURRENT " link Current}
  1910.    o German documentation included.
  1911.    o Catalog files changed.
  1912.    o Included italian catalog file.
  1913.    o Major code cleanup.
  1914.    o Other minor changes.
  1915.  - Version 0.90 (9.1.95)
  1916.    o requires MUI 2.3 or better.
  1917.    o Fixed all known bugs.
  1918.    o Added some filetypes.
  1919.    o Added config variables @{" FORMATLEFT " link variable} & @{" FORMATRIGHT " link variable}.
  1920.    o Added new config keyword @{" HOTKEY " link hotkey}.
  1921.    o Added config variable @{" COPYVERIFY " link variable}.
  1922.    o Added config variable 'SYMMETRICAL'.
  1923.    o Improved listview activation.
  1924.    o Changed command strings in configuration.
  1925.      Added many new '%' parameters.
  1926.    o Changed archive configuration.
  1927.    o Removed Functions 'COMMAND','EXECUTE' and 'REXX'.
  1928.    o Enhanced @{" arexx interface " link arexxinterface} supports all basic functions.
  1929.    o Catalog files changed.
  1930.    o Many other minor changes.
  1931.  - Version 0.91 (23.1.95)
  1932.    o Fixed some minor bugs.
  1933.    o Added new '&' parameters.
  1934.    o Changed archive default commands.
  1935.    o Changed overwrite & unprotect requester.
  1936.    o Included some arexx examples.
  1937.    o Catalog files changed.
  1938.    o Improved installer script.
  1939.    o Information window displays version string now.
  1940.  - Version 1.00 (20.3.95)
  1941.    o Fixed some bugs.
  1942.    o Catalog files changed.
  1943.    o Minor code cleanup.
  1944.    o Added user configurable filetypes.
  1945.    o Changed @{" filetype " link customtype} configuration.
  1946.    o Changed @{" archive " link archive} configuration.
  1947.    o Removed config variable ARCHANDLER.
  1948.    o Added new and improved old arexx scripts.
  1949.  - Version 1.01 (22.3.95)
  1950.    o Fixed some major bugs.
  1951.  - Version 1.02 (3.4.95)
  1952.    o Fixed some bugs.
  1953.    o Catalog files changed.
  1954.    o Improved german documentation.
  1955.    o New menu entry @{" Last Message " link menus}.
  1956.    o New menu entry @{" Update All " link menus}.
  1957.  - Version 1.03 (4.6.95)
  1958.    o Fixed some bugs.
  1959.    o Improved installation script.
  1960.    o Improved default handling for unknown filetypes.
  1961.    o Added config variable @{" CHECKDUPES " link variable}.
  1962.    o Added '%a' parameter to get arexx port name.
  1963.  - Version 1.04 (9.7.95)
  1964.    o Fixed some minor bugs.
  1965.    o Catalog files changed.
  1966.    o French documentation included.
  1967.    o Included french catalog file.
  1968.    o Other minor changes.
  1969.    o Added list cycle with middle mouse button.
  1970.    o Added button bank switching with middle mouse button.
  1971.    o New menu entry @{" Spawn New " link menus}.
  1972.  - Version 1.10 (16.10.95)
  1973.    o Included preference program.
  1974.    o Config now stored in 'ENV:RO/'
  1975.    o Fixed some minor bugs.
  1976.    o Catalog files changed.
  1977.    o Minor code cleanup.
  1978.    o Added config variable @{" FRAMES " link variable}.
  1979.    o Added config variable @{" MIDDLEMOUSE " link variable}.
  1980.    o Config supports '^' as esc character.
  1981.    o Other minor changes.
  1982.  - Version 1.20 (3.12.95)
  1983.    o requires MUI 3.1 or better.
  1984.    o Made some changes for MUI3+ compatibily.
  1985.    o Fixed some minor bugs.
  1986.    o Catalog files changed.
  1987.    o Removed some useless menu entries.
  1988.    o New menu entry @{" MUI... " link menus}.
  1989.    o New menu entry @{" RO... " link menus}.
  1990.    o Improved RO prefs handling.
  1991.    o Implemented resizeable @{" listviews " link listview}.
  1992.    o Implemented @{" drag&drop " link listview} mechanism.
  1993.  - Version 1.21 (5.2.96)
  1994.    o Requires MUI 3.2 or better.
  1995.    o Fixed some minor bugs.
  1996.    o Removed config variable FRAMES.
  1997.    o Improved installation script.
  1998.    o Other minor changes.
  1999.  - Version 1.22 (14.4.96)
  2000.    o Catalog files changed.
  2001.    o Made some changes for MUI3.3 compatibily.
  2002.    o Fixed some bugs.
  2003.    o Swedish documentation included.
  2004.    o Included swedish catalog file.
  2005.    o Removed config variable 'SYMMETRICAL'.
  2006.    o Changed @{" drag&drop " link listview} mechanism.
  2007.    o Changed command requester @{" Change " link Change}.
  2008.    o Added '&b' parameter to ignore returncodes.
  2009.    o Added '&d' parameter to not deselect entries.
  2010.    o Added arexx command @{" Change " link arexxinterface} to change sort order.
  2011.    o Added config variable @{" ORDERLEFT " link variable} and @{" ORDERRIGHT " link variable}.
  2012.    o Reload directories after preference change.
  2013.    o Other minor changes.
  2014.  - Version 1.23 (11.9.96)
  2015.    o Fixed some bugs.
  2016.    o Other minor changes.
  2017.    o Catalog files changed.
  2018.  - Version 1.24 (28.11.96)
  2019.    o Fixed some bugs.
  2020.    o Catalog files changed.
  2021.    o Added config variable @{" PAGES " link variable}.
  2022.    o User defined 'Buffers' are displayed bold.
  2023.    o User defined 'Buffers' are always displayed on top.
  2024.    o Added 'Bubble Help'.
  2025.    o Other minor changes.
  2026.  - Version 1.25 (20.2.97)
  2027.    o Requires MUI 3.6 or better.
  2028.    o Fixed a major bug.
  2029.    o Fixed some minor bugs.
  2030.    o Catalog files changed.
  2031.    o New internal Function @{" LFOLD " link LFold}.
  2032.    o Other minor changes.
  2033. @endnode
  2034. @node future "Future Enhancments"
  2035. @prev history
  2036. @next disclaimer
  2037.  @{b}@{u}Future Enhancments@{ub}@{uu}
  2038.  o Enhanced Drag & Drop mechanism.
  2039.  o Enhanced ARexx port.
  2040.  o Implement horizontal scroller for listviews.
  2041.  o Improve preference program.
  2042.  o Write documentation for preference program.
  2043.  o Many other minor things...
  2044. @endnode
  2045. @node disclaimer "Disclaimer"
  2046. @prev future
  2047. @next license
  2048.  @{b}@{u}Disclaimer@{ub}@{uu}
  2049.  THERE  IS  NO  WARRANTY  FOR  THE  PROGRAM,  TO  THE  EXTENT  PERMITTED BY
  2050.  APPLICABLE  LAW.   EXCEPT  WHEN  OTHERWISE STATED IN WRITING THE COPYRIGHT
  2051.  HOLDER  AND/OR  OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  2052.  OF  ANY  KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  2053.  THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  2054.  PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
  2055.  IS  WITH  YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  2056.  ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  2057.  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  2058.  ANY  COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  2059.  AS  PERMITTED  ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  2060.  SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL  DAMAGES ARISING OUT OF THE USE OR
  2061.  INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  2062.  DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  2063.  OR  A  FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
  2064.  SUCH  HOLDER  OR  OTHER  PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  2065.  DAMAGES.
  2066. @endnode
  2067. @node license "License"
  2068. @prev disclaimer
  2069. @next installer
  2070.  @{b}@{u}License@{ub}@{uu}
  2071.  - You may use RO for a period  of up to 14 days of evaluation.  After that
  2072.    you have to register.
  2073.  - You may copy and distribute verbatim copies of the program's executable
  2074.    code  and  documentation as you receive it, in any medium, provided that
  2075.    you   conspicuously   and   appropriately  publish  only  the  original,
  2076.    unmodified  program,  with  all  copyright  notices  and  disclaimers of
  2077.    warranty  intact  and  including  all  the  accompanying  documentation,
  2078.    example files and anything else that came with the original.
  2079.  - Except  when  otherwise  stated in  this documentation, you may not copy
  2080.    and/or  distribute  this  program without the accompanying documentation
  2081.    and  other  additional  files  that came with the original.  You may not
  2082.    copy and/or distribute modified versions of this program.
  2083.  - You may not copy, modify, sublicense, distribute or transfer the program
  2084.    except  as expressly provided under this license.  Any attempt otherwise
  2085.    to copy, modify, sublicense, distribute or transfer the program is void,
  2086.    and  will  automatically  terminate your rights to use the program under
  2087.    this  license.   However, parties who have received copies, or rights to
  2088.    use  copies,  from  you  under this license will not have their licenses
  2089.    terminated so long as such parties remain in full compliance.
  2090.  - By  copying,  distributing  and/or  using the  program you indicate your
  2091.    acceptance of this license to do so, and all its terms and conditions.
  2092.  - Each  time  you  redistribute  the  program, the recipient automatically
  2093.    receives a license from the original licensor to copy, distribute and/or
  2094.    use  the  program  subject  to  these terms and conditions.  You may not
  2095.    impose  any  further  restrictions  on  the  recipients' exercise of the
  2096.    rights granted herein.
  2097.  - You  may  not  disassemble,  decompile,  re-source  or otherwise reverse
  2098.    engineer the program.
  2099.  - You  agree  to  cease  distributing  the  program  and data involved if
  2100.    requested to do so by the author.
  2101. @endnode
  2102. @node installer "Installer"
  2103. @prev "license"
  2104. @next "magicuserinterface"
  2105.  @{b}@{u}Installer@{ub}@{uu}
  2106.    Along with RO comes the `Installer' from Commodore:
  2107.      Installer and Installer project icon
  2108.      (c) Copyright 1991-93 Commodore-Amiga, Inc.  All Rights Reserved.
  2109.      Reproduced and distributed under license from Commodore.
  2110.      
  2111.      INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE;
  2112.      NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY
  2113.      OR RESPONSIBILITY IS ASSUMED.
  2114. @endnode
  2115. @node magicuserinterface "Magic User Interface"
  2116. @prev installer
  2117.                           This application uses
  2118.                         MUI - MagicUserInterface
  2119.                 (c) Copyright 1993/94 by Stefan Stuntz
  2120. MUI is a system to generate and maintain graphical user interfaces. With
  2121. the  aid  of  a  preferences program, the user of an application has the
  2122. ability to customize the outfit according to his personal taste.
  2123. MUI is distributed as shareware. To obtain a complete package containing
  2124. lots of examples and more information about registration please look for
  2125. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  2126. your local bulletin boards or on public domain disks.
  2127.           If you want to register directly, feel free to send
  2128.                          DM 30.-  or  US$ 20.-
  2129.                                   to
  2130.                              Stefan Stuntz
  2131.                         Eduard-Spranger-Stra
  2132.                              80935 M
  2133. nchen
  2134.                                 GERMANY
  2135. @endnode
  2136. @index Index
  2137. @node Index
  2138.  @{"About" link About}
  2139.  @{"Acknowledgments" link acknowledgments}
  2140.  @{"Action" link Action}
  2141.  @{"All" link All}
  2142.  @{"APPWINDOW" link variable}
  2143.  @{"ARCHIVETYPE" link archive}
  2144.  @{"ARexx Interface" link arexxinterface}
  2145.  @{"Assign" link Assign}
  2146.  @{"BINARY" link filetype}
  2147.  @{"BUFFER" link buffer}
  2148.  @{"BUTTON" link button}
  2149.  @{"Buffers" link Buffers}
  2150.  @{"ByName" link ByName}
  2151.  @{"Bytes" link Bytes}
  2152.  @{"Change" link Change}
  2153.  @{"CHECKFIT" link variable}
  2154.  @{"Command Buttons" link commandbutton}
  2155.  @{"Configuration" link configuration}
  2156.  @{"Copy" link Copy}
  2157.  @{"CopyAs" link Copy}
  2158.  @{"COPYDATE" link variable}
  2159.  @{"CopyDev" link CopyDev}
  2160.  @{"COPYFLAGS" link variable}
  2161.  @{"COPYNOTE" link variable}
  2162.  @{"COPYVERIFY" link variable}
  2163.  @{"Current" link Current}
  2164.  @{"CUSTOMTYPE" link customtype}
  2165.  @{"DEFAULT" link filetype}
  2166.  @{"Delete" link Delete}
  2167.  @{"DELFORCE" link variable}
  2168.  @{"DELVERIFY" link variable}
  2169.  @{"Directory" link Directory}
  2170.  @{"Disclaimer" link disclaimer}
  2171.  @{"Discussion" link discussion}
  2172.  @{"Disk" link Disk}
  2173.  @{"Drive Buttons" link drivebutton}
  2174.  @{"DRIVE" link drive}
  2175.  @{"Dup" link Dup}
  2176.  @{"Expand" link Expand}
  2177.  @{"FILETYPE" link filetype}
  2178.  @{"FIRSTLEFT" link variable}
  2179.  @{"FIRSTRIGHT" link variable}
  2180.  @{"Fit" link Fit}
  2181.  @{"FLUSHMEMORY" link variable}
  2182.  @{"FORMATLEFT" link variable}
  2183.  @{"FORMATRIGHT" link variable}
  2184.  @{"Future" link future}
  2185.  @{"Help" link Help}
  2186.  @{"History" link history}
  2187.  @{"HOTDIR" link hotdir}
  2188.  @{"HOTKEY" link hotkey}
  2189.  @{"How to install RO" link installation}
  2190.  @{"How to register for RO" link registration}
  2191.  @{"Icon" link Icon}
  2192.  @{"ICONIFY" link menus}
  2193.  @{"Info" link Info}
  2194.  @{"Information Textfield" link dirinformation}
  2195.  @{"Installer" link installer}
  2196.  @{"LActive" link Active}
  2197.  @{"LCopy" link LCopy}
  2198.  @{"LFold" link LFold}
  2199.  @{"License" link license}
  2200.  @{"ListArc" link ListArc}
  2201.  @{"Listview" link listview}
  2202.  @{"LParent" link Parent}
  2203.  @{"LReload" link Reload}
  2204.  @{"LRoot" link Root}
  2205.  @{"LSwap" link LSwap}
  2206.  @{"Magic User Interface" link magicuserinterface}
  2207.  @{"Main Window" link mainwindow}
  2208.  @{"MakeDir" link MakeDir}
  2209.  @{"MDLoad" link MakeDir}
  2210.  @{"MENU" link menu}
  2211.  @{"Menus" link menus}
  2212.  @{"MIDDLEMOUSE" link variable}
  2213.  @{"Move" link Move}
  2214.  @{"MoveAs" link MoveAs}
  2215.  @{"None" link None}
  2216.  @{"Note" link Note}
  2217.  @{"OVERWRITE" link variable}
  2218.  @{"ORDERLEFT" link variable}
  2219.  @{"ORDERRIGHT" link variable}
  2220.  @{"Parent" link Parent}
  2221.  @{"Path Gadget" link pathgadget}
  2222.  @{"Protect" link Protect}
  2223.  @{"Quit" link Quit}
  2224.  @{"RActive" link Active}
  2225.  @{"Reboot" link Reboot}
  2226.  @{"Register" link registergroup}
  2227.  @{"Registration Form" link registrationform}
  2228.  @{"Relabel" link Relabel}
  2229.  @{"Reload" link Reload}
  2230.  @{"Rename" link Rename}
  2231.  @{"Root" link Root}
  2232.  @{"RParent" link Parent}
  2233.  @{"RReload" link Reload}
  2234.  @{"RRoot" link Root}
  2235.  @{"SetDate" link SetDate}
  2236.  @{"Short description" link introduction}
  2237.  @{"Shrink" link Shrink}
  2238.  @{"SORTLEFT" link variable}
  2239.  @{"SORTRIGHT" link variable}
  2240.  @{"Status Bar" link statusbar}
  2241.  @{"Support" link support}
  2242.  @{"System Requirements" link requirements}
  2243.  @{"Toggle" link Toggle}
  2244.  @{"Touch" link Touch}
  2245.  @{"UnArc" link UnArc}
  2246.  @{"Unregistered Version" link unregistered}
  2247.  @{"Update" link Update}
  2248.  @{"Updates" link updates}
  2249.  @{"VARIABLE" link variable}
  2250.  @{"Volumes" link Volumes}
  2251. @endnode
  2252.