-*- Mode:Text -*-

		 The new comint-based LPMUD interface
	      by Bjorn Victor <Bjorn.Victor@DoCS.UU.SE>
			 release of 12-Apr-91

The interface is built on comint.el, and thus has the same basic user
interface as cmushell, cmulisp et al.  It is inspired by lpmud.el by
Lars Willfor and Thomas Bellman of Lysator Computer Club.

Features:
* Coherent with cmushell, cmulisp, cmugdb et al, since it's based on comint.
* Dynamic abbrevs on TAB, word abbrevs work normally.
* Dynamic spell and combat spell names (give an argument to M-q or M-s).
* Powerful (I think) macro mechanism, with inversibility for simple actions.
* Start at automatic go-back mechanism
* Gag feature for Harry, Drunkard and those.
* Configuration list that *works*.
  It includes:
    selecting a mud name -> machine,port
    selecting a player name -> drink,spell
* Auto-replies
* Notification on messages when buffer is not in any window

For wizards:
* A real nice file editing/viewing interface.

It does not:
* have auto-actions (yet).
* automagically find out what drink and spell are best at the moment.
* have automatically updatable configurations
* have auto-save for wizards editing files
* have whatever more I haven't thought of

To use this code, do the following.

1) Copy/move comint.* into a directory in your load-path,
   or set your load-path so that it contains the directory
   where you put it.
   To set the load-path, do something like
   (setq load-path (cons (expand-file-name "~/emacs") load-path))
   in you .emacs file.  Substitute the directory you have the files in.
2) Do the same with clpmud.* and clpmud-ed.*.
3) Either simply load it (M-x load-library clpmud) and say M-x clpmud,
   or add
   (autoload 'clpmud "clpmud"
	     "Open an LPmud connection to HOST.
   HOST can be an Internet host name, or a name of an LPmud
   defined in clpmud-configuration-list.
   If it is a host name, the port number is given by prefix argument
    (e.g \\[universal-argument] 9000 \\[clpmud]),
   and defaults to 2000" t)
   to you .emacs file, and then use M-x clpmud.

Use
  C-h d clpmud
and
  C-h m
when in clpmud-mode
to get more documentation.
Then use C-h c and C-h d on the commands described there.

It has the following new commands bound to keys:

TAB             dabbrev-expand
RET             clpmud-send-input

ESC i           clpmud-inventory
ESC .           clpmud-score
ESC m           clpmud-missile
ESC s           clpmud-combat-spell
ESC q           clpmud-drink
ESC RET         clpmud-repeat-last-command
ESC DEL         clpmud-backward-kill-word

C-c i           clpmud-inventory
C-c .           clpmud-score
C-c w           clpmud-who
C-c l           clpmud-look
C-c m           clpmud-missile
C-c q           clpmud-drink
C-c s           clpmud-combat-spell
C-c u           clpmud-ungag-player
C-c g           clpmud-gag-player
C-c (           clpmud-start-macro-definition
C-c )           clpmud-end-macro-definition
C-c e           clpmud-run-macro
C-c C-v         clpmud-view-file
C-c C-e         clpmud-ed
C-c C-s         clpmud-send-ed-buffer
C-c C-@         clpmud-set-landmark
C-c C-b         clpmud-return-to-landmark

Also available are
 clpmud-list-macros	List defined macros
 clpmud-delete-macro	Delete a macro definition
 clpmud-save-macros	Save macros to a file
 clpmud-load-macros	Load macros from a file
 clpmud-set-auto-reply	Set auto-reply message

If Abbrev mode is turned on (see clpmud-mode-abbrev-mode),
the following commands are available:

C-x '		expand-abbrev
M-x unexpand-abbrev	   unexpand-abbrev
C-x C-a		add-mode-abbrev
C-x C-h		inverse-add-mode-abbrev
ESC '		abbrev-prefix-mark

See also the following non-interactive functions:
 clpmud-define-mud
 clpmud-define-player

See also variables:
 clpmud-configuration-list
 clpmud-drink
 clpmud-combat-spell
 clpmud-notify-on-messages
 clpmud-macro-table
 clpmud-macro-file-name
 clpmud-macro-blink-beep
 clpmud-macro-brief
 clpmud-macro-fast-execution
 clpmud-return-sends-whole-line
 clpmud-mode-abbrev-mode
 clpmud-mode-abbrev-table
 clpmud-mode-hook
 clpmud-load-hook