From 05209528cad427d4df322bde20f1662196e762e4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gustav=20H=C3=A5llberg?= Date: Thu, 1 Jan 2009 02:58:52 +0100 Subject: cleaned up the man page a bit diff --git a/powwow.6 b/powwow.6 index 97eac27..acf1d39 100644 --- a/powwow.6 +++ b/powwow.6 @@ -1,23 +1,16 @@ .\" -*-nroff-*- -.TH POWWOW 6 "09 Oct 2007" -.UC 4 +.TH POWWOW 6 "2008 Dec 30" "powwow 1.2.13" .SH NAME powwow \- telnet protocol client for MUD playing .SH SYNOPSIS .B powwow -[ -.I host port -] -| -[ -.I definition-file -] +.RI "[ " host " " port " ] | [ " definition-file " ]" .SH DESCRIPTION .PP .B powwow is a client program that implements the telnet protocol, adding some bells and whistles to the standard -.B telnet(1) +.BR telnet (1) communication utility, mainly intended for playing multi-user games such as .I MUDs (Multi User Dungeons). @@ -33,80 +26,92 @@ which is supposed to contain various definitions as well as the name of the host and the port number. If the definition-file does not exist, the user is prompted for the host name and port number which are saved in the new file. The definition file can be edited with any -text editor, and is updated whenever a definition (action, alias etc) -is changed. If the environment variable POWWOWDIR is defined, +text editor, and is updated whenever a definition (action, alias, +etc.) is changed. If the environment variable POWWOWDIR is defined, .B powwow will look there first for definition files (and create new ones there). Lines that begin with `#' are assumed to be special commands to be -processed locally. Help is available with the #help command. There is -also a more detailed manual somewhere. Notably, semicolons separate -commands on a single line. To send a literal semicolon, prefix it with -a backslash. +processed locally. Help is available with the +.I #help +command. There is also a more detailed manual somewhere. Notably, +semicolons separate commands on a single line. To send a literal +semicolon, prefix it with a backslash. .B powwow also supports the MUME editing protocol for editing texts locally. The name of the editor is taken from the environment variable POWWOWEDITOR -or EDITOR. "emacs" is used by default. For text viewing, POWWOWPAGER -is searched, then PAGER and "more" is used by default. +or EDITOR. +.BR emacs (1) +is used by default. For text viewing, POWWOWPAGER is searched, then +PAGER and +.BR more (1) +is used by default. If the first character of the editor is `&' (which is then skipped), -the editor is assumed to run in another window and powwow will run -concurrently with the editor without waiting for it to finish. +the editor is assumed to run in another window and +.I powwow +will run concurrently with the editor without waiting for it to +finish. + +When launched, the editor program will have its TITLE environment +variable set to the document title sent from the MUD. .SH AUTHOR .PP -Massimiliano Ghilardi and -Gustav Hållberg -are the people that added many new features to an existing client, +Massimiliano Ghilardi and Gustav HÃ¥llberg are the people that added many new features to an +existing client, .I Cancan -and transformed it into powwow. -Mattias EngdegÃ¥rd (f91-men@nada.kth.se) was the original author of Cancan -but 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). +and transformed it into +.IR powwow . +Mattias EngdegÃ¥rd (f91-men@nada.kth.se) was the original author of +Cancan but 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). -powwow moved to hoopajoo.net in 2005, and is now maintained by -Steve Slaven , please send bug reports and -patches to that address. +.I powwow +moved to hoopajoo.net in 2005, and is now maintained by Steve Slaven +, please send bug reports and patches to that +address. -The powwow WWW page is: http://hoopajoo.net/projects/powwow.html +The +.I powwow +WWW page is: http://hoopajoo.net/projects/powwow.html .I powwow was originally inspired by Peter Unold's .I Tintin -client, but now only bears a very remote resemblance -to the original. It aims to be a simple but very interactive client, -and contains features that are interesting for "immortal players", in +client, but now only bears a very remote resemblance to the +original. It aims to be a simple but very interactive client, and +contains features that are interesting for ``immortal'' players, in particular on MUME, though any mud player should benefit from .I powwow as well. .SH FILES -.br -.DT -.ta \w'$(POWWOWDIR)/*\ \ \ 'u -powwow The binary. -.br -$(POWWOWDIR)/* Definition files (aliases, etc) +.TP \w'$(POWWOWDIR)/*\ \ \ 'u +powwow +The binary. +.TP +$(POWWOWDIR)/* +Definition files for aliases, etc. .SH ENVIRONMENT -.DT -.ta \w'POWWOWEDITOR\ \ \ 'u -TERM Your terminal type. -.br -POWWOWDIR Where powwow will store and search for its -.br - files by default. -.br -POWWOWEDITOR Name of editor to use -.br -EDITOR Alternative editor -.br -POWWOWPAGER Name of pager to use -.br -PAGER Alternative pager +.TP +.B TERM +Your terminal type. +.TP +.B POWWOWDIR +Where powwow will store and search for its files by default. +.TP +.BR POWWOWEDITOR " or " EDITOR +Name of editor to use. +.TP +.BR POWWOWPAGER " or " PAGER +Name of pager to use. .SH SEE ALSO -telnet(1), more(1), emacs(1) +.BR telnet "(1), " more "(1), " emacs (1) .SH DIAGNOSTICS Most diagnostics are self-explanatory. Some are even more self-explanatory than others, namely those who crash the program. @@ -118,4 +123,3 @@ the remote host. .SH BUGS .PP Are you kidding? - -- cgit v0.10.2