dist.doc

Unix下的MUD客户端程序

/list_defs [<pattern>|<name>]

Lists macro definitions.  In this listing command as with others, if
<pattern> is specified (the argument is considered a pattern if it
contains * or ?), the distribution only displays those entries whose
names match <pattern>.	If <name> is specified, the distribution
displays a detailed listing of the entry matching <name>.


/list_gags [<pattern>]

Lists gag triggers.  The numbers by the triggers can be used by
/untrig to remove them.	 <pattern> applies to the names of the gag
triggers, not to their matching patterns.  For a detailed listing of a
trigger, use /list_trigs.


/list_hilites [<pattern>]

Lists hilite triggers.


/list_keys

Lists key bindings.


/list_norms [<pattern>]

Lists triggers that are not gags or hilites.


/list_trigs [<pattern>|<name>]

Lists triggers.	 Can also be used to display a detailed listing of a
particular trigger by specifying its name or number.  To specify its
number, preceed the name with a '#', e.g. "/list_trigs #7".


/list_worlds [<pattern>|<name>]

Lists world entries.


/load <file>

Loads <file> as a VTC file.  The extension ".vtc" may be dropped.
/load searches the current directory and the directories in load_path
(defined in main.vtc), which in the archive distribution includes:
	~/vt/dist
	/usr/local/lib/vt
	~/vt/extra
	/usr/local/lib/vt/extra
	~/vt
	~

To load a file of VTC commands, see "obscure features".


/log [<file>]

Displays the logging status for the current remote if <file> is not
specified, or begins logging to <file> on the current remote if it is.
Use "/log off" to stop logging.


/more [on|off]

Turns the pager on or off for a window.	 When on, the output routine
pauses each time windowfull of text has been displayed.	 The indicator
"[PAUSE]" is displayed on the divider at the bottom of the appropriate
window, and you can press TAB while in that window to continue, press
ESC Q to discard output in that window up until the current time, or
enter /more off to turn off the pager.

To set the default pager status, see "obscure features".


/parse <text>

Sends <text> to the parser.  Equivalent to \<text>, except that the
command form undergoes argument substitutions.


/path <path>

Sets the load path to <path>.  Use ; to separate directories.  The
default is "~;~/vt;~/vt/dist;/usr/local/lib/vt".


/quit

Exits VT.


/quote [-<delay>] <prefix>['!]<file/cmd>

Quotes a file or shell command.	 To quote a file, do, for instance:
	/quote :| 'filename
To quote a shell command:
	/quote :| !command

If <delay> is specified, then there is a pause of <delay> seconds
between lines.	You can stop a runaway /quote process with the console
(^C C and delete appropriate programs from (G)eneral (S)leep).

You can use a suffix with /quote by placing the filename or command in
quotes.	 For instance:
	/quote :checks the time, and sees that it is !"date".
If <file> or <command> contain any quote characters, escape them with
a backslash.


/recall [-aghnl] [-w<world>] <lines> [<pattern>]

Displays the most recent <lines> lines matching <pattern> from the
history buffer, or any lines if <pattern> is not specified.  The
switches are:
	-a	Display lines from any remote, not just the current
		remote
	-g	Obey gags, that is, do not display lines that were
		gagged by triggers
	-h	Obey hilites
	-n	Display world names (useful with -a)
	-l	Display line numbers
	-w	Display lines from the given world, rather than the
		current remote (useless with -a)

To display a range of lines other than the most current ones, or to
set the history size, see "obscure features".


/receive <line>

Pretends <line> has been received by the current remote.  Beware of
infinite loops resulting from this.


/repeat [-<delay>] <number> <command>

Executes <command> <number> times.


/resize <size>

Resizes the current window to size <size>, by moving the divider at
the bottom of the window.


/save [<file>]

Saves the current settings information to <file> or the default save
file, which is usually "~/.settings.vtc".  Settings include world
entries, macro definitions, and trigger definitions.  If <file> is
specified, that becomes the new default save file for the remainder of
the session.  To set the default save file without saving, or to save
only certain piece of information, see "obscure features".


/send <text>

Sends <text> to the current remote.


/sh <command>
/shw <command>

Executes <command> in a shell.	/sh positions the cursor at the bottom
of the screen and waits for a keypress when done, appropriate for
running, say, vi, while /shw positions the cursor in the active
window, appropriate for a non-interactive command.


/split <row>

Splits the current window in two, at <row>.  Rows are numbered
starting at 0.


/trig [+|-e1hg] [-p<pri>] [-n<name>] [-w<world>] <pattern> = <cmd>

Creates a new trigger.	This is similar to /gag and /hilite except the
line is neither suppressed nor boldfaced.  The switches are:

	+e	The trigger is disabled until it is enabled with /edit
	-1	The trigger only goes off the first time it is hit
	-h	The trigger is a hilite trigger (as with /hilite)
	-g	The trigger is a gag trigger (as with /gag)
	-p	Set trigger priority (q.v.)
	-n	Give the trigger a name
	-w	Make trigger specific to <world>

Trigger priority can be used to preempt other triggers.	 If a line
matches several triggers and they are of different priorities, only
the trigger(s) at the highest priority level go off.  The default
priority level is 0.

To create gag triggers that do not place lines matching them in the
history buffer, see "obscure features".


/undef <name>|<pattern>

Deletes the macro with the name <name>, or all macros with names
matching <pattern>.


/untrig <name>|<pattern>|<number>

Deletes the trigger with the name <name>, or names matching the
pattern <pattern>, or with the number <number>.


/unworld <name>|<pattern>

Deletes the world with the name <name>, or names matching the pattern
<pattern>.


/version

Displays the current version number.  In previous versions, this would
be \echo(version, "\n");


/world [-]<name>

Connects to the world matching <name> and displays it in the current
window.	 If the '-' is included, disables automic login for muds.


/wrapspace <spaces>

Sets the number of spaces to indent the second and subsequent lines of
a wrapped line.


Obscure features
----------------

These features are specialized enough that no command-line syntax is
provided to access them.  In most cases, it is possible to create
macros to access these features if desired.  For instance, the VTC
command to save macros to a file is "save_one(.save_macros,
filename);"  We can make this a command, even:
	func Save_macros(name) { save_one(.save_macros,
		*name ? name : "~/.macros.vtc"); }
	add_cmd("save_macros", 1, .save_macros, \
		"/save_macros [filename]");

Some of these features involve setting globals.	 It is convenient to
place commands of this nature in ~/.local.vtc, which is automatically
loaded by the distribution code.  For instance, the author keeps,
among other things, the following commands:
	line_numbers = 1; // Display line numbers
	bind(ctrl("^f"), .next_win); // ^F for next window
	bind(ctrl("^b"), .prev_win); // ^B for previous window
	Load("mush"); // Load Mush world support file
	Load("unter"); // Load Unter world support file

Calling commands by VTC: It is easy to call commands within VTC code.
	The Load() commands above are an example.  The command handler
	for every VTC command is the name of the command with the
	first letter in uppercase.  In general, commands that take
	space-separated arguments, e.g. /add_mud, take their arguments
	as separate strings, as in "Add_mud("Name", "Addr", "Port",
	"Char", "Pwd");" while other commands take one string
	argument, as in "Trig("-g Druid*");"

	A less direct way of calling commands is to call
	process_cmd(), which interprets a line of text just as if it
	had come from the keyboard.  For example:
		process_cmd("/send :| %{" + itoa(lineno) + "}");

Line numbers: If the line_numbers global is on, then the distribution
	code displays incoming remote server lines with their line
	numbers in the history buffer.	This is helpful for the %{...}
	substitution.

Loading distribution commands: The load_cmd() function will load a
	file of distribution commands; a file full of macro
	definitions using /def commands, for instance.

Default pager status: The global default_pager_state is used to
	initialize the pager status (on or off) of windows when they
	are created.  It is normally 0.

Minimal range of history lines: The function histdump(start, end)
	displays a list of history lines.  It displays lines from any
	remote, with line numbers and world names, and obeys hilites
	(but not gags).

Default save file: The global default_save_file contains the name of
	the default save file.	It is initialized to "~/.settings.vtc"
	in misc.vtc.

Saving only some information: The function save_one() will save just
	one of the three groups of settings information.  The format
	is save_one(function, filename), where function is one of
		.save_worlds
		.save_macros
		.save_trigs

No-history gag triggers: Triggers that modify incoming text shouldn't
	store their matches in the history buffer.  This is possible
	with the /trig command, using the -G option, which creates a
	"no history" gag trigger.  For instance:
		/trig -G Huh?* = /receive <!> Unrecognized command