From: Richard M. Stallman <rms@gnu.org>
Date: Sun, 21 Dec 1997 01:49:03 +0000 (+0000)
Subject: (toggle-enable-multibyte-characters): Doc fix.
X-Git-Tag: emacs-20.3~2591
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=6998e1a1e534c28c3b14881203c5e6e1dc6e0064;p=emacs.git

(toggle-enable-multibyte-characters): Doc fix.
---

diff --git a/lisp/international/mule-cmds.el b/lisp/international/mule-cmds.el
index 193465dbae0..8a32a9f4c19 100644
--- a/lisp/international/mule-cmds.el
+++ b/lisp/international/mule-cmds.el
@@ -149,8 +149,17 @@
 ;;; (define-key global-map [?\S- ] 'toggle-input-method)
 
 (defun toggle-enable-multibyte-characters (&optional arg)
-  "Change whether this buffer enables multibyte characters.
-With arg, make them enable iff arg is positive."
+  "Change whether this buffer uses multibyte characters.
+With arg, use multibyte characters if the arg is positive.
+
+Note that this command does not convert the byte contents of
+the buffer; it only changes the way those bytes are interpreted.
+In general, therefore, this command *changes* the sequence of
+characters that the current buffer contains.
+
+We suggest you avoid using use this command unless you know what you
+are doing.  If you use it by mistake, and the buffer is now displayed
+wrong, use this command again to toggle back to the right mode."
   (interactive "P")
   (setq enable-multibyte-characters
 	(if (null arg) (null enable-multibyte-characters)