\input texinfo   @c -*-texinfo-*-
@c %**start of header
@setfilename administrators_guide.info
@settitle Administrator'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 Administrator'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
@comment  node-name, 	next,      		previous,	up

@top

This is the Administrator'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
* Programs::		The actual "binary" programs that are used
			to run a MOZ, and their command line
			arguments.

* Administration Commands::	Commands of relevance only to MOZ
			administrators.  They generally require
			Wizard privledges.

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

* Command Index::	Index of all commands defined in this
			document.
@end menu

@node Programs
@chapter Programs

@section new_moz

*** Unfinished

@var{new_moz} creates an entirely new MOZ database, destroying
anything that was there before.

@section moz

*** Unfinished

@var{moz} is the normal MOZ program.

@section Command Line Arguments

Both @var{moz} and @var{new_moz} take the same command line
arguments, except that only @var{new_moz} takes the @var{--quiet}
argument.

@defvr Argument {--debug}
Specifies the level of debugging.  Values are @var{debug},
@var{info}, @var{warn}, @var{error}, and @var{critical}.

The default is warn.  For whatever level is selected, that level of
log message and above (above meaning "less verbose" or "more
severe") are printed.
@end defvr

@defvr Argument {--port}
Specifies the port to make available for player connections.
@end defvr

@defvr Argument {--rootdir}
Specifies the directory to find the MOZ data files in, i.e. the
directory above db/ and classes/ and functors/.
@end defvr

@defvr Argument {--quiet}
Used only by @var{new_moz}, causes @var{new_moz} to not complain
about how you're about to destroy everything.
@end defvr

@node Administration Commands
@chapter Administration Commands

@deffn Command {reload all [classes]}
Re-reads all of the .class files and runs upgrade on every object in
the MOZ @emph{except} the Storage object.  So, basically, refreshes
all of the running MOZ's code.  Used after upgrades and such.
@end deffn

@deffn Command bless type object
Used to bless an object with special capabilities, generally on the
Storage object.

Possible Types
@table @var
@item Gate
Gives a Gate the ability to take tickets from URLs and use them.

@item Terminus
Gives a Terminus the ability to write a pickle file for itself.
Note that to be useful, the pickle file will have to be 
web-accessible in some fashion.

@end table
@end deffn

@node Unsorted
@chapter Unsorted

@itemize @bullet

@item How to find players and objects.
@item About object file numbers?
@item How to kick players.

@end itemize

@node Command Index
@chapter Command Index

@printindex fn


@bye
