[Emacs-diffs] Changes to emacs/doc/emacs/display.texi,v

[Miles Bader]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Miles Bader <miles>     08/06/04 05:38:04

Index: doc/emacs/display.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/emacs/display.texi,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- doc/emacs/display.texi      3 Jun 2008 11:05:52 -0000       1.8
+++ doc/emacs/display.texi      4 Jun 2008 05:38:04 -0000       1.9
@@ -1178,24 +1178,48 @@
 These are commands which temporarily change the default face used to
 display text in a buffer.
 
address@hidden adjust buffer face height
address@hidden adjust-buffer-face-height
address@hidden C-x C-+
address@hidden C-x C--
address@hidden C-x C-=
address@hidden C-x C-0
+To increase the height of the default face in the current buffer one
+step, type @kbd{C-x C-+} or @kbd{C-x C-=}.  To decrease it one step,
+type @kbd{C-x C--}.  To restore the default (global) face height, type
address@hidden C-0}.  These keys are all bound to the same command,
address@hidden, which looks at the last key typed to
+determine the adjustment to make.
+
+The final key of these commands may be repeated without the leading
address@hidden -- for instance, @kbd{C-x C-= C-= C-=} increases the face
+height by three steps.
+
+Each step scales the height of the default face by the value of the
+variable @code{text-scale-mode-step} (a negative number of steps
+decreases the height by the same amount).  As a special case, an
+argument of 0 will remove any scaling currently active.
+
+This command is a special-purpose wrapper around the
address@hidden command which makes repetition
+convenient even when it is bound in a non-top-level keymap.  For
+binding in a top-level keymap, @code{increase-buffer-face-height} or
address@hidden may be more appropriate."
+
 @cindex increase buffer face height
 @findex increase-buffer-face-height
 @cindex decrease buffer face height
 @findex decrease-buffer-face-height
address@hidden text-scale-mode
-To increase the size of the font used to display text in the current
-buffer, type @kbd{C-=} or @kbd{C-+}
-(@code{increase-buffer-face-height}).  With a numeric prefix argument,
-the size will be increased by that many steps (the default is 1 step);
-each step scales the font height by the value of the variable
address@hidden  If repeated, this command has a
+The @code{increase-buffer-face-height} and
address@hidden commands increase or decrease the
+height of the default face in the current buffer by one step.  With a
+numeric prefix argument, the size will be increased/decreased by that
+many steps; each step scales the font height by the value of the
+variable @code{text-scale-mode-step}.  If repeated, this command has a
 cumulative effect.  As a special case, a prefix argument of 0 will
 remove any scaling currently active.
 
-To decrease the size of the text, type @kbd{C--}
-(@code{decrease-buffer-face-height}).  The behavior is similar to that
-of @code{increase-buffer-face-height}, but in reverse.
-
address@hidden text-scale-mode
 These commands automatically enable or disable the
 @code{text-scale-mode} minor-mode, depending on whether the current
 font scaling is other than 1 or not.