Command: stanza

Syntax

stanza <assign> {,<assign> ... }

Description

Declare (and optionally assign) a stanza identifier.

Parameters

Switches

None

Notes

A command stanza is an executable string of one or more commands, which may be passed parameters if necessary.

A stanza and its parameters are executed by name, similar to the execution of any other command.

Parameters within a stanza should be indicated by the sequence $<n>, where n has a range 1 through 9.

All parameters together can be handled by using $*. If a $ is required within the stanza string it should be escaped, e.g.

"tell \$mydir/file".

A stanza with a straight word-for-word replacement has the same effect as an alias identifier.

A stanza identifier may be used like a string identifier within other commands.

If not given a value, the identifier is initialized to an empty string.

Examples

Simple stanza.

stanza pwd = 'tell current_dir'

Multiple command stanza with parameters.

stanza helpme
helpme = '!Help on $1; type $1.hlp'

Stanza with use of variable number of parameters

stanza htype = 'type -h,$*'

See Also

Commands:

alias, string