The Fred Fish Collection 1.5/ffcollection-1-5-1992-11.iso/ff_disks/200-299/ff297.lzh/SuperMenu/AmigaDOS.HELP

Text File | 1989-12-29 | 32KB | 1,095 lines

*:ADDBUFFERS
Format:     ADDBUFFERS <drive>: <nn>

Template:   ADDBUFFERS "DRIVE/A,BUFFERS/A"

Purpose:    To command the file system to add cache buffers.

Path:       C:ADDBUFFERS

Specification:

ADDBUFFERS adds <nn> buffers to the list of sector caches for <drive>. When
using the standard file system, additional buffers can make disk access
significantly faster. However, each additional buffer reduces memory by
approximately 500 bytes. As a general rule, only add 25-30 buffers. Disk
access time does not really increase by adding more than 25 or 30; you would
also be using up valuable memory.

When using the FastFileSystem with a hard drive, adding additional buffers
always speeds up disk access. The recommended number of additional buffers
varies depending on how much extra memory is available.

Example:

1> ADDBUFFERS df1: 25

Adds 24 buffers to the sector caches for disk drive df1:.
*:ASK
Format:     ASK <prompt>

Template:   ASK "PROMPT/A"

Purpose:    To obtain user input when executing a script file.

Path:       C:ASK

Specification:

ASK writes the <prompt> string to the current output stream, then waits for
the user's keyboard input. Valid responses are Y (yes), N (no), and RETURN
(same as no). ASK then sets the condition flag to 5 (= WARN) is a YES
response was typed, and 0 if a NO response was typed. This command is
normally only useful in script files.

See also:   IF, EXECUTE
*:ASSIGN
Format:     ASSIGN [[<name>:] <dir>] [LIST][EXISTS][REMOVE]

Template:   ASSIGN "NAME,DIR,LIST/S,EXISTS/S,REMOVE/S"

Purpose:    To assign a logical device name to a file system directory.

Path:       C:ASSIGN

Specification:

With Version 1.3, ASSIGN will now print device names with more than 3 letters
properly. If the LIST keyword is given along with a logical device name,
ASSIGN will search the ASSIGN list for that name and remove it from the list.

If the EXISTS keyword is given along with a logical device name, ASSIGN will
search the ASSIGN list for that name, and display the device and the
directory assigned to the device. If the device is not found, the condition
flag is set to WARN.

The REMOVE option disconnects a volume or device from the list of mounted
devices. It does not free up resources; it merely removes the name from the
list. THIS OPTION IS PRIMARILY USED DURING SOFTWARE DEVELOPMENT. CARELESS
USE OF THIS OPTION MAY CAUSE A GURU FAILURE.

Examples:

1> ASSIGN fonts: EXISTS
FONTS: Workbench 1.3:fonts

1> ASSIGN fonts: LIST
Volumes:
RAM Disk [Mounted]

Directories:
CLIPS:      RAM DISK:clipboards
ENV:        RAM DISK:env
T:          RAM DISK:t
S:          Workbench 1.3:s
L:          Workbench 1.3:l
C:          Workbench 1.3:c
DEVS:       Workbench 1.3:devs
LIBS:       Workbench 1.3:libs
SYS:        Workbench 1.3:sys

Devices:
SPEAK NEWCON DF2 DF0 PRT
PAR SER RAW CON RAM

Note that the assignment "FONTS:Workbench 1.3:fonts" has been removed from
the ASSIGN list.
*:AVAIL
Format:     AVAIL [CHIP|FAST|TOTAL]

Template:   AVAIL "CHIP/S,FAST/S,TOTAL/S"

Purpose:    To report the amount of available CHIP and FAST memory.

Path:       C:AVAIL

Specification:

The AVAIL command gives a summary of the system RAM memory, both CHIP and
FAST. For each memory type, AVAIL reports the total amount, how much is
available, how much is currently in use, and the largest contiguous memory
block not yet allocated.

By using the CHIP, FAST, and/or TOTAL options, AVAIL will display only the
number of free bytes of CHIP, FAST or TOTAL RAM available, instead of the
complete summary. This value can be used for comparisons in scripts.

Examples:

1> AVAIL
Type     Available   In-Use   Maximum  Largest
chip     233592      282272    515864    76792
fast     341384      182896    524280   197360
total    574976      465168   1040144   197360

1> AVAIL CHIP
233592

See Also: EXECUTE, IF
*:BINDDRIVERS
Format:     BINDDRIVERS

Template:   BINDDRIVERS

Purpose:    To bind device drivers to hardware.

Path:       C:BINDDRIVERS

Specifications:

BINDDRIVERS is normally part of a startup sequence. It is used to bind device
drivers found in the SYS:Expansion directory to add-on hardware that has been
automatically configured by the expansion library. What this means, is that
if drivers for expansion hardware are in the Expansion drawer, the hardware
will be configured automatically when the system is booted.
*:BREAK
Format:     BREAK <process> [ALL|C|D|E|F]

Template:   BREAK "PROCESS/A,ALL/S,C/S,D/S,E/S,F/S"

Purpose:    To set attention flags in the specified process.

Path:       C:BREAK
*:CD
Format:     CD <directory>

Template:   CD "DIR"

Purpose:    To set, change, or list the current directory.

Path:       C:CD
*:CHANGETASKPRI
Format:     CHANGETASKPRI <priority>[<process>]

Template:   CHANGETASKPRI "PRIORITY/A,PROCESS/K"

Purpose:    To change the priority of processes started from the CLI.

Path:       C:CHANGETASKPRI

Specification:

Since the Amiga is a multitasking machine, it uses priority numbers to
determine which tasks it should attend to and in which order. Normally, most
tasks have a priority of 0, and the time and instruction cycles of the CPU
are divided among them. CHANGETASKPRI changes the priority of the specified
CLI process. (If no process is specified, the current CLI process is
assumed.) Any tasks started from <process> inherit its priority.

The range of acceptable values for <priority> is -128 to 127. However, you
should not enter values above +5 to avoid disrupting important system tasks.

Process numbers of CLIs can be determined by using the STATUS command.

Example:

1> CHANGETASKPRI 5

The priority of the current CLI task is changed to 5. Any tasks started from
this CLI will also have a priority of 5. They will have priority over any
other user tasks created without using CHANGETASKPRI (those tasks will have
a priority of 0).

See also:   STATUS
*:COPY
Format:     COPY [[FROM] <name>] [TO] <name> [ALL][QUIET][BUF|BUFFER=<nn>]
               [CLONE][DATE][COM][NOPRO]

Template:   COPY "FROM,TO/A,ALL/S,QUIET/S,BUF=BUFFER/K,CLONE/S,DATE/S,COM/S,
               NOPRO/S"

Purpose:    To copy a file or directory.

Path:       C:COPY

Specification:

You can use COPY to copy multiple files to a device. Either use the ALL
option to copy an entire directory, or use pattern matching to copy files
that share a common set of characters or symbols.

For instance, you can use pattern matching to copy all the files of a
directory by specifying the directory name as the pattern. (For a full
explanation of patterns see The AmigaDOS Manual. Note: The 31 character
restriction on the use of wildcards has been removed.)

The BUF= option is used to set the number of 512 byte buffers used during
the copy. (Default is 100K or 200 buffers). It is often useful to limit the
number of buffers when copying to the RAM: disk.

The CLONE option tells COPY to copy the date, comments, and protection bits
of the original to the destination file. The DATE and COM options direct COPY
to copy the creation date and the comments of the original file. By default,
COPY retains the protection bits of the original file when it makes a copy.
This may be overridden by using the NOPRO option.

Formerly, if a directory specified as the destination did not exist, COPY did
not create one. With Version 1.3, COPY will now create a new destination
directory. You can also use a pair of quotes ("") to refer to the current
directory when specifying a destination.
*:DATE
Format:     DATE [<date>][<time>][TO=VER<filename>]

Template:   DATE "DATE,TIME,TO=VER/K"

Purpose:    To display or set the system date and/or time.

Path:       C:DATE

Specification:

DATE now allows either a leading zero or a single digit in the date
specification. Formerly you had to supply the leading zero.
*:DELETE
Format:     DELETE <name>* [ALL][Q][QUIET]

Template:   DELETE "NAME(S),ALL/S,Q=QUIET/S"

Purpose:    To delete up to 10 files or directories.

Path:       C:DELETE

Specification:

You can use pattern matching to delete files. If you are using pattern
matching, the 31 character restriction on the use of wildcards has been
removed. (For a full explanation of patterns, see The AmigaDOS Manual.)
*:DIR
Format:     DIR [<name>] [OPT A|I|AI|D][ALL][DIRS][INTER][FILES]

Template:   DIR "NAME,OPT/K,ALL/S,DIR/S,INTER/S,FILES/S"

Purpose:    To display a sorted list of the files in a directory.

Path:       C:DIR

Specification:

ALL, DIRS, and INTER are now synonyms for the A, D, and I options,
respectively. In addition, there is a COMMAND= option in interactive mode
(invoked through OPT I or INTER) which allows almost any AmigaDOS command
to be executed during the interactive directory list.

When you want to issue a general command in interactive mode, type C (or COM)
at the question mark prompt. DIR will ask you for the command. Type the
desired command, then hit RETURN. The command will be executed and DIR will
continue. You can also combine the C and the command on one line, by putting
the command in quotes following the C. For instance, C "type prefs.info hex".

The FILES option displays only the files in a directory; subdirectories are
not displayed.
*:DISKCHANGE
Format:     DISKCHANGE <drive>:

Template:   DISKCHANGE "DRIVE/A"

Purpose:    To inform the Amiga that you have changed a disk in the 5 1/4"
            disk drive.

Path:       C:DISKCHANGE

Specification:

You must use the DISKCHANGE command when you are using 5 1/4" floppy disk
drives with your Amiga system. Whenever you change the disks in the 5 1/4"
drive, you must use DISKCHANGE to inform the system of the switch.

This command is also useful to inform Workbench of any name changes made to
diskettes with the RELABEL command.

Example:

If a requester appears and asks you to insert a new disk into your 5 1/4"
drive, known as df2:, you must insert the disk, then type:

1> DISKCHANGE df2:

AmigaDOS will then recognize the new disk, and you can proceed.
*:DISKDOCTOR
Format:     DISKDOCTOR <drive>:

Template:   DISKDOCTOR "DRIVE/A"

Purpose:    To attempt to repair a corrupt disk.

Path:       C:DISKDOCTOR

Specification:

DISKDOCTOR attempts to repair a corrupt floppy disk enough to allow you to
retrieve files from it and copy them onto a good disk. If AmigaDOS detects a
corrupt disk, it displays a requester stating that the disk could not be
validated. By using DISKDOCTOR, you can try to restore the disk's file
structure. After running DISKDOCTOR, you should copy the restored files to
another disk, then reformat the corrupt disk.

You can use DISKDOCTOR on both the standard file system and the FastFile
System. However, to use DISKDOCTOR with the FastFileSystem, YOU MUST MAKE
SURE THAT THE DOSTYPE KEYWORD IN THE MOUNTLIST IS SET TO 0X444F5301. Do NOT
use DISKDOCTOR on the FastFileSystem partition if the DosType Keyword is not
set correctly.

With Version 1.3, DISKDOCTOR checks for enough memory before starting
operations and changes the boot block to type DOS.

Example:

If you receive a message stating that "Volume Workbench is not validated" or
"Error validating disk/Disk is unreadable", you can use DISKDOCTOR to
retrieve the disk's files. For instance, if the corrupt disk is in df1, type:

1> DISKDOCTOR df1:

AmigaDOS will ask you to insert the disk to be corrected and press RETURN.
DISKDOCTOR then reads each cylinder of the disk. If it finds an error, it
displays "Hard error Track xx, Surface xx". As each file and directory is
replaced, the filename is displayed on the screen. When DISKDOCTOR is
finished, it says "Now copy files required to a new disk and reformat this
disk."
*:ECHO
Format:     ECHO <string> [NOLINE][FIRST <nn>][LEN <nn>]

Template:   ECHO "STRING,NOLINES/S,FIRST/S,LEN/S"

Purpose:    To print a string.

Path:       C:ECHO

Specification:

Version 1.3 has introduced the NOLINE option. When the NOLINE option is
specified, ECHO does not automatically output a new line after printing the
string.

The FIRST and LEN options allow the echoing of a substring. FIRST <nn>
indicates the character position to begin the echo; LEN <nn> indicates the
number of characters of the substring to echo, beginning with the first
character.

If the FIRST option is omitted and only the LEN keyword is given, the
substring printed will consist of the rightmost <nn> characters of the main
string. For instance, if your string is 20 characters long and you specify
LEN <4>, the 17th, 18th, 19th, and 20th characters of the string will be
echoed.
*:ED
Format:     ED [FROM] <filename> [SIZE <n>]

Template:   ED "FROM/A,SIZE"

Purpose:    To edit text files (a screen editor).

Path:       C:ED
*:EDIT
Format:     EDIT [FROM] <filename> [[TO] <filename>] [WITH <filename>]
                 [VER <filename>] [OPT <option>]

Template:   EDIT "FROM/A,TO,WITH/K,VER/K,OPT/K"

Purpose:    To edit text files by processing the source file sequentially
            (a line editor).

Path:       C:EDIT

Specification:

Worthless - get rid of it.
*:ELSE
Format:     ELSE

Template:   ELSE

Purpose:    To have an alternative in a conditional in a script file.

Path:       C:ELSE
*:ENDCLI
Format:     ENDCLI

Template:   ENDCLI

Purpose:    To end an interactive CLI process or a SHELL process.

Path:       C:ENDCLI

Specification:

ENDCLI can be used to end either a CLI process or a SHELL process.
*:ENDIF
Format:     ENDIF

Template:   ENDIF

Purpose:    To terminate an IF block in a script file.

Path:       C:ENDIF
*:ENDSKIP
Format:     ENDSKIP

Template:   ENDSKIP

Purpose:    To terminate a SKIP block in a script file

Path:       C:ENDSKIP

Specification:

When an ENDSKIP is encountered during a SKIP, execution of the script file
resumes at the line following the ENDSKIP. (The condition flag is set to
WARN.)
*:EVAL
Format:     EVAL <value1> <operation> <value2> [TO <file>][LFORMAT=<string>]

Template:   EVAL "VALUE1,OPERATION,VALUE2,TO/K,LFORMAT/K"

Purpose:    To provide a means of evaluating simple expressions.

Path:       C:EVAL

Specification:

The EVAL command is used to evaluate, and to print the answer of, simple (1
and 2 argument) integer expressions. <value1> and <value2> may be in decimal,
hexedecimal, or octal numbers. Decimal numbers are the default. Hexadecimal
numbers are indicated by either a leading 0X or #X. Octal numbers are
indicated by either a leading 0 or a leading # (followed by other digits).
Alphabetical characters are indicated by a leading single quote (').

The supported operations and their corresponding symbols are as follows:

addition          +           not                  ~
subtraction       -           left shift           <<
multiplication    *           right shift          >>
division          /           negation             -
mod               mod         exclusive or         xor
and               &           bitwise equivalence  eqv
or                |

The output format defaults to decimal; however, through use of the LFORMAT
keyword, you may select another format. The LFORMAT keyword specifies the
formatting string used to print the answer. You may use %X (hexadecimal), %O
(octal), %N (decimal), or %C (character). Note that the %X and %O options
require a "number of digits" specification, (ie. %X8 gives 8 digits of hex
output.)

When using the LFORMAT keyword, you can specify that a new line should be
printed by including a *N in your string.

EVAL can be used in scripts to act as a counter for loops. In that case, the
TO option, which sends the output of EVAL to a file, is very useful.

Examples:

1> EVAL 4 * -5
-20

1> EVAL 0x4f / 010 LFORMAT = "The answer is %X4*N"
The answer is 9

Example in a script:

.key loop/a
;demo a loop using eval and skip
.bra {
.ket }
echo >env:loop {loop}
lab start
echo "Loop #" noline
type env:loop
eval <env:loop >NIL: to=t:qwe{$$} value2=1 op=-?
type >env:loop t:qwe{$$}
IF val $loop GT 0
skip start back
endif
echo "done"
*:EXECUTE
Format:     EXECUTE <command file> <arguments>

Template:   EXECUTE "COMMANDFILE,ARGUMENTS"

Purpose:    To execute a command file with argument substitution.

Path:       C:EXECUTE

Specification:

EXECUTE now uses the logical name T: if it is ASSIGNed; otherwise it uses the
:T directory.

Since script files call on the EXECUTE command, it is an excellent candidate
for being made resident when using the SHELL.

The current CLI number can be referenced by the characters <$$>. This is
useful in creating unique temporary files, logical assignments, and PIPE
names.

See Also:   ASSIGN
*:FAILAT
Format:     FAILAT <n>

Template:   FAILAT "RCLIM"

Purpose:    To set the failure condition of a script file.

Path:       C:FAILAT
*:FAULT
Format:     FAULT <error number>

Template:   FAULT ",,,,,,,,,,"

Purpose:    To print the specified error message(s).

Path:       C:FAULT
*:FF
Format:     FF [-0][-N]

Template:   FF "-0/S,-N/S"

Purpose:    To speed up text on the Amiga.

Path:       C:FF

Specification:

FF (FastFonts) is a program written by Charlie Heath, of Microsmiths, Inc.
FF speeds up the display of text on the Amiga. To turn on the FastText
routines, use the -0 option. To turn off the FastText routines, use the -N
option. FF can also be used to replace the default system font with a plain
8x8 pixel font. Use the command: FF <fontname>.

FF is used by permission of Microsmiths, Inc.
*:FILENOTE
Format:     FILENOTE [FILE] <filename> COMMENT <comment>

Template:   FILENOTE "FILE/A,COMMENT/K"

Purpose:    To attach a comment to a file.

Path:       C:FILENOTE

Specification:

The length of <comment> is limited to 79 characters.
*:GETENV
Format:     GETENV <name>

Template:   GETENV "NAME/A"

Purpose:    To get the value of an environment variable.

Path:       C:GETENV

Specification:

GETENV is used to get the value of an environment variable. Environment
variables are stored in the ENV: handler. (Currently, this is simulated by
using the RAM: disk.)

You can use many AmigaDOS commands with the ENV: handler, such as DIR, LIST,
ASSIGN, etc. This gives users great flexibility in working with environment
variables.

See also:   SETENV
*:ICONX
Format:     ICONX

Template:   ICONX

Purpose:    To execute an AmigaDOS script file from Workbench.

Path:       C:ICONX

Specification:

ICONS allows you to execute a script file of AmigaDOS commands from the
Workbench. ICONX changes the current directory to the directory containing
the project icon before executing the script. An input/output window for the
script file is opened on the Workbench screen. You can use the icon's TOOL
TYPES to specify the size of the window (WINDOW=). The DELAY= TOOL TYPES will
add a short delay after the execution of the file is complete to allow time
for reading the output. If a 0 is specified for DELAY=, ICONX waits for a
control-C before exiting.

To use ICONX, create a script file (an ASCII file containing AmigaDOS
commands), and attach a project icon to it. (Notepad can be used for this
purpose, as long as you do not use styles and multiple fonts in your
document). Using the Workbench INFO menu item, change the default tool of the
icon to c:ICONX. Add the WINDOW= and DELAY= TOOL TYPES specifications if you
choose. Then save the changed info. To execute the script, double-click on
the icon.

You can work through Workbench and use extended selection to pass Workbench
files to the script. These files appear to the script as keywords. To use
this facility, the .key keyword must be at the start of the script. In this
case, the AmigaDOS EXECUTE command is used to execute the script file. Adding
a .key "" or .<space> allows the use of commands that require input in an
ICONX script. (See the AmigaDOS Manual for more information on executing
script files).

See Also:   EXECUTE
*:IF
Format:     IF [NOT][WARN][ERROR][FAIL][<string> EQ|GT|GE <string>][VAL]
               [EXISTS <file>]

Template:   IF "NOT/S,WARN/S,ERROR/S,FAIL/S,,EQ/K,GT/K,GE/K,VAL/S,EXISTS/K"

Purpose:    To handle conditional operations in the script files.

Path:       C:IF

Specification:

In an EXECUTE script file, IF carries out all subsequent commands until an
ENDIF or ELSE command is found.

IF now supports the GT (greater than) and GE (greater than or equal to)
comparisons. Normally, the comparisons are performed as string comparisons.
However, if the VAL option is specified, the comparison is a numeric
comparison.

The IF command can evaluate environment variables. To specift an environment
variable, the variable's name is prefaced with a $ character.

NOTE: You can use NOT GE for LT and NOT GT for LE.

For more information on the IF command, see The AmigaDOS Manual.
*:INFO
Format:     INFO [<device>]

Template:   INFO "DEVICE"

Purpose:    To give information about the file system(s).

Path:       C:INFO

Specification:

INFO's output now adjusts to allow longer volume names. INFO reads reserved
blocks from the environment vector of the specified device.

The DEVICE option allows INFO to provide information on just one device or
volume.
*:INSTALL
Format:     INSTALL DRIVE <DF0/A,NOBOOT/S,CHECK/S"

Template:   INSTALL "DRIVE/A,NOBOOT/S,CHECK/S"

Purpose:    To handle the boot block of a formatted disk.

Path:       C:INSTALL

Specification:

INSTALL now clears memory used to build the boot block. The NOBOOT option
makes the a disk a DOS disk, but not bootable. The CHECK option checks
against valid boot code. INSTALL reports if a disk is bootable, or not, and
whether standard Commodore-Amiga boot code is present on the disk. The
condition flag is set to 0 if the boot code is standard (or the disk isn't
bootable), 5 (=WARN) otherwise.

NOTE: INSTALL's NOBOOT option will write the boot block on a non-DOS disk.
*:JOIN
Format:     JOIN <name> <name> * AS|TO <name>

Template:   JOIN "NAME(S),TO=AS/K"

Purpose:    To concatenate up to 15 files to make a new file.

Path:       C:JOIN

Specification:

TO is now a synonym for AS.
*:LAB
Format:     LAB <string>

Template:   LAB "STRING"

Purpose:    To specify a label in a script file.

Path:       C:LAB
*:LIST
Format:     LIST [<dir|pattern>] [P|PAT <pattern>] [KEYS][DATES][NODATES]
                 [TO <name>][SUB <substring>][SINCE <date>][UPTO <date>]
                 [QUICK][BLOCK][NOHEAD][FILES][DIRS][LFORMAT <string>]

Template:   LIST "DIR,P=PAT/K,KEYS/S,DATES/S,NODATES/S,TO/K,SUB/K,SINCE/K
                 UPTO/K,QUICK/S,BLOCK/S,NOHEAD/S,FILES/S,DIRS/S,LFORMAT/K"

Purpose:    To list specified information about directories and files.

Path:       C:LIST

Specification:

LIST now displays the new protection bits: s (script), p (pure - used with
the RESIDENT command), and a (archive).

When searching for a pattern, you can specify a search string within a
directory. For example, to search for a pattern within the C: directory,
you could type LIST:C:l#?. This would result in a display of all the files
in the C: directory that start with the letter l.

The LIST options are as follows:

   QUICK    extra spaces are not output after each filename

   BLOCK    LIST displays file sizes in blocks, rather than bytes

   NOHEAD   supresses the printing of the header information

   FILES    limits LIST to displaying files only (no directories)

   DIRS     limits LIST to displaying directories only (no files)

LFORMAT modifies the output of LIST and can be used as a quick method of
generating script files. When LFORMAT is specified, the QUICK and NOHEAD
options are automatically selected. When using LFORMAT you must specify an
"output format specification" string; this string is incorporated into the
script file. Also, if you want the output to be saved, you must redirect it
to a file by using the > command.

The format for the output format specification string (hereafter referred to
as "string") is LFORMAT="string". TO include the output of LIST in this
string, you can specify a %S substitution. The path and filename can also be
part of this string. The number of occurrences of the %S determines the type
of output to be included in the string, as follows.

      Number of %S      Output
            1           filename only
            2           path, filename
            3           path, filename, path
            4           path, filename, path, filename

Example:

1> LIST >RAM:qwe #? LFORMAT="protect %S -d"

A new script file "qwe" is created in RAM:. The contents will include a list
of all the files in the current directory. When "qwe" is executed, it will
remove the delete protection from each file. For instance, the contents may
look like this:

   protect Expansion.info -d
   protect Trashcan.info -d
   protect .info -d
   protect c -d
   protect Clock.info -d
   protect Prefs -d
     etc...
*:LOADWB
Format:     LOADWB [DELAY][-DEBUG]

Template:   LOADWB "DELAY/S,-DEBUG/S"

Purpose:    To start Workbench.

Path:       C:LOADWB

Specification:

The LOADWB command is used to start the Workbench. Normally, this is only
done when booting, by placing the LOADWB command in the startup-sequence
file.

Workbench snapshots the current paths in effect when the LOADWB command is
executed. It uses these paths for each CLI (or SHELL) started from the
Workbench.

If the DELAY option is specified, LOADWB waits three seconds before exiting.
This allows disk activity to stop before execution continues.

The -DEBUG option tells Workbench to bring up a hidden Workbench menu --
DEBUG. This menu contains the menu items Debug and FlushLibs. The Debug item
breaks you into ROMWACK, the Amiga's ROM-resident debugger, so you must have
a 9600 baud serial terminal attached if you intend to use this command!
FlushLibs causes Workbench to attempt to allocate as much memory as possible,
so that any libraries, devices, fonts, etc., resident in memory, but not
currently in use will be expunged. (Assuming that the particular library or
device allows itself to be expunged.)

Both the DELAY and -DEBUG options cannot be used at the same time. You can
only choose one or the other.
*:LOCK
Format:     LOCK <drive>: [ON|OFF][<passkey>]

Template:   LOCK "DRIVE/A,ON/S,OFF/S,PASSKEY"

Purpose:    To set the write protect status of a hard disk using the
            FastFileSystem.

Path:       C:LOCK

Specification:

the LOCK command sets or unsets the write protect status of a hard disk drive
or partition mounted using the FastFileSystem. The LOCK remains on until the
system is rebooted or until the LOCK is turned off with the LOCK OFF command.
An optional 4 character passkey may be specified. If the passkey is used to
lock a hard disk partition, the same passkey must be specified to unlock the
partition.
*:MAKEDIR
Format:     MAKEDIR <dir>

Template:   MAKEDIR "DIR/A"

Purpose:    To create a new directory.

Path:       C:MAKEDIR
*:MOUNT
Format:     MOUNT <device> [FROM <file>]

Template:   MOUNT "DEVICE/A,FROM/K"

Purpose:    To create an AmigaDOS device node.

Path:       C:MOUNT

Specification:

MOUNT is used to create an AmigaDOS node. In other words, MOUNT informs the
Amiga that an additional device has been added to the system. When the MOUNT
command is issed, MOUNT looks in the DEVS:Mountlist file (or the optional
FROM file) for the parameters of the device that is being mounted.
*:NEWCLI
Format:     NEWCLI [<window specification>][FROM <filename>]

Template:   NEWCLI "WINDOW,FROM/K"

Purpose:    To start a new interactive CLI with a new window.

Path:       C:NEWCLI

Specification:
*:NEWSHELL
Format:     NEWSHELL [<window specification>][FROM <filename>]

Template:   NEWSHELL "WINDOW,FROM/K"

Purpose:    To start a new interactive SHELL with a NEWCON window.

Path:       C:NEWSHELL

Specification:
*:PATH
Format:     PATH [SHOW][ADD <directory>*][RESET][QUIET]

Template:   PATH "SHOW/S,ADD,RESET/S,QUIET/S"

Purpose:    To control the PATH list that the CLI uses to search for
            commands.

Path:       C:PATH

Specification:
*:PROMPT
Format:     PROMPT <prompt>

Template:   PROMPT "PROMPT"

Purpose:    To change the prompt string of the current CLI.

Path:       C:PROMPT

Specification:
*:PROTECT
Format:     PROTECT [FILE] <filenmame> [FLAGS] <+-status bits> [ADD][SUB]

Template:   PROTECT "FILE/A,FLAGS,ADD/S,SUB/S"

Purpose:    To change the protection bits of a file.

Path:       C:PROTECT

Specification:
*:QUIT
Format:     QUIT <return code>

Template:   QUIT "RC"

Purpose:    To exit from a script file with a specified error code.

Path:       C:QUIT
*:RELABEL
Format:     RELABEL DRIVE <drive>: NAME <name>

Template:   RELABEL "DRIVE/A,NAME/A"

Purpose:    To change the volume name of a disk.

Path:       C:RELABEL
*:REMRAD
Format:     REMRAD

Template:   REMRAD

Purpose:    To remove the recoverable ramdrive.device.

Path:       C:REMRAD

Specification:
*:RENAME
Format:     RENAME [FROM] <name> [TO|AS] <name>

Template:   RENAME "FROM/A,TO=AS/A"

Purpose:    To change the name of a file or directory.

Path:       C:RENAME
*:RESIDENT
Format:     RESIDENT <Resident Name> <File> [REMOVE][ADD][REPLACE][PURE]
                     [SYSTEM]

Template:   RESIDENT "NAME,FILE,REMOVE/S,ADD/S,REPLACE/S,PURE/S,SYSTEM/S"

Purpose:    To load and add commands to the resident list.

Path:       C:RESIDENT

Specification:
*:RUN
Format:     RUN <command> [+<comment>]

Template:   RUN "COMMAND"

Purpose:    To execute commands as background processes.

Path:       C:RUN

Specification:
*:SEARCH
Format:     SEARCH FROM <name> <pattern> [SEARCH]<string>[ALL][NONUM][QUIET]
                   [QUICK][FILE]

Template:   SEARCH "FROM,SEARCH/A,ALL/S,NONUM/S,QUIET/QUICK/S,FILE/S"

Purpose:    To look for the specified text string in the specified files.

Path:       C:SEARCH

Specification:
*:SETCLOCK
Format:     SETCLOCK LOAD|SAVE|RESET

Template:   SETCLOCK "LOAD/S,SAVE/S,RESET/S"

Purpose:    To set or read the real time clock.

Path:       C:SETCLOCK

Specification:
*:SETDATE
Format:     SETDATE <file> <date> <time>

Template:   SETDATE "FILE/A,DATE,TIME"

Purpose:    To change the date and time of a file or directory.

Path:       C:SETDATE

Specification:
*:SETENV
Format:     SETENV <variable name> <variable string>

Template:   SETENV "NAME/A,STRING"

Purpose:    To set an environment variable.

Path:       C:SETENV

Specification:
*:SETPATCH
Format:     SETPATCH [R]

Template:   SETPATCH "R/S"

Purpose:    To make ROM patches in Version 1.2 and Version 1.3 Kickstarts.

Path:       C:SETPATCH

Specification:
*:SKIP
Format:     SKIP <label> [BACK]

Template:   SKIP "LABEL,BACK/S"

Purpose:    To skip ahead when executing command files.

Path:       C:SKIP

Specification:
*:SORT
Format:     SORT [FROM] <filename> [TO] <filename> [COLSTART <n>]

Template:   SORT "FROM/A,TO/A,COLSTART/K"

Purpose:    To alphabetically sort each line of a small file.

Path:       C:SORT
*:STACK
Format:     STACK [<n>]

Template:   STACK "SIZE"

Purpose:    To display or set the stack size of the current CLI.

Path:       C:STACK
*:STATUS
Format:     STATUS <process> [FULL][TCB][CLI|ALL][COMMAND]

Template:   STATUS "PROCESS,FULL/S,TCB/S,CLI=ALL/S,COMMAND/K"

Purpose:    To list information about the CLI/SHELL process.

Path:       C:STATUS

Specification:
*:TYPE
Format:     TYPE <from> [TO <name>] [OPT H=HEX][N=NUMBER]

Template:   TYPE "FROM/A,TO/S,OPT/K,HEX/S,NUMBER/S"

Purpose:    To type a text file.

Path:       C:TYPE

Specification:
*:VERSION
Format:     VERSION <library name|device name> [<version #>][<revision #>]
                    [<unit #>]

Template:   VERSION "NAME,VERSION,REVISION,UNIT"

Purpose:    To find the version and revision numbers of a Workbench disk.

Path:       C:VERSION

Specification:
*:WAIT
Format:     WAIT <n> [SEC|SECS][MIN|MINS][UNTIL <time>]

Template:   WAIT ",SEC=SECS/S,MIN=MINS/S,UNTIL/K"

Purpose:    To wait for the specified time.

Path:       C:WAIT

Specification:
*:WHICH
Format:     WHICH <filename> [NORES][RES]

Template:   WHICH "FILE/A,NORES/S,RES/S"

Purpose:    To search the command path for a particular command.

Path:       C:WHICH

Specification:
*:WHY
Format:     WHY

Template:   WHY

Purpose:    To print an error message to explain why the previous command
            failed.

Path:       C:WHY