powwow 1.2.23 README

Powwow is a client program intended mainly for playing MUD.
It implements (a subset of) the telnet protocol.

Files you should have received:

	README		This text.
	Changelog 	What has changed since the last release.
	powwow.doc	Complete documentation. READ this!
	configure	A shell script that will create a Makefile
			suitable for your system
	*.[ch]		Sources.
	tools/*		Additional standalone utilities.
	powwow.help	Online help file (in plain ASCII).
	powwow.6	Man page.
	Config.demo	A demonstrative definition file for powwow
	Hacking		Read this if you want to improve/destroy powwow
			yourself.
	README.follow	Documentation for the 'follow' mini-program.
	README.term     How to make termpowwow

COMPILING

	powwow is built using GNU autoconf scripts, it should detect any
	system dependancies it needs and set the appropriate flags.  Just
	run:

	./configure
	make

	To build the powwow binary.  It will run from any location, but there
	are some settings set at compile time that will make more sense if
	you use the "install" make target to install the binaries and
	documentation together.  For example, POWWOWDIR will default to the
	location that "make install" will put the online powwow documentation,
	making the #help feature work out of the box without modifying any
	settings or flags.

	If you require changes to the build process, please e-mail the problems
	(and hopefully solution) to me at bpk@hoopajoo.net.  Also please
	include your system information (uname -a, etc)

	There are also some other options that may be turned on or off or
	forced using configure.  Try "configure --help" to see the full
	list of compile-time configuration options.

INSTALLING

	If you want powwow's definition files to go in a specific directory,
	set the environment variable POWWOWDIR to that directory. It will be
	searched first for definition files at startup.
	
	Put the file powwow.6 in a suitable directory if you want users on
	your system to be able to read the long and comprehensive man page ;)

	Powwow supports the MUME editing protocol.  It enables you to edit
	texts locally with your favourite editor.  So far, only MUME supports
	this protocol, but this might change in the future.

	Powwow looks for the editor in the POWWOWEDITOR enviroment variable,
	and if it doesn't exist, in EDITOR, and uses "emacs" as default.  For
	text viewing, powwow looks for POWWOWPAGER, then PAGER, then uses
	"more" as default.

	If you are on a multi-window terminal (such as an X terminal or NCSA
	telnet from a Mac or PC), powwow will let you start the editor in
	another window and remain active.  You will then also be able to edit
	several texts at the same time.  To achieve this, let the first
	character of your editor/pager be '&' (which is then skipped).

	Example: (Bourne shell syntax)
	
	POWWOWEDITOR=vi		  Use vi as normal editor (same window as
				  powwow)
	POWWOWEDITOR='&emacs'	  Use emacs as editor in a separate window (if
				  you are on an X terminal)
	POWWOWEDITOR='&xterm -e vi'  Use vi in another X window
	POWWOWPAGER='&xterm -e less' Use less as your file viewer in another
				     X window

	If you use a multi-window terminal and have emacsclient installed, it
	is a good choice, since you only need one emacs window for all your
	editing sessions and you don't have to start and exit emacs all the
	time.  Set POWWOWEDITOR='&emacsclient' in that case, and make sure your
	emacs has a running server (put (server-start) in your .emacs file or
	type M-x server-start).

	If you want to use the editing functions, you must execute the
	"#identify" command to notify the server that the client supports the
	protocol. This can also be done with an action; see the documentation
	for details.

	For editing Mudlle programs with emacs, there is a special mode that
	helps you with indenting. To use it, put mudlle.el in a suitable
	place, and add the two following lines to your .emacs file:

	(setq load-path (append load-path '("mydirectory")))
	(autoload 'mudlle-mode "mudlle.el" "Turns on mudlle editing mode" t)

	where you replace mydirectory with the directory where mudlle.el can
	be found. If you put the string -*-mudlle-*- in the first line of
	a mudlle program (i.e. in a comment), then emacs will automatically
	turn on mudlle mode for that file when you edit it.
	The mudlle mode can be customized to some extent. See the source for
	details.

BUGS

	If you have any problems with powwow, try to fix them yourself
	(you have the source, right?) or at least isolate the bugs so
	the maintainer has a fair chance of fixing them. Don't expect
	a bug to be fixed, unless you explain it in detail (expecially
	how to reproduce it) and supply the powwow and OS version,
	as well as the compilation options.
        Suggestions for improvements are also very welcome.

AUTHORS OF CANCAN

	Since powwow is based on cancan, we report also this.

        Mattias Engdegård <f91-men@nada.kth.se> was the original author.
	Many other people have contributed at least as much, including
	Finn Arne Gangstad <finnag@pvv.unit.no>, David Gay <dgay@di.epfl.ch>,
	Gary Dezern <gdezern@satelnet.org>
	and Lai-Chang Woo <vivriel@scs.com.sg>.
	It is unclear who the current maintainer is, but it seems to be
	Finn Arne Gangstad. Ask around at MUME to find out more about cancan.

AUTHORS OF POWWOW

        Massimiliano Ghilardi <max@Linuz.sns.it>, alias Cosmos, is the original
	author, and Gustav Hållberg contributed a lot of new features.

	powwow moved to hoopajoo.net in 2005, and is now maintained by
	Steve Slaven <bpk@hoopajoo.net>

        The powwow WWW page is: http://hoopajoo.net/projects/powwow.html

	If you forgot where you downloaded powwow from, you can get it from
	the above address.

	To learn more about MUME, have a look at http://www.mume.org
	which also explains how to connect.

COPYRIGHT

	Powwow is placed under the terms of GPL (GNU General Public License)
	The GPL License can be found in the file COPYING.