powwow 1.2.13 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 was the original author. Many other people have contributed at least as much, including Finn Arne Gangstad , David Gay , Gary Dezern and Lai-Chang Woo . 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 , 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 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://fire.pvv.org/mume/ 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.