# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 882668943 0
# Node ID 141c2d41d39c59e029d7f5ce048c6dae04d35007
# Parent  1fe822fa93e614c793ff1b65763cdc0fb919531f
(toggle-enable-multibyte-characters): Doc fix.

diff -r 1fe822fa93e6 -r 141c2d41d39c lisp/international/mule-cmds.el
--- a/lisp/international/mule-cmds.el	Sun Dec 21 01:47:48 1997 +0000
+++ b/lisp/international/mule-cmds.el	Sun Dec 21 01:49:03 1997 +0000
@@ -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)