(ielm-prompt-read-only): Update docstring.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 65c8131fb61ca7e729eaf12d8263613ae72962b3..3095966655aafd0aa9ebc5ae04a3842b010ae229 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,14 @@
+2004-05-01  Luc Teirlinck  <teirllm@auburn.edu>
+
+       * ielm.el (ielm-prompt-read-only): Update docstring.
+
+       * comint.el (comint-prompt-read-only): Update docstring.
+       (comint-update-fence, comint-kill-whole-line)
+       (comint-kill-region): New functions.
+
+       * simple.el (kill-whole-line): Use "p" instead of "P" in
+       interactive form".
+
 2004-05-01  Juanma Barranquero  <lektu@terra.es>
 
        * help-fns.el (help-add-fundoc-usage): Use %S instead of %s to

diff --git a/lisp/ielm.el b/lisp/ielm.el
index 53e3d83cdaa17b155cd323953b6cfcc11445840a..944e2453cb9ef84c2fc5a05ed42abb24a83fc9eb 100644 (file)
--- a/lisp/ielm.el
+++ b/lisp/ielm.el
@@ -51,9 +51,30 @@
 
 (defcustom ielm-prompt-read-only t
   "If non-nil, the IELM prompt is read only.
+The read only region includes the newline before the prompt.
 Setting this variable does not affect existing IELM runs.
 This works by setting the buffer-local value of `comint-prompt-read-only'.
-Setting that value directly affects new prompts in the current buffer."
+Setting that value directly affects new prompts in the current buffer.
+
+If this option is enabled, then the safe way to temporarily
+override the read-only-ness of ielm prompts is to call
+`comint-kill-whole-line' or `comint-kill-region' with no
+narrowing in effect.  This way you will be certain that none of
+the remaining prompts will be accidentally messed up.  You may
+wish to put something like the following in your `.emacs' file:
+
+\(add-hook 'ielm-mode-hook
+         '(lambda ()
+            (define-key ielm-map \"\C-w\" 'comint-kill-region)
+            (define-key ielm-map [C-S-backspace]
+              'comint-kill-whole-line)))
+
+If you set `comint-prompt-read-only' to t, you might wish to use
+`comint-mode-hook' and `comint-mode-map' instead of
+`ielm-mode-hook' and `ielm-map'.  That will affect all comint
+buffers, including ielm buffers.  If you sometimes use ielm on
+text-only terminals or with `emacs -nw', you might wish to use
+another binding for `comint-kill-whole-line'."
   :type 'boolean
   :group 'ielm
   :version "21.4")