\input texinfo   @c -*-texinfo-*-
@c %**start of header
@setfilename builders_guide.info
@settitle Builder's Guide to MOZ (Moo in OZ).
@setchapternewpage on
@c %**end of header


@copying
This manual is for MOZ (MOO in Oz) version 1.0.

Copyright @copyright{} 2002 Robin Lee Powell

@quotation
Permission is granted to distribute and modify as long as credit is
given.  See the file license.txt in the main MOZ distribution for full
copyright information.
@end quotation
@end copying


@titlepage
@title Builder's Guide to MOZ (Moo in OZ).
@author Robin Lee Powell

@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@ifnothtml
@contents
@end ifnothtml

@node 	  Top
@top

This is the Builder's Gudie for MOZ (Moo in OZ). MOO is Mud Object
Oriented.  MUD is Multi-User Dungeon or Dimension.  In general, a MUD is
a multi-user text-based virtual environment.  For information on MUDs in
general, see @url{http://www.godlike.com/muds/} or your local search
engine.  For information on MOOs, see
@url{http://www.moo.mud.org/moo-faq/}.

Oz is a multi-paradigmatic language that happens not to suck.  See
@url{http://www.mozart-oz.org/}.

@menu
* Building Commands::	Commands used in creating rooms and objects.

* Unsorted::		Point-form notes that haven't been fully fleshed
			out.

* Command Index::
@end menu

@node Building Commands
@chapter Building Commands

@defvar create className @code{named} objectName
Creates an object of the given @var{className}, and gives it the
name @var{objectName} (in the current language only).

Please see the design document for a list of the available classes.
@end defvar

@defvar teleport thing @code{to} place
Teleports an object (named by @var{thing}) to either the player
(``me'') or the player's location (``here'').  Alternatively,
teleports the character (``me'') to a location they own (named by
@var{place}).
@end defvar

@defvar link exit
Sets the named @var{exit}'s destination to whatever location the
@var{exit} is currently located in.
@end defvar

@defvar link gate @code{to url} url
A Gate is like an exit, except it links two running MOZ servers.  To
make the connection, the Gate must set its destination to the
information that has been stored in a file by a Terminus.

Use this command to link then named @var{gate} to the terminus that
has advertised itself in @var{url}.  Note that an administrator must
bless @var{gate} for this command to work.
@end defvar

@defvar advertise terminus @code{in file} file
A Terminus is like a location except that, when blessed by an
administrator, it has the ability to save some information to a file
that allows a Gate to set its destination to the Terminus.
Generally, the file is made web accessible.

Use this comamnd to advertise Gate connection information about
@var{terminus} in @var{file}, which is a file that will be placed
under the pickle directory in the server root directory.  The file
will probably not be useful unless it is web accessible; you will
need to talk to your administrator to see what URL to use to access
the file.
@end defvar

@node Unsorted
@chapter Unsorted

@itemize @bullet

@item Room creation.
@item Verb aliasing?

@end itemize

@node Command Index
@chapter Command Index

@printindex vr

@bye
