@database dopus5
@master dopus5.guide
@$VER: Dopus5Guide 2.11 (3.6.97)
@author "Mark Anderson, Andrew Dunbar, Dr Greg Perry, and Leo Davidson"
@(c) "Directory Opus 5 Help Guide (c) GPSoftware 1997"
@index Index
@remark Created with Heddley v1.1 (c) Edd Dumbill 1994
@remark (Except the small additions made by Leo Davidson because he has
@remark an attitude of hatred and distrust towards all hypertext editing systems.)

@node "Main" "dopus5.guide"
Help Introduction for Directory Opus 5


This help system has been designed to allow you to quickly skip to items or
commands of interest.  It is not designed to replace the manual and has only
brief explanations of the Opus 5 functions.

The Opus 5 Visual Display Objects:
  Opus 5 can be run with a myriad of different configurations for almost
  every conceivable use.  However, the essential nature of the Opus 5
  display consists of a few simple component windows and objects -

  The Main Window:
    The parent window of the Opus 5 system.

  Listers:
    Independent Windows which display lists of files and directories.

  Button Banks:
    Windows which display custom action buttons showing text or graphic
    images.

  Configuration and Options:
    These requesters allow you to customise the visual display and
    procedural operations of Directory Opus 5.

For help on any lister gadget, button, or requester, simply press the help
key over the item of interest.  For help on a menu item you must highlight
that item and then press the help key before selecting it.

See the @{" Index " link "Index"} or the list of Opus 5 @{" Commands " link "Commands"} for more details.
@endnode

@node "Index" "Index"
                               INDEX

  @{" AddIcon                      " link "AddIcon"}  @{" Alarm                        " link "Alarm"}
  @{" All                          " link "All"}  @{" AnsiRead                     " link "AnsiRead"}
  @{" AppMenuItem                  " link "AppMenuItem"}  @{" Assign                       " link "Assign"}
  @{" Beep                         " link "Beep"}  @{" Buttons, Close               " link "Buttons - Close"}
  @{" Buttons, Edit                " link "Buttons - Edit"}  @{" Buttons, Iconify             " link "Buttons - Iconify"}
  @{" Buttons, New Gfx Buttons     " link "Buttons - New Gfx Buttons"}  @{" Buttons, New Start Menu      " link "Buttons - New Start Menu"}
  @{" Buttons, New Text Buttons    " link "Buttons - New Text Buttons"}  @{" Buttons, Open Start Menu     " link "Buttons - Open Start Menu"}
  @{" Buttons, Open                " link "Buttons - Open"}  @{" Buttons, Save As             " link "Buttons - Save As"}
  @{" Buttons, Save                " link "Buttons - Save"}  @{" Button Bank Editor           " link "Button Bank Editor"}
  @{" Button Editor                " link "Button Editor"}  @{" Button                       " link "Button"}
  @{" CacheList                    " link "CacheList"}  @{" CheckFit                     " link "CheckFit"}
  @{" CleanUp                      " link "CleanUp"}  @{" CLI                          " link "CLI"}
  @{" CloseButtons                 " link "CloseButtons"}  @{" Comment                      " link "Comment"}
  @{" Configuration Conversion     " link "Config Convert"}  @{" Configure                    " link "Configure"}
  @{" Confirm                      " link "Confirm"}  @{" CopyAs                       " link "CopyAs"}
  @{" Copy                         " link "Copy"}  @{" CreateFiletype               " link "CreateFiletype"}
  @{" DateStamp                    " link "DateStamp"}  @{" Delete                       " link "Delete"}
  @{" Desktop, Cancel              " link "Desktop - Cancel"}  @{" Desktop, Copy                " link "Desktop - Copy"}
  @{" Desktop, Left-Out            " link "Desktop - Left-Out"}  @{" Desktop, Move                " link "Desktop - Move"}
  @{" Destination                  " link "Destination"}  @{" DeviceList                   " link "DeviceList"}
  @{" Diskcopy Requester           " link "Diskcopy Requester"}  @{" Diskcopy                     " link "Diskcopy"}
  @{" DiskInfo                     " link "DiskInfo"}  @{" DoubleClick                  " link "DoubleClick"}
  @{" DragNDrop                    " link "DragNDrop"}  @{" Duplicate                    " link "Duplicate"}
  @{" Encrypt                      " link "Encrypt"}  @{" Environment, Backgrounds     " link "Environment - Backgrounds"}
  @{" Environment, CLI Launching   " link "Environment - CLI Launching"}  @{" Environment, Desktop         " link "Environment - Desktop"}
  @{" Environment, Display Mode    " link "Environment - Display Mode"}  @{" Environment, Edit            " link "Environment - Edit"}
  @{" Environment, Icon Display    " link "Environment - Icon Display"}  @{" Environment, Icon Settings   " link "Environment - Icon Settings"}
  @{" Environment, Lister Colours  " link "Environment - Lister Colours"}  @{" Environment, Lister Default  " link "Environment - Lister Default"}
  @{" Environment, Lister Display  " link "Environment - Lister Display"}  @{" Environment, Lister Options  " link "Environment - Lister Options"}
  @{" Environment, Open            " link "Environment - Open"}  @{" Environment, Palette         " link "Environment - Palette"}
  @{" Environment, Save As         " link "Environment - Save As"}  @{" Environment, Save Layout     " link "Environment - Save Layout"}
  @{" Environment, Save            " link "Environment - Save"}  @{" Environment, WB Emulation    " link "Environment - WB Emulation"}
  @{" Environment                  " link "Environment"}  @{" Filetype Creator             " link "Filetype Creator"}
  @{" Filetype Finder              " link "Filetype Finder"}  @{" File Class Editor            " link "File Class Editor"}
  @{" File Types                   " link "File Types"}  @{" File Type Editor             " link "File Type Editor"}
  @{" FindFiletype                 " link "FindFiletype"}  @{" FindFile                     " link "FindFile"}
  @{" FinishSection                " link "FinishSection"}  @{" Flash                        " link "Flash"}
  @{" Format Requester             " link "Format Requester"}  @{" Format                       " link "Format"}
  @{" FreeCaches                   " link "FreeCaches"}  @{" FTPAddressbook               " link "FTPAddressbook"}
  @{" FTPCD                        " link "FTPCD"}  @{" FTPCommand                   " link "FTPCommand"}
  @{" FTPConnect                   " link "FTPConnect"}  @{" FTPCopy                      " link "FTPCopy"}
  @{" FTPDelete                    " link "FTPDelete"}  @{" FTPQuit                      " link "FTPQuit"}
  @{" FTPRename                    " link "FTPRename"}  @{" FTPSetVar                    " link "FTPSetVar"}
  @{" Function Editor              " link "Function Editor"}  @{" GetSizes                     " link "GetSizes"}
  @{" HexRead                      " link "HexRead"}  @{" Hotkey Editor                " link "Hotkey editor"}
  @{" IconInfo                     " link "IconInfo"}  @{" Icons, Arrange Icons         " link "Icons - Arrange Icons"}
  @{" Icons, Cleanup               " link "Icons - CleanUp"}  @{" Icons, Close                 " link "Icon Popup - Close"}
  @{" Icons, Copy                  " link "Icons - Copy"}  @{" Icons, Delete                " link "Icons - Delete"}
  @{" Icons, Disk Information      " link "Icons - Disk Information"}  @{" Icons, Edit Command          " link "Icons - Edit Command"}
  @{" Icons, Format                " link "Icons - Format"}  @{" Icons, Information           " link "Icons - Information"}
  @{" Icons, Leave Out             " link "Icons - Leave Out"}  @{" Icons, New Command           " link "Icons - New Command"}
  @{" Icons, New Drawer            " link "Icons - New Drawer"}  @{" Icons, New Group             " link "Icons - New Group"}
  @{" Icons, Open In New Lister    " link "Icon Popup - Open In New Lister"}  @{" Icons, Open With             " link "Icon Popup - Open With"}
  @{" Icons, Open                  " link "Icons - Open"}  @{" Icons, Put Away              " link "Icons - Put Away"}
  @{" Icons, Rename                " link "Icons - Rename"}  @{" Icons, Reset                 " link "Icons - Reset"}
  @{" Icons, Select All            " link "Icons - Select All"}  @{" Icons, Snapshot              " link "Icons - Snapshot"}
  @{" Icons, UnSnapshot            " link "Icons - UnSnapshot"}  @{" Icon Popup, Custom           " link "Icon Popup - Custom"}
  @{" Join                         " link "Join"}  @{" LeaveOut                     " link "LeaveOut"}
  @{" Lister, Close All            " link "Lister - Close All"}  @{" Lister, Close                " link "Lister - Close"}
  @{" Lister, Edit Menu            " link "Lister - Edit Menu"}  @{" Lister, Edit ToolBar         " link "Lister - Edit Toolbar"}
  @{" Lister, Edit                 " link "Lister - Edit"}  @{" Lister, File Count           " link "Lister File Count"}
  @{" Lister, Format               " link "Lister Format"}  @{" Lister, Iconify              " link "Lister - Iconify"}
  @{" Lister, Lock Dest            " link "Lister - Lock Dest"}  @{" Lister, Lock Position        " link "Lister - Lock Position"}
  @{" Lister, Lock Source          " link "Lister - Lock Source"}  @{" Lister, Make Dest            " link "Lister - Make Dest"}
  @{" Lister, Make Source          " link "Lister - Make Source"}  @{" Lister, Menu Popup           " link "Lister Menu PopUp"}
  @{" Lister, Menu                 " link "ListerMenu"}  @{" Lister, New                  " link "Lister - New"}
  @{" Lister, Off                  " link "Lister - Off"}  @{" Lister, Open Parent          " link "Lister - Open Parent"}
  @{" Lister, Path Popup           " link "Lister Path PopUp"}  @{" Lister, Snapshot             " link "Lister - Snapshot"}
  @{" Lister, Status Popup         " link "Lister Status PopUp"}  @{" Lister, Tile                 " link "Lister - Tile"}
  @{" Lister, Unlock All           " link "Lister - Unlock All"}  @{" Lister, Unlock               " link "Lister - Unlock"}
  @{" Lister, UnSnapshot           " link "Lister - UnSnapshot"}  @{" Lister, View As              " link "Lister - View As"}
  @{" Lister                       " link "Lister"}  @{" LoadButtons                  " link "LoadButtons"}
  @{" LoadEnvironment              " link "LoadEnvironment"}  @{" LoadOptions                  " link "LoadOptions"}
  @{" MakeDir                      " link "MakeDir"}  @{" MakeLinkAs                   " link "MakeLinkAs"}
  @{" MakeLink                     " link "MakeLink"}  @{" Menu Editor                  " link "Menu Editor"}
  @{" MoveAs                       " link "MoveAs"}  @{" Move                         " link "Move"}
  @{" None                         " link "None"}  @{" Options, Caching             " link "Options - Caching"}
  @{" Options, Copy                " link "Options - Copy"}  @{" Options, Delete              " link "Options - Delete"}
  @{" Options, Edit                " link "Options - Edit"}  @{" Options, Hide Method         " link "Options - Hide Method"}
  @{" Options, Icons               " link "Options - Icons"}  @{" Options, Locale              " link "Options - Locale"}
  @{" Options, Miscellaneous       " link "Options - Miscellaneous"}  @{" Options, Priority            " link "Options - Priority"}
  @{" Options, Replace             " link "Options - Replace"}  @{" Options                      " link "Options"}
  @{" Opus, About                  " link "Project - About"}  @{" Opus, Backdrop               " link "Project - Backdrop"}
  @{" Opus, Execute Command        " link "Project - Execute Command"}  @{" Opus, Hide                   " link "Project - Hide"}
  @{" Opus, Quit                   " link "Project - Quit"}  @{" Parent                       " link "Parent"}
  @{" PathHistory                  " link "PathHistory"}  @{" Play                         " link "Play"}
  @{" PrintDir                     " link "PrintDir"}  @{" Print Requester              " link "Print Requester"}
  @{" Print                        " link "Print"}  @{" Program Group                " link "Program Group"}
  @{" Protection Bits              " link "Protectionbits"}  @{" Protect                      " link "Protect"}
  @{" Quit                         " link "Quit"}  @{" Read                         " link "Read"}
  @{" Recursive Filter             " link "Settings - Filter"}  @{" Rename                       " link "Rename"}
  @{" ReReadDir                    " link "ReReadDir"}  @{" Reselect                     " link "Reselect"}
  @{" Reveal                       " link "Reveal"}  @{" Root                         " link "Root"}
  @{" Run                          " link "Run"}  @{" ScanDir                      " link "ScanDir"}
  @{" Scripts Editor               " link "Scripts Editor"}  @{" Search                       " link "Search"}
  @{" Select Colours               " link "Select Colours"}  @{" Select                       " link "Select"}
  @{" SetAsBackground              " link "SetAsBackground"}  @{" Settings, Clock              " link "Settings - Clock"}
  @{" Settings, Create Icons       " link "Settings - Create Icons"}  @{" Settings, Default PubScreen  " link "Settings - Default PubScreen"}
  @{" Settings, Filetypes          " link "Settings - Filetypes"}  @{" Settings, Filter             " link "Settings - Filter"}
  @{" Settings, Hotkeys            " link "Settings - Hotkeys"}  @{" Settings, Icon Positioning   " link "Settings - Icon Positioning"}
  @{" Settings, Scripts            " link "Settings - Scripts"}  @{" Settings, User Menu          " link "Settings - User Menu"}
  @{" Set                          " link "Set"}  @{" SmartRead                    " link "SmartRead"}
  @{" Source                       " link "Source"}  @{" Split                        " link "Split"}
  @{" Toggle                       " link "Toggle"}  @{" ToolBar Arrow                " link "Toolbar Arrow"}
  @{" ToolBar Button               " link "ToolbarButton"}  @{" User1                        " link "User1"}
  @{" User2                        " link "User2"}  @{" User3                        " link "User3"}
  @{" User4                        " link "User4"}  @{" UserMenu                     " link "UserMenu"}
  @{" User                         " link "User"}

@endnode

@node "Commands" "Commands"
Commands

Opus 5 supports the following internal commands:

@{" AddIcon         " link "AddIcon"} @{" Alarm           " link "Alarm"} @{" All             " link "All"} @{" AnsiRead        " link "AnsiRead"}
@{" Assign          " link "Assign"} @{" Beep            " link "Beep"} @{" CacheList       " link "CacheList"} @{" CheckFit        " link "CheckFit"}
@{" CleanUp         " link "CleanUp"} @{" CLI             " link "CLI"} @{" CloseButtons    " link "CloseButtons"} @{" Comment         " link "Comment"}
@{" Configure       " link "Configure"} @{" Confirm         " link "Confirm"} @{" CopyAs          " link "CopyAs"} @{" Copy            " link "Copy"}
@{" CreateFiletype  " link "CreateFiletype"} @{" DateStamp       " link "DateStamp"} @{" Delete          " link "Delete"} @{" DeviceList      " link "DeviceList"}
@{" DiskCopy        " link "DiskCopy"} @{" DiskInfo        " link "DiskInfo"} @{" DoubleClick     " link "DoubleClick"} @{" DragNDrop       " link "DragNDrop"}
@{" Duplicate       " link "Duplicate"} @{" Encrypt         " link "Encrypt"} @{" FindFiletype    " link "FindFiletype"} @{" FindFile        " link "FindFile"}
@{" FinishSection   " link "FinishSection"} @{" Flash           " link "Flash"} @{" Format          " link "Format"} @{" FreeCaches      " link "FreeCaches"}
@{" FTPAddressbook  " link "FTPAddressbook"} @{" FTPCD           " link "FTPCD"} @{" FTPCommand      " link "FTPCommand"} @{" FTPConnect      " link "FTPConnect"}
@{" FTPCopy         " link "FTPCopy"} @{" FTPDelete       " link "FTPDelete"} @{" FTPQuit         " link "FTPQuit"} @{" FTPRename       " link "FTPRename"}
@{" FTPSetVar       " link "FTPSetVar"} @{" GetSizes        " link "GetSizes"} @{" HexRead         " link "HexRead"} @{" Hide            " link "Hide"}
@{" IconInfo        " link "IconInfo"} @{" Join            " link "Join"} @{" LeaveOut        " link "LeaveOut"} @{" LoadButtons     " link "LoadButtons"}
@{" LoadEnvironment " link "LoadEnvironment"} @{" LoadOptions     " link "LoadOptions"} @{" MakeDir         " link "MakeDir"} @{" MakeLinkAs      " link "MakeLinkAs"}
@{" MakeLink        " link "MakeLink"} @{" MoveAs          " link "MoveAs"} @{" Move            " link "Move"} @{" None            " link "None"}
@{" Parent          " link "Parent"} @{" Play            " link "Play"} @{" PrintDir        " link "PrintDir"} @{" Print           " link "Print"}
@{" Protect         " link "Protect"} @{" Quit            " link "Quit"} @{" Read            " link "Read"} @{" Rename          " link "Rename"}
@{" ReReadDir       " link "ReReadDir"} @{" ReSelect        " link "ReSelect"} @{" Reveal          " link "Reveal"} @{" Root            " link "Root"}
@{" Run             " link "Run"} @{" ScanDir         " link "ScanDir"} @{" Search          " link "Search"} @{" Select          " link "Select"}
@{" SetAsBackground " link "SetAsBackground"} @{" Set             " link "Set"} @{" Show            " link "Show"} @{" SmartRead       " link "SmartRead"}
@{" Split           " link "Split"} @{" Toggle          " link "Toggle"} @{" User1           " link "User1"} @{" User2           " link "User2"}
@{" User3           " link "User3"} @{" User4           " link "User4"} @{" User            " link "User"}

@endnode

@node "AddIcon" "AddIcon"
AddIcon              NAME, BORDER/S, NOBORDER/S, LABEL/S, NOLABEL/S,
CHANGE/S

AddIcon allows you to add icons to all selected entries in the active
directory window.  Directory Opus will automatically sense what type of file
it is and add the appropriate icon (drawer, tool or project).  The system
Default icons are used unless you have specified the name of your own icons
within the @{" Configuration " link "Options - Icons"}.


  BORDER/NOBORDER lets you turn the icon border on or off
  LABEL/NOLABEL allows you to turn the label on or off
  If CHANGE is specified, it allows you to change the border/label
  state of existing icons (no new icons will be created).

This command operates on all files selected in all current @{" SRCE " link "Source"} listers.
@endnode

@node "Alarm" "Alarm"
Alarm

This command will produce an alarm sound on both or either of the sound
channels.  You could use this command to signify that a command or script
has finished.

See also @{" Beep " link "Beep"}, and @{" Flash " link "Flash"}.
@endnode

@node "All" "All"
All

The All button selects all entries in any and all of the current @{" SRCE " link "Source"}
directory windows.

See also @{" None " link "None"}, @{" Select " link "Select"}, @{" Reselect " link "Reselect"}, and @{" Toggle " link "Toggle"}.
@endnode

@node "AnsiRead" "AnsiRead"
AnsiRead             NAME/F, WAIT/S

The AnsiRead command brings up the same file reader as @{" Read " link "Read"} except that it
handles the special ANSI control sequences.

Giving the "WAIT" switch will ensure that any later commands will not
execute until the reader has closed.

See also @{" HexRead " link "HexRead"}, @{" Read " link "Read"}, and @{" SmartRead " link "SmartRead"}.
@endnode

@node "Assign" "Assign"
Assign

Use this command to add an assign to the current directory.
@endnode

@node "Beep" "Beep"
Beep

This command will sound a beep on both or either of the sound channels.  You
could use this command to signify that a command has finished.

See also @{" Alarm " link "Alarm"}, and @{" Flash " link "Flash"}.
@endnode

@node "CacheList" "CacheList"
CacheList              NEW/S

This command displays a list of all the currently buffered directories.  You
may then click on one of the displayed buffers to jump to that buffer
immediately, rather than clicking the arrows to cycle through the buffers
one by one.

If there is no current @{" SRCE " link "Source"} lister, the command will open a new lister. If
the "NEW" switch is specified, a new lister will always be opened.
@endnode

@node "CleanUp" "CleanUp"
CleanUp

This command will search your position-info file and remove any directories
or left-outs that no longer exist.  It will only do this if the volume they
are on is available (this will stop it from removing entries for removable
media).
@endnode

@node "ClearSizes" "ClearSizes"
ClearSizes

The ClearSizes command has been made private, so it won't show up on
function lists, but it still works for compatibility.  You can now use the
FORCE option of the @{" GetSizes " link "GetSizes"} command in place of this command.

The ClearSizes command will clear the sizes for selected directories in all
@{" SRCE " link "Source"} listers, but not for selected files.  This will make it possible for
another @{" GetSizes " link "GetSizes"} to re-scan the selected directory.
@endnode

@node "CheckFit" "CheckFit"
CheckFit

The CheckFit command tests whether the selected files will fit on the
destination drive.  The command displays a requester which will display the
number of bytes needed, the available space, and the percentage of the file
which will fit on the destination drive.

CheckFit works between ALL @{" SRCE " link "Source"} directories to the first @{" DEST " link "Destination"} directory
ONLY.
@endnode

@node "CLI" "CLI"
CLI

The CLI command opens a new internal Opus 5 Command Line Interface.

The internal CLI recognizes all Opus built-in commands, and all Opus ARexx
commands too. ARexx commands must be preceeded by a + symbol.

Try entering 'help' in the CLI for more information.
@endnode

@node "CloseButtons" "CloseButtons"
CloseButtons          NAME/F, ALL/S

This command is used to close one or all button banks.

  CloseButtons        - closes the button bank that the function was
                        launched from.
  CloseButtons <name> - closes a named bank.
  CloseButtons all    - closes all button banks.
@endnode

@node "Comment" "Comment"
Comment                NAME, COMMENT, RECURSE/K

The Comment command allows you to add comments to all selected entries, or
to edit existing comments.  The maximum length of a comment is 79
characters.  If any directories are selected to comment, the
@{" Recursive Filter " link "Settings - Filter"} will be used to determine which files will be commented.
@endnode

@node "Configure" "Configure"
Configure

This command brings up the @{" List Format Editor " link "Lister Format"} for the current @{" SRCE " link "Source"}
lister which allows you to change the format of the lister's display.
@endnode

@node "Confirm" "Confirm"
Confirm                TEXT/F

The confirm command calls a requester for the user to either confirm or not
confirm the continuation of the present action.  This command allows the
implementation of a safety net, as would be associated with a delete
command.
@endnode

@node "Copy" "Copy"
Copy                  NAME, TO, QUIET/S, UPDATE/S, MOVEWHENSAME/S

The Copy button copies the selected file from the @{" SRCE " link "Source"} directory to the
@{" DEST " link "Destination"} directory.

If any directories are selected to copy, the global setting of the
@{" Recursive Filter " link "Settings - Filter"} will be used to determine which files will be copied.


If multiple @{" SRCE " link "Source"} or multiple @{" DEST " link "Destination"} directories are selected, the copy
command will copy all selected items from the @{" SRCE " link "Source"} directories to all the
@{" DEST " link "Destination"} directories in turn.

The QUIET option suppresses warning requesters but not error requesters.

The UPDATE option tells Opus to copy the file only if a file of the same
name is also in the destination.

The MOVEWHENSAME switch, when specified, changes the Copy function into
the @{" Move " LINK "Move"} function when the source and destination paths are both on the
same disk. This emulates the behaviour when dragging and dropping icons;
within the same disk, the files are moved, when dropped on a different
disk the files are copied.
@endnode

@node "CopyAs" "CopyAs"
CopyAs                NAME, NEWNAME, TO, QUIET/S, MOVEWHENSAME/S

The CopyAs function is similar to @{" Copy " link "Copy"} except that the entries are copied
to the @{" DEST " link "Destination"} directory using new names that you specify.  Wild cards can be
used with the naming.

If any directories are selected to copy, the @{" Recursive Filter " link "Settings - Filter"} will be used
to determine which files will be copied.

If multiple @{" SRCE " link "Source"} or multiple @{" DEST " link "Destination"} directories are selected, the copy
command will copy all selected items from the @{" SRCE " link "Source"} directories to all the
@{" DEST " link "Destination"} directories in turn.

The QUIET option suppresses warning requesters but not error requesters.

The MOVEWHENSAME switch, when specified, changes the CopyAs function into
the @{" MoveAs " LINK "MoveAs"} function when the source and destination paths are both on
the same disk. This emulates the behaviour when dragging and dropping
icons; within the same disk, the files are moved, when dropped on a
different disk the files are copied.
@endnode

@node "CreateFiletype" "CreateFiletype"
CreateFiletype

This command invokes the @{" Filetype Creator " link "Filetype Creator"} requester which can be very
useful for automatically making filetypes for files if you do not know much
about file formats.
@endnode

@node "DateStamp" "DateStamp"
DateStamp             NAME, RECURSE/S, DATE/F

The DateStamp command allows you to change the datestamp of the selected
files and directories in the active directory window.  When you select
directories, you are asked whether you wish the files within them to have
their datestamps modified too.

If any directories are selected for datestamp, the @{" Recursive Filter " link "Settings - Filter"} will
be used to determine which files will be datestamped.

For each entry, you are presented with a requester.  If you wish the file to
have its datestamp set to the current date and time, simply press return.
Otherwise, enter the date and time you want.  To set the datestamp of all
selected entries you should select the All button from the datestamp
requester.

Choose 'Ok' or press return to set the datestamp one file at a time.
@endnode

@node "Delete" "Delete"
Delete                NAME, QUIET/S

Delete will delete all selected entries in ALL current @{" SRCE " link "Source"} directory
windows.

Be careful with this, as it is easy to wipe out valuable data if you are
careless.  Directory Opus' default @{" Configuration " link "Options - Delete"} brings up a requester
before deleting.  Nevertheless, you should always double check the selected
files before clicking this button.

The Delete command works on ALL @{" SRCE " link "Source"} listers in turn.

The QUIET option suppresses warning requesters but not error requesters.
@endnode

@node "DeviceList" "DeviceList"
DeviceList            NEW/S, FULL/S, BRIEF/S

This command displays a list of all devices, volumes and assigned
directories present in the system in the current @{" SRCE " link "Source"} lister.  You may
then read in these devices by clicking on them.

If there is no current SRCE lister, the command will open a new lister.

If the NEW switch is used, a new lister will always be opened.

If the FULL switch is used, the display will expand the Assign list to show
the full path of the normal and multi-directory assigns.

If the BRIEF switch is used, only devices and volumes will be listed,
assigns will not.

By dropping a drawer icon onto the device list in icon mode you can make an
assignment to that icon's path using the @{" Assign " link "Assign"} command.
@endnode

@node "Diskcopy" "Diskcopy"
Diskcopy

This command will bring up the Opus @{" Diskcopy Requester " link "Diskcopy Requester"} allowing you to
select the source and destination drives and parameters for copying disks.
@endnode

@node "DiskInfo" "DiskInfo"
DiskInfo

DiskInfo displays some information about the disk the active directory
resides on, including space used and free, datestamp and number of errors on
the disk.
@endnode

@node "DoubleClick" "DoubleClick"
DoubleClick           ALT/S, CTRL=CONTROL/S, NAME/F

This command executes the defined action for DoubleClick as defined by the
user for files of the selected type.  In other words, it performs the same
action as if you, for example, double-clicked on a file.

You can use the ALT and CONTROL switches to have Opus execute the action
as if the alt/control keys were held down.
@endnode

@node "DragNDrop" "DragNDrop"
DragNDrop             ALT/S, CTRL=CONTROL/S, SHIFT/S, NAME/F

This command executes the defined action for DragNDrop as defined by the
user for files of the selected type.

You can use the ALT, CONTROL, and SHIFT switches to have Opus execute the
action as if the alt/control/shift keys were held down.
@endnode

@node "Duplicate" "Duplicate"
Duplicate             NAME, NEWNAME, QUIET/S

Duplicate allows you to make a copy of selected entries in the same
directory, but with different names.  A requester will appear for each
entry, asking for the new name.

The Duplicate command works on ALL @{" SRCE " link "Source"} listers.

The QUIET option suppresses warning requesters but not error requesters.
@endnode

@node "Encrypt" "Encrypt"
Encrypt               NAME, TO, PASSWORD, QUIET/S

This function will encrypt all selected files, using the password that you
enter.  The resulting files are not written over the originals, but are
instead written to the destination directory.  They will be the same size as
the original files, so you can ensure you have @{" Enough Room " link "ClearSizes"} in the
@{" Destination " link "Destination"} directory.

To decrypt a previously encrypted file, first enable the checkbox marked
'Decrypt files' in the Encrypt requester.  It is also possible to enter the
same password preceded by a minus sign.  For example, to decrypt files you
encrypted with the password 'FOO', select the fields, choose the encrypt
function and enter '-FOO' as the password.

This command operates on all files selected in all current @{" SRCE " link "Source"} listers.

If the QUIET option is specified, no warning requesters will be displayed
(error requesters still will though)
@endnode

@node "FindFile" "FindFile"
FindFile

The FindFile command will search all selected subdirectories in all @{" SRCE " link "Source"}
listers for a specified file or files.  A requester will appear asking for
the pattern for which to @{" Search " link "Search"}.  You can use full pattern matching for
this search.

If a file matching the pattern is found, you are asked if you wish to enter
the directory containing it, or to continue the search.  If you elect to
enter the directory, the directory will be read and then all matching
entries will be highlighted.

You can also select entire devices to search, using the @{" DEVICE LIST " link "DeviceList"}
feature.
@endnode

@node "FindFiletype" "FindFiletype"
FindFiletype

This command invokes the @{" Filetype Finder " link "Filetype Finder"} requester which can be used in
finding, installing, and creating filetypes for the selected files.
@endnode

@node "FinishSection" "FinishSection"
FinishSection

The FinishSection command forces any preceding programs (AmigaDOS,
Workbench, Batch or ARexx) to finish executing before carrying on to the
next command.
@endnode

@node "Flash" "Flash"
Flash

This command will cause the screen to flash briefly.  If you have your sound
preferences set to produce a beep or play a sound sample then this will also
occur.

You could use this command to signify that a command has finished.

See also @{" Alarm " link "Alarm"}, and @{" Beep " link "Beep"}.
@endnode

@node "Format" "Format"
Format                DRIVE/F

This allows you to format a new disk.  Without arguments, the command will
display the Opus @{" Format Requester " link "Format Requester"} allowing you to choose the disk to
format and other parameters.
@endnode

@node "FreeCaches" "FreeCaches"
FreeCaches

This command will clear the contents of all the directory buffers other than
any that are currently displayed.  All unused memory will be deallocated.
This is a good way to free memory quickly if you have lots of used buffers
and are running a bit low on memory.
@endnode

@node "FTPAddressBook" "FTPAddressBook"
FTPAddressBook

This command causes the FTP addressbook requester to be shown.

The requester is a listview of all the FTP sites in your
DOpus5:System/ftp.config.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.

Double click on an entry to connect or highlight the entry and select Edit
or Delete. Select New to add new entries.

Select Options to show the configuration sections:-

  Anon Pass:
    You may choose a specific password to be used for anonymous
    connections. This should usually be your email address.

  Log File:
    This is the file where log messages go. Most people will want a
    console file so that they can see log messages on screen.
    e.g. CON:////OpusFTP Log/Auto/Close

  Log:
    Turns the log display on or off to display messages from the remote
    site.

  Debug:
    Enables verbose log display.

  Update:
    Defines the delay between updating display of entries in a directory
    list. A higher value updates the display less often resulting in
    faster overall performance.

  Timeout:
    The timeout for FTP commands. (The default value is 60 seconds.)

  NOOP:
    This provides an idle timer mechanism to keep remote sites active. It
    sends the FTP command NOOP approximately every 30 seconds to prevent
    the remote site's inactivity timer from being triggered. By default
    this should be turned off. Do not activate this unnecessarily.

    @{b}Keeping your connection alive when you are not actually using it often
    prevents other users from accessing the site. Some ISPs frown on such
    behaviour.@{ub}

  Index, Auto & Max Size:
    Many sites, especially Aminet, add a special index or comment file to
    each directory. This provides a short comment with extra information
    on each file. With Index turned on, the FTP module will check for the
    presence of files called 'INDEX' or 'Files.BBS' when scanning a new
    remote directory. If found, the index file will be automatically
    downloaded and the comments added to the file's Comment field.
    Generally these index files are small, less than 30Kb.

    If the Auto switch is off, files smaller than the Max Size value will
    be automatically downloaded. If the size of the index file exceeds
    this value, a requester will be presented asking if you wish to
    download the index.

    With Auto turned on, only files smaller than the Max Size will be
    downloaded. If the index file is larger than this value it will be
    ignored.

    Note:  Most of the index files on AmiNet sites are in a defined
    standard format. However this cannot be guaranteed and some files may
    display truncated comments.

The FTP module offers many extras such as site-to-site FTP and instant FTP
access by typing paths starting with "FTP://" into listers. See your
manual for further information.

@endnode

@node "FTPCD" "FTPCD"
FTPCD                 DIR/F

This command allows you to change directories on the current FTP site.

The main use of this command is on FTP sites that do not list all files and
directories.  Such 'private' directories may still be entered even though
they are invisible by entering the path in the requester provided.  The same
effect can be achieved by entering the path in the path string gadget at the
bottom of the lister.

Note: It is necessary to enter the full path of a the directory as Opus does
not know the filesystem structure of every type of machine that is
accessible via FTP.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPCommand" "FTPCommand"
FTPCommand            COMMAND/F

This command allows you to enter any FTP command literally.

The usefulness of this command is very limited.  Some commands which may be
interesting are 'STAT', and 'HELP'.  Also some FTP sites provide extended
commands which may be useful.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPConnect" "FTPConnect"
FTPConnect            HOST, USER, PASSWORD=PASS, DIR/K

For FTP sites which are not in your DOpus5:System/ftp.config file, use
this command to connect to them.

If you do not provide the host, user, or password, you will be prompted for
them if they are required.  However, if you wish to specify the initial
directory for your FTP session you must specify this in your command as no
requester is provided for this.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPCopy" "FTPCopy"
FTPCopy

This command provides a way to retrieve 'private' or 'hidden' files from an
FTP site.

If you know a file is on the FTP site but it does not show up in the lister,
you can enter the exact filename in the requester that the FTPCopy command
provides.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPDelete" "FTPDelete"
FTPDelete             FILE/F

If you need to delete 'private' or 'hidden' files or directories from an FTP
site, this command provides a way to do it.

You must be sure to enter the exact name of the file you wish to delete.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPQuit" "FTPQuit"
FTPQuit               FORCE/S

The FTPQuit command causes all current FTP connections to be closed.

If any FTP listers are currently busy transfering files, the transfers will
not be aborted unless the FORCE switch is specified.  No new FTP connections
will be allowed.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPRename" "FTPRename"
FTPRename

This command provides a way for you to rename 'hidden' or 'invisible' FTP
files and directories.

Simply enter the exact name of the hidden file in the first requester, then
enter the new name you wish that entry to have in the second requester.

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "FTPSetVar" "FTPSetVar"
FTPSetVar             VAR, VALUE/F

This command allows you to modify the values of the internal FTP variables.

  LogFile
    'FTPSetVar LogFile filename' will cause all FTP messages to be logged
    to the specified file.  Usually this will not be an actual disk file
    but a console window description.  E.g.: FTPSetVar LogFile
    "KCON:/400//100/FTP Log/Auto/Close/ScreenDOPUS.1"

    'FTPSetVar LogFile' alone will cause the log file to be toggled between
    open and closed.

  Debug
    'FTPSetVar Debug value' will set the level of debugging information to
    be dumped into the log file.  Currently supported values are 0 and 1.
    With debug set to 1 all outgoing FTP commands will be logged.

    'FTPSetVar Debug' alone will cause then debug level to be toggled
    between 0 and 1.

    Debug level defaults to 0.

  TimeOut
    'FTPSetVar TimeOut value' will set the maximum number of seconds Opus
    will wait for a response from the FTP site after sending it a command.
    If Opus does not hear from the FTP site in this period the connection
    will be closed.

    TimeOut defaults to 60 seconds.

  ListUpdate
    'FTPSetVar ListUpdate value' will set the interval in seconds between
    successive updates of an FTP site's directory contents while the
    directory is being scanned.

    ListUpdate defaults to 1 second.

  List
    'FTPSetVar List command' will set the command used for obtaining the
    list of files from the FTP site.  This is generally intended for
    experts only.

    List defaults to "LIST -alF"

You must have AmiTCP, AS225, Inet, or MLink running to use the FTP commands.
@endnode

@node "GetSizes" "GetSizes"
GetSizes              FORCE/S

The GetSizes command causes any selected subdirectories in ALL @{" SRCE " link "Source"}
listers to be scanned.  The scanning process calculates the total size, in
bytes, of all files contained in the subdirectory.  Once scanned, the
subdirectory will be displayed.

The FORCE option can be used to force the command to scan all directories.
Without the FORCE option, if a subdirectory has been previously scanned, it
will not be re-scanned when you select the GetSizes button.

The GetSizes button also displays in the status bar the number of files,
directories and bytes that have been selected out of the total number of
files, directories and bytes.  If there is enough space for the total
selected bytes on the disk in the destination directory window, all selected
files would fit on the destination disk if they were copied and a 'Y' will
be displayed after the count.  If they won't fit, an 'N' will be displayed.

If you select an operation which causes a subdirectory to be scanned (e.g.,
@{" Copy " link "Copy"}, @{" Protect " link "Protect"}, @{" Search " link "Search"}, etc.), the size will be displayed as though you
had performed a GetSizes.

GetSizes works on ALL @{" SRCE " link "Source"} listers in turn.
@endnode

@node "HexRead" "HexRead"
HexRead               NAME/F, WAIT/S

The HexRead button will read the selected files in the same way as @{" READ " link "Read"},
except in hexadecimal format.  This allows you to view binary files and
other files containing non-text characters.

Giving the "WAIT" switch will ensure that any later commands will not
execute until the reader has closed.

See also @{" AnsiRead " link "AnsiRead"}, @{" Read " link "Read"}, and @{" SmartRead " link "SmartRead"}.
@endnode

@node "Hide" "Hide"
Hide

This command iconifies Directory Opus and deallocates as much memory as
possible.  Directory Opus' appearance and the method used to re-enter it
vary depending on the defined @{" Hide Method " link "Options - Hide Method"}.
@endnode

@node "IconInfo" "IconInfo"
IconInfo              NAME/F

This command allows you to modify the characteristics of icons such as Stack
size, Default Tool and Tool Types.  It operates in a similar fashion to the
Information menu of Workbench.

To use this command you may either select the '.info' files themselves or
the actual files or directories the icons belong to.

A requester will appear when you run this command on a valid icon.  The
actual appearance of the requester will vary depending on the type of icon,
but in all cases the actual icon imagery will be displayed.

The icon imagery can be simply replaced by dragging another icon onto the
requester.

You can disable/enable tooltypes (by adding or removing parentheses) by
double-clicking on the tooltype line.

The requester also has a menu allowing you to turn off icon borders and icon
names. Access this menu by right clicking over the requester. For icons
with a NewIcons image this menu will also allow you to choose whether to
see that image or the 'standard' image, as well as give you the ability
to strip the NewIcons data from the icon file.
@endnode

@node "LeaveOut" "LeaveOut"
LeaveOut              NAME/F

Places the currently selected files on the Opus Main Window and leaves them
out for easy access.  The command works on all selected files (and
directories) in all current @{" SRCE " link "Source"} listers.
@endnode

@node "LoadButtons" "LoadButtons"
LoadButtons           NAME/F

This command takes a filename as an argument and loads the button's
component files as named.  If only a simple filename is given the function
searches in the appropriate Opus 5 path of DOpus5:Buttons/ for the specified
file.  If a full pathname is given, the command will use that pathname
instead.
@endnode

@node "LoadEnvironment" "LoadEnvironment"
LoadEnvironment       NAME/F

This function takes a filename as an argument and loads the environment
component files as named.  LoadEnvironment will then reset the program
operation to the newly loaded parameters.

If only a simple filename is given, each command searches in the appropriate
Opus 5 path of DOpus5:Environment/ for the specified file.  If a full
pathname is given, the command will use that pathname instead.
@endnode

@node "LoadOptions" "LoadOptions"
LoadOptions           NAME/F

This command takes a filename as an argument and loads the component files
named.  LoadOptions will then reset the program operation to the newly
loaded parameters.

If only a simple filename is given, the command searches in the appropriate
Opus 5 path of Dopus5:Settings/ for the specified file.  If a full pathname
is given, the command will use that pathname instead.
@endnode

@node "MakeDir" "MakeDir"
Makedir               NAME, NOICON/S, SELECT/S, NEW/S, READ/S

Makedir allows you to create a new subdirectory in the @{" SRCE " link "Source"} directory
window; its name is limited to 30 characters.  From the displayed requester
you can choose whether to create an icon with the new directory or not.
Entering a name and just pressing RETURN will either create an icon or not
according to the status of the global Settings menu, @{" Create Icons " link "Settings - Create Icons"}.  The
name of the directory is limited to 25 characters if Create Icons is
enabled.


If the optional NAME is used, the command will not ask for the directory
name but will make it immediately in the current @{" SRCE " link "Source"} directory.

If the optional NOICON switch is used, the directory will be made without an
associated '.info' file.  Otherwise, the command obeys the global Create
Icons setting.

The SELECT option causes the new directory to be selected automatically.

The NEW option causes the new directory to be read into a new lister.

If the READ option is specified, the new directory will be read into the
current lister.

The MakeDir command works on the first @{" SRCE " link "Source"} directory ONLY.
@endnode

@node "MakeLink" "MakeLink"
MakeLink              NAME, TO, QUIET/S

This command allows you to create HARD links in the @{" DEST " link "Destination"} directory to
files or directories in the @{" SRCE " link "Source"} lister.  Hard links are only supported
within the same volume - this is a limitation of the operating system.  Hard
links are displayed in listers in bold, to make it easy to distinguish them
from plain files/directories.  In icon mode hard links are displayed with
the same superimposed arrow symbol as @{" left out icons " link "Icons - Leave Out"}.

The QUIET option suppresses warning requesters but not error requesters.
@endnode

@node "MakeLinkAs" "MakeLinkAs"
MakeLinkAs            NAME, NEWNAME, TO, QUIET/S

The MakeLinkAs function is similar to @{" MakeLink " link "MakeLink"} except that the links are
created in the @{" DEST " link "Destination"} directory using new names that you specify.  Wild
cards can be used with the naming.

If the QUIET option is specified, no warning requesters will be displayed
(error requesters still will though)
@endnode

@node "Move" "Move"
Move                  NAME, TO, QUIET/S

This function will move all selected entries from the @{" SRCE " link "Source"} directory to
the @{" DEST " link "Destination"} directory.  The entry will no longer exist in its original
place.


If any directories are selected to move, the @{" Recursive Filter " link "Settings - Filter"} will be used
to determine which files will be copied.

If the Move operation is on the same device, Opus 5 actually uses the
@{" Rename " link "Rename"} command.  On different devices, @{" Copy " link "Copy"} and @{" Delete " link "Delete"} commands are
used.

The QUIET option suppresses warning requesters but not error requesters.

Be careful with this function.  Opus 5 will delete the file if you are
moving it to a different device.

Move acts on a single destination ONLY.
@endnode

@node "MoveAs" "MoveAs"
MoveAs                NAME, NEWNAME, TO, QUIET/S

MoveAs performs the same function as @{" Move " link "Move"} but allows you to give each
entry a new name before it is moved.

MoveAs acts on a single destination ONLY.
@endnode

@node "None" "None"
None

The None button deselects all entries in all @{" SRCE " link "Source"} Listers.

See also @{" All " link "All"}, @{" Select " link "Select"}, @{" Reselect " link "Reselect"}, and @{" Toggle " link "Toggle"}.
@endnode

@node "Join" "Join"
Join                  FILE=FILE/M/A, AS=TO/A

The Join command can be used to concatenate two or more files into one
larger file.  It displays a requester which allows you to add and remove
files, and to specify the order they are concatenated in.
@endnode

@node "Parent" "Parent"
Parent

The Parent button reads the parent directory of the directory open in the
current @{" SRCE " link "Source"} directory window.  If the parent directory is contained in
the window's Buffer List, it will be displayed without re-reading it.

This command acts on the first @{" SRCE " link "Source"} directory only.
@endnode

@node "Play" "Play"
Play                  NAME/F, WAIT=SYNC/S, QUIET/S, ICON/S

The Play command allows you to listen to sound files.  This command plays
IFF 8SVX format sound files, and raw data files.  It will also play other
sound formats via the datatypes system of OS3.0 and higher.

A small requester will appear while the sound is playing, showing the name
and type of sound file, and the approximate playing time.  To abort a sound
before it has finished playing, click the Abort button in this requester, or
click the Next button to move on to the next sound.

If you specify the "QUIET" option, the sound is played without displaying
the status window.

Giving the "WAIT" switch will ensure that any later commands will not
execute until the sample has been played.

Because of deficiencies in the OS datatypes system, Opus will sometimes not
notice when a sound being played through datatypes finishes playing.  If
this is the case, you will have to click the Next or Abort button manually.

Opus 5.1 added the ability to play Soundtracker modules to the PLAY command.
We still believe that there are some very good commercial and PD/Shareware
programs (for example, the OctaMedPlayer and Delitracker) which do a much
better job, but many users wanted the ability built-in as in Opus 4.  The
PLAY command will now handle some of these formats, but not all.
@endnode

@node "Print" "Print"
Print                 NAME/F, WAIT/S

The Print command prints the selected files from all the current @{" SRCE " link "Source"}
directories.  It first displays the Opus @{" Print Requester " link "Print Requester"} which allows you
full control of Print formatting.

Giving the "WAIT" switch will ensure that any later commands will not
execute until the file has been printed.
@endnode

@node "PrintDir" "PrintDir"
PrintDir

This command allows you to print the directory shown in the current @{" SRCE " link "Source"}
lister.  The directory will be printed as it is currently displayed; to
change the format of the print-out you must edit the lister format first.
PrintDir works through the main @{" Print Requester " link "Print Requester"}, allowing you full control
over print formatting.

The command operates on the current @{" SRCE " link "Source"} lister ONLY.
@endnode

@node "Protect" "Protect"
Protect               NAME, RECURSE/S, SET=+/K, CLEAR=-/K

The Protect command allows you to modify the @{" Protection Bits " link "Protectionbits"} of the
selected files and directories in the active directory window.  When you
select directories, you are asked whether you also wish the files within
them to be protected.  For each entry, you are presented with a requester
displaying the protection bits currently set for that entry.

If any directories are selected to protect, the @{" Recursive Filter " link "Settings - Filter"} may be
used to determine which files will be affected.

This command applies to all selected files in all the current @{" SRCE " link "Source"}
listers.
@endnode

@node "Quit" "Quit"
Quit                  FORCE/S

This command shuts down all open windows and quits Directory Opus.  If Opus
has launched an associated task on the main window, you may be asked to quit
such programs before Opus can fully close down.

If the FORCE switch is specified you will not be asked for confirmation
before quitting.
@endnode

@node "Read" "Read"
Read                  NAME/F, WAIT/S

The Read command brings up the Opus text reader so you may read selected
files.  The reader provides a number of options from its menu selections.
These include a search capability and the ability to print the displayed
file.

You may move backwards and forwards through the file using the window scroll
bar or the cursor or keypad keys.

This command operates ONLY on the current @{" SRCE " link "Source"} directory.

Giving the "WAIT" switch will ensure that any later commands will not
execute until the reader has closed.

See also @{" AnsiRead " link "AnsiRead"}, @{" HexRead " link "HexRead"}, and @{" SmartRead " link "SmartRead"}.
@endnode

@node "Rename" "Rename"
Rename                NAME, NEWNAME

Rename allows you to give new names to all selected entries in the currently
selected @{" SRCE " link "Source"} directory windows.  A requester will appear for each entry
in turn, asking for the new name.  The initial rename requester has two
string fields instead of one.  You will usually just edit the name in the
lower of the two to the new name.

A limited type of wildcard rename is possible.  Entering an '*' in the
bottom field allows you to add prefixes or suffixes.  For instance, entering
'*.pic' will add a '.pic' suffix to all selected entries.  Entering 'A*'
will add an A prefix.  Only one '*' may be used in this process.

You cannot give a file a name that contains a '*'.

If you enter an '*' in the top as well as the bottom field, you can replace
sections of the name.  For example, entering '*.pic' in the top Field and
'*.iff' in the bottom Field will replace the '.pic' suffix in that entry
that has one with a '.iff' suffix.  If an entry does not have a '.pic'
suffix, it will be left untouched.  The * may also be embedded.  For
instance, renaming 'FOO*BAZ' as 'GEE*WIZ' would rename 'FOOBARBAZ' to
'GEEBARWIZ'.  Again, only one '*' may be used in each of the string fields.

The Rename command works on ALL @{" SRCE " link "Source"} listers in turn.

You can use the "NAME" and "NEWNAME" arguments to rename files in scripts.
Both arguments can accept asterisk (*) wildcards, like the Rename
requester itself.
@endnode

@node "Reselect" "Reselect"
Reselect

This command causes any files and directories in the current lister that
were deselected by the previous command to be selected ready for use once
more.

See also @{" All " link "All"}, @{" None " link "None"}, @{" Select " link "Select"}, and @{" Toggle " link "Toggle"}.
@endnode

@node "Reveal" "Reveal"
Reveal

This command causes Opus to deiconify if it has been iconified.
@endnode

@node "Root" "Root"
Root

The Root button reads the root directory of the @{" SRCE " link "Source"} directory window.  As
with the @{" Parent " link "Parent"} function, the buffer list will be searched before the
parent directory is reread.

This command acts on the first @{" SRCE " link "Source"} directory only.
@endnode

@node "Run" "Run"
Run                   NAME/F

The Run command will run each selected file in turn, providing that file is
executable.  It is similar to double clicking on the file's icon, or running
it from the CLI.  A requester will appear, asking for any arguments (should
you require any).
@endnode

@node "ScanDir" "ScanDir"
ScanDir               PATH, NEW/S, MODE/K, SHOWALL/S

With no arguments ScanDir rereads the current directory in the first @{" SRCE " link "Source"}
lister.  If you specify a path it will read that path into the current
@{" SRCE " link "Source"} lister.  If there is no current @{" SRCE " link "Source"} it will open a new lister.

if you call ScanDir with no arguments, and have a directory selected in the
source lister, it is the selected directory that will be read.  Also, in
this case, if you have a destination lister selected the directory will be
read into that.

MODE can specify one of @{" Name " link "Lister - View As"}, @{" Icon " link "Lister - View As"}, or @{" Icon Action " link "Lister - View As"}, the default is
@{" Name mode " link "Lister - View As"}.

The @{" SHOWALL " link "Lister - View As"} switch causes all files to be displayed in Icon mode even if
they have no icon.

If the NEW switch is specified, it will always open a new lister.
@endnode

@node "Search" "Search"
Search

The Search command will search the contents of all selected files in all
@{" SRCE " link "Source"} listers, and the files within selected directories, for a specified
string which is selected in a requester.

If a file containing the string is found, you are asked if you wish to read
that file, or continue the search.  If you elect to read the file it will be
loaded into the @{" Text Viewer " link "AnsiRead"}, and a search will automatically be initiated
for the string you want.

You can also select entire devices to search, using the @{" DEVICE LIST " link "DeviceList"}
feature that is described later.  If any directories are selected to search,
the global @{" Recursive Filter " link "Settings - Filter"} will be used to determine which files will be
searched.
@endnode

@node "Select" "Select"
Select         NAME/K, FROM/K, TO/K, BITSON/K, BITSOFF/K, COMPARE/K,
               MATCHNAME/S, NOMATCHNAME/S, IGNORENAME/S,
               MATCHDATE/S, NOMATCHDATE/S, IGNOREDATE/S,
               MATCHBITS/S, NOMATCHBITS/S, IGNOREBITS/S,
               MATCHCOMPARE/S, NOMATCHCOMPARE/S, IGNORECOMPARE/S,
               BOTH/S, FILESONLY/S, DIRSONLY/S, EXCLUDE/S, INCLUDE/S

When called with no arguments, this command will display a requester
allowing you to specify a pattern to match files in the current @{" SRCE " link "Source"}
listers.  Files matching the selection criteria will be selected or
deselected depending on the state of the Include or Exclude switch.

The optional arguments take their names from the fields displayed in the
complex selection requester.  If called with arguments which satisfy a
selection criteria, the requester will not be displayed.

See also @{" All " link "All"}, @{" None " link "None"}, @{" Reselect " link "Reselect"}, and @{" Toggle " link "Toggle"}.
@endnode

@node "Set" "Set"
Set

This command allows you to set certain things regarding the current lister
or the operation of the current function:

  Set Dest
    Set lister into destination mode.

  Set Display <items>
    Change the display items.

  Set Flags [[+|-|/] Reverse] [[+|-|/] NoIcons] [[+|-|/] Hidden]
    Alter flags.  Use '+' to set a flag, '-' to reset, and '/' to toggle.
    Multiple flags may be specified at once.  For example, "Set Flags
    +hidden -noicons".

  Set Hide <pattern>
    Change the hide pattern.

  Set Labelcolour [desktop|windows] <fg> <bg> <drawmode>
    Modify icon label colours on the fly.
    For example,
               Set labelcolour desktop 3 1 jam1
               Set labelcolour desktop 7 0 jam2

  Set Lock [On|Off]
    Lock or unlock lister as source/dest.

  Set Mode [Name | Icon | Icon Action] [Showall]
    Change the mode of the current source lister.

  Set Off
    Turn lister off.

  Set Output <handle>
    Allows you to change the output handle for the lifetime of this
    function.

  Set Separate <method>
    Change the file/directory separation.

  Set Show <pattern>
    Change the show pattern.

  Set Sort <method>
    Change the sort method for the current source lister.

  Set Source
    Set lister into source mode.

  Set ToolBar <file>
    This allows you to specify which toolbar a lister should use.
@endnode

@node "SetAsBackground" "SetAsBackground"
SetAsBackground NAME, DESKTOP/S, LISTER=WINDOW/S, REQ=REQUESTER/S, TILE/S,
                CENTER/S, PRECISION/K

(Only OS3.0 or greater)

The SetAsBackground command takes the filename of a picture and installs
it as the background in either the desktop, windows or requesters. The
main use of this command is in a filetype popup menu, whereby you could
click the right mouse button on a picture, select the 'Set As Background'
option and instantly have the picture as your backdrop image. Another use
of this command would be to implement a random background picture
switching application for Opus.

  PRECISION
    Lets you specify the remapping precision; valid values are "none" (no
    remap), "gui" (poor), "icon" (ok), "image" (good), and "exact" (best).
    Please note that the Amiga datatypes system is responsible for
    remapping the images, and so the results achieved may be dependent
    upon your datatypes settings.
@endnode

@node "Show" "Show"
Show                  NAME/F, WAIT/S


The Show command allows you to display IFF ILBM pictures, brushes and
animations.  It will also display other picture formats via the datatypes
system of OS3.0 and higher.

Opus 5 will show most pictures and brushes, including overscan, extra
halfbrite (EHB), HAM (4096 colour) pictures, and AGA 8 bit pictures.

Under OS3.0 and higher, if a file is a different format picture for which a
datatype is installed, the picture will be displayed by that datatype.

The following keys can be used when viewing a picture or animation.

  Mouse Pointer Scroll
  ESC or Right Mouse Button Abort
  Q or Left Mouse Button Next (and leave entry selected)
  Delete Next (and mark entry for deletion)
  Space, Help or P Help and Print Requester


These keys can be used when viewing an Animation.

  S         Starts and Stops
  N         Next Frame
  -         Slow Down
  =         Speed Up
            Original Speed
  F1 - F10  Various Speeds (F1=Fastest)


If any pictures are marked for deletion when the last picture has been
shown, the delete function is automatically launched on them (you are given
the usual warning first).

Giving the "WAIT" switch will ensure that any later commands will not
execute until all of the files have been viewed.
@endnode

@node "SmartRead" "SmartRead"
SmartRead             NAME/F, WAIT/S

Invokes the Opus reader program in either text, ANSI or hex mode according
to the type of file selected.  Just as does the @{" Read " link "Read"} command, if multiple
files are selected, these will be displayed in sequence.  Pressing ESC will
terminate the reading of the sequence.

Giving the "WAIT" switch will ensure that any later commands will not
execute until the reader has closed.

See also @{" AnsiRead " link "AnsiRead"}, @{" HexRead " link "HexRead"}, and @{" Read " link "Read"}.
@endnode

@node "Split" "Split"
Split                 FILE=FROM/A, TO/A, CHUNK/N/A, STEM

This command is used to split one large file into several smaller files.

CHUNK specifies the size in kilobytes of each part.

STEM is the base name of the parts.  .001, .002, etc. will be added to the
stem to form the filenames of the parts.
@endnode

@node "Toggle" "Toggle"
Toggle

This command will Toggle or reverse the state of all entries.  This causes
selected entries to be deselected and deselected entries to be selected.
This acts on all @{" SRCE " link "Source"} directories.

See also @{" All " link "All"}, @{" None " link "None"}, @{" Reselect " link "Reselect"}, and @{" Select " link "Select"}.
@endnode

@node "User" "User"
User                  ID/N, NAME/F

This command will invode one of ten user-definable functions associated
with your filetypes.

The ID argument takes a number from 1 to 10 which determines which
function is executed.

You can use the NAME argument to specify the name of the file you want
the command to act upon, if you don't want it to work on the selected
files.

As an example, in the filetypes for archives which come with the default
Opus configuration, the first user-defined command ("User 1") is defined
to extract files from the archives. While this is a different operation
for each different type of archive, it is possible now to select several
archives of different types and click a single button (which is defined
as "User 1") to unpack all of them at once.

Note: This supersedes and extends the old @{" UserX " LINK "User1"} commands.

@endnode

@node "User1" "User1"
User1                 NAME/F

This command will invoke the user-definable command associated with your
filetypes.  In the default configuration User1 is defined to extract files
from archives.

While the User1 - User4 commands still work, they have been superseded by
the @{" User " LINK "User"} command which provides up to ten user-definable filetype
actions.
@endnode

@node "User2" "User2"
User2                 NAME/F

This command will invoke the user-definable command associated with your
filetypes.

While the User1 - User4 commands still work, they have been superseded by
the @{" User " LINK "User"} command which provides up to ten user-definable filetype
actions.
@endnode

@node "User3" "User3"
User3                 NAME/F

This command will invoke the user-definable command associated with your
filetypes.

While the User1 - User4 commands still work, they have been superseded by
the @{" User " LINK "User"} command which provides up to ten user-definable filetype
actions.
@endnode

@node "User4" "User4"
User4                 NAME/F

This command will invoke the user-definable command associated with your
filetypes.

While the User1 - User4 commands still work, they have been superseded by
the @{" User " LINK "User"} command which provides up to ten user-definable filetype
actions.
@endnode

@node "Diskcopy Requester" "Diskcopy Requester"
Diskcopy Requester

The Diskcopy Requester allows you to oversee the copying of disks.  The
Requester has the following fields -

  From...
    This list contains the possible disk drives that may be used as the
    source.  When you click on one, it becomes the selected drive.

  To...
    This list contains the possible destination drives which are compatible
    with the selected source drive.  The source disk drive is always
    available as a destination to allow you to make single drive copies.

  Verify
    This button allows you to turn off the integrity verification when
    writing data to the destination drive.  Although it is faster, you
    probably won't want to do this.

  Bump Name
    This button allows you to change the volume name using the same naming
    convention as Workbench's DiskCopy.

This function will not copy any protected software, or non-AmigaDOS format
disks.
@endnode

@node "Filetype Creator" "Filetype Creator"
Filetype Creator

The filetype creator is very useful for making new filetypes without having
an in-depth understanding of how the files work.

The best way to use it is to select a large number of files of the new type
and use the @{" CreateFiletype " link "CreateFiletype"} command.  The files will now be checked to see
what makes them similar.  You can add or remove files from the list using
the listview gadgets on the left side of the requester or drag and drop. You
can then edit the filetype and give it a default icon, double-click event,
custom popup menus, and more.

The filetype creator may also be called by the @{" Filetype Finder " link "Filetype Finder"} if it can't
find a matching filetype for a file.
@endnode

@node "Filetype Finder" "Filetype Finder"
Filetype Finder

The filetype finder is invoked whenever you double-click on a file for which
no filetype has been defined or by using the @{" FindFiletype " link "FindFiletype"} command.

On the left side of the display is a list of all the filetypes that match
the selected file.  This list shows the priority, ID, and name of each
matching filetype.  Any file shown with a tick is already installed in your
DOpus5:Filetypes directory, those without a tick are in the
DOpus5:Storage/Filetypes directory and will be ignored by the rest of the
Opus 5 system until they are installed.

The filetype which Opus 5 will actually use for the selected file is the one
which is highlighted.  If you wish to makes changes to any of the other
filetypes besides the highlighted one, you must use the standard
@{" Filetype Manager " link "File Types"}.

The right side of the display will recommend an action for you to take
depending on what matching filetypes were found and whether or not they were
installed.  At this point you may be able to use the filetype as it is
already set up, install a filetype from your DOpus5:Storage/Filetypes
drawer, create a new filetype with the @{" Filetype Creator " link "Filetype Creator"}, edit the best
installed matching filetype, or cancel the process altogether.
@endnode

@node "Format Requester" "Format Requester"
The Format Requester allows you to control the formatting of devices.  The
list on the left side of the requester contains the devices which you can
format.  The selected device is highlighted.  Be sure the device you intend
to format is the one that is highlighted! The other sections of the
requester are -

  Name:
    This field allows you to give the drive to be formatted a volume name.

  Fast File System:
    This allows you to format a device using the Fast File System option of
    AmigaDOS.

  International Mode:
    This allows file and directory names to include accented characters.

  Directory Caching:
    Directory caching mode will cause the directory reading speed to be
    much faster.

  Make Bootable:
    This button will 'Install' the disk with a standard AmigaDOS boot
    sector after it has been formatted, thus making a bootable disk.

  Put Trashcan:
    This button allows you to put a trashcan in the root directory of the
    newly formatted device.

  Verify:
    This button allows you to disable the format verification.  The process
    is faster with Verify turned off, but you won't be made aware of any
    errors.  It's better to leave Verify turned on, unless you completely
    trust your disks.

  Format:
    This button begins the formatting process.  Be very careful that you
    have selected the correct device.  Once a Format begins, it can be
    aborted, but data will be lost!

  Quick Format:
    When this button is selected, the disk will just be initialised.  This
    provides an extremely fast way to erase an old disk.  This will not
    work on new disks, it will only work on disks that have previously been
    formatted.

  Cancel:
    This button will abort without attempting a Format.
@endnode

@node "Print Requester" "Print Requester"
Print Requester

The Print Requester gives you full print formatting control for text files.


You may adjust the following configuration items:-

  Quality
    This button cycles between Letter and Draft.  Some printers can
    be toggled between letter and Draft quality printing.

  Spacing
    This button cycles between 6 lines per inch, and 8 lines per
    inch.

  Pitch
    This button cycles between Pica, Elite, and Fine.  These values
    specify the size of letters to print.  Your printer will
    determine the exact dimensions of these values.

  Output
    By default, the output will be sent to the current Preferences
    printer.  However, you can redirect the output to a file of your
    choosing.

      Printer: This option directs output to the printer.

      File:    When this option is enabled, output is directed to a
               selected disk file or device.

  Left Margin
    This field contains the number of characters to skip before
    printing each line.

  Right Margin
    This field contains the number of printed characters allowed on
    each line.  The Left Margin characters are not included in this
    value.

  Page Length
    This specifies the number of lines per page to be printed.

  Tab Size
    This field contains the number of spaces to which a tab character
    is equivalent.

Configuration...

  This button cycles between Header and Footer.  The Title, Date and
  Page no.  Buttons can be used with creating a Header or Footer line
  for each page in the print-out.  When the configuration button is
  Header, these buttons affect the Header line; otherwise, they
  affect the Footer line.

  Title
    When checked, a title will be generated.  By default, the
    filename will be the title.

  Date
    When checked, the current date will be printed.

  Page
    When checked, the page number will be printed.

  Style
    This button allows you to modify the appearance of all the
    printed text, except the headers and footers.
@endnode

@node "Button" "Button"
This is a user-editable button.  It currently has either no function set or
has a custom function calling external programs.

To edit this button, select @{" Edit " link "Button Bank Editor"} from the Buttons menu and double-click on
the button.
@endnode

@node "ToolbarButton" "ToolbarButton"
This is a user-editable toolbar button.  It currently has either no function
set or has a custom function calling external programs.

To Edit this button, select @{" Edit Lister Toolbar " link "Lister - Edit Toolbar"} from the Listers menu,
press right-amiga 1, or hold the alt key down and click on the button.
@endnode

@node "Toolbar Arrow" "Toolbar Arrow"
The Toolbar Arrow allows you to scroll through the buttons on the toolbar
when the lister is not large enough to display them all at once.
@endnode

@node "ListerMenu" "ListerMenu"
This is a user-editable lister menu entry.  It currently has either no
function set or has a custom function calling external programs.

To @{" Edit " link "Menu Editor"} this entry, select @{" Edit Lister Menu " link "Lister - Edit Menu"} from the Lister menu.
@endnode

@node "UserMenu" "UserMenu"
This is a user-editable user menu entry.  It currently has either no
function set or has a custom function calling external programs.

To @{" Edit " link "Menu Editor"} this entry, select "User Menu" from the Settings menu.
@endnode

@node "Desktop - Copy" "Desktop - Copy"
 Desktop - Copy

The files which you dragged to the desktop will be copied to the desktop,
leaving the original copies where they were.
@endnode

@node "Desktop - Move" "Desktop - Move"
 Desktop - Move

The files which you dragged to the desktop will be moved to the desktop,
removing the original copies from where they were. The only copy of the
files will be that on the desktop -- be careful not to delete them by
mistake thinking that they are only left-outs.
@endnode

@node "Desktop - Left-Out" "Desktop - Left-Out"
 Desktop - Left-Out

The files which you dragged to the desktop will be "left-out". This means
that it will look like the files are on the desktop, but the files are
really still where they were originally. You can delete left-out files
later without deleting the real files which they point to.
@endnode

@node "Desktop - Cancel" "Desktop - Cancel"
 Desktop - Cancel

Your action of dragging some files to the desktop will be aborted and have
no effect.
@endnode

@node "Project - Backdrop" "Menu Opus - Backdrop"
 Menu Opus - Backdrop

This toggle converts the Main Window to a special borderless window that is
always behind all other windows on the screen.
@endnode

@node "Project - Execute Command" "Menu Opus - Execute Command"
 Menu Opus - Execute Command

Execute Command allows you to start an AmigaDOS command without having to
open a new Shell.  Opus will open a requester for you to enter the command
and any arguments.

If required, Opus will open a new console window to output the results of
the command.  The window will remain open until you select the close
gadget.

The CLI button causes a new @{" Opus Command Line Interface " link "CLI"} to be opened.

This requester has a history of the last 20 commands you have entered.  Use
the cursor up / cursor down keys to move through the history.
@endnode

@node "Project - About" "Menu Opus - About"
 Menu Opus - About

This command displays information about Directory Opus including the version
number and your registration details.
@endnode

@node "Project - Hide" "Menu Opus - Hide"
 Menu Opus - Hide

This command iconifies Directory Opus and deallocates as much memory as
possible.  Directory Opus' appearance and the method used to re-enter it
vary depending on the defined @{" Hide Method " link "Options - Hide Method"}.
@endnode

@node "Project - Quit" "Menu Opus - Quit"
 Menu Opus - Quit

This command shuts down all open windows and quits Directory Opus.  If Opus
has launched an associated task on the main window, you may be asked to quit
such programs before Opus can fully close down.
@endnode

@node "Lister - New" "Lister - New"
 Lister - New

This function opens up a new blank Lister relative to the mouse position.
When the new lister opens it can optionally display the @{" Device List " link "DeviceList"}.

The initial size and contents of the new lister is determined by the
settings in the @{" Lister Options " link "Environment - Lister Options"}.
@endnode

@node "Lister - Open Parent" "Lister - Open Parent"
 Lister - Open Parent

As in Workbench, this function causes the parent of the current source
lister to be displayed in a new lister.
@endnode

@node "Lister - Close" "Lister - Close"
 Lister - Close

Closes the current active Lister.  Note that no warning is given, the
currently active lister will close immediately.
@endnode

@node "Lister - Close All" "Lister - Close All"
 Lister - Close All

This command @{" Closes " link "Lister - Close"} down all the open listers.
@endnode

@node "Lister - Make Source" "Lister - Make Source"
 Lister - Make Source

When activated it makes the lister a @{" Source " link "Source"}.  The other listers now may
cycle through to either @{" Destination " link "Destination"} or @{" Off " link "Lister - Off"} modes unless they are
@{" Locked " link "Lister - Lock Source"}.
@endnode

@node "Lister - Make Dest" "Lister - Make Dest"
 Lister - Make Dest

This makes the lister into a destination, this may also cycle other
@{" Unlocked " link "Lister - Unlock"} listers into different modes.
@endnode

@node "Lister - Off" "Lister - Off"
 Lister - Off

This turns the mode of the active lister to off so that it is neither a
@{" Source " link "Source"} nor a @{" Destination " link "Destination"}.
@endnode

@node "Lister - Lock Source" "Lister - Lock Source"
 Lister - Lock Source

This locks the mode of the lister to being a source, the locking means that
the mode changing of other listers will not affect this lister's mode.  This
lister can still have its mode changed with the @{" Make Dest " link "Lister - Make Dest"} and @{" Lock Dest " link "Lister - Lock Dest"}
options.  The lister can be reverted to a normal mode by @{" Unlocking " link "Lister - Unlock"} it.
@endnode

@node "Lister - Lock Dest" "Lister - Lock Dest"
 Lister - Lock Dest

This function will lock the active lister into @{" Destination " link "Destination"} mode.  By
locking, it is meant that any mode changing of other listers will not effect
the mode of this lister.  The lister can now only have its mode changed by
user action or by @{" Unlocking " link "Lister - Unlock"} it then it will change as normal.
@endnode

@node "Lister - Unlock" "Lister - Unlock"
 Lister - Unlock

This command will unlock the active lister if it is locked.  If you wish to
unlock all the listers, @{" Unlock All " link "Lister - Unlock All"} would be a more suitable command.
@endnode

@node "Lister - Unlock All" "Lister - Unlock All"
 Lister - Unlock All

This command @{" Unlocks " link "Lister - Unlock"} all the @{" Locked " link "Lister - Lock Source"} listers, not just the active one.
@endnode

@node "Lister - Edit" "Lister - Edit"
 Lister - Edit

This brings up the @{" List Format Editor " link "Lister Format"} and allows you to change the format
of the currently active lister's display.
@endnode

@node "Lister - Edit Toolbar" "Lister - Edit Toolbar"
 Lister - Edit Toolbar

This brings up the @{" Button Bank Editor " link "Button Bank Editor"} with the default toolbar as the
button bank.  It allows you to customise the icon images and commands used
in the Lister ToolBar.

Note that if you are using a toolbar other than the default, this will not
be the toolbar which you will edit.  Only the default toolbar will be edited
by this function.
@endnode

@node "Lister - Edit Menu" "Lister - Edit Menu"
 Lister - Edit Menu

This brings up the @{" Menu Editor " link "Menu Editor"} which allows you to customise the user
popup menus in the toolbar.
@endnode

@node "Lister - Tile" "Lister - Tile"
 Lister - Tile

The Horizontal/Vertical tiling arranges the displayed listers to fit equally
within the current Opus Main Window with either horizontal or vertical
priority.  If the main window is in Backdrop mode, this will tile the
Listers equally over the whole screen.

The Cascade option cascades the displayed listers within the borders of the
Opus Main Window.  If the main window is set as a backdrop, this will
cascade the current listers over the full screen.
@endnode

@node "Lister - Snapshot" "Lister - Snapshot"
 Lister - Snapshot

This snapshots the size and position of the currently active lister.  This
function does not @{" Snapshot " link "Icons - Snapshot"} icons.
@endnode

@node "Lister - UnSnapshot" "Lister - UnSnapshot"
 Lister - Un-Snapshot

This command cancels the @{" Snapshot " link "Lister - Snapshot"} position of the selected lister.
@endnode

@node "Lister - View As" "Lister - View As"
 Lister - View As

This selects the mode of display to be shown in the current Lister. Possible
modes are Workbench style 'Icon mode', the normal 'File mode', and 'Icon
action mode' which displays the files and directories as icons but still
allows use of the toolbar and all associated functions.  With the Show All
option, which is only available in Icon Mode and Icon Action Mode, Opus 5
will display all the files and directories using pseudo-icons for those
which do not have real icons, using filetype icons wherever possible.
@endnode

@node "Lister - Iconify" "Lister - Iconify"
 Lister - Iconify

This reduces the window to a small icon on the Opus 5 Main Window.  To
un-iconify a Lister, simply double-click on the icon or choose Open from the
icon's popup menu.
@endnode

@node "Lister - Lock Position" "Lister - Lock Position"
 Lister - Lock Position

Normally, each Lister is displayed in a standard Amiga window, which may be
dragged to any position and may also be resized.  However, Opus 5 provides
the option to lock the Lister window in a set position at a set size.
@endnode

@node "Icons - New Drawer" "Icons - New Drawer"
 Icons - New Drawer

As in Workbench, this function can be used to create a new drawer in the
current lister.
@endnode

@node "Icons - New Group" "Icons - New Group"
 Icons - New Group

This creates a new program group with the name that you specify.
@endnode

@node "Icons - New Command" "Icons - New Command"
 Icons - New Command

Allows the creation of a command file, essentially a single Opus function
in a file. The command is saved to the DOpus5:Commands directory and a
left-out for it is automatically created on the main window.

Double-clicking a left-out command icon will run the command, just like
clicking a button in a button bank. Edit the command file by right-clicking
on it and selecting @{" Edit " LINK "Icons - Edit Command"} from the popup menu.

To remove the left-out from the main window, choose @{" Put Away " LINK "Icons - Put Away"} from the
RMB popup menu. This will not delete the command itself; you must delete
it manually from the DOpus5:Commands directory if you want to get rid of
it permanently.

Left-out commands use the default icon command.info from DOpus5:Icons but
you can give individual commands their own icons by just adding an icon
(.info) to the file in the DOpus5:Commands directory.

Command files may also be added to a standard Opus group.
@endnode

@node "Icons - Edit Command" "Icons - Edit Command"
 Icons - Edit Command

This will bring up the @{" function editor " LINK "Function Editor"} for the selected @{" command " LINK "Icons - New Command"}.

@endnode

@node "Icons - Open" "Icons - Open"
 Icons - Open

Acts the same as a double click on an icon.  If the icon is a disk or
drawer, it opens a new lister and displays the directory contents.  If the
icon is a project or tool, it will examine the file to determine if it knows
the specific filetype.  If the file matches a previously
@{" User-Defined Filetype " link "File Types"}, for which the appropriate function has been
defined, the function is executed.  If the icon is an iconified lister or
button bank it will be deiconified.

If the file does not match a user-defined filetype, it is tested against the
internal filetype definitions and action is taken accordingly.  If there is
still no match, the @{" Filetype Finder " link "Filetype Finder"} or the @{" SmartRead " link "SmartRead"} command will be
called depending on whether you have the @{" Filetype Sniffer " link "Options - Miscellaneous"} option enabled.
@endnode

@node "Icons - Information" "Icons - Information"
 Icons - Information

Displays status information about the selected icon.  It also allows you to
edit the tooltypes and other information in an application icon.  See also
the @{" IconInfo " link "IconInfo"} internal command.
@endnode

@node "Icons - Snapshot" "Icons - Snapshot"
 Icons - Snapshot

Snapshot saves the current layout and position of icons and/or windows.  The
Snapshot can be performed with the Icon option where only highlighted Icons
are Snapshotted or with the Window option where only the active window is
Snapshotted or with the All option where both the active window and all the
icons it contains are snapshotted.
@endnode

@node "Icons - UnSnapshot" "Icons - UnSnapshot"
 Icons - UnSnapshot

This command cancels the @{" Snapshot " link "Icons - Snapshot"} position of the selected icon or icons.
@endnode

@node "Icons - Leave Out" "Icons - Leave Out"
 Icons - Leave Out

This command puts a copy of the selected file's icon from a Lister onto the
main Opus window for easy access.  Files and directories left out in this
manner will appear in the main window next time you run Opus.  Left out
icons can be identified by a small arrow image superimposed onto them.
@endnode

@node "Icons - Put Away" "Icons - Put Away"
 Icons - Put Away

Removes any selected icons which have been @{" Left Out " link "Icons - Leave Out"} on the Opus main
window.
@endnode

@node "Icons - Select All" "Icons - Select All"
 Icons - Select All

Selects all the entries in the active lister, or on the Opus 5 Main Window
if no lister is currently active.
@endnode

@node "Icons - CleanUp" "Icons - CleanUp"
 Icons - CleanUp

This command attempts to adjust the positions of all the icons in the Opus
Main Window and Icon windows to their optimal positions within the confines
of their window's dimensions.
@endnode

@node "Icons - Reset" "Icons - Reset"
 Icons - Reset

Resets all the icon positions to those currently stored in the icon itself
from the last @{" Snapshot " link "Icons - Snapshot"} operation.
@endnode

@node "Icons - Rename" "Icons - Rename"
 Icons - Rename

Provides the option to @{" Rename " link "Rename"} the selected icons.
@endnode

@node "Icons - Delete" "Icons - Delete"
 Icons - Delete

This function can be used to @{" Delete " link "Delete"} any selected files and directories
from the current lister.  It can also delete @{" program groups " link "Program Group"} from the main
Opus 5 window, and group icons from within @{" program groups " link "Program Group"}.
@endnode

@node "Icons - Format" "Icons - Format"
 Icons - Format

This brings up the Opus @{" Format Requester " link "Format Requester"} and allows you to @{" Format " link "Format"} disks.
@endnode

@node "Icons - Disk Information" "Icons - Disk Information"
 Icons - Disk Information

Displays some information about the disk the active directory resides on,
including space used and free, @{" DateStamp " link "DateStamp"} and number of errors on the disk,
if any.
@endnode

@node "Icons - Copy" "Icons - Copy"
 Icons - Copy

For a disk this invokes the @{" DiskCopy " link "Diskcopy"} command.  For files and directories
there are four options:
  Copy to Ram:
  Copy to DF0:
  Copy to Desktop
  Copy to other...

Note that you can add extra directories and even Arexx scripts to the list
of paths. See your Opus 5 manual for details.

'Copy to Desktop' will cause the entry to be copied to the Desktop Folder.
The new copy will appear on the Opus main window as an icon while the
original will remain where it was.

'Copy to other' allows you to select a destination via the standard file
requester.
@endnode

@node "Icons - Arrange Icons" "Icons - Arrange Icons"
 Icons - Arrange Icons

This is similar to the @{" Icons - Clean Up " link "Icons - CleanUp"} menu item, but you have the option
of arranging the icons by several methods:
  by Name
  by Type
  by Size
  by Date
@endnode

@node "Icon Popup - Open With" "Icon Popup - Open With"
 Icon Popup - Open With

Project files have an Open With... item in the file popup menu, which lets
you select an application to open the file with. Opus remembers up to the
last 10 programs chosen, and displays them in the menu for you to select
from.
@endnode

@node "Icon Popup - Open In New Lister" "Icon Popup - Open In New Lister"
 Icon Popup - Open In New Lister

This entry opens a new lister for the directory in question.
@endnode

@node "Icon Popup - Close" "Icon Popup - Close"
 Icon Popup - Close

Causes the icon to be removed from the Opus 5 screen.
@endnode

@node "Icon Popup - Custom" "Icon Popup - Custom"
 Icon Popup - Custom

This is a user-editable popup menu entry.  It currently has either no
function set or has a custom function calling external programs.

To edit this button you must use the @{" Filetype Editor " link "File Type Editor"}.
@endnode

@node "Buttons - New Gfx Buttons" "Buttons - New Gfx Buttons"
 Buttons - New Gfx Buttons

Creates a new Button bank of Graphic buttons.  When first opened, the
button bank will have only one button.  The size of the button bank and
the definitions for each button may be changed by calling the
@{" Button Editor " link "Button Bank Editor"}.
@endnode

@node "Buttons - New Text Buttons" "Buttons - New Text Buttons"
 Buttons - New Text Buttons

Creates a new Button bank of Text buttons.  When first opened, the
button bank will have only one button.  The size of the button bank and
the definitions for each button may be changed by calling the
@{" Button Editor " link "Button Bank Editor"}.
@endnode

@node "Buttons - New Start Menu" "Buttons - New Start Menu"
 Buttons - New Start Menu

Creates a new Start Menu button. After defining the entries you
want using the @{" Menu Editor " LINK "Menu Editor"} and saving to a file, you can edit how the
Start Menu looks using the popup menu from it's drag-bar. You can
also bring up this popup by holding the ctrl key and clicking the
button.
@endnode

@node "Buttons - Open" "Buttons - Load"
 Buttons - Load

Loads an old Button Bank from disk.  The loaded bank will appear on the
screen in the position last saved with the button bank, or in the position
it was in when you saved the environment settings.
@endnode

@node "Buttons - Open Start Menu" "Buttons - Load Start Menu"
 Buttons - Load Start Menu

Loads an old Start Menu from disk.  The loaded Start Menu will appear on
the screen in the position it was last saved in, or in the position
it was in when you saved the environment settings.
@endnode

@node "Buttons - Save" "Buttons - Save"
 Buttons - Save

Saves the selected Button Bank to disk using the name under which it was
loaded.
@endnode

@node "Buttons - Save As" "Buttons - Save As"
 Buttons - Save As

This command saves the selected Button Bank to disk under the name you
specify.
@endnode

@node "Buttons - Close" "Buttons - Close"
 Buttons - Close

This command closes an open Button Bank.
@endnode

@node "Buttons - Edit" "Buttons - Edit"
 Buttons - Edit

This command brings up the @{" Button Editor " link "Button Bank Editor"} and allows you to edit the
definitions of all buttons in all Button Banks currently open.  You can
readily edit several button banks at once.  Note that while the Button
Editor is open the buttons cannot be used in the normal way.
@endnode

@node "Buttons - Iconify" "Buttons - Iconify"
 Buttons - Iconify

This will cause the button bank to be replaced by a small icon.  To
deiconify again, select @{" Open " link "Icons - Open"} from the icon popup menu, or just
double-click on the icon.
@endnode

@node "Settings - Clock" "Settings - Clock"
 Settings - Clock

This command toggles the display of a clock in the Opus main window title
bar.
@endnode

@node "Settings - Create Icons" "Settings - Create Icons"
 Settings - Create Icons

When Opus creates a new directory, this option toggles whether Opus will
create the associated icon or '.info' file as well.
@endnode

@node "Settings - Default PubScreen" "Settings - Default PubScreen"
 Settings - Default PubScreen

This command toggles whether Opus' screen is set as the system Default
Public Screen.  When used in this manner, the Opus screen will be used by
other programs as the default screen on which to open their windows instead
of using the Workbench screen.  (Depending on the program!)

This command is only valid when Opus is running on its own screen.
@endnode

@node "Settings - Filter" "Settings - Recursive Filter"
 Settings - Recursive Filter

This command toggles the filter option.  The Recursive Filter, when enabled,
prompts you for an optional file pattern whenever you execute a function
which operates recursively on files within sub-directories.  If you enter a
file pattern then only files matching that pattern will be operated upon.
@endnode

@node "Options - Edit" "Options - Edit"
 Options - Edit

This command displays the @{" Options Editor " link "Options"} which allows you to change the
operational modes of Opus commands.
@endnode

@node "Settings - Filetypes" "Settings - Filetypes"
 Settings - Filetypes

This button displays the @{" Filetype Manager " link "File Types"} which shows the currently known
Filetypes and allows you to edit the filetype definitions, events and
actions.
@endnode

@node "Settings - User Menu" "Settings - User Menu"
 Settings - User Menu

This button brings up the @{" Menu Editor " link "Menu Editor"} which allows you to customise the
user menus.  You may have as many user menus as will fit after the Settings
menus.
@endnode

@node "Settings - Hotkeys" "Settings - Hotkeys"
 Settings - Hotkeys

Brings up the @{" Hotkeys editor " link "Hotkey Editor"} which allows you to add and remove custom
hotkeys from Opus 5.
@endnode

@node "Settings - Scripts" "Settings - Scripts"
 Settings - Scripts

Brings up the @{" Scripts Editor " link "Scripts Editor"} which allows you to attach standard Opus 5
functions to a number of Opus 5 events.
@endnode

@node "Settings - Icon Positioning" "Settings - Icon Positioning"
 Settings - Icon Positioning

From the Settings menu, choose Icon Positioning and Opus will enter a mode
where you may create special icon positioning areas by clicking and
dragging on the main window. These areas are represented by windows which
can be resized, re-positioned and closed as normal. Each window has a RMB
sticky popup menu to configure which types of icons will appear in that
area. You can also select one of five priorities for the area, which
determines in what order the positioning areas will be used.

These areas are saved in the Environment file. Defined areas may
optionally include Appicons, Disks, iconified Listers and  Buttons, Groups
and any Left-outs icons including items in the Desktop Folder.
@endnode

@node "Environment - Edit" "Environment - Edit"
 Environment - Edit

This command displays the @{" Environment Editor " link "Environment"} which allows you to change
the visual display characteristics used by Opus 5.
@endnode

@node "Environment - Open" "Environment - Load"
 Environment - Load

This command loads an Environment file from disk and resets the visual
display of Opus 5 to that defined therein.
@endnode

@node "Environment - Save" "Environment - Save"
 Environment - Save

This command saves the selected Environment using the name under which it
was loaded.  If no Environment had been loaded, Save will save the current
Environment under than name 'Default'.
@endnode

@node "Environment - Save As" "Environment - Save As"
 Environment - Save As

@{" Saves " link "Environment - Save"} the current Environment to disk under the name you specify.
@endnode

@node "Environment - Save Layout" "Environment - Save Layout"
 Environment - Save Layout?

This command toggles whether or not the layout of the listers and button
banks should be saved when you @{" Save " link "Environment - Save"} the environment.
@endnode

@node "Menu Editor" "Menu Editor"
 Menu Editor

The Menu Editor enables you to add, insert, duplicate, delete, edit and move
around entries in the @{" Lister Menu " link "ListerMenu"} and the @{" User Menus " link "UserMenu"}.  The
@{" Function Editor " link "Function Editor"} is called when editing an entry.

The menu editor has the following features:
  Drag & drop moves the item.
  Drag & drop with shift held down copies it.
  Tab to change the 'active list' (indicated by a dotted rectangle).
  Cursor up/down to change selection in active list.
  Cursor up/down with shift to move the selection up or down.
  Return to edit the selection in the active list.
  + to add an item.
  DEL to delete current item.
@endnode

@node "Hotkey Editor" "Hotkey Editor"
 Hotkey Editor

Each hotkey can run any standard Opus 5 function just as with buttons and
menus.  The 'System-global hotkey' option can be enabled for each hotkey.
Without this, the hotkey can be used only when an Opus 5 window is active.
However, if this is set the hotkey will be global and is accessible whether
or not an Opus 5 window is active.
@endnode

@node "Scripts Editor" "Scripts Editor"
 Scripts Editor

This allows you to attach standard Opus 5 functions to a number of events.
The scripts currently available are:

  Bad disk inserted   - triggered when you insert a non-DOS disk in any
                        floppy.
  Close buttons       - when a button bank is closed
  Close group         - when a group is closed
  Close lister        - when a lister is closed
  Disk inserted       - when a disk is inserted
  Disk removed        - when a disk is removed
  Double-click        - when you double-click on the main Opus window (but
                        not on an icon)
  Hide                - when you hide the display
  Middle double-click - when you double-click the middle button anywhere at
                        all.
  Open buttons        - when a button bank is opened
  Open group          - when a group is opened
  Open lister         - when a lister is opened
  Reveal              - when you reveal the display after hiding it
  Right double-click  - when you double-click the right button over the
                        main Opus window ONLY.
  Shutdown            - when the program quits
  Startup             - when the program is run

Some good uses for scripts would be to open a new lister for 'Disk inserted'
and display its contents, and to run the @{" Format " link "Format"} command for 'Bad disk
inserted'.
@endnode

@node "File Class Editor" "File Class Editor"
 File Class Editor

The File Class Editor selects the way in which this file type will be
recognised by the Opus 5 system.  The name field specifies the name of the
file, the ID is a shorthand way of expressing the filetype.  The Pri is the
priority of that file type, it should normally be set at 0.

The file identification definition can be altered with the add, insert and
remove gadgets.  The scripts consist of a group of match instructions linked
together with logical 'and's and 'or's.  For any more detail on the File
Class Editor please consult your Opus 5 manual.
@endnode

@node "Config Convert" "Config Convert"
 Convert version 4 configuration files

Directory Opus 5 is able to detect and convert the old configuration files
from Directory Opus 4.  Opus 5 will not convert environment files from
earlier versions.  If you have a version earlier to version 4 then you will
have to convert the files using version 4 first.

If you select 'Environment/Open' in Opus 5, and try to load an old version 4
configuration file, you will be given the option of what to convert.  The
base-name you specify will be used when creating individual files
corresponding to button banks, etc.

Opus 5 will convert your old Buttons, Menus, Filetypes, and Hotkeys.
@endnode

@node "Button Bank Editor" "Button Bank Editor"
 Button Bank Editor

The button bank editor enables you to edit a Toolbar or Custom button.  The
bank editor permits the reshaping of button banks with the Xform button and
the addition, insertion, and deletion of buttons from a button bank.

Individual buttons can be copied, cut, and erased as well as @{" Edited " link "Button Editor"}.

The 'Paint Mode' option allows you to paint @{" colours " link "Button Editor"} onto the buttons of an
entire bank.  The 'Show Clipboard' option lets you drag and drop buttons
between the different button banks on the screen and a small clipboard
window which will appear.

In the 'Appearance' section of the editor you can turn off the old-style
full borders on each button bank, and if they are off you can also set the
dragbar to be horizontal, vertical, or automatic depending on the size of
the button bank.  You can also make all of the buttons in a bank borderless,
turn off the 'dog ears' for buttons with right and middle button functions,
and make the button bank simple refresh if you wish.
@endnode

@node "Button Editor" "Button Editor"
 Button Editor

The Button editor allows the editing of the actual button.  The things that
may be edited are the button's name or icon and its @{" Colours " link "Select Colours"}.  The
functions that are called for the left, right, and middle mouse buttons, and
any popup menu functions it may have can also be @{" Edited " link "Function Editor"} from here.
@endnode

@node "Function Editor" "Function Editor"
 Function Editor

The function editor enables you to edit the function(s) performed when the
button, filetype action, menu item, script, etc. is activated.  These
functions can be AmigaDOS, Opus 5, ARexx, Script or Workbench commands.

The "{}" button allows the inclusion of parameters onto the command line of
the instruction such as the filename of the highlighted file(s).  For
built-in commands it also allows access to the command argument template.

The flags allow the custom commands to be implemented in a variety of
different manners.

The Key field will sample the keys you press as a  hotkey for this function.
If you wish to enter a hotkey combination manually, press caps-lock and type
as per normal. To erase the hotkey field, press backspace twice.

For any more details please refer to your Opus 5 Manual.
@endnode

@node "Select Colours" "Select Colours"
 Select button colours

This allows you to select the foreground and the background colours of your
button you are editing.  The selecting is a simple process of tapping the
mouse pointer on the desired colour.
@endnode

@node "Environment" "Environment"
 Environment Editor

You may adjust the following parameters of the visual display within the
Environment editor:

    @{" Backgrounds " link "Environment - Backgrounds"}
    @{" CLI Launching " link "Environment - CLI Launching"}
    @{" Desktop " link "Environment - Desktop"}
    @{" Display Mode " link "Environment - Display Mode"}
    @{" Icon Display " link "Environment - Icon Display"}
    @{" Icon Settings " link "Environment - Icon Settings"}
    @{" Lister Colours " link "Environment - Lister Colours"}
    @{" Lister Default " link "Environment - Lister Default"}
    @{" Lister Display " link "Environment - Lister Display"}
    @{" Lister Options " link "Environment - Lister Options"}
    @{" Palette " link "Environment - Palette"}
    @{" WB Emulation " link "Environment - WB Emulation"}
@endnode

@node "Environment - Backgrounds" "Environment - Backgrounds"
 Backgrounds

This allows you to define whether to use backdrop pictures on the Screen
and in listers and requesters.

Enable Backgrounds lets you turn on or off all background pictures in
opus.

You can either display background pictures using a settings file created
with the WBPattern Prefs program or directly by giving the filenames of
the images you wish to use.

Under OS2.0 and 2.1, you can only use WBPattern prefs, and only
to generate patterns, not pictures. The picture display system relies
on the Amiga Datatypes system, which is not available under OS2.0.

If the Use WBPattern Prefs flag is cleared you should specify the images
files you want to use using the set top set of gadgets.

  Desktop:
    The main Opus window uses this image.

  Window:
    Icon-mode listers and groups use this image.

  Requester:
    Opus requesters and configuration windows use this image.

Either enter filepaths in the string gadgets or use the folder button
on their left to bring up a file requester.

At the far right of each field is a gadget for a popup menu to control
the display parameters including whether each picture is tiled
(the default) or centred in the display, and the remapping used for each
picture. See your Opus Magellan manual for more detailed information.


If Use WBPattern Prefs is selected you should specify in the string
gadget below the name of a preferences file created with the WBPattern
program which came with Workbench.

To the right of the name field there is a gadget with an exclamation mark
(!) which will call the standard WBPattern preferences editor for you.
Use the editor to create the display you require, SaveAs the settings
under the name (e.g. "envarc:DOPatern.prefs"), then use this for Opus.

NOTE: The backdrop pattern will use the current Workbench pattern unless you
have entered a specific WBPrefs filename.
@endnode

@node "Environment - Desktop" "Environment - Desktop"
 Desktop

From here you can set up some features of Opus 5's desktop environment.

  The function of the main listview depends on the state of the cycle
  gadget above it.

  Hidden drives:
    The listview contains a list of all the drive icons Opus can see. If
    you wish for some of these icons to not be displayed (for instance if
    they are not AmigaDOS volumes) then simply click on their entries.

  Hidden drives (bad disks only):
    Using the listview you may selectively hide devices that have bad disks
    in them. For example, if you had four filesystems mounted on the one
    drive, you could hide all of them for bad disks except for one.


  Desktop Folder:
    This is the physical location of the drawer used by Opus to hold the
    desktop files (files which are actually copied to the desktop). By
    default this is the directory DOpus5:Desktop. You may change this
    location but we do not recommend it since it establishes connections
    outside the parent DOpus5: directory tree. If the location is changed,
    you will have to move any current files in the old desktop drawer to
    the new location before they will be noticed.


  PopUp Enabled:
    If you turn this flag on, when you drop a file onto the desktop, a
    popup menu will appear giving you a choice of several actions,
    unless Default Action (below) is not set to None.

  Default Action:
    When the Desktop popup is enabled, the default action option allows
    you to choose the action to be performed by default when you drag a
    file to the desktop. If None is set (the default), then the popup menu
    appears  as normal. However, if you set Create Left-out,
    Move to Desktop or Copy to Desktop, then that action will be performed
    without a popup menu appearing. With a default action set in this  way,
    access to the popup menu is still possible by holding down either shift
    key when you drop the file onto the desktop.
@endnode

@node "Environment - Display Mode" "Environment - Display Mode"
 Display Mode

The Screen Display Mode requester allows you to specify the mode, size and
depth of the screen.  The requester contains a list of available Display
modes.  The screen height and width fields allow you to specify screen width
and height.  You can also select a default screen font for the Opus 5
screen.
@endnode

@node "Environment - Icon Display" "Environment - Icon Display"
 Icon Display

This section allows you to configure how icons are displayed within Opus.

  Enable NewIcons:
    Turn NewIcons support on or off.

  Discourage NewIcons:
    Only shows a NewIcon image if there is no 'standard' image (i.e if
    the image is less than 5x5 in size).

  Dither Image:
    Turns on dithering for NewIcons.

  Pen Precision:
    Sets the precision for NewIcons.

    The Dither Image and Pen Precision settings affect the operation of the
    NewIcons system itself. It was necessary for Opus to have these
    settings, as version 3 of the newicons.library does not load the
    user-defined NewIcons preferences (unless the c:NewIcons patch is
    running.) Version 4 of the newicons.library reads the user preferences
    automatically, however, you can still adjust the settings through this
    Opus section as well as through the NewIconsPrefs program.

    If a change is made to any of these settings you will need to
    restart Opus for the change to become effective.

  Label Font and Colour:
    The Desktop and Windows buttons allow you to edit the font settings
    for icons on the desktop and in windows, respectively. You can change
    which font is used and how it is coloured.

@endnode

@node "Environment - Icon Settings" "Environment - Icon Settings"
 Icon Settings

This section controls various aspects of Opus's icon display routines.

  Cache icon images:
    Icon caching improves the speed of displaying icon mode and icon action
    mode listers.  However, if you find this causes problems, you may
    disable it.  This setting is only checked at Opus startup - you will
    need to quit and restart Opus after altering this setting.

  Remap icons:
    Directory Opus will, by default, remap 8 colour icons to the top and
    bottom 4 colours in the palette. This option allows you to override
    this behaviour.

  Icon Borders:
    Turns off ALL icon borders by default but can be overridden on an
    individual icon basis from the @{" Icon Information " LINK "IconInfo"} requester.

  Full Transparency:
    Makes Opus render its borderless icons with colour 0 transparent over
    the whole icon, rather than just colour 0 around the edge. This
    results in quite a large speed increase when loading borderless icons.

  Show Left-out Arrow:
    Controls whether or not you see the little arrow shown on the bottom
    left of left-out icons.

  Split Long Labels:
    If an icon's label is more than 1.5 times the width of the icon
    itself, it can be split onto multiple lines. The algorithm will only
    split labels on spaces, punctuation characters or on a capital letter.
    If there is nowhere to split the text then the label won't be split at
    all.

  Use Workbench Positions:
    Tells Opus to use the same fields in icons as the Workbench does to
    store and retrieve icon and window positioning information. If you
    snapshot icons on a disk and give the disk to an unfortunate
    Opus-less Amiga user, they will still be able to view your icons in
    the correct positions with Workbench.

  Remove Opus Icon Positions:
    Setting this option along with the Use Workbench Icon Positions flag
    enables you to move an Opus-ised system back to a Workbench position
    system without having to resnapshot all your icons. When set, Opus
    will use the Opus icon position in icons when there is one. When an
    icon is snapshotted, the Opus position will be removed, and the
    Workbench position will be saved. The next time the icon is read, it's
    the Workbench position that will be used.
@endnode

@node "Environment - Lister Colours" "Environment - Lister Colours"
 Lister Colours

This section lets you adjust lister colour settings. Each elements has an
additional custom pen which is completely separate from the standard
user/system pens. It can be configured individually for each element,
providing there are free pens available.

At the moment, the custom pen is only implemented by the free space
gauge, but the other elements will be using it in the next version.

When setting the colours for the free space gauge, the foreground colour
is used when the bar shows less than 90% full, and the background colour
is used when the bar is at 90% or above. This lets you have a warning
colour when the disk is getting full.
@endnode

@node "Environment - WB Emulation" "Environment - WB Emulation"
 WB Emulation

This allows you to enable some Workbench Application functions. 

Display AppIcons tells Opus to display all application icons in the Opus
window.  Display Tools Menu tells Opus to add any Workbench Application
Menus to a Global Tools Menu.  If you enable Move AppIcons to 'Tools' Menu
then application icons will be redirected to the tools menu instead of
appearing on the desktop.

Note that if you turn on Move AppIcons to 'Tools' Menu, you should make
sure that Display Tools Menu is also on, otherwise application icons will
be completely hidden. Also note that changing the flag only affects
AppIcons added after the change is made.

By default, Opus will display all icons representing all volumes available
in the system, including non-DOS disks.  The display of these 'bad disks'
can be turned off.
@endnode

@node "Environment - Lister Default" "Environment - Lister Default"
 Lister Default

  Default Size:
    This allows you to choose the default size to be used when a new
    Lister is opened.

  Default Format:
    This allows you to define the default lister format to be used in
    listers which have not had a custom format defined.
@endnode

@node "Environment - Lister Display" "Environment - Lister Display"
 Lister Display

  Field Titles:
    With this turned on, name mode listers have a title at the top of each
    field of the lister.  You can click on the fields in the title to
    change the sort mode of the lister, clicking again to reverse it.
    Also, the field titles can be dragged around to change their order.

  Font:
    Sets the font used in listers.

  Status Text:
    Allows you to customise the look of the lister status bar. The gadget
    on the right brings up a list of character sequences which insert
    informational values into the string.
@endnode

@node "Environment - Lister Options" "Environment - Lister Options"
 Lister Options

The following options also control the lister behaviour:

  Device List in new lister:
    If this is set, a device list will be displayed when you open a New
    lister.  If cleared, the new lister will appear blank.

  RMB Double-Click editing:
    If set, a double click of the Right Mouse Button over a name mode
    lister will activate the @{" Format Editor " link "Lister Format"}.  Otherwise, the double-click
    will be ignored by the lister.

  SimpleRefresh windows:
    If you enable this option, less memory will be used by Opus to refresh
    listers, but refreshing will be slower.

  Always use Snapshot position:
    With this flag turned on, new listers that are opened will always
    come up in the position and size they were snapshotted to, instead
    of in the last position you had them in.

  Name Mode PopUp:
    In Icon Mode and Icon Action Mode, every icon has a popup menu
    accessible via the right mouse button.  This option enables these popup
    menus when in Name Mode also.

  Drag Into Sub-Directories:
    When enabled, moving the mouse when dragging files over a directory in
    a lister (either the same lister or a different one) will highlight
    the directory name; if you release the files over that directory, the
    defined filetype action will use that sub-directory as the destination
    path rather than the path of the lister itself.

    If you have this option switched off you can always activate it by
    holding down the shift key while dragging.

    Note that this is not yet implemented when dragging icons, only files
    and directories from a name-mode lister.

    OpusFTP now also supports this function from a remote FTP directory to
    a local dir, but it is NOT supported on or between remote FTP
    directories.

  Inline Editing:
    Enables inline editing of the filename and details in name mode
    listers. The setting of the cycle gadget controls how the inline
    editing mode is activated. Left Button means that you must hold the
    left mouse button over the entry for a certain time before editing
    mode is activated. Likewise, Middle Button means that you must hold
    the middle mouse button down. Left & Middle means that both buttons
    work.
@endnode

@node "Environment - CLI Launching" "Environment - CLI Launching"
 CLI Launching

This allows you to set the title and size of the Output Window used by Opus
to display CLI tasks and associated messages.  You can also set the name of
the device to be used as the output window - this defaults to 'CON:', as well
as the default stack size which CLI tasks will be given.
@endnode

@node "Environment - Palette" "Environment - Palette"
 Palette

This displays the current colours used on screen plus any user colours
available.  The number of pens is limited by the display mode.  You can then
modify the colours of the pens by using the sliders.  You can also reset the
palette or load a standard palette preferences file as used by the Workbench
'Palette' program.
@endnode

@node "Options" "Options"
 Options editor

This enables the editing of the Options settings which provide control over
the operation of commands.  These functions and commands include:

    @{" Caching " link "Options - Caching"}
    @{" Copy " link "Options - Copy"}
    @{" Delete " link "Options - Delete"}
    @{" Hide Method " link "Options - Hide Method"}
    @{" Icons " link "Options - Icons"}
    @{" Locale " link "Options - Locale"}
    @{" Miscellaneous " link "Options - Miscellaneous"}
    @{" Priority " link "Options - Priority"}
    @{" Replace " link "Options - Replace"}
@endnode

@node "Options - Caching" "Options - Caching"
 Caching control

This enables you to set the maximum number of directories you will have
internally buffered.  If 'Disable directory caching' is selected then
directory caching is turned off.  The 'Re-read modified caches' toggle means
if the contents of a directory has changed since you last activated it, it
will then re-read the directory.
@endnode

@node "Options - Copy" "Options - Copy"
 Copy settings

This sets the controls for what happens when Opus copies files.
  These are the options and what they do:

  Update destination free space:
    When the files are finished being copied then the destination drive's
    size will be updated.

  Set source archive bit:
    When the file is copied the original version will have its archive bit
    set to true.

  Also copy source's:
    When set, these attributes of the original are to be copied as well as
    the file itself.
@endnode

@node "Options - Delete" "Options - Delete"
 Delete settings

This allows you to set when Opus should ask about @{" deleting " link "Delete"}.  The point at
where a toggle is set is where Opus will ask to confirm the request to
delete.
@endnode

@node "Options - Hide Method" "Options - Hide Method"
 Hide method

This allows you to specify and control the method Opus will use to iconify
itself.  The choices range from:

  Clock:
    This will iconify Opus to a one line clock.

  Hotkey Only:
    This will place no visual icon on screen when closed and will require
    the hotkey combination to bring it up again.

  AppIcon (Workbench Only):
    This creates a normal icon on Workbench when Opus iconifies.

  AppMenu (Workbench Only):
    This makes Opus append itself to the 'Workbench Application Tools'
    menu.

  Popkey:
    This field allows you to alter the Opus 5 hotkey.  To use the standard
    hotkey of 'lalt lshift ctrl', simply leave this field blank.

The hotkey field will sample the keys you press as the hotkey.  If you wish
to enter a hotkey combination manually, press caps-lock and type as per
normal. To erase the hotkey field, press backspace twice.
@endnode

@node "Options - Icons" "Options - Icons"
 Icon settings

This defines how Opus processes a file with associated icons or '.info'
files.  The options are:

  Perform all actions on icons:
    Anything that happens to the icon will happen to the '.info' file
    associated with it.

  Select icons automatically:
    Whenever an icon is selected the associated '.info' file is selected
    automatically.

  Trap 'More' in default tool:
    When you double-click or @{" Open " link "Icons - Open"} a project icon whose default tool is
    set to 'More', the file's contents will instead be displayed in the
    Opus 5 text viewer.
@endnode

@node "Options - Locale" "Options - Locale"
 Locale settings

This enables you to set up Opus display methods to adhere to your locale.
The different things that can be changed are:

  Date Format:
    This enables you to select which way you prefer to read dates.

  Name substitution:
    Allows the substitution of words like 'today' and 'yesterday' in the
    place of dates, if appropriate.

  12 hour clock:
    This allows you to select between a 24 or a 12 hour clock.

  Thousands separator:
    This allows you to have a separator between the hundreds and thousands
    when a number is displayed.
@endnode

@node "Options - Miscellaneous" "Options - Miscellaneous"
 Miscellaneous options

This enables you to set a few miscellaneous options.

  Mouse buttons over inactive banks:
    When this is enabled you can use the right and middle mouse buttons on
    button banks and listers without first having to activate the window
    that they use.  Also you will be able to use the left mouse button on a
    button bank without the button bank becoming active.  This will leave
    the lister you were using active.

  Quick quit:
    If you set this Opus 5 will @{" quit " link "Project - Quit"} without first asking for
    confirmation.

  Extended lister key selection:
    With this enabled you will be able to quickly find files in large
    directories even if all files begin with the same letters.  When you
    type the first letter a string gadget will appear over the lister
    toolbar enabling you to type as much of the filename as is necessary
    for it to scroll into view.  As soon as you begin any other action the
    string gadget will disappear once more.

  Filetype Sniffer:
    Enabling this gadget tells Opus to automatically run the @{" FindFiletype " link "FindFiletype"}
    command when a file with no defined filetype is double-clicked.  With
    the option turned off Opus will run the @{" SmartRead " link "SmartRead"} function to view
    the file as either text or hexadecimal.
@endnode

@node "Options - Priority" "Options - Priority"
 Priority settings

This allows you to change the task priorities of the main Opus 5 process and
of the lister processes.  You can set the priority independently for when
the process is busy and for the rest of the time.

You might need to use this, for instance, if you find a program you use at
the same time as Opus 5 is at a higher priority and is hogging the CPU,
preventing Opus 5 from working efficiently.
@endnode

@node "Options - Replace" "Options - Replace"
 Replace requester settings

This lets you customise the operation of the requester which appears when
you are copying a file over one of the same name.

  Verbose 'Replace?' requester:
    When enabled, the display will be more user-friendly - instead of
    showing the size and datestamp, you are now told what is different.

  Automatically check version:
    With this option turned on, every time you copy a file over an older
    one, Opus 5 will check the file version along with the size and
    datestamp. If it is turned off, an extra button on the replace
    requester will allow you to check the version manually.  You may need
    to turn this option off if you copy very large files that have no
    version information as looking for the version number can take some
    time.
@endnode

@node "Lister Format" "Lister Format"
 Lister Format Editor

This Editor alters the basic setup of the lister from choosing the manner in
which the files should be displayed to the way that they should be ordered.
The display window in the editor shows what features of a file will be
displayed with the feature with a tick being the sorting key of the file. To
add or remove a feature from display just drag & drop the feature in
question to the adjacent window.

There are a variety of different options:

  Entry Separation:
    This allows you to select whether directories or files are to be shown
    first in the listers, or whether they should be intermixed.

  Reverse Sorting:
    This causes the files to be displayed in the reverse order of the sort.

  Filter Icons:
    This will filter the icons so that the '.info' files won't be
    displayed.

  Hidden:
    Makes sure not to show files with the hidden bit set.

  Free Space Gauge:
    Toggles whether or not the lister has a space guage which graphically
    shows the proportion of free space on the drive. It is possible to
    set the colour for the 'bar' part of the gauge from the
    @{" Lister Colours " LINK "Environment - Lister Colours"} section.

  Inherit:
    This flag has the same effect as the padlock gadget; if turned on,
    sub-directories will inherit the format of the parent directory when
    double-clicking on them in name mode. When turned off, unless a
    directory has a format defined for it, it will use the default format.

  Show Filter:
    Declares a pattern for which all files matching it must be displayed.

  Hide Filter:
    Declares a pattern for which all files matching it are not displayed.

  Reset to Defaults:
    Restores all options for this lister to match the default
    @{" lister display " link "Environment - Lister Display"}.

  Save:
    Saves the display format for this lister so that these settings are
    always used when viewing the directory currently in the lister.

  Use:
    Applies any changes you have made to the display options for this
    lister.

  Cancel:
    Abandons any changes you have made to the display options for this
    lister.
@endnode

@node "File Types" "File Types"
 Filetype Manager

This function allows you to alter the filetypes recognised and handled by
Opus 5.  You may add, remove, rename, duplicate or @{" Edit " link "File Type Editor"} a selected
filetype at this level.
@endnode

@node "File Type Editor" "File Type Editor"
 File Type Editor

The File Type Editor has a list of a variety of different actions that can
take place to a file as well as a list of items that will appear in the
popup menu for files of this type.  To edit the function that will execute
when one of these actions occur or when a popup menu item is selected, just
click on the action and the @{" Function Editor " link "Function Editor"} will be brought up.  A default
icon can be established for this filetype by simply either dragging and
dropping the icon into the icon box or selecting the icon file using select
icon.  The manner in which Opus 5 identifies a file to be of this filetype
can be edited with the @{" Edit Class " link "File Class Editor"} button.
@endnode

@node "Lister File Count" "Lister File Count"
 This area displays a count of selected files and their combined size.  An
asterisk '*' will also be shown if any files are hidden from view for any
reason.
@endnode

@node "Lister Menu PopUp" "Lister Menu PopUp"
 This button activates the user-editable lister menu popup.
@endnode

@node "Lister Path PopUp" "Lister Path PopUp"
 This button activates the lister path popup.
@endnode

@node "Lister Status PopUp" "Lister Status PopUp"
 This button activates the lister status popup.  The display here shows what
mode the lister is in.  The various modes are:
     @{" SRCE " link "Source"}
     @{" DEST " link "Destination"}
     @{" SRCE! " link "Lister - Lock Source"}
     @{" DEST! " link "Lister - Lock Dest"}
     @{" BUSY " link "Busy"}
     @{" OFF " link "Lister - Off"}
@endnode

@node "Lister" "Lister"
This is a lister.  The lister enables you to list directories, access files,
and perform much more.  Just point your mouse to some of the icons and
objects located on the lister and press "HELP" for more details on the
functions it provides.
@endnode

@node "Program Group" "Program Group"
This is a program group.  Program groups make a handy alternative to
@{" leaving out " link "LeaveOut"} files - especially when your workbench is getting a little
cluttered.  You can make a group for a set of related programs, files, or
directories from the @{" Icons - New Group " link "Icons - New Group"} menu.  Then simply drag and drop
the icons you wish to use into the group window or onto the group icon.
@endnode

@node "Protectionbits" "Protection Bits"
Protection Bits

The protection bits are a group of flags that are stored with the file that
determine the characteristics of the file.  These flags are given one
character names.  The protection bits currently in use are HSPARWED.


  H  Hidden:
    If this flag is set, the file is not normally displayed.  This allows
    you to mark certain files as "invisible" to avoid cluttering your
    directories.  The file can still be accessed normally, and not all
    programs implement this flag.

  S  Script:
    A script file is a file containing a list of AmigaDOS commands to
    execute; it is like a simple computer program.

    This flag indicates that the file in question is a script file.

    A script file is sometimes called a batch file.

  P  Pure:
    If a program file is flagged as pure, it can be made to remain in
    memory, even when not in use, This can save a great deal of time,
    especially if the program is used a lot, as it does not have to be
    loaded from disk each time.

  A  Archive:
    This flag indicates that the file has not been changed.  If this file
    is ever written to, the A flag will be turned off.  This can be used in
    a hard disk backup program, to record which files have been backed up,
    and need not be backed up again.

  R  Readable:
    If this flag is set, the file can be accessed.

  W  Writable:
    If this flag is set, the file can be written to (i.e., more information
    can be stored in it than is already there).

  E  Executable:
    If a program file does not have this flag set, it can not be run.

  D  Deletable:
    If this flag is not set, the file can not be deleted.


These flags can be changed in a file with the @{" Protect " link "Protect"} function.
@endnode

@node "Source" "Source"
Source

A source lister is the lister that is acted upon by commands that act upon
source listers, such as @{" Copy " link "Copy"}, @{" Move " link "Move"} and @{" Rename " link "Rename"}.  It is possible to have
multiple source listers.
@endnode

@node "Destination" "Destination "
Destination

The destination lister is the lister that is acted upon by commands that
effect a destination.  Usually such things as the arrival point of @{" Moves " link "Move"}
or @{" Copies " link "Copy"}.  It is possible to have multiple destination listers.
@endnode

@node "Busy" " BUSY "
Busy

The busy mode means that the lister is processing some task so that it is
unable, at the present time, to perform other actions although it may still
be moved, resized, scrolled, or iconified.
@endnode

@node "ReReadDir" "ReReadDir"
Re-Read Directory

This re-reads the current directory and displays the current directory
listing.
@endnode

@node "PathHistory" "PathHistory"
PathHistory

This section of the menu displays all the paths that this particular Lister
has passed through.  Select it and your path will be changed to the selected
path.  This is similar to the @{" CacheList " link "CacheList"}, but the cachelist shows all paths
all the listers have passed through.  Remember if the memory used by these
lists becomes excessive a @{" FreeCaches " link "FreeCaches"} will clear the caches.
@endnode

@node "AppMenuItem" "AppMenuItem"
Application Menu Item

This button calls an application which is external to the Directory Opus 5
system.
@endnode

@remark   turn off the sun   pull the stars from the sky