Merciful 3/Merciful_Release_3.bin/software/d/data_division_docs/datadivisiondocs02.dms/datadivisiondocs02.adf/10

Text File | 1996-10-14 | 49KB | 1,226 lines

                               Chapter Nine
Commands and Custom Buttons .....................95
Scope and Focus of Buttons ......................96
Special buttons Menu ............................96
Internal Opus 5 Commands ........................97

                       Commands and Custom Buttons

 With Directory Opus 5, you can create your own custom buttons which
execute your desired commands at the click of the mouse.  Buttons are
grouped together in a window called a Button Bank.  Any given bank of
buttons may show either graphical images or text, but you may not mix
graphics and text in the one bank.  You may have as many banks open at any
one time as you desire.

 The modular design of Opus 5 means that Button Banks are fully
independent tasks and the buttons themselves are interchangeable between
different banks.  Even editing of button banks via the Button Editor is
independent of other program operations, so you do not need to stop other
activities to create, load, edit or save banks.

                             Directory Opus 5                        95

 Each button can execute an unlimited set of instructions, which may be
triggered by the action of a left, middle or right mouse click on the
custom button, or by selecting an item from the button's optional pop-up
menu.  Instructions may include any mix of AmigaDOS, Workbench, ARexx,
Script or Opus 5 commands.

 Right mouse button commands and pop-up menu commands are indicated by a
'dog-ear' in the upper right of the button.  For middle mouse button
commands, the 'dog-ear' appears on the bottom left.  This also applies to
graphical Button Banks.

 With Opus 5.5, you can now define an infinite set of pop-up menus for
each button.  This allows you to group a larger number of related
functions in one place and select the specific one when required.  Holding
down the LMB on a button displays the full list of commands attached to
that button.  Releasing the LMB over a command brings this command to the
top and makes it the default LMB command.

                        Scope and Focus of Buttons

 Many button commands act on the selected files in the current source
(SRCE) directory, or between the source and destination (DEST)
directories.  When creating and using buttons, it is very important that
you understand both what the command does, and what files and directories
it will affect.  This is known as the scope and focus of a button.

 Novice Opus 5 users can be confused when they have clicked on a custom
button and nothing happens.  Often they have no SRCE window selected!

  +-------------------------------------------------------------------+
  | Before clicking on a custom button, verify that the intended SRCE |
  | and DEST directory windows are set correctly.                     |
  +-------------------------------------------------------------------+

                           Special Buttons Menu

 As well as from the global Buttons menu, Opus 5 also provides a special
menu directly attached to each button window.  This gives quick access to
popular functions.

 *** See Fig 9-01 ***

 To access this menu, move the mouse to the button window title bar and
press the right mouse button to display the menu.  If you have 'Mouse
buttons over inactive banks' in Options / Miscellaneous disabled, you will
need to activate the Button Bank window first.

 *** See Fig 9-01 ***

    96                       Directory Opus 5

 The menu options are identical to those provided in the global Buttons
menu, except that this special menu allows you to iconify the button bank
to save space on your Opus backdrop window.

 When iconified, the button bank will have a pop-up menu which will allow
you to open the button bank again, or close it for good.  You can also re-
open it by double-clicking on the icon.

                         Internal Opus 5 Commands

 As already explained, each button can execute a set of instructions
including AmigaDOS, Workbench, ARexx, Script or internal Opus commands.
The list of internal commands which Directory Opus 5 offers for each
custom button or menu is shown below.  Each command is discussed in detail
in the following section.

                                Commands

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


                             Directory Opus 5                        97

 *     AddIcon NAME,BORDER/S,NOBORDER/S,LABEL/S,NOLABEL/S, CHANGE/S

 Adds icons to all selected entries in the active Lister.  Directory Opus
5 will automatically sense the type of file and the appropriate icon for a
drawer, tool or project.  The icons used are the current system default
icons as defined in ENV:Sys directory.  (See your AmigaDOS manual for more
details.)

 The BORDER and NOBORDER switches turn the icon border on or off.  The
LABEL and NOLABEL switches turn the (text) label on or off.  If CHANGE is
specified, the state of the borders or labels of existing icons will be
changed without creating new icons.

 AddIcon operates on all files selected in all current SRCE Listers.

  +-----------------------------------------------------------------------+
  | Since this command uses the Amiga's default icons, it may fail if the |
  | correct default icons of the required type are not available in your  |
  | ENV:SYS directory. If this happens, run the Amiga IconEdit program    |
  | to create and save a set of default icons for the various file types. |
  | For more information on the creation and editing of default icons,    |
  | please consult your AmigaDOS user manual.                             |
  +-----------------------------------------------------------------------+
 *      Alarm

 This command compliments the Beep command and produces a short siren
sound effect rather than a simple beep.  Use this to provide a more
noticeable or urgent warning sound than would be indicated by a simple
beep.

 See Also: Beep, Flash

 *      All

 Selects all entries in any and all of the SRCE or selected Listers

 See Also: None,Toggle, Reselect, Select

    98                       Directory Opus 5

 *      AnsiRead        NAME/F

 Invokes the Opus viewer in ANSI mode which interprets and displays any
special ANSI control sequences.

See Also:  HexRead, Read, SmartRead

 *      Assign

 Allows you to create AmigaDOS assignments for the path as shown in the
Directory Path gadget at the bottom of the active SRCE Lister.  A
requester is opened with a set of buttons for :-

 *** See Fig 9-02 ***

 Assign:  Create an assign for this directory with the specified name.

(Default)

 Add:  Add this directory to the existing assign with the specified name.

 Path:  Add the path of this directory to the existing assign with the
        specified name.

 Defer:  Create a deferred assign for this directory which will become
         active only when first accessed.

 Abort:  Abort the assign operation.

 For a more details discussion, refer to your AmigaDOS manual

                             Directory Opus 5                        99

 *      Beep

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

 For instance, you could create a Diskcopy button to read:-

                Command         DiskCopy
                Command         Beep

 See Also: Alarm, Flash, FinishSection

 *      CacheList               NEW/F

 Displays a list of all the currently buffered directories.  Click on one
of the displayed buffers to jump to that buffer immediately, rather than
having to locate it manually.

 If there is no current SRCE Lister, a new Lister will be opened.  If the
NEW  switch is used, a new Lister will always be opened.

 See Also: DeviceList

 *      CheckFit

 Tests whether the selected files will fit on the destination drive.  A
requester displays 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 directories to the first DEST directory
ONLY.

 *      CleanUp

 An Opus housekeeping command.  It examines the internal 'position-info'
file and remove references to any directories or left-out icons which no
longer exist on your system.  References will only be removed if the
parent volume is mounted and available on your system so entries from
removable media will be preserved.

    100                      Directory Opus 5

 *      CLI

 This is a new debugging command added for Opus 5.5 for the more advanced
users.  It opens up a Command Line Interface or Shell type window where
you may enter internal Opus commands and ARexx functions directly.   Such
commands operate on highlighted files and between SRC and DEST Listers
just as if you had them attached to a button or menu.  The CLI is useful
to test Opus commands or for quickly entering Opus commands which you have
not set up in a button or menu. Type 'Help' in the window for more
information.

 *      CloseButtons    NAME, ALL/S

 This command closes the current button bank, a named button bank, or all
button banks.  CloseButtons     closes the bank from which the function was
launched.  CloseButtons <NAME>  closes a named bank and CloseButtons ALL
closes all button banks

 See Also: LoadButtons

 *      Comment         NAME, COMMENT/F, RECURSE/S

 Adds or edits the comment field of all selected entries in the Lister.
The maximum length of a comment is 79 characters.  The RECURSE switch
enables recursive access to any files in selected subdirectories, subject
to the global Recursive Filter.

 *      Configure

 Displays the Lister Format Editor for the current SRCE Lister.

 *      Confirm  TEXT/A

 Displays a simple requester showing your chosen TEXT and presenting the
user with the choice of 'Ok' and 'Cancel' buttons.  If the user selects
the 'Cancel' button the Command script will be terminated at this point.

                             Directory Opus 5                        101

 *      Copy            NAME, TO, QUIET/S, UPDATE/S

 Copies the selected file(s) from the SRCE directory to the DEST
directory.

 If any directories are selected to be copied, the global setting of the
Recursive Filter will determine which files are copied.  See global menus
Settings/Recursive Filter for more details.

 If the UPDATE switch is specified, only files which do not already exist
will be copied.

 If multiple SRCE or multiple DEST directories are selected, the copy
command will copy all selected items from the SRCE directories to all the
DEST directories in turn.

 *      CopyAs  NAME, NEWNAME, TO, QUIET/S

 Copies the selected file(s) from the SRCE directory to the DEST directory
using the new name that you specify.  Wildcards can be used here; see the
Rename command for more details.  If any directories are selected to copy,
the Recursive Filter determines which files will be copied.

 Copies multiple SRCE to multiple DEST directories if more than one is
selected.

 *      CreateFiletype

 Invokes the Filetype Creator which can be very useful for automatically
making Opus Filetypes for unknown files, especially if you do not know
much about file formats.  For detailed information on the Filetype
Creator, see page 152.

 See Also: FindFiletype

 *      Datestamp       NAME, RECURSE/S, DATE/F

 Allows you to change the datestamp of the selected files and directories
in the active Lister.  If directories are selected, you will be given to
option to modify the datestamps of the files within them.

    102                      Directory Opus 5

 The RECURSE switch enables recursive access to any selected files in
subdirectories, subject to the global Recursive Filter.

 *** See Fig 9-03 ***

 For each entry, you will be presented with a requester.  To set the
datestamp of the file to the current date and time, simply press return.
Otherwise, enter the date and time you want.

 Choose the 'OK' button, or press RETURN, to set the datestamp one file at
a time.  To set the datestamp of all selected entries at once, select the
'All' button from the requester.

 *      Delete  NAME, QUIET/S

 Deletes all the selected entries in ALL current SRCE Listers.

 *** See Fig 9-04 ***

 Be careful with this! It is easy to wipe out valuable data if you are
careless.  For safety, Directory Opus 5's default configuration displays a
requester before deleting files.  Nevertheless, you should always double
check the selected files before clicking any button which uses this
command.

 The Delete command works on ALL SRCE Listers in turn.

 *      DeviceList  NEW/S, FULL/S, BRIEF/S

 Displays the list of all devices, volumes and assigned directories in the
current SRCE Lister.  If the FULL switch is added, the list of Assigns is

                             Directory Opus 5                        103

expanded to show the full path of the assigned volumes plus any multi-
directory assigns.  Alternatively, if the BRIEF switch is added, only the
devices will be shown.

 If there is no current SRCE Lister, a new Lister will be opened.  A new
Lister will always be opened if the NEW switch is specified.

 When the device list is in Icon or Icon Action mode, you can delete and
rename assigns using the icon menu.

 See Also: CacheList

 *      DiskCopy

 Invokes the Opus 5 Diskcopy Requester allowing you to select the source
and destination drives and parameters for copying disks.  (See page 185.)

 *      DiskInfo

 Displays information on the parent disk of the current SRCE Lister.  This
command works only in a Lister, it does not work on a selected disk icon.
For icons use the global menu item Icons/Disk Information.

 This command works on the active SRCE Lister ONLY.

 *      DoubleClick     NAME/F
 *      DragNDrop       NAME/F

 Execute the defined action for either DoubleClick or DragNDrop as defined
in the Opus filetype for files of the selected type.  ( See Filetypes on
page 139 for details.)

 Commands work on all files selected in all current SRCE Listers.

 *      Duplicate       NAME, NEWNAME, QUIET/S

 Makes a copy of selected entries in the same directory, but with
different names.

    104                      Directory Opus 5

 *** See Fig 9-05 ***

 A requester will appear for each entry, asking for the new name.
Wildcards can be used here; see the Rename command for more details.

 The Duplicate command works on ALL SRCE Listers.

 *      Encrypt    NAME, TO, PASSWORD, QUIET/S

 Have you ever had files that you wanted to encrypt so that only people
who knew the password could understand them?  This command allows you to
do just that.  It will encrypt all selected files, using the password that
you enter, with a complex algorithm that most people will find impossible
to work out.  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 in the
destination directory.

 *** See Fig 9-06 ***

 To decrypt a previously encrypted file, you should enter the same
password and click on the Decrypt files checkbox, or precede the password
with a minus sign.  For example, to decrypt files encrypted with the
password 'SMEG', select the files, choose the encrypt command and enter '-
SMEG' as the password.

 Encrypt operates on all files selected in all current SRCE Listers.

                             Directory Opus 5                        105

 *      FindFile

 Searches all selected subdirectories in all SRCE Listers for a specified
file or files.  A requester will appear asking for the pattern to search
for.  You can use full AmigaDOS pattern matching for searches.

 If a file matching the pattern is found, you may enter the directory
containing it, or to continue the search.  If you enter the directory,
all matching entries will be highlighted.

 *      FindFiletype

 This command invokes the Filetype Finder which can be used in finding,
installing, and creating Filetypes for the selected files.  For details,
see the FileType Creator on page 152.

 *** See Fig 9-07 ***

 *      FinishSection

 Forces any preceding programs (AmigaDOS, Workbench, Batch or ARexx) to
finish executing before carrying on to the next command.  Note that the
next command need not be an Opus command; it is just more likely that it
will be one.

 For instance, to add a beep to the end of the LHArc list Filetype
command, you would change the command list to read:-

    AmigaDOS  LHARc  v  {f}
    Command FinishSection
    Command Beep

    106                      Directory Opus 5

 *      Flash

 This command has the same uses as the Beep command.  It is different in
that it calls the system DisplayBeep function so that it will flash the
display and/or produce a beep or sampled sound as defined by the Sound
preferences program.

See Also: Alarm, Beep

 *      Format  DRIVE/F

 Allows you to format a new disk.  All new disks need to be formatted
before the computer can write to them.

 Without arguments, the command will display the Opus 5 Format Requester
allowing you to choose the disk to format and other parameters.  (See page
187.)

 *      FreeCaches

 Clears all the internally cached directory buffers which are not
currently displayed and frees all unused memory.  If you are running a bit
low on memory, this is a good way to free memory quickly.

 If your system uses WB 3.0 or higher, Opus 5 will install its own
internal low memory handler which will flush all unseen buffers
automatically if required under low memory conditions.

 *      GetSizes        FORCE/S

 Causes any selected subdirectories in ALL SRCE Listers to be scanned to
calculate the total size, in bytes, of all files contained in the
subdirectory.  Once scanned, the sizes of the subdirectory will be
displayed in the Lister.  It 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 a subdirectory has been previously scanned, it will not be rescanned
when you use the GetSizes command unless you use the FORCE switch.

                             Directory Opus 5                        107

 GetSizes only checks the SRC Lister.  If you wish to check if the
selected files would fit on the DEST, use the CheckFit command.

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

 GetSizes works on ALL SRCE Listers in turn.

See Also: ClearSizes, CheckFit

 *      HexRead         NAME/F

 Reads and displays the selected files in the same way as Read, except in
hexadecimal format.  This allows you to view binary files and other files
containing non-text characters.

 *** See Fig 9-08 ***

 Shown above is an example of the Hex Viewer's output.  The first value is
the offset, displayed in hex.  This is the offset position, in bytes, from
the start of the file.  The next four values are each a four-byte long-
word, with the actual ASCII representation at the end.  Any non-text
characters are shown with a period ('.') character.

See Also: Read, AnsiRead, SmartRead.

    108                      Directory Opus 5

 *      Hide

 The hide command iconifies Opus 5.  It has the same effect as selecting
Opus / Hide from the global menus.

 *      IconInfo        NAME/F

 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.  With this command, you may select either
the '.info' files themselves or the actual parent files or directories to
which the icons refer.

 *** See Fig 9-09 ***

 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.  If you
click on the icon imagery with the left mouse button, any alternative
imagery will be displayed if it exists.  The information displayed for
each icon type is listed below.

 Once you have made the desired changes to the icon, the Save button will
save the changes to disk.  The Cancel button will exit without modifying
the icon on disk.

 Drawer icon:  For a drawer icon, you may edit the drawer's protection
               bits, comment and tool types.  The date of the last
               modification of the drawer is also displayed.

 Project icon:  For a project icon, you may edit the project's stack size,
                default tool and tool types.  Also displayed are the size
                of the project in bytes and blocks, and the last
                modification date.

                             Directory Opus 5                        109

 Tool icon:  For a tool icon, you may edit the tool's protection bits,
             stack size, comment and tool types.  Also displayed are the
             size of the tool in bytes and blocks, and the last
             modification date.

 Disk icon:  For a disk icon, you may edit the disk's Default Tool.
             Displayed are the total number of blocks, and the number of
             blocks used and free.  The block size, creation date,
             filesystem type, and read/write status are also displayed.

 Trashcan icon:  For a trashcan icon, you may edit the trashcan's
                 protection bits, comment and tool types.  The date of the
                 last modification of the trashcan is also displayed.

 Group icon:  For a group icon, you may edit the group's comment and Tool
              Types.  Also displayed is the last modification date.

 Protection bits:  (where appropriate) are modified in the same way as
                   with the Protect command, except that the Hidden and
                   Pure bits are not accessible.

 Tool types:  (where appropriate) are modified in the same way as from
              Workbench.  To edit an existing Tool Type, simply select it,
              and press RETURN when you have modified it.  To create a new
              Tool Type, select the New button.  To delete an existing
              Tool Type, select it and then select the Delete button.

 The IconInfo requester allows you to drop other icons on it to replace
the imagery of the icon being edited.  Clicking on any of the Tool Types
toggles its state.

 Icon Borders and Icon Name

 New for Opus 5.5 is a special custom pop-up menu for the IconInfo
requester, just press the RMB when over the IconInfo requester.  The two
options allow you to turn off the icon border  and turn off the display of
the name shown underneath the icon.

    110                      Directory Opus 5

 If you are running Workbench version OS3.0 or later and wish to use a
third party replacement for the Workbench Information function, you can
set the 'DOpus/UseWBInfo' environment variable, and Opus 5 will call the
OS WBInfo() routine for icon information (this may only work if you have
Workbench running).  Use this with patches like SwazInfo.

 *      Join

 This command opens the Join Requester showing a list of the files that
were selected in the SRCE directory.  From the buttons, you may add and
remove files to or from this list, clear the list, or rearrange the order
of the files to be joined by moving individual files up and down in the
list.  Choose the destination directory, which defaults to the current
DEST directory if one is present, and press the Join button.  You will
then be prompted for a filename for the new file.

 *** See Fig 9-10 ***

 See Also: Split

 *      LeaveOut        NAME/F

 Places the currently selected files on the Opus 5 Main Window and
permanently leaves them out for easy access.

 The command works on all selected entries (files or directories)  in all
current SRCE Listers.

                             Directory Opus 5                        111

 *      LoadButtons                     NAME/F
 *      LoadEnvironment                 NAME/F
 *      LoadOptions                     NAME/F

 These three commands take a filename as an argument and load the Opus 5
component files as described.

 LoadEnvironment and LoadOptions 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 either DOpus5:Buttons/
or DOpus5:Environment/ or DOpus5:Settings/ for the specified file.  If a
full pathname is given, the command will use that pathname instead.

 *      Makedir NAME, NOICON/S, SELECT/S, NEW/S, READ/S

 Allows you to create a new subdirectory in the SRCE directory window; its
name is limited to 30 characters.

 *** See Fig 9-11 ***

 From the requester, you can choose whether to create an icon along 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/Create Icons? menu.  The name of the directory is limited to 25
characters if Create Icons is enabled.  The newly created directory will
always be scrolled into view for further use when in Name mode.

 If the optional NAME is used, the command will not ask for the directory
name, but will make it immediately in the current SRCE directory.

 If the optional NOICON switch is used, the directory will be made without
an associated '.info' file.

    112                      Directory Opus 5

 The SELECT switch will cause the newly created directory to be selected
immediately, and the READ switch will cause it to be read into a new
Lister.

 MakeDir works on the first SRCE or current Lister ONLY.

 *      MakeLink        NAME, TO, QUIET/S

 This command creates a HARD link to files and directories from SRC to
DEST.  In essence, it is similar to the Copy command but creates an Amiga
link file in the DEST instead of copying the file itself.  (See the
AmigaDos manual for more information on links.)

 By a limitation of the Amiga filesystem, hard links are only supported to
files and directories on the same volume.  Soft links are not supported by
Opus 5 and cannot be created with this command.

 To distinguish them from plain files and directories, links are displayed
in bold in Listers in name mode.  In icon mode, they have a little 'arrow'
image superimposed on them to indicate that they are links.  The same
image is shown on any icons which have been left-out.

 Makelinks works from multiple SRCE to multiple DEST directories if more
than one is selected.

 *      MakeLinkAs      NAME, NEWNAME, TO, QUIET/S

 Performs the same command as MakeLink but allows you to give each entry a
new name in the destination directory.  Wildcards can be used here; see
the Rename command for more details.

 *** See Fig 9-12 ***

                             Directory Opus 5                        113

 MakelinkAs works from multiple SRCE to multiple DEST directories if more
than one is selected.

 *      Move            NAME, TO, QUIET/S

 Moves all selected entries from the SRCE directory to the DEST directory.
The entry will no longer exist in its original place.  If any directories
are selected to move, the Recursive 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 command.  On different devices, Copy and Delete commands are used.

 Move acts to move files to a single destination ONLY.

 See Also: MoveAs, Copy, CopyAs

  +-----------------------------------------------------------------------+
  | Be careful with this command!  Opus 5 will delete the file if you are |
  | moving it to a different device.                                      |
  +-----------------------------------------------------------------------+

 *      MoveAs  NAME, NEWNAME, TO, QUIET/S

 Performs the same command as Move, but allows you to give each entry a
new name before it is moved.  Wildcards can be used here; see the Rename
command for more details.

 MoveAs acts to move files to single destination ONLY.

 See Also: Move, Copy, CopyAs

 *      None

 Deselects all entries in all the SRCE directory windows.

 See Also: All, Toggle, Select, Reselect

 *      Parent

 Reads and displays the parent directory of the current directory open in
the SRCE Lister.  If the parent directory is contained in Opus 5's cached
buffer list, it will be displayed without re-reading it.  The command is

    114                      Directory Opus 5

assigned to '/' and '?' keys in Listers.  The shifted '?' key opens a new
Lister for the parent.

 When the current directory is an assignment, for example, C:, the
assignment will be expanded to the full path (Workbench:C), whereby the
parent command will move to the parent directory (Workbench:) of the
assigned directory.

 This command acts on the first SRCE directory only.

 *      Play            NAME, QUIET/S

 Allows you to listen to sound files.  This command plays IFF 8SVX format
sound files, raw data files, and a limited set of SoundTracker type MOD
files.  It will also play other sound formats via the datatypes system of
OS3.0 and higher.  Unless you have specified the QUIET option, A small
requester will appear while the sound is playing, showing the name, type
of sound file, and playing time.  To abort a sound before it has finished
playing, click the 'Abort' button in this requester, or click the 'Next'
button to skip to the next sound.

 *** See Fig 9-13 ***

 Because of some deficiencies in the OS datatypes system, Opus sometimes
cannot tell 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.

  +--------------------------------------------------------------------+
  | Due to the explosion in the variety of sound module formats, e.g.  |
  | Star/Sound/Noise/ProTracker, Med, OctaMed, Octalizer, and Med with |
  | MIDI modules, Opus 5 cannot play all such sound formats. To play   |
  | these formats, we recommended that you set up a button to call one |
  | of the many excellent sound players currently available.           |
  | (DeliTracker is an excellent example and can be readily obtained   |
  | from AmiNet.)                                                      |
  +--------------------------------------------------------------------+

                             Directory Opus 5                        115

 *      Protect NAME, RECURSE/S, SET=+/K, CLEAR=-/K

 Modify the protection bits of the selected files and directories in the
active directory window.  When you select directories, you will be 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.  This is described in greater detail later.

 *** See Fig 9-14 ***

 The RECURSE switch enables recursive access to any selected files in
subdirectories, subject to the global Recursive Filter .

 Protect applies to all selected files in all the current SRCE Listers.

 The Protection Requester allows you to change the protection bits of a
file or subdirectory.  The protection bits are a group of flags stored
with the file, that determine the characteristics of the file.  These
flags are given single 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 ("made resident"), even when not in use.  This can

    116                      Directory Opus 5

           save a great deal of time, especially if the program is used
           often, since 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 cleared.
              This flag is often used by hard disk backup programs to
              record which files have not been changed and do not need to
              be backed up again.

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

 W  Writeable:  If this flag is set, the file can be written to (ie, 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  Deleteable:  If this flag is not set, the file can not be deleted.

 The Protection Requester shows the current file to be modified and the
protection bits currently set.  Underneath are two rows of buttons
corresponding to the protection bits which you may wish to set or clear.
When a button is highlighted, it means that the bit will be cleared or set
as shown when you click the 'OK' button.

 The bottom of the requester gives you buttons to chose the action
required for this specific file.

 OK:  Causes the current file's protection bits to be set as indicated in
      the display.

 All:  Causes all selected files to be set, without additional prompting,
       as indicated in the display.

 Skip:  Skips over the current file and moves on to the next selected file
        in sequence.

 Abort:  Aborts the Protect command.

                             Directory Opus 5                        117

 *      Print           NAME/F

 Prints the selected files from all the current SRCE directories.  It
first displays the Opus 5 Print Requester which allows full control over
print formatting.

 New for Opus 5.5, the Print routine automatically prints a form feed
after every file.  See page 189 for more details of the Print Requester.

 *      PrintDir

 Print the current directory list shown in the SRCE Lister.  The directory
will be printed as currently displayed.  To change the format of the
print-out you must edit the Lister format first.  PrintDir works via the
Print Requester, giving control over print formatting.

 PrintDir operates on the current SRCE Lister ONLY.

 *      Quit            FORCE/S

 The Quit command will quit Opus 5, first asking for confirmation unless
you have set Quick Quit in the Options / Miscellaneous settings.  With the
FORCE switch, Opus will always quit without asking for confirmation.

 *      Read            NAME/F

 Displays the Opus 5 text reader so you may read selected files.  The name
of the file is displayed in the viewer window's title bar.  Since the
viewer is an independent program with its own window, you may open as many
viewers to show as many different files as you wish at any one time.

 The Opus 5 viewer provides a number of options from its menu selections.
These include search and print capabilities and are discussed in detail on
page 192.

 Read operates on the current SRCE directory ONLY.

See Also: AnsiRead, HexRead, SmartRead

    118                      Directory Opus 5

 *      Rename

 Allows you to give new names to all selected entries in the currently
selected SRCE 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.

 *** See Fig 9-15 ***

 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 an '*'.

 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 of
any entries with the '.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 Listers in turn.

 *      Reselect

 The Reselect command causes all entries in all SRCE directories which
were deselected by the operation of the previous command to be reselected.

                             Directory Opus 5                        119

The Reselect command is assigned to the '\' key in Listers.

 See Also: Select, All, None, Toggle

 *      Reveal

 This command causes Opus 5 to deiconify if it has been iconified.  It
will also bring the Opus 5 screen to the front or send it to the back if
it is already the frontmost screen.  It is equivalent to pressing the hot
key combination (by default,  Ctrl + left Shift + left Alt).

 *      Root

 Reads and displays the root directory of the SRCE Lister.  As with the
Parent command, the buffer list will be searched before the parent
directory is re-read.

 When the current directory is an assigned directory, the Root command
will display the root drive of the assigned directory.  When the current
directory is a subdirectory to an assigned directory, the Root command
will display the assigned directory.  It is assigned to the ':' and ';'
keys in Listers.

 This command acts on the first SRCE directory only.

 See Also: Parent

 *      Run             NAME/F

 Runs each selected file in turn, providing that the file is an executable
program.  The action 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).

  +----------------------------------------------------------------------+
  | Directory Opus 5 does not provide an 'Execute' command.  This        |
  | function is handled by the Run command which functions in the same   |
  | manner as the AmigaDOS 'run' command. If a file has the 's' (script) |
  | bit set, the run command will execute it as a script.                |
  +----------------------------------------------------------------------+

    120                      Directory Opus 5

 *      ScanDir PATH,NEW/S, MODE/K, SHOWALL/S

 With no arguments, re-reads the current directory in the first SRCE
Lister.  If you specify a path, that path will be read into the current
SRCE Lister.  If there is no current SRCE, it will open a new Lister.  If
the NEW switch is used, it will always open a new Lister.  You may specify
the display mode with MODE=ICON, ACTION or NAME, otherwise the new Lister
will open using the system default as defined by the settings of the
global Lister/ViewAs menu, unless overridden by a stored snapshot of this
path.  The SHOWALL switch will cause files without icons to be visible
when in an icon mode.

 *      Search

 Searches the contents of all selected files in all SRCE Listers, and the
files within selected directories, for a specified string.  A requester
will appear, asking for the search string.  There are also several options
available within the requester.

 *** See Fig 9-16 ***

 Case insensitive:  When checked, any upper and lower case letters are
                    treated as the same.

 Wildcard search:  When checked, you can use a question mark (?) character
                   as a limited wildcard, to mean "match any character".

 Match whole words:  When checked, the string you enter must be matched in
                     a whole word (if the string is embedded within a
                     longer string it will not be matched).

 You can also specify how the results of the search are presented to you.

                             Directory Opus 5                        121

 Ask:  If a match is found, Opus 5 will ask whether you wish to read the
       file.  If selected to do so, the text viewer will be opened and the
       file will be read automatically.

 Leave selected:  If enabled, any files that contain the matching string
                  will be left highlighted.  All files that did not match
                  will be deselected, enabling you to see quickly the
                  files that contained a match.

 Output results:  If enabled, the names of files that contained the
                  matching string will be written to a temporary file.
                  Once the search has finished, this temporary file will
                  be displayed in the text viewer.

 *      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

 *** See Fig 9-17 ***

    122                      Directory Opus 5

 When called with no arguments, Select displays a requester allowing you
to specify a pattern to match files in the current SRCE 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.

 The selection requester may be used in simple or complex mode as shown
above.

 See Also: All, None, Toggle, Reselect

 *      Set

 The Set command allows you to set certain things regarding the current
Lister or the operation of the current function.

 Set Output <handle> - allows you to define the output handle for the
                       lifetime of this function where <handle> is CON: or
                       a filename etc.

 Set Sort <method> - changes the sort method for the current source Lister
                     where <method> is either NAME, SIZE, DATE, PROTECTION,
                     COMMENT, FILETYPE, VERSION, OWNER, GROUP, or NETPROT
                     (for access).

 Set Display <items> - changes the display items (same options as Set Sort
                       above).

 Set Separate <method> - changes the file/directory separation where
                         <method> is either MIX, DIRSFIRST or FILESFIRST.

 Set Hide <pattern>    - changes the hide pattern.

 Set Show <pattern>    - changes the show pattern.

                             Directory Opus 5                        123

 Set Flags <flags>     - sets various flags of REVERSE, NOICONS, or HIDDEN.

 The 'Set Flags' command allows you to add and subtract flags.  For
example, "Set Flags +hidden -noicons" sets the hidden flag, clears the
noicons flag, and leaves all other flags untouched.  The state of a given
flag can be toggled by using the '/flag' command, e.g. Set Flags /hidden

 Set ToolBar <name>  - allows you to change a Lister's toolbar.

 Set Mode <mode>     - sets mode to NAME, ICON, or ACTION, with or without
                       SHOWALL switch.

 Set Source          - sets Lister into source mode.

 Set Dest            - sets Lister into destination mode.

 Set lock [on|off]   - locks or unlocks Lister as SRCE/DEST.

 Set off              - turns Lister off.

 As with other Opus commands, the Set command and options are not case
sensitive.

 *      Show            NAME/F

 Displays IFF ILBM pictures, brushes and animations.  It will also display
other picture formats via the datatypes system of OS3.0 and higher.

 *** See Fig 9-18 ***

    124                      Directory Opus 5

 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 not in IFF format, but in a format
for which a datatype has been installed, the picture will be displayed by
that datatype.

 You may scroll around the image by moving the mouse pointer and the
following actions or keys can be used when viewing a picture or
animation:-

 Space, Help or P for Help and Print Requester,
 Esc or RMB to abort,
 LMB to deselect this picture and view the next,
 Q to view the next image without deselecting this one,
 Del to view the next image and mark this one for deletion.

 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 will be automatically launched on them (you are
given the usual warning first).

 The Show command will use its own IFF code in preference to datatypes
IFF, since datatypes can be slower and have more problems.  If you wish to
force Opus to use datatypes first, set the Opus environment variable
with:-

                setenv dopus/ShowUseDatatypesFirst

                             Directory Opus 5                        125

 *      SmartRead       NAME/F

 Invokes the Opus 5 reader program in either text, ANSI or HEX mode
according to the type of file selected.  As with the read command, if
multiple files are selected, they will be displayed in sequence.  Pressing
ESC will terminate the reading of the sequence.  See page 192 for more
information regarding the reader.

 See Also: AnsiRead, Read, HexRead

 *      Split

 Splits files into smaller chunks.  It opens a requester for you to pick
the file to split and the destination directory in which to put the parts.
You may choose the size of the chunks into which to split the file from
preset values optimised for Double Density floppy disk size, High Density
disk size, Double Density MS-DOS disk size, High Density MS-DOS disk size,
or a custom size of your choice.  Size is measured in kilobytes.  You must
also provide a stem name for the output files to which .000, .0001, etc
will be added.

 *** See Fig 9-19 ***

 If the destination directory is a floppy disk (either a trackdisk.device
or a mfm.device disk), you will be prompted automatically for a new disk
to be inserted as necessary.

 Split works on ALL SRCE Listers in turn.

    126                      Directory Opus 5

 *      Toggle

 Causes selected entries in all SRCE directories to be deselected and
deselected entries to be selected.  This command is often used as a
complementary right mouse button action for a button using the All
command.  The right mouse button would then toggle or reverse the state of
all entries.

 See Also: All, None, Select, Reselect.

 *      User1, User2, User 3, User 4            NAME/F

 These commands invoke the four user definable commands associated with
your user defined Opus Filetypes.

 For example, with the LHA Filetype supplied with Opus 5, the User1
command is defined to extract files from the archive.  So, selecting an
LHA file and pressing a button with the command, User1, would reference
the Filetype, obtain the command and extract the archive.

                             Directory Opus 5                        127

                    This page is intentionally left blank

    128                      Directory Opus 5