@c =============================================================
@c = $B85(B $BK](B $BLu(B: $BNkLZ1Y;R!wDEED=NBg3X(B
@c = $B2CI.=$@5(B: $BBgLZFXM:!wBgDM(B.$BC^GHBg3X(B = 1998/11/25
@c = 20.4$B2~D{(B: $BBgLZFXM:!wBgDM(B.$BC^GHBg3X(B = 1999/09/12
@c =============================================================
@c This is part of the Emacs manual.
@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Frames, International, Windows, Top
@c @chapter Frames and X Windows
@c @cindex frames
@chapter $B%U%l!<%`$H(BX$B%&%#%s%I%&%7%9%F%`(B
@cindex $B%U%l!<%`(B

@c   When using the X Window System, you can create multiple windows at the
@c X level in a single Emacs session.  Each X window that belongs to Emacs
@c displays a @dfn{frame} which can contain one or several Emacs windows.
@c A frame initially contains a single general-purpose Emacs window which
@c you can subdivide vertically or horizontally into smaller windows.  A
@c frame normally contains its own echo area and minibuffer, but you can
@c make frames that don't have these---they use the echo area and
@c minibuffer of another frame.
X$B%&%#%s%I%&%7%9%F%`$G;H$C$F$$$k$H$-$K$O!"(B
1$B$D$N(BEmacs$B%;%C%7%g%s$G(BX$B$N%l%Y%k$GJ#?t$N%&%#%s%I%&$r:n$k$3$H$,$G$-$^$9!#(B
Emacs$B$KB0$9$k(BX$B$N3F%&%#%s%I%&$O!"(B
Emacs$B$N%&%#%s%I%&$r(B1$B$D0J>e4^$a$3$H$,$G$-$k(B@dfn{$B%U%l!<%`(B}$B!J(Bframe$B!K$rI=<($7$^$9!#(B
$B%U%l!<%`$O!":G=i$OHFMQ$N(BEmacs$B$N%&%#%s%I%&$r(B1$B$D4^$_$^$9$,!"(B
$B>e2<:81&$K>.$5$J%&%#%s%I%&$KJ,3d$G$-$^$9!#(B
$B%U%l!<%`$ODL>o!"@lMQ$N%(%3!<NN0h$H%_%K%P%C%U%!$r4^$_$^$9$,!"(B
$B$=$l$i$r4^$^$J$$$b$N$r:n$k$3$H$b$G$-$^$9!#(B
$B$=$N>l9g$O!"JL$N%U%l!<%`$N%(%3!<NN0h$d%_%K%P%C%U%!$r;H$$$^$9!#(B

@c   Editing you do in one frame also affects the other frames.  For
@c instance, if you put text in the kill ring in one frame, you can yank it
@c in another frame.  If you exit Emacs through @kbd{C-x C-c} in one frame,
@c it terminates all the frames.  To delete just one frame, use @kbd{C-x 5
@c 0}.
$B$"$k%U%l!<%`$G$NJT=8$O!"JL$N%U%l!<%`$K$b1F6A$7$^$9!#(B
$B$?$H$($P!"$"$k%U%l!<%`$G%-%k%j%s%0$K%F%-%9%H$rF~$l$k$H!"(B
$BJL$N%U%l!<%`$G%d%s%/$G$-$^$9!#(B
$B$"$k%U%l!<%`$G(B@kbd{C-x C-c}$B$G(BEmacs$B$r=*$k$H!"(B
$B$9$Y$F$N%U%l!<%`$r=*N;$7$^$9!#(B
1$B$D$N%U%l!<%`$@$1$r:o=|$9$k$J$i!"(B@kbd{C-x 5 0}$B$r;H$$$^$9!#(B

@c   To avoid confusion, we reserve the word ``window'' for the
@c subdivisions that Emacs implements, and never use it to refer to a
@c frame.
$B:.Mp$rHr$1$k$?$a$K!"(BEmacs$B$,<BAu$7$F$$$k:YJ,2=$G$-$k$b$N$r(B
$B!X%&%#%s%I%&!Y$H8F$S!"%U%l!<%`$r0UL#$9$k$H$-$K$O$3$NC18l$r;H$$$^$;$s!#(B

@c   Emacs compiled for MS-DOS emulates some aspects of the window system
@c so that you can use many of the features described in this chapter.
@c @xref{MS-DOS Input}, for more information.
MS-DOS$BMQ$K%3%s%Q%$%k$7$?(BEmacs$B$O!"(B
$B%&%#%s%I%&%7%9%F%`$N$"$k<o$NFCD'$r%(%_%e%l!<%H$9$k$N$G!"(B
$BK\>O$G@bL@$9$k5!G=$NB?$/$r;H$&$3$H$,$G$-$^$9!#(B
$B>\$7$/$O!"(B@xref{MS-DOS Input}$B!#(B

@menu
* Mouse Commands::      Moving, cutting, and pasting, with the mouse.
* Secondary Selection:: Cutting without altering point and mark.
* Mouse References::    Using the mouse to select an item from a list.
* Menu Mouse Clicks::   Mouse clicks that bring up menus.
* Mode Line Mouse::     Mouse clicks on the mode line.
* Speedbar::            How to make and use a speedbar frame.
* Creating Frames::     Creating additional Emacs frames with various contents.
* Multiple Displays::   How one Emacs job can talk to several displays.
* Special Buffer Frames::  You can make certain buffers have their own frames.
* Frame Parameters::    Changing the colors and other modes of frames.
* Scroll Bars::	        How to enable and disable scroll bars; how to use them.
* Menu Bars::	        Enabling and disabling the menu bar.
* Faces::	        How to change the display style using faces.
* Font Lock::           Minor mode for syntactic highlighting using faces.
* Support Modes::       Font Lock support modes make Font Lock faster.
* Highlight Changes::   Using colors to show where you changed the buffer.
* Misc X::	        Iconifying and deleting frames. Region highlighting.
* Non-Window Terminals::  Multiple frames on terminals that show only one.
@end menu

@node Mouse Commands
@c @section Mouse Commands for Editing
@c @cindex mouse buttons (what they do)
@section $BJT=8MQ%^%&%9%3%^%s%I(B
@cindex $B%^%&%9%\%?%s!J2?$r$9$k$+!K(B

@c   The mouse commands for selecting and copying a region are mostly
@c compatible with the @code{xterm} program.  You can use the same mouse
@c commands for copying between Emacs and other X client programs.
$B%j!<%8%g%s$rA*Br$7$?$j%3%T!<$7$?$j$9$k%^%&%9%3%^%s%I$O!"(B
@code{xterm}$B%W%m%0%i%`$H$[$\8_49$G$9!#(B
Emacs$B$HB>$N(BX$B%/%i%$%"%s%H%W%m%0%i%`$H$N$"$$$@$G%3%T!<$9$k$K$O!"(B
X$B$N%^%&%9%3%^%s%I$HF1$8$b$N$r;H$($^$9!#(B

@kindex DELETE
@c   If you select a region with any of these mouse commands, and then
@c immediately afterward type the @key{DELETE} function key, it deletes the
@c region that you selected.  The @key{BACKSPACE} function key and the
@c ASCII character @key{DEL} do not do this; if you type any other key
@c in between the mouse command and @key{DELETE}, it does not do this.
$B$3$l$i$N%^%&%9%3%^%s%I$G%j!<%8%g%s$rA*Br$7$F!"(B
$B$=$N$"$H$9$0$K%U%!%s%/%7%g%s%-!<(B@key{DELETE}$B$rBG$D$H!"(B
$BA*Br$7$?%j!<%8%g%s$r:o=|$7$^$9!#(B
$B%U%!%s%/%7%g%s%-!<(B@key{BACKSPACE}$B$d(BASCII$BJ8;z(B@key{DEL}$B$O!"(B
$B$3$l$r9T$$$^$;$s!#(B
$B%^%&%9%3%^%s%I$H(B@key{DELETE}$B$N$"$$$@$KJL$N%-!<$rBG$C$?$H$-$b!"(B
$B$3$l$r9T$$$^$;$s!#(B

@findex mouse-set-region
@findex mouse-set-point
@findex mouse-yank-at-click
@findex mouse-save-then-click
@kindex Mouse-1
@kindex Mouse-2
@kindex Mouse-3
@table @kbd
@item Mouse-1
@c Move point to where you click (@code{mouse-set-point}).
@c This is normally the left button.
$B%/%j%C%/$7$?0LCV$K%]%$%s%H$r0\F0$9$k!J(B@code{mouse-set-point}$B!K!#(B
$BDL>o!":8%\%?%s!#(B

@item Drag-Mouse-1
@c Set the region to the text you select by dragging, and copy it to the
@c kill ring (@code{mouse-set-region}).  You can specify both ends of the
@c region with this single command.
$B%I%i%C%0$K$h$jA*Br$7$?%F%-%9%H$K%j!<%8%g%s$r@_Dj$7!"(B
$B%-%k%j%s%0$K$=$l$r%3%T!<$9$k!J(B@code{mouse-set-region}$B!K!#(B
$B%j!<%8%g%s$N;O$a$H=*$j$NN>J}$r$3$N%3%^%s%I(B1$B$D$G;XDj$G$-$k!#(B

@vindex mouse-scroll-min-lines
@c If you move the mouse off the top or bottom of the window while
@c dragging, the window scrolls at a steady rate until you move the mouse
@c back into the window.  This way, you can select regions that don't fit
@c entirely on the screen.  The number of lines scrolled per step depends
@c on how far away from the window edge the mouse has gone; the variable
@c @code{mouse-scroll-min-lines} specifies a minimum step size.
$B%I%i%C%0Cf$K!"%&%#%s%I%&$N>e2<$+$i%^%&%9$,=P$k$H!"(B
$B%^%&%9$,%&%#%s%I%&Fb$KLa$C$F$/$k$^$G!"(B
$B%&%#%s%I%&$r0lDj$N3d9g$G%9%/%m!<%k$9$k!#(B
$B$3$&$7$F!"2hLLA4BN$KF~$j$-$i$J$$%j!<%8%g%s$G$bA*Br$G$-$k!#(B
$B0lEY$K%9%/%m!<%k$9$k9T?t$O!"(B
$B%^%&%9$,%&%#%s%I%&$N1o$+$i$I$NDxEYN%$l$F$$$k$+$K0MB8$9$k!#(B
$BJQ?t(B@code{mouse-scroll-min-lines}$B$K$O:G>.$N9T?t$r;XDj$9$k!#(B

@item Mouse-2
@c Yank the last killed text, where you click (@code{mouse-yank-at-click}).
@c This is normally the middle button.
$B%/%j%C%/$7$?>l=j$K!"$b$C$H$b:G6a$K%-%k$7$?%F%-%9%H$r%d%s%/$9$k(B
$B!J(B@code{mouse-yank-at-click}$B!K!#(B
$BDL>o!"Cf%\%?%s!#(B

@item Mouse-3
@c This command, @code{mouse-save-then-kill}, has several functions
@c depending on where you click and the status of the region.
$B$3$N%3%^%s%I(B@code{mouse-save-then-kill}$B$O!"(B
$B%/%j%C%/$7$?>l=j$H%j!<%8%g%s$N>uBV$K0MB8$7$F!"(B
$B$$$/$D$+$N5!G=$,$"$k!#(B

@c The most basic case is when you click @kbd{Mouse-1} in one place and
@c then @kbd{Mouse-3} in another.  This selects the text between those two
@c positions as the region.  It also copies the new region to the kill
@c ring, so that you can copy it to someplace else.
$B$b$C$H$b4pK\E*$J>l9g$O!"$"$k>l=j$G(B@kbd{Mouse-1}$B$r%/%j%C%/$7$F$+$i!"(B
$BJL$N>l=j$G(B@kbd{Mouse-3}$B$r%/%j%C%/$7$?$H$-!#(B
$B$3$&$9$k$H!"$3$l$i$N(B2$BE@$N$"$$$@$K$"$k%F%-%9%H$r%j!<%8%g%s$H$7$FA*Br$9$k!#(B
$B$5$i$K!"?7$7$$%j!<%8%g%s$r%-%k%j%s%0$X$b%3%T!<$9$k$N$G!"(B
$BJL$N>l=j$X$=$l$r%3%T!<$G$-$k!#(B

@c If you click @kbd{Mouse-1} in the text, scroll with the scroll bar, and
@c then click @kbd{Mouse-3}, it remembers where point was before scrolling
@c (where you put it with @kbd{Mouse-1}), and uses that position as the
@c other end of the region.  This is so that you can select a region that
@c doesn't fit entirely on the screen.
$B%F%-%9%H>e$G(B@kbd{Mouse-1}$B$r%/%j%C%/$7$F$+$i!"(B
$B%9%/%m!<%k%P!<$G%9%/%m!<%k$7$?$"$H$G(B@kbd{Mouse-3}$B$r%/%j%C%/$9$k$H!"(B
$B%9%/%m!<%k$9$k0JA0$N!J(B@kbd{Mouse-1}$B$G%/%j%C%/$7$?!K>l=j$r3P$($F$$$F!"(B
$B$=$3$r%j!<%8%g%s$NJRJ}$NC<E@$H$7$F;H$&!#(B
$B$3$&$9$k$H!"2hLL$KF~$j$-$i$J$$%j!<%8%g%s$G$bA*Br$G$-$k!#(B

@c More generally, if you do not have a highlighted region, @kbd{Mouse-3}
@c selects the text between point and the click position as the region.  It
@c does this by setting the mark where point was, and moving point to where
@c you click.
$B$h$j0lHLE*$K$O!"6/D4I=<($5$l$?%j!<%8%g%s$,$J$$$J$i$P!"(B
@kbd{Mouse-3}$B$O!"%]%$%s%H$H%/%j%C%/$7$?0LCV$N$"$$$@$N%F%-%9%H$r(B
$B%j!<%8%g%s$H$7$FA*Br$9$k!#(B
$B$3$l$O!"%]%$%s%H$,$"$C$?0LCV$K%^!<%/$r@_Dj$7!"(B
$B%/%j%C%/$7$?0LCV$K%]%$%s%H$r0\F0$9$k$3$H$G9T$&!#(B

@c If you have a highlighted region, or if the region was set just before
@c by dragging button 1, @kbd{Mouse-3} adjusts the nearer end of the region
@c by moving it to where you click.  The adjusted region's text also
@c replaces the old region's text in the kill ring.
$B6/D4I=<($5$l$?%j!<%8%g%s$,$"$k>l9g!"$"$k$$$O!"(B
$B%\%?%s(B1$B$r%I%i%C%0$7$F%j!<%8%g%s$r@_Dj$7$F$"$k>l9g!"(B
@kbd{Mouse-3}$B$O%/%j%C%/$7$?>l=j$K6a$$B&$N%j!<%8%g%s$NC<$r(B
$B%/%j%C%/0LCV$K0\F0$7$FD4@0$9$k!#(B
$B$^$?!"D4@0$7$?%j!<%8%g%s$N%F%-%9%H$O!"(B
$B%-%k%j%s%0Fb$N8E$$%j!<%8%g%s$N%F%-%9%H$rCV$-49$($k!#(B

@c If you originally specified the region using a double or triple
@c @kbd{Mouse-1}, so that the region is defined to consist of entire words
@c or lines, then adjusting the region with @kbd{Mouse-3} also proceeds by
@c entire words or lines.
$B$b$H$b$H(B@kbd{Mouse-1}$B$r%@%V%k%/%j%C%/$"$k$$$O%H%j%W%k%/%j%C%/$7$F!"(B
$B%j!<%8%g%s$rC18l$d9TC10L$G@_Dj$7$?>l9g$K$O!"(B
@kbd{Mouse-3}$B$K$h$k%j!<%8%g%s$ND4@0$bC18l$d9TC10L$G9T$o$l$k!#(B

@c If you use @kbd{Mouse-3} a second time consecutively, at the same place,
@c that kills the region already selected.
$BO"B3$7$F(B2$BEYF1$8>l=j$G(B@kbd{Mouse-3}$B$r;H$&$H!"(B
$B$9$G$KA*Br$7$F$"$k%j!<%8%g%s$r%-%k$9$k!#(B

@item Double-Mouse-1
@c This key sets the region around the word which you click on.  If you
@c click on a character with ``symbol'' syntax (such as underscore, in C
@c mode), it sets the region around the symbol surrounding that character.
$B$3$N%-!<$O!"%/%j%C%/$7$?C18lA4BN$K%j!<%8%g%s$r@_Dj$9$k!#(B
$B!X%7%s%\%k!Y$N9=J8!J(BC$B$N2<@~$N$h$&$J!K$NJ8;z$r%/%j%C%/$9$k$H!"(B
$B$=$NJ8;z$r0O$`%7%s%\%kA4BN$K%j!<%8%g%s$r@_Dj$9$k!#(B

@c If you click on a character with open-parenthesis or close-parenthesis
@c syntax, it sets the region around the parenthetical grouping (sexp)
@c which that character starts or ends.  If you click on a character with
@c string-delimiter syntax (such as a singlequote or doublequote in C), it
@c sets the region around the string constant (using heuristics to figure
@c out whether that character is the beginning or the end of it).
$B3+$-3g8L$dJD$83g8L$N9=J8$NJ8;z$r%/%j%C%/$9$k$H!"(B
$B$=$NJ8;z$G;O$^$j!?=*$k3g8L$G0O$^$l$?2t!J(Bsexp$B!K$K%j!<%8%g%s$r@_Dj$9$k!#(B
$BJ8;zNs6h@Z$j$N9=J8!J(BC$B$N%7%s%0%k%/%)!<%H$d%@%V%k%/%)!<%H!K$NJ8;z$r%/%j%C%/(B
$B$9$k$H!"!J$=$NJ8;z$,J8;zNs$N;O$^$j$+=*$j$+$rH/8+E*J}K!$r;H$C$F7h$a$F!K(B
$BJ8;zNsDj?t$r0O$`%j!<%8%g%s$r@_Dj$9$k!#(B

@item Double-Drag-Mouse-1
@c This key selects a region made up of the words you drag across.
$B$3$N%-!<$O!"(B
$B%I%i%C%0$7$?HO0OFb$K$"$kC18l$r0O$`%j!<%8%g%s$r@_Dj$9$k!#(B

@item Triple-Mouse-1
@c This key sets the region around the line you click on.
$B$3$N%-!<$O!"%/%j%C%/$7$?9TA4BN$r0O$`%j!<%8%g%s$r@_Dj$9$k!#(B

@item Triple-Drag-Mouse-1
@c This key selects a region made up of the lines you drag across.
$B$3$N%-!<$O!"%I%i%C%0$7$?HO0OFb$K$"$k9T$9$Y$F$r0O$`%j!<%8%g%s$r@_Dj$9$k!#(B
@end table

@c   The simplest way to kill text with the mouse is to press @kbd{Mouse-1}
@c at one end, then press @kbd{Mouse-3} twice at the other end.
@c @xref{Killing}.  To copy the text into the kill ring without deleting it
@c from the buffer, press @kbd{Mouse-3} just once---or just drag across the
@c text with @kbd{Mouse-1}.  Then you can copy it elsewhere by yanking it.
$B%^%&%9$r;H$C$?$b$C$H$bC1=c$J%F%-%9%H$N%-%kJ}K!$O!"(B
$BJRJ}$NC<$G(B@kbd{Mouse-1}$B$r2!$7!"$b$&0lJ}$NC<$G(B@kbd{Mouse-3}$B$r(B2$B2s2!$9$3$H$G$9!#(B
@xref{Killing}$B!#(B
$B%P%C%U%!$+$i:o=|$7$J$$$G%-%k%j%s%0$K%F%-%9%H$r%3%T!<$9$k$K$O!"(B
@kbd{Mouse-3}$B$r0lEY$@$12!$7$^$9!#(B
$B$"$k$$$O!"(B@kbd{Mouse-1}$B$G%F%-%9%H$r2#CG$7$F%I%i%C%0$9$k$@$1$G$9!#(B
$B$=$&$9$k$H!"$I$3$G$G$b!"$=$l$r%d%s%/$9$k$3$H$G%3%T!<$G$-$^$9!#(B

@vindex mouse-yank-at-point
@c   To yank the killed or copied text somewhere else, move the mouse there
@c and press @kbd{Mouse-2}.  @xref{Yanking}.  However, if
@c @code{mouse-yank-at-point} is non-@code{nil}, @kbd{Mouse-2} yanks at
@c point.  Then it does not matter where you click, or even which of the
@c frame's windows you click on.  The default value is @code{nil}.  This
@c variable also affects yanking the secondary selection.
$B%-%k$7$?$j%3%T!<$7$?$j$7$?%F%-%9%H$r$I$3$+JL$N>l=j$K%d%s%/$9$k$K$O!"(B
$B%^%&%9$r$=$N>l=j$K0\F0$7$F(B@kbd{Mouse-2}$B$r2!$7$^$9!#(B
@xref{Yanking}$B!#(B
$B$7$+$7!"(B@code{mouse-yank-at-point}$B$,(B@code{nil}$B0J30$J$i$P!"(B
@kbd{Mouse-2}$B$O%]%$%s%H0LCV$K%d%s%/$7$^$9!#(B
$B$D$^$j!"%&%#%s%I%&$N$I$3$r%/%j%C%/$7$?$N$+!"$"$k$$$O!"(B
$B%U%l!<%`$N$I$N%&%#%s%I%&$r%/%j%C%/$7$?$N$+$OLdBj$G$O$"$j$^$;$s!#(B
$B%G%U%)%k%H$NCM$O(B@code{nil}$B$G$9!#(B
$B$3$NJQ?t$OFs<!%;%l%/%7%g%s$N%d%s%/$K$b1F6A$7$^$9!#(B

@c @cindex cutting and X
@c @cindex pasting and X
@c @cindex X cutting and pasting
@c   To copy text to another X window, kill it or save it in the kill ring.
@c Under X, this also sets the @dfn{primary selection}.  Then use the
@c ``paste'' or ``yank'' command of the program operating the other window
@c to insert the text from the selection.
@cindex $B%+%C%H$H(BX
@cindex $B%Z!<%9%H$H(BX
@cindex X$B$G$N%+%C%H$H%Z!<%9%H(B
$BJL$N(BX$B$N%&%#%s%I%&$X%F%-%9%H$r%3%T!<$9$k$K$O!"(B
$B$=$NItJ,$r%-%k$9$k$+%-%k%j%s%0$KJ]B8$7$^$9!#(B
X$B$N4IM}2<$G$O!"(B@dfn{$B0l<!%;%l%/%7%g%s(B}$B$b@_Dj$7$^$9!#(B
$B$=$N$"$H$G!"JL$N(BX$B$N%&%#%s%I%&$GF0$$$F$$$k%W%m%0%i%`$N!X%Z!<%9%H!Y$d(B
$B!X%d%s%/!Y%3%^%s%I$r;H$C$F!"%;%l%/%7%g%s$+$i%F%-%9%H$rA^F~$7$^$9!#(B

@c   To copy text from another X window, use the ``cut'' or ``copy'' command
@c of the program operating the other window, to select the text you want.
@c Then yank it in Emacs with @kbd{C-y} or @kbd{Mouse-2}.
$BJL$N(BX$B$N%&%#%s%I%&$+$i%F%-%9%H$r%3%T!<$9$k$K$O!"(B
$B$=$N%&%#%s%I%&$GF0$$$F$$$k%W%m%0%i%`$N!X%+%C%H!Y$d!X%3%T!<!Y%3%^%s%I$r(B
$B;H$C$FL\E*$N%F%-%9%H$r%;%l%/%7%g%s$K$7$^$9!#(B
$B$=$N$"$H$G!"(B@kbd{C-y}$B$d(B@kbd{Mouse-2}$B$r;H$C$F(BEmacs$B$K%d%s%/$7$^$9!#(B

@c   These cutting and pasting commands also work on MS-Windows.
$B$3$l$i$N%+%C%H!?%Z!<%9%H%3%^%s%I$O(BMS-Windows$B>e$G$bF0:n$7$^$9!#(B

@c @cindex primary selection
@c @cindex cut buffer
@c @cindex selection, primary
@cindex $B0l<!%;%l%/%7%g%s(B
@cindex $B%+%C%H%P%C%U%!(B
@cindex $B%;%l%/%7%g%s!"0l<!(B
@vindex x-cut-buffer-max
@c   When Emacs puts text into the kill ring, or rotates text to the front
@c of the kill ring, it sets the @dfn{primary selection} in the X server.
@c This is how other X clients can access the text.  Emacs also stores the
@c text in the cut buffer, but only if the text is short enough
@c (@code{x-cut-buffer-max} specifies the maximum number of characters);
@c putting long strings in the cut buffer can be slow.
Emacs$B$,%F%-%9%H$r%-%k%j%s%0$KF~$l$?$j!"(B
$B%-%k%j%s%0$N%F%-%9%H$r@hF,$X=d2s$9$k$H$-!"(B
Emacs$B$O(BX$B%5!<%P!<$N0l<!%;%l%/%7%g%s$K@_Dj$7$^$9!#(B
$B$3$N$?$a$K!"JL$N(BX$B%/%i%$%"%s%H$,%F%-%9%H$r;2>H$G$-$k$N$G$9!#(B
$B%F%-%9%H$,==J,$KC;$$>l9g$K$N$_(B
$B!J(B@code{x-cut-buffer-max}$B$O:GBgJ8;z?t$r;XDj$9$k!K!"(B
Emacs$B$O%+%C%H%P%C%U%!$K$b%F%-%9%H$r<}$a$^$9!#(B
$BD9$$J8;zNs$r%+%C%H%P%C%U%!$XCV$/$K$O;~4V$,$+$+$j$^$9!#(B

@c   The commands to yank the first entry in the kill ring actually check
@c first for a primary selection in another program; after that, they check
@c for text in the cut buffer.  If neither of those sources provides text
@c to yank, the kill ring contents are used.
$B%-%k%j%s%0$N;O$a$N%F%-%9%H$r%d%s%/$9$k%3%^%s%I$O!"(B
$B<B:]$K$O!"JL$N%W%m%0%i%`$N0l<!%;%l%/%7%g%s$r$^$:D4$Y!"(B
$B$=$N$"$H$G!"%+%C%H%P%C%U%!$N%F%-%9%H$rD4$Y$^$9!#(B
$B$I$A$i$K$b%d%s%/$9$k%F%-%9%H$,$J$l$P!"%-%k%j%s%0$NFbMF$r;H$$$^$9!#(B

@node Secondary Selection
@c @section Secondary Selection
@c @cindex secondary selection
@section $BFs<!%;%l%/%7%g%s(B
@cindex $BFs<!%;%l%/%7%g%s(B
@cindex $B%;%l%/%7%g%s!"Fs<!(B

@c   The @dfn{secondary selection} is another way of selecting text using
@c X.  It does not use point or the mark, so you can use it to kill text
@c without setting point or the mark.
@dfn{$BFs<!%;%l%/%7%g%s(B}$B$O!"(BX$B$K$*$$$F%F%-%9%H$rA*Br$9$kJL$NJ}K!$G$9!#(B
$B$3$l$O!"%]%$%s%H$d%^!<%/$r;H$o$J$$$N$G!"(B
$B%]%$%s%H$d%^!<%/$r@_Dj$;$:$K%F%-%9%H$r:o=|$9$k$N$K;H$($^$9!#(B

@table @kbd
@findex mouse-set-secondary
@kindex M-Drag-Mouse-1
@item M-Drag-Mouse-1
@c Set the secondary selection, with one end at the place where you press
@c down the button, and the other end at the place where you release it
@c (@code{mouse-set-secondary}).  The highlighting appears and changes as
@c you drag.
$B%\%?%s$r2!$7$?>l=j$rJRJ}$NC<!"%\%?%s$rN%$7$?>l=j$r$b$&0lJ}$NC<$H$7$F!"(B
$BFs<!%;%l%/%7%g%s$r@_Dj$9$k!J(B@code{mouse-set-secondary}$B!K!#(B
$B6/D4I=<($5$l%I%i%C%0$9$k$K$D$l$FJQ2=$9$k!#(B

@c If you move the mouse off the top or bottom of the window while
@c dragging, the window scrolls at a steady rate until you move the mouse
@c back into the window.  This way, you can mark regions that don't fit
@c entirely on the screen.
$B%I%i%C%0Cf$K%&%#%s%I%&$N>e2<$+$i%^%&%9$,=P$k$H!"(B
$B%&%#%s%I%&$X%^%&%9$,La$C$F$/$k$^$G!"(B
$B%&%#%s%I%&$r0lDj$N3d9g$G%9%/%m!<%k$9$k!#(B
$B$3$&$7$F!"2hLLA4BN$KF~$j$-$i$J$$%j!<%8%g%s$bA*Br$G$-$k!#(B

@findex mouse-start-secondary
@kindex M-Mouse-1
@item M-Mouse-1
@c Set one endpoint for the @dfn{secondary selection}
@c (@code{mouse-start-secondary}).
@dfn{$BFs<!%;%l%/%7%g%s(B}$B$N0lJ}$NC<$r@_Dj$9$k(B
$B!J(B@code{mouse-start-secondary}$B!K!#(B

@findex mouse-secondary-save-then-kill
@kindex M-Mouse-3
@item M-Mouse-3
@c Make a secondary selection, using the place specified with @kbd{M-Mouse-1}
@c as the other end (@code{mouse-secondary-save-then-kill}).  A second click
@c at the same place kills the secondary selection just made.
@kbd{M-Mouse-1}$B$G;XDj$7$?>l=j$r0lJ}$NC<$H$7$F;H$$!"(B
$BFs<!%;%l%/%7%g%s$r@_Dj$9$k!#(B
$B!J(B@code{mouse-secondary-save-then-kill}$B!K!#(B
$BF1$80LCV$G$N(B2$B2sL\$N%/%j%C%/$O!"(B
$B$A$g$&$I:n@.$7$?Fs<!%;%l%/%7%g%s$r%-%k$9$k!#(B

@findex mouse-yank-secondary
@kindex M-Mouse-2
@item M-Mouse-2
@c Insert the secondary selection where you click
@c (@code{mouse-yank-secondary}).  This places point at the end of the
@c yanked text.
$B%/%j%C%/$7$?0LCV$KFs<!%;%l%/%7%g%s$rA^F~$9$k(B
$B!J(B@code{mouse-yank-secondary}$B!K!#(B
$B%d%s%/$7$?%F%-%9%H$N:G8e$K%]%$%s%H$rCV$/!#(B
@end table

@c Double or triple clicking of @kbd{M-Mouse-1} operates on words and
@c lines, much like @kbd{Mouse-1}.
@kbd{M-Mouse-1}$B$N%@%V%k%/%j%C%/$d%H%j%W%k%/%j%C%/$O!"(B
@kbd{Mouse-1}$B$N$h$&$KC18l$d9TC10L$K:nMQ$7$^$9!#(B

@c If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-Mouse-2}
@c yanks at point.  Then it does not matter precisely where you click; all
@c that matters is which window you click on.  @xref{Mouse Commands}.
@code{mouse-yank-at-point}$B$,(B@code{nil}$B0J30$J$i$P!"(B
@kbd{M-Mouse-2}$B$O%]%$%s%H0LCV$K%d%s%/$7$^$9!#(B
$B$=$N$H$-$K$O!"$I$3$r%/%j%C%/$7$?$+$O4X78$J$/!"(B
$B$I$N%&%#%s%I%&$r%/%j%C%/$7$?$+$@$1$,4X78$7$^$9!#(B
@xref{Mouse Commands}$B!#(B

@node Mouse References
@c @section Following References with the Mouse
@c @kindex Mouse-2 @r{(selection)}
@section $B%^%&%9$G;2>H$rC)$k(B
@kindex Mouse-2 @r{$B!J%;%l%/%7%g%s!K(B}

@c   Some Emacs buffers display lists of various sorts.  These include
@c lists of files, of buffers, of possible completions, of matches for
@c a pattern, and so on.
$B$$$/$D$+$N(BEmacs$B%P%C%U%!$G$O!"$$$m$$$m$J$b$N$N0lMw$rI=<($7$^$9!#(B
$B%U%!%$%k0lMw!"%P%C%U%!0lMw!"Jd408uJd0lMw!"%Q%?!<%s$K0lCW$7$?$b$N$N0lMw(B
$B$J$I$G$9!#(B

@c   Since yanking text into these buffers is not very useful, most of them
@c define @kbd{Mouse-2} specially, as a command to use or view the item you
@c click on.
$B$3$l$i$N%P%C%U%!$K%F%-%9%H$r%d%s%/$G$-$F$bJXMx$H$$$&$3$H$O$J$$$N$G!"(B
$B$3$l$i$NB?$/$O(B@kbd{Mouse-2}$B$rFCJL$KDj5A$7$F!"(B
$B%/%j%C%/$7$?9`L\$r;H$C$?$jD/$a$?$j$9$k%3%^%s%I$H$7$F$$$^$9!#(B

@c   For example, if you click @kbd{Mouse-2} on a file name in a Dired
@c buffer, you visit that file.  If you click @kbd{Mouse-2} on an error
@c message in the @samp{*Compilation*} buffer, you go to the source code
@c for that error message.  If you click @kbd{Mouse-2} on a completion in
@c the @samp{*Completions*} buffer, you choose that completion.
$B$?$H$($P!"(Bdired$B%P%C%U%!$N%U%!%$%kL>$r(B@kbd{Mouse-2}$B$G%/%j%C%/$9$k$H!"(B
$B$=$N%U%!%$%k$rK,Ld$7$^$9!#(B
@samp{*Compilation*}$B%P%C%U%!$N%(%i!<%a%C%;!<%8$r(B@kbd{Mouse-2}$B$G(B
$B%/%j%C%/$9$k$H!"$=$N%(%i!<%a%C%;!<%8$KBP1~$9$k%=!<%9%3!<%I$X9T$-$^$9!#(B
@samp{*Completions*}$B%P%C%U%!$NJd408uJd$r(B@kbd{Mouse-2}$B$G%/%j%C%/$9$k$H!"(B
$B$=$NJd408uJd$rA*Br$7$^$9!#(B

@c   You can usually tell when @kbd{Mouse-2} has this special sort of
@c meaning because the sensitive text highlights when you move the mouse
@c over it.
$BH?1~$9$k%F%-%9%H$N>e$K%^%&%9$,0\F0$9$k$H%F%-%9%H$,6/D4I=<($5$l$k$N$G!"(B
@kbd{Mouse-2}$B$,$$$DFCJL$J0UL#$r;}$D$+IaDL$O$o$+$j$^$9!#(B

@node Menu Mouse Clicks
@c @section Mouse Clicks for Menus
@section $B%a%K%e!<$r=P$9%^%&%9%/%j%C%/(B

@c   Mouse clicks modified with the @key{CTRL} and @key{SHIFT} keys
@c bring up menus.
@key{CTRL}$B$d(B@key{SHIFT}$B%-!<$G=$>~$5$l$?%^%&%9%/%j%C%/$O!"(B
$B%a%K%e!<$rN)$A>e$2$^$9!#(B

@kindex C-Mouse-3
@table @kbd
@item C-Mouse-1
@c This menu is for selecting a buffer.
$B%P%C%U%!$rA*Br$9$k$?$a$N%a%K%e!<!#(B

@item C-Mouse-2
@c This menu is for specifying faces and other text properties
@c for editing formatted text.  @xref{Formatted Text}.
$B@07A:Q$_$N%F%-%9%H$K;H$&%U%'%$%9$d%F%-%9%HB0@-$r;XDj$9$k$?$a$N%a%K%e!<!#(B
@pxref{Formatted Text}$B!#(B

@item C-Mouse-3
@c This menu is mode-specific.  For most modes, this menu has the same
@c items as all the mode-specific menu-bar menus put together.  Some modes
@c may specify a different menu for this button.@footnote{Some systems use
@c @kbd{Mouse-3} for a mode-specific menu.  We took a survey of users, and
@c found they preferred to keep @kbd{Mouse-3} for selecting and killing
@c regions.  Hence the decision to use @kbd{C-Mouse-3} for this menu.}
$B%b!<%I$KFCM-$N%a%K%e!<!#(B
$B$[$H$s$I$N%b!<%I$G$O!"$3$N%a%K%e!<$O!"(B
$B$9$Y$F$N%b!<%IFCM-$N%a%K%e!<%P!<%a%K%e!<$r0l=o$K$7$?$N$HF1$89`L\$r;}$D!#(B
$B$$$/$D$+$N%b!<%I$G$O!"$3$N%\%?%s(B
@footnote{$B$$$/$D$+$N%7%9%F%`$G$O!"(B@kbd{Mouse-3}$B$r%b!<%IFCM-$N%a%K%e!<$K;H$&!#(B
$B%f!<%6!<$rD4::$7$?7k2L!"(B@kbd{Mouse-3}$B$r%j!<%8%g%s$NA*Br$H%-%k$K(B
$B;H$$B3$1$k$3$H$,9%$^$l$F$$$k$3$H$,H=L@$7$?!#(B
$B$f$($K!"$3$N%a%K%e!<$KBP$7$F(B@kbd{C-Mouse-3}$B$r;H$&$3$H$K$7$?!#(B}
$B$K0[$J$k%a%K%e!<$r;XDj$7$F$$$k$+$b$7$l$J$$!#(B

@item S-mouse-1
@c This menu is for specifying the frame's principal font.
$B%U%l!<%`$N<gMW%U%)%s%H$N;XDj$K4X$9$k%a%K%e!<!#(B
@end table

@node Mode Line Mouse
@c @section Mode Line Mouse Commands
@section $B%b!<%I9T$N%^%&%9%3%^%s%I(B

@c   You can use mouse clicks on window mode lines to select and manipulate
@c windows.
$B%&%#%s%I%&$rA*Br$7$?$jA`:n$9$k$?$a$K!"(B
$B%&%#%s%I%&$N%b!<%I9T$G%^%&%9%/%j%C%/$r;H$($^$9!#(B

@table @kbd
@item Mouse-1
@c @kbd{Mouse-1} on a mode line selects the window above.  By dragging
@c @kbd{Mouse-1} on the mode line, you can move it, thus changing the
@c height of the windows above and below.
$B%b!<%I9T$G(B@kbd{Mouse-1}$B$r%/%j%C%/$9$k$H$=$N>e$N%&%#%s%I%&$rA*Br$9$k!#(B
$B%b!<%I9T$r(B@kbd{Mouse-1}$B$G%I%i%C%0$9$k$H%b!<%I9T$r0\F0$9$k$3$H$,$G$-!"(B
$B$=$N%&%#%s%I%&$N9b$5$rJQ99$G$-$k!#(B 

@item Mouse-2
@c @kbd{Mouse-2} on a mode line expands that window to fill its frame.
$B%b!<%I9T$G(B@kbd{Mouse-2}$B$r%/%j%C%/$9$k$H!"(B
$B$=$N%U%l!<%`0lGU$K%&%#%s%I%&$r9-$2$k!#(B

@item Mouse-3
@c @kbd{Mouse-3} on a mode line deletes the window above.
$B%b!<%I9T$G(B@kbd{Mouse-3}$B$r%/%j%C%/$9$k$H!"(B
$B$=$N>e$N%&%#%s%I%&$r:o=|$9$k!#(B

@item C-Mouse-2
@c @kbd{C-Mouse-2} on a mode line splits the window above
@c horizontally, above the place in the mode line where you click.
$B%b!<%I9T$G(B@kbd{C-Mouse-2}$B$r%/%j%C%/$9$k$H!"(B
$B%b!<%I9T$r%/%j%C%/$7$?>l=j$G$=$N>e$N%&%#%s%I%&$r:81&$KJ,3d$9$k!#(B
@end table

@c   @kbd{C-Mouse-2} on a scroll bar splits the corresponding window
@c vertically.  @xref{Split Window}.
$B%9%/%m!<%k%P!<$G(B@kbd{C-Mouse-2}$B$r%/%j%C%/$9$k$H!"(B
$BBP1~$9$k%&%#%s%I%&$r>e2<$KJ,3d$7$^$9!#(B
@xref{Split Window}$B!#(B

@node Creating Frames
@c @section Creating Frames
@c @cindex creating frames
@section $B%U%l!<%`$N:n@.(B
@cindex $B%U%l!<%`$N:n@.(B

@kindex C-x 5
@c   The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}, with parallel
@c subcommands.  The difference is that @kbd{C-x 5} commands create a new
@c frame rather than just a new window in the selected frame (@pxref{Pop
@c Up Window}).  If an existing visible or iconified frame already displays
@c the requested material, these commands use the existing frame, after
@c raising or deiconifying as necessary. 
$B%W%l%U%#%C%/%9%-!<(B@kbd{C-x 5}$B$O!"(B
@kbd{C-x 4}$B$HF1$8$h$&$J%5%V%3%^%s%I$,$"$k$H$$$&E@$G;w$F$$$^$9!#(B
$B0c$$$O!"(B@kbd{C-x 5}$B%3%^%s%I$O!"(B
$BA*Br$5$l$F$$$k%U%l!<%`$G?7$?$K%&%#%s%I%&$r:n$k$N$G$O$J$/!"(B
$B?7$7$$%U%l!<%`$r:n$k$3$H$G$9!J(B@pxref{Pop Up Window}$B!K!#(B
$B4{B8$N8+$($F$$$k%U%l!<%`$d%"%$%3%s2=$5$l$?%U%l!<%`$,!"(B
$BMW5a$5$l$?FbMF$rI=<($7$F$$$k$J$i!"$3$l$i$N%3%^%s%I$O!"(B
$BI,MW$J$i%U%l!<%`$r$$$A$P$s<jA0$K$b$C$F$-$?$j%"%$%3%s$r3+$$$F$+$i!"(B
$B4{B8$N%U%l!<%`$r;H$$$^$9!#(B

@c   The various @kbd{C-x 5} commands differ in how they find or create the
@c buffer to select:
$B$5$^$6$^$J(B@kbd{C-x 5}$B%3%^%s%I$O!"(B
$BA*Br$9$k%P%C%U%!$NC5$7J}$d:n@.J}K!$,0[$J$j$^$9!#(B

@table @kbd
@item C-x 5 2
@kindex C-x 5 2
@findex make-frame-command
@c Create a new frame (@code{make-frame-command}).
$B?7$7$$%U%l!<%`$r:n$k!J(B@code{make-frame-command}$B!K!#(B
@item C-x 5 b @var{bufname} @key{RET}
@c Select buffer @var{bufname} in another frame.  This runs
@c @code{switch-to-buffer-other-frame}.
$BJL$N%U%l!<%`$G%P%C%U%!(B@var{bufname}$B$rA*Br$9$k!#(B
$B$3$l$O!"(B@code{switch-to-buffer-other-frame}$B$r<B9T$9$k!#(B
@item C-x 5 f @var{filename} @key{RET}
@c Visit file @var{filename} and select its buffer in another frame.  This
@c runs @code{find-file-other-frame}.  @xref{Visiting}.
$B%U%!%$%k(B@var{filename}$B$rK,Ld$7$F!"JL$N%U%l!<%`$G$=$N%P%C%U%!$rA*Br$9$k!#(B
$B$3$l$O!"(B@code{find-file-other-frame}$B$r<B9T$9$k!#(B
@pxref{Visiting}$B!#(B
@item C-x 5 d @var{directory} @key{RET}
@c Select a Dired buffer for directory @var{directory} in another frame.
@c This runs @code{dired-other-frame}.  @xref{Dired}.
$BJL$N%U%l!<%`$G%G%#%l%/%H%j(B@var{directory}$B$KBP$9$k(Bdired$B%P%C%U%!$rA*Br$9$k!#(B
$B$3$l$O!"(B@code{dired-other-frame}$B$r<B9T$9$k!#(B
@pxref{Dired}$B!#(B
@item C-x 5 m
@c Start composing a mail message in another frame.  This runs
@c @code{mail-other-frame}.  It is the other-frame variant of @kbd{C-x m}.
@c @xref{Sending Mail}.
$BJL$N%U%l!<%`$G%a%$%k%a%C%;!<%8$N:n@.$r;O$a$k!#(B
$B$3$l$O!"(B@code{mail-other-frame}$B$r<B9T$9$k!#(B
$B$3$l$O!"(B@kbd{C-x m}$B$NB>$N%U%l!<%`$r;H$&JQ7AHG!#(B
@pxref{Sending Mail}$B!#(B
@item C-x 5 .
@c Find a tag in the current tag table in another frame.  This runs
@c @code{find-tag-other-frame}, the multiple-frame variant of @kbd{M-.}.
@c @xref{Tags}.
$BJL$N%U%l!<%`$G8=:_$N%?%0%F!<%V%k$+$i%?%0$rC5$9!#(B
$B$3$l$O!"(B@code{find-tag-other-frame}$B$r<B9T$7!"(B
@kbd{M-.}$B$NJ#?t%U%l!<%`8~$1$NJQ7AHG!#(B
@pxref{Tags}$B!#(B
@item C-x 5 r @var{filename} @key{RET}
@kindex C-x 5 r
@findex find-file-read-only-other-frame
@c Visit file @var{filename} read-only, and select its buffer in another
@c frame.  This runs @code{find-file-read-only-other-frame}.
@c @xref{Visiting}.
$B%U%!%$%k(B@var{filename}$B$rFI$_=P$7@lMQ$GK,Ld$7!"(B
$BJL$N%U%l!<%`$G$=$N%P%C%U%!$rA*Br$9$k!#(B
$B$3$l$O!"(B@code{find-file-read-only-other-frame}$B$r<B9T$9$k!#(B
@pxref{Visiting}$B!#(B
@end table

@cindex default-frame-alist
@cindex initial-frame-alist
@c   You can control the appearance of new frames you create by setting the
@c frame parameters in @code{default-frame-alist}.  You can use the
@c variable @code{initial-frame-alist} to specify parameters that affect
@c only the initial frame.  @xref{Initial Parameters,,, elisp, The Emacs
@c Lisp Reference Manual}, for more information.
@code{default-frame-alist}$B$K%U%l!<%`%Q%i%a!<%?$r@_Dj$9$k$3$H$G!"(B
$B?7$?$K:n@.$9$k%U%l!<%`$N8+$?L\$r@)8f$G$-$^$9!#(B
$B=i4|%U%l!<%`$@$1$K1F6A$9$k%Q%i%a!<%?$r;XDj$9$k$K$O!"(B
$BJQ?t(B@code{initial-frame-alist}$B$r;H$$$^$9!#(B
$B>\$7$/$O!"(B@xref{Initial Parameters,,, elisp, The Emacs Lisp Reference Manual}$B!#(B

@c @cindex font (default)
@cindex $B%U%)%s%H!J%G%U%)%k%H!K(B
@c   The easiest way to specify the principal font for all your Emacs
@c frames is with an X resource (@pxref{Font X}), but you can also do it by
@c modifying @code{default-frame-alist} to specify the @code{font}
@c parameter, as shown here:
$B$9$Y$F$N(BEmacs$B%U%l!<%`$K<gMW%U%)%s%H$r;XDj$9$k$b$C$H$b4JC1$JJ}K!$O!"(B
X$B$N%j%=!<%9!J(B@pxref{Font X}$B!K$r;H$&$3$H$G$9$,!"(B
$B$D$.$K<($9$h$&$K!"(B@code{font}$B%Q%i%a!<%?$r;XDj$9$k$h$&$K(B
@code{default-frame-alist}$B$rJQ99$7$F$b$G$-$^$9!#(B

@example
(add-to-list 'default-frame-alist '(font . "10x20"))
@end example

@node Speedbar
@c @section Making and Using a Speedbar Frame
@section $B%9%T!<%I%P!<%U%l!<%`$N:n@.$H;H$$J}(B
@c @cindex speedbar
@cindex $B%9%T!<%I%P!<(B

@c   An Emacs frame can have a @dfn{speedbar}, which is a vertical window
@c that serves as a scrollable menu of files you could visit and tags
@c within those files.  To create a speedbar, type @kbd{M-x speedbar}; this
@c creates a speedbar window for the selected frame.  From then on, you can
@c click on a file name in the speedbar to visit that file in the
@c corresponding Emacs frame, or click on a tag name to jump to that tag in
@c the Emacs frame.
Emacs$B$N%U%l!<%`$O!"(B@dfn{$B%9%T!<%I%P!<(B}$B$r;}$D$3$H$,$G$-$^$9!#(B
$B%9%T!<%I%P!<$O!"=DD9$N%&%#%s%I%&$G!"(B
$BK,Ld$7$?$j%?%0$rC5$7$?$j$9$k$?$a$N%9%/%m!<%k2DG=$J(B
$B%U%!%$%k%a%K%e!<$H$7$FF/$-$^$9!#(B
$B%9%T!<%I%P!<$r:n$k$K$O!"(B@kbd{M-x speedbar}$B$HBG$A$^$9!#(B
$B$3$l$O!"A*Br$5$l$?%U%l!<%`$KBP$9$k%9%T!<%I%P!<%&%#%s%I%&$r:n$j$^$9!#(B
$B$=$&$9$k$H!"%9%T!<%I%P!<$N%U%!%$%kL>$r%/%j%C%/$9$k$H!"(B
$BBP1~$9$k(BEmacs$B%U%l!<%`$G$=$N%U%!%$%k$rK,Ld$G$-$^$9!#(B
$B$"$k$$$O!"%?%0$NL>A0$r%/%j%C%/$9$k$H!"(B
Emacs$B%U%l!<%`$G$=$N%?%0$N2U=j$XHt$s$G9T$-$^$9!#(B

@c   Initially the speedbar lists the immediate contents of the current
@c directory, one file per line.  Each line also has a box, @samp{[+]} or
@c @samp{<+>}, that you can click on with @kbd{Mouse-2} to ``open up'' the
@c contents of that item.  If the line names a directory, opening it adds
@c the contents of that directory to the speedbar display, underneath the
@c directory's own line.  If the line lists an ordinary file, opening it up
@c adds a list of the tags in that file to the speedbar display.  When a
@c file is opened up, the @samp{[+]} changes to @samp{[-]}; you can click
@c on that box to ``close up'' that file (hide its contents).
$B:G=i!"%9%T!<%I%P!<$K$O!"%+%l%s%H%G%#%l%/%H%j$ND>2<$NFbMF$r(B
1$B9T$K$D$-(B1$B$D$N%U%!%$%k$GI=<($7$^$9!#(B
$B3F9T$K$O!"(B@samp{[+]}$B$+(B@samp{<+>}$B$NH"$,$"$C$F!"(B
$B$=$l$r(B@kbd{Mouse-2}$B$G%/%j%C%/$9$k$H$=$N9`L\$NFbMF$r!X3+$1!Y$^$9!#(B
$B$=$N9T$NL>A0$,%G%#%l%/%H%j$J$i$P!"$=$l$r3+$/$H!"(B
$B$=$N%G%#%l%/%H%j$NFbMF$r$=$N9T$N2<$KDI2C$7$F%9%T!<%I%P!<$KI=<($7$^$9!#(B
$B$=$N9T$,IaDL$N%U%!%$%k$J$i$P!"$=$l$r3+$/$H!"(B
$B$=$N%U%!%$%kFb$N%?%00lMw$r%9%T!<%I%P!<$KDI2C$7$FI=<($7$^$9!#(B
$B%U%!%$%k$,3+$+$l$F$$$k$H!"(B@samp{[+]}$B$O(B@samp{[-]}$B$KJQ$o$j$^$9!#(B
$B%U%!%$%k$r!XJD$8$k!Y!JFbMF$r1#$9!K$?$a$K$=$NH"$r%/%j%C%/$G$-$^$9!#(B

@c   Some major modes, including Rmail mode, Info, and GUD, have
@c specialized ways of putting useful items into the speedbar for you to
@c select.  For example, in Rmail mode, the speedbar shows a list of Rmail
@c files, and lets you move the current message to another Rmail file by
@c clicking on its @samp{<M>} box.
rmail$B%b!<%I!"(Binfo$B%b!<%I!"(BGUD$B%b!<%I$r4^$`$$$/$D$+$N%a%8%c!<%b!<%I$K$O!"(B
$BA*Br2DG=$JM-MQ$J9`L\$r%9%T!<%I%P!<$KDI2C$9$kFCJL$JJ}K!$,$"$j$^$9!#(B
$B$?$H$($P!"(Brmail$B%b!<%I$G$O!"%9%T!<%I%P!<$K$O(Brmail$B%U%!%$%k0lMw$rI=<($7$^$9!#(B
$B%+%l%s%H%a%C%;!<%8$rJL$N(Brmail$B%U%!%$%k$K0\$9$K$O!"(B
$BL\E*$N(Brmail$B%U%!%$%k$N(B@samp{<M>}$B$NH"$r%/%j%C%/$9$k$@$1$G$9!#(B

@c   A speedbar belongs to one Emacs frame, and always operates on that
@c frame.  If you use multiple frames, you can make a speedbar for some or
@c all of the frames; type @kbd{M-x speedbar} in any given frame to make a
@c speedbar for it.
$B%9%T!<%I%P!<$O(B1$B$D$N(BEmacs$B%U%l!<%`$KB0$7!"$D$M$K$=$N%U%l!<%`$K:nMQ$7$^$9!#(B
$BJ#?t$N%U%l!<%`$r;H$&$H$-$K$O!"(B
$B0lIt$N%U%l!<%`$d$9$Y$F$N%U%l!<%`$K%9%T!<%I%P!<$r:n$l$^$9!#(B
$B%U%l!<%`$N%9%T!<%I%P!<$r:n$k$K$O!"$=$N%U%l!<%`$G(B@kbd{M-x speedbar}$B$HBG$A$^$9!#(B

@node Multiple Displays
@c @section Multiple Displays
@c @cindex multiple displays
@section $BJ#?t%G%#%9%W%l%$(B
@cindex $BJ#?t%G%#%9%W%l%$(B

@c   A single Emacs can talk to more than one X Windows display.
@c Initially, Emacs uses just one display---the one specified with the
@c @code{DISPLAY} environment variable or with the @samp{--display} option
@c (@pxref{Initial Options}).  To connect to another display, use the
@c command @code{make-frame-on-display}:
1$B$D$N(BEmacs$B$O!"J#?t$N(BX$B%G%#%9%W%l%$$HDL?.$G$-$^$9!#(B
$B:G=i$O!"(BEmacs$B$O(B1$B$D$N%G%#%9%W%l%$$@$1$r;H$$$^$9!#(B
$B4D6-JQ?t(B@code{DISPLAY}$B$d(B@samp{--display}$B%*%W%7%g%s$K;XDj$5$l$?$b$N$G$9(B
$B!J(B@pxref{Initial Options}$B!K!#(B
$BB>$N%G%#%9%W%l%$$K@\B3$9$k$K$O!"(B
$B%3%^%s%I(B@code{make-frame-on-display}$B$r;H$$$^$9!#(B

@findex make-frame-on-display
@table @kbd
@item M-x make-frame-on-display @key{RET} @var{display} @key{RET}
@c Create a new frame on display @var{display}.
$B%G%#%9%W%l%$(B@var{display}$B>e$K?7$7$$%U%l!<%`$r:n@.$9$k!#(B
@end table

@c   A single X server can handle more than one screen.  When you open
@c frames on two screens belonging to one server, Emacs knows they share a
@c single keyboard, and it treats all the commands arriving from these
@c screens as a single stream of input.
1$B$D$N(BX$B%5!<%P!<$OJ#?t$N%9%/%j!<%s$r07$($^$9!#(B
1$B$D$N%5!<%P!<$KB0$9$k(B2$B$D$N%9%/%j!<%s$K%U%l!<%`$r3+$/$H$-!"(B
Emacs$B$O(B1$B$D$N%-!<%\!<%I$r6&M-$7$F$$$k$3$H$rCN$C$F$$$F!"(B
$B$3$l$i$N%9%/%j!<%s$+$iE~Ce$9$k$9$Y$F$N%3%^%s%I$r(B1$B$D$N(B
$BF~NO%9%H%j!<%`$H$7$F07$$$^$9!#(B

@c   When you open frames on different X servers, Emacs makes a separate
@c input stream for each server.  This way, two users can type
@c simultaneously on the two displays, and Emacs will not garble their
@c input.  Each server also has its own selected frame.  The commands you
@c enter with a particular X server apply to that server's selected frame.
$B0[$J$k(BX$B%5!<%P!<>e$K%U%l!<%`$r3+$/$H$-!"(B
Emacs$B$O$=$l$>$l$N%5!<%P!<$KBP$7$FJL!9$NF~NO%9%H%j!<%`$r:n$j$^$9!#(B
$B$3$&$9$k$3$H$G!"(B2$B$D$N%G%#%9%W%l%$>e$G(B2$B?M$N%f!<%6!<$,F1;~$KBG80$G$-!"(B
Emacs$B$O$=$l$i$NF~NO$r$4$C$A$c$K$9$k$3$H$O$"$j$^$;$s!#(B
$B3F%5!<%P!<$K$O$=$l<+?H$,A*Br$7$F$$$k%U%l!<%`$,$"$j$^$9!#(B
$BFCDj$N(BX$B%5!<%P!<$GF~NO$7$?%3%^%s%I$O!"(B
$B$=$N%5!<%P!<$,A*Br$7$F$$$k%U%l!<%`$KE,MQ$5$l$^$9!#(B

@c   Despite these features, people using the same Emacs job from different
@c displays can still interfere with each other if they are not careful.
@c For example, if any one types @kbd{C-x C-c}, that exits the Emacs job
@c for all of them!
$B$3$l$i$N5!G=$K$b4X$o$i$:!"0[$J$k%G%#%9%W%l%$$GF1$8(BEmacs$B%8%g%V$r(B
$B;H$C$F$$$k?MC#$O!"Cm0U$rBU$k$H!"8_$$$K43>D$79g$C$F$7$^$$$^$9!#(B
$B$?$H$($P!"C/$+$,(B@kbd{C-x C-c}$B$HBG$D$H!"(B
$B$=$N?MC#$,6&M-$7$F$$$k!J(B1$B$D$N!K(BEmacs$B%8%g%V$O=*N;$7$F$7$^$$$^$9!*(B

@node Special Buffer Frames
@c @section Special Buffer Frames
@section $BFCJL$J%P%C%U%!%U%l!<%`(B

@vindex special-display-buffer-names
@c   You can make certain chosen buffers, for which Emacs normally creates
@c a second window when you have just one window, appear in special frames
@c of their own.  To do this, set the variable
@c @code{special-display-buffer-names} to a list of buffer names; any
@c buffer whose name is in that list automatically gets a special frame,
@c when an Emacs command wants to display it ``in another window.''
$B%&%#%s%I%&$,(B1$B$D$N$H$-$K$O(BEmacs$B$,IaDL(B2$B$D$a$N%&%#%s%I%&$r:n$k$h$&$J(B
$BFCDj$N%P%C%U%!$G$O!"$=$l@lMQ$NFCJL$J%U%l!<%`$KI=<($9$k$3$H$,$G$-$^$9!#(B
$B$3$&$9$k$K$O!"JQ?t(B@code{special-display-buffer-names}$B$K(B
$B%P%C%U%!L>$N%j%9%H$r@_Dj$7$^$9!#(B
$B$=$N%j%9%H$KL>A0$,$"$k$I$N%P%C%U%!$b!"(B
Emacs$B%3%^%s%I$,!XJL$N%&%#%s%I%&$K!YI=<($7$?$$$H$-$K$O!"(B
$BFCJL$J%U%l!<%`$r<+F0E*$K<hF@$7$^$9!#(B

@c   For example, if you set the variable this way,
$B$?$H$($P!"$D$.$N$h$&$KJQ?t$r@_Dj$7$?$H$9$k$H!"(B
$BJd400lMw!"(B@code{grep}$B$N=PNO!"(B@TeX{}$B%b!<%I$N%7%'%k%P%C%U%!$O!"(B
$B$=$l$>$l8DJL$N%U%l!<%`$r<hF@$7$^$9!#(B

@example
(setq special-display-buffer-names
      '("*Completions*" "*grep*" "*tex-shell*"))
@end example

@noindent
@c then completion lists, @code{grep} output and the @TeX{} mode shell
@c buffer get individual frames of their own.  These frames, and the
@c windows in them, are never automatically split or reused for any other
@c buffers.  They continue to show the buffers they were created for,
@c unless you alter them by hand.  Killing the special buffer deletes its
@c frame automatically.
$B$3$l$i$N%U%l!<%`$H$=$NCf$N%&%#%s%I%&$O!"(B
$BJL$N%P%C%U%!$N$?$a$K<+F0E*$KJ,3d$5$l$?$j:FMxMQ$5$l$k$3$H$O$"$j$^$;$s!#(B
$B<jF0$GJQ99$9$k$^$G!"$=$N$?$a$K:n@.$5$l$?%P%C%U%!$rI=<($7B3$1$^$9!#(B
$BFCJL$J%P%C%U%!$r>C5n$9$k$H!"$=$N%U%l!<%`$b<+F0E*$K:o=|$5$l$^$9!#(B

@vindex special-display-regexps
@c   More generally, you can set @code{special-display-regexps} to a list
@c of regular expressions; then a buffer gets its own frame if its name
@c matches any of those regular expressions.  (Once again, this applies only
@c to buffers that normally get displayed for you in a separate window.)
$B$h$j0lHLE*$K$O!"@55,I=8=$N%j%9%H$r(B@code{special-display-regexps}$B$K(B
$B@_Dj$G$-$^$9!#(B
$B$9$k$H!"%P%C%U%!$NL>A0$,$=$l$i$N@55,I=8=$K0lCW$9$k$H!"(B
$B%P%C%U%!$O@lMQ$N%U%l!<%`$r<hF@$7$^$9!#(B
$B!J7+$jJV$9$,!"$3$l$ODL>o!"JL$N%&%#%s%I%&$KI=<($9$k%P%C%U%!$K$N$_E,MQ$9$k!#!K(B

@vindex special-display-frame-alist
@c   The variable @code{special-display-frame-alist} specifies the frame
@c parameters for these frames.  It has a default value, so you don't need
@c to set it.
$BJQ?t(B@code{special-display-frame-alist}$B$O!"(B
$B$3$N$h$&$J%U%l!<%`$KBP$9$k%U%l!<%`%Q%i%a!<%?$r;XDj$7$^$9!#(B
$B$3$l$K$O%G%U%)%k%HCM$,$"$k$N$G!"FC$K@_Dj$9$kI,MW$O$"$j$^$;$s!#(B

@c   For those who know Lisp, an element of
@c @code{special-display-buffer-names} or @code{special-display-regexps}
@c can also be a list.  Then the first element is the buffer name or
@c regular expression; the rest of the list specifies how to create the
@c frame.  It can be an association list specifying frame parameter values;
@c these values take precedence over parameter values specified in
@c @code{special-display-frame-alist}.  Alternatively, it can have this
@c form:
Lisp$B$,$o$+$k?M$N$?$a$K$G$9$,!"(B
@code{special-display-buffer-names}$B$d(B@code{special-display-regexps}$B$NMWAG$O!"(B
$B%j%9%H$G$b$+$^$$$^$;$s!#(B
$B$=$N>l9g!":G=i$NMWAG$O%P%C%U%!L>$+@55,I=8=$G$9!#(B
$B%j%9%H$N;D$j$O!"%U%l!<%`$N:n@.J}K!$r;XDj$7$^$9!#(B
$B$3$l$O!"%U%l!<%`%Q%i%a!<%?$NCM$r;XDj$9$kO"A[%j%9%H$K$9$k$3$H$b$G$-$^$9!#(B
$B$3$l$i$NCM$O!"(B@code{special-display-frame-alist}$B$K(B
$B;XDj$5$l$?%Q%i%a!<%?$NCM$h$jM%@h$5$l$^$9!#(B
$B$"$k$$$O!"%j%9%H$O$D$.$N$h$&$J7A<0$K$9$k$3$H$b$G$-$^$9!#(B

@example
(@var{function} @var{args}...)
@end example

@noindent
@c where @var{function} is a symbol.  Then the frame is constructed by
@c calling @var{function}; its first argument is the buffer, and its
@c remaining arguments are @var{args}.
$B$3$3$G!"(B@var{function}$B$O%7%s%\%k$G$9!#(B
$B$3$&$9$k$H!"(B@var{function}$B$r8F$s$G%U%l!<%`$r:n$j$^$9!#(B
$B4X?t8F$S=P$7$N:G=i$N0z?t$O%P%C%U%!$G!";D$j$N0z?t$O(B@var{args}$B$G$9!#(B

@c    An analogous feature lets you specify buffers which should be
@c displayed in the selected window.  @xref{Force Same Window}.  The
@c same-window feature takes precedence over the special-frame feature;
@c therefore, if you add a buffer name to
@c @code{special-display-buffer-names} and it has no effect, check to see
@c whether that feature is also in use for the same buffer name.
$B;w$?$h$&$J5!G=$G!"%P%C%U%!$r$I$NA*Br$5$l$F$$$k%&%#%s%I%&$KI=<($9$k$+(B
$B;XDj$G$-$^$9!#(B
@xref{Force Same Window}$B!#(B
$BF1$8%&%#%s%I%&$KI=<($9$k5!G=$O!"FCJL$J%U%l!<%`$KI=<($9$k5!G=$KM%$j$^$9!#(B
$B$7$?$,$C$F!"%P%C%U%!L>$r(B@code{special-display-buffer-names}$B$KDI2C$7$F$b(B
$B2?$N8z2L$b$J$+$C$?$i!"(B
$B$=$N5!G=$,F1$8%P%C%U%!L>$KBP$7$F$b;H$o$l$F$$$J$$$+D4$Y$F$/$@$5$$!#(B

@node Frame Parameters
@c @section Setting Frame Parameters
@c @cindex colors
@c @cindex Auto-Raise mode
@c @cindex Auto-Lower mode
@section $B%U%l!<%`%Q%i%a!<%?$N@_Dj(B
@cindex $BI=<(?'(B
@cindex $B%*!<%H%l%$%:%b!<%I!J(BAuto-Raise mode$B!K(B
@cindex $B%*!<%H%m!<%o%b!<%I!J(BAuto-Lower mode$B!K(B

@c   This section describes commands for altering the display style and
@c window management behavior of the selected frame.
$BK\@a$G$O!"A*Br$7$F$$$k%U%l!<%`$NI=<(%9%?%$%k$d%&%#%s%I%&4IM}$N$U$k$^$$$r(B
$BJQ99$9$k%3%^%s%I$r@bL@$7$^$9!#(B

@findex set-foreground-color
@findex set-background-color
@findex set-cursor-color
@findex set-mouse-color
@findex set-border-color
@findex auto-raise-mode
@findex auto-lower-mode
@table @kbd
@item M-x set-foreground-color @key{RET} @var{color} @key{RET}
@c Specify color @var{color} for the foreground of the selected frame.
$BA*Br$7$F$$$k%U%l!<%`$NA07J?'$r(B@var{color}$B$H;XDj$9$k!#(B

@item M-x set-background-color @key{RET} @var{color} @key{RET}
@c Specify color @var{color} for the background of the selected frame.
@c This changes the foreground color of the @code{modeline} face also, so
@c that it remains in inverse video compared with the default.
$BA*Br$7$F$$$k%U%l!<%`$NGX7J?'$r(B@var{color}$B$H;XDj$9$k!#(B
$B$3$l$O(B@code{modeline}$B%U%'%$%9$NA07J?'$bJQ99$9$k$N$G!"(B
$B%G%U%)%k%H$HHf3S$7$F$bH?E>I=<($N$^$^$K$J$k!#(B

@item M-x set-cursor-color @key{RET} @var{color} @key{RET}
@c Specify color @var{color} for the cursor of the selected frame.
$BA*Br$7$F$$$k%U%l!<%`$N%+!<%=%k$NI=<(?'$r(B@var{color}$B$H;XDj$9$k!#(B

@item M-x set-mouse-color @key{RET} @var{color} @key{RET}
@c Specify color @var{color} for the mouse cursor when it is over the
@c selected frame.
$B%^%&%9%+!<%=%k$,A*Br$7$F$$$k%U%l!<%`Fb$K$"$k$H$-$N(B
$B%^%&%9%+!<%=%k$NI=<(?'$r(B@var{color}$B$H;XDj$9$k!#(B

@item M-x set-border-color @key{RET} @var{color} @key{RET}
@c Specify color @var{color} for the border of the selected frame.
$BA*Br$7$F$$$k%U%l!<%`$N6-3&?'$r(B@var{color}$B$H;XDj$9$k!#(B

@item M-x list-colors-display
@c Display the defined color names and show what the colors look like.
@c This command is somewhat slow.
$BDj5A$5$l$F$$$kI=<(?'$NL>>N$H$=$l$,$I$&8+$($k$+I=<($9$k!#(B
$B$3$N%3%^%s%I$O>/$7CY$$!#(B

@item M-x auto-raise-mode
@c Toggle whether or not the selected frame should auto-raise.  Auto-raise
@c means that every time you move the mouse onto the frame, it raises the
@c frame.
$BA*Br$5$l$F$$$k%U%l!<%`$r%*!<%H%l%$%:$9$k$Y$-$+$I$&$+@Z$jBX$($k!#(B
$B%*!<%H%l%$%:$H$O!"%^%&%9%+!<%=%k$,%U%l!<%`$KF~$k$?$S$K!"(B
$B$=$N%U%l!<%`$r<jA0$K$b$C$F$/$k$3$H!#(B

@c Note that this auto-raise feature is implemented by Emacs itself.  Some
@c window managers also implement auto-raise.  If you enable auto-raise for
@c Emacs frames in your X window manager, it should work, but it is beyond
@c Emacs's control and therefore @code{auto-raise-mode} has no effect on
@c it.
$B$3$N%*!<%H%l%$%:5!G=$O(BEmacs$B<+?H$,<BAu$7$F$$$k$3$H$KCm0U!#(B
$B%&%#%s%I%&%^%M!<%8%c$NCf$K$b!"%*!<%H%l%$%:$r<BAu$7$F$$$k$b$N$,$"$k!#(B
X$B$N%&%#%s%I%&%^%M!<%8%c$G(BEmacs$B%U%l!<%`$N%*!<%H%l%$%:$r;XDj$7$F$$$k$H$-$K$O!"(B
$B$=$l$,F0:n$9$k$O$:!#(B
$B$7$+$7!"$=$l$O(BEmacs$B$N@)8f$rD6$($F$$$k$N$G!"$=$l$K4X$7$F$O(B
@code{auto-raise-mode}$B$O2?$N1F6A$b$J$$!#(B

@item M-x auto-lower-mode
@c Toggle whether or not the selected frame should auto-lower.
@c Auto-lower means that every time you move the mouse off the frame,
@c the frame moves to the bottom of the stack of X windows.
$BA*Br$5$l$F$$$k%U%l!<%`$r%*!<%H%m!<%o$9$k$Y$-$+$I$&$+@Z$jBX$($k!#(B
$B%*!<%H%m!<%o$H$O!"%^%&%9%+!<%=%k$,%U%l!<%`$+$i=P$k$?$S$K!"(B
$B$=$N%U%l!<%`$r(BX$B$N%&%#%s%I%&%9%?%C%/$NDl$K0\$9$3$H!#(B

@c The command @code{auto-lower-mode} has no effect on auto-lower
@c implemented by the X window manager.  To control that, you must use
@c the appropriate window manager features.
$B%3%^%s%I(B@code{auto-lower-mode}$B$O!"(B
X$B$N%&%#%s%I%&%^%M!<%8%c$,<BAu$9$k%*!<%H%m!<%o$K$O2?$N1F6A$b$J$$!#(B
$B$=$l$r@)8f$9$k$K$O!"E,@Z$J%&%#%s%I%&%^%M!<%8%c$N5!G=$r;H$&I,MW$,$"$k!#(B

@findex set-frame-font
@item M-x set-frame-font @key{RET} @var{font} @key{RET}
@c @cindex font (principal)
@cindex $B%U%)%s%H!J<gMW!K(B
@c Specify font @var{font} as the principal font for the selected frame.
@c The principal font is used for all text displayed in the frame, except
@c when a face (@pxref{Faces}) specifies a different font to use for
@c certain text.  @xref{Font X}, for ways to list the available fonts on
@c your system.
$BA*Br$5$l$?%U%l!<%`$KBP$9$k<gMW%U%)%s%H$H$7$F(B@var{font}$B$r;XDj$9$k!#(B
$B%U%'%$%9!J(B@pxref{Faces}$B!K$,JL$N%U%)%s%H$r;H$&$3$H$r;XDj$7$F$$$k$H$-$r(B
$B=|$$$F!"<gMW%U%)%s%H$O!"%U%l!<%`$KI=<($9$k$9$Y$F$N%F%-%9%H$KBP$7$F;H$o$l$k!#(B
$B$"$J$?$N%7%9%F%`$G;H$($k%U%)%s%H0lMw$rI=<($9$kJ}K!$K$D$$$F$O!"(B
@pxref{Font X}$B!#(B

@c @kindex S-Mouse-1
@c You can also set a frame's principal font through a pop-up menu.
@c Press @kbd{S-Mouse-1} to activate this menu.
$B%]%C%W%"%C%W%a%K%e!<$+$i!"%U%l!<%`$N<gMW%U%)%s%H$r@_Dj$9$k$3$H$b$G$-$k!#(B
$B$3$N%a%K%e!<$rN)$A>e$2$k$K$O(B@kbd{S-Mouse-1}$B$r2!$9!#(B
@end table

@c   In Emacs versions that use an X toolkit, the color-setting and
@c font-setting functions don't affect menus and the menu bar, since they
@c are displayed by their own widget classes.  To change the appearance of
@c the menus and menu bar, you must use X resources (@pxref{Resources X}).
@c @xref{Colors X}, regarding colors.  @xref{Font X}, regarding choice of
@c font.
X$B%D!<%k%-%C%H$r;H$&(BEmacs$B$NHG$G$O!"I=<(?'$H%U%)%s%H$r@_Dj$9$k4X?t$O(B
$B%a%K%e!<$d%a%K%e!<%P!<$K$O1F6A$7$^$;$s!#(B
$B$H$$$&$N$O!"%a%K%e!<$d%a%K%e!<%P!<$O!"(B
$B$=$l$i<+?H$N%&%#%8%'%C%H%/%i%9$r;H$C$FI=<($5$l$F$$$k$+$i$G$9!#(B
$B%a%K%e!<$H%a%K%e!<%P!<$N8+$?L\$rJQ99$9$k$K$O!"(B
X$B$N%j%=!<%9$r;H$&I,MW$,$"$j$^$9!J(B@pxref{Resources X}$B!K!#(B
$BI=<(?'$K4X$7$F$O!"(B@xref{Colors X}$B!#(B
$B%U%)%s%H$NA*Br$K$D$$$F$O!"(B@xref{Font X}$B!#(B

@c   For information on frame parameters and customization, see @ref{Frame
@c Parameters,,, elisp, The Emacs Lisp Reference Manual}.
$B%U%l!<%`%Q%i%a!<%?$H$=$N%+%9%?%^%$%:$K$D$$$F$O!"(B
@xref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}$B!#(B

@node Scroll Bars
@c @section Scroll Bars
@section $B%9%/%m!<%k%P!<(B
@c @cindex Scroll Bar mode
@c @cindex mode, Scroll Bar
@cindex $B%9%/%m!<%k%P!<%b!<%I!J(BScroll Bar mode$B!K(B
@cindex $B%b!<%I!"(BScroll Bar

@c   When using X, Emacs normally makes a @dfn{scroll bar} at the left of
@c each Emacs window.  The scroll bar runs the height of the window, and
@c shows a moving rectangular inner box which represents the portion of the
@c buffer currently displayed.  The entire height of the scroll bar
@c represents the entire length of the buffer.
X$B$r;H$C$F$$$k$H$-$K$O!"(BEmacs$B$ODL>o!"3F(BEmacs$B%&%#%s%I%&$N:8B&$K(B
@dfn{$B%9%/%m!<%k%P!<(B}$B!J(Bscroll bar$B!K$r:n$j$^$9!#(B
$B%9%/%m!<%k%P!<$O!"%&%#%s%I%&$N9b$5$K1d$S$F$$$F!"(B
$BFbB&$KF0$/6k7A$NH"$rI=<($7$^$9!#(B
$B$3$NH"$O!"8=:_I=<($5$l$F$$$k%P%C%U%!Fb$NItJ,$rI=$7$F$$$^$9!#(B
$B%9%/%m!<%k%P!<$NA4BN$N9b$5$O!"%P%C%U%!$NA4BN$ND9$5$rI=$7$^$9!#(B

@c   You can use @kbd{Mouse-2} (normally, the middle button) in the scroll
@c bar to move or drag the inner box up and down.  If you move it to the
@c top of the scroll bar, you see the top of the buffer.  If you move it to
@c the bottom of the scroll bar, you see the bottom of the buffer.
@kbd{Mouse-2}$B!JDL>o!"Cf%\%?%s!K$r;H$C$F!"(B
$B%9%/%m!<%k%P!<$NFbB&$NH"$r>e2<$K0\F0$7$?$j%I%i%C%0$G$-$^$9!#(B
$BFbB&$NH"$r%9%/%m!<%k%P!<$N$$$A$P$s>e$X0\F0$9$k$H!"(B
$B%P%C%U%!$N@hF,$r8+$k$3$H$,$G$-$^$9!#(B
$B%9%/%m!<%k%P!<$N$$$A$P$s2<$KFbB&$NH"$r0\F0$9$k$H!"%P%C%U%!$NKvHx$,8+$($^$9!#(B

@c   The left and right buttons in the scroll bar scroll by controlled
@c increments.  @kbd{Mouse-1} (normally, the left button) moves the line at
@c the level where you click up to the top of the window.  @kbd{Mouse-3}
@c (normally, the right button) moves the line at the top of the window
@c down to the level where you click.  By clicking repeatedly in the same
@c place, you can scroll by the same distance over and over.
$B%9%/%m!<%k%P!<$G:8$d1&%\%?%s$r;H$&$H!"@)8f$5$l$?A}J,$G%9%/%m!<%k$G$-$^$9!#(B
@kbd{Mouse-1}$B!JDL>o!":8%\%?%s!K$O!"(B
$B%/%j%C%/$7$?>l=j$N9b$5$N9T$r%&%#%s%I%&$N:G>eC<$N9T$X0\F0$7$^$9!#(B
@kbd{Mouse-3}$B!JDL>o!"1&%\%?%s!K$O!"(B
$B%&%#%s%I%&$N:G>eC<$N9T$r%/%j%C%/$7$?>l=j$N9b$5$N9T$X0\F0$7$^$9!#(B
$BF1$80LCV$G7+$jJV$7%/%j%C%/$9$k$H!"(B
$BF1$8J,NL$N%9%/%m!<%k$r7+$jJV$7$^$9!#(B

@c   Aside from scrolling, you can also click @kbd{C-Mouse-2} in the scroll
@c bar to split a window vertically.  The split occurs on the line where
@c you click.
$B%9%/%m!<%k0J30$G$O!"%9%/%m!<%k%P!<$G(B@kbd{C-Mouse-2}$B$r%/%j%C%/$9$k$H!"(B
$B%&%#%s%I%&$r>e2<$KJ,3d$G$-$^$9!#(B
$B%/%j%C%/$7$?>l=j$N9T$GJ,3d$5$l$^$9!#(B

@findex scroll-bar-mode
@c   You can enable or disable Scroll Bar mode with the command @kbd{M-x
@c scroll-bar-mode}.  With no argument, it toggles the use of scroll bars.
@c With an argument, it turns use of scroll bars on if and only if the
@c argument is positive.  This command applies to all frames, including
@c frames yet to be created.  You can use the X resource
@c @samp{verticalScrollBars} to control the initial setting of Scroll Bar
@c mode.  @xref{Resources X}.
$B%3%^%s%I(B@kbd{M-x scroll-bar-mode}$B$G!"(B
$B%9%/%m!<%k%P!<!J(Bscroll-bar$B!K%b!<%I$r%*%s!?%*%U$G$-$^$9!#(B
$B0z?t$r;XDj$7$J$1$l$P!"%9%/%m!<%k%P!<$N;HMQ$r%H%0%k$7$^$9!#(B
$B0z?t$r;XDj$7$?>l9g!"0z?t$,@5$N$H$-$@$1%9%/%m!<%k%P!<$r;H$&$h$&$K$7$^$9!#(B
$B$3$N%3%^%s%I$O!"$3$l$+$i:n@.$5$l$k%U%l!<%`$r4^$a$F$9$Y$F$N(B
$B%U%l!<%`$K:nMQ$7$^$9!#(B
X$B$N%j%=!<%9(B@samp{verticalScrollBars}$B$r;H$C$F!"(B
$B%9%/%m!<%k%P!<!J(Bscroll-bar$B!K%b!<%I$N=i4|@_Dj$r@)8f$G$-$^$9!#(B
@xref{Resources X}$B!#(B

@c @findex toggle-scroll-bar
@c   To enable or disable scroll bars for just the selected frame, use the
@c @kbd{M-x toggle-scroll-bar} command.
$BA*Br$5$l$F$$$k%U%l!<%`$KBP$7$F$N$_%9%/%m!<%k%P!<$r%*%s!?%*%U$9$k$K$O!"(B
@kbd{M-x toggle-scroll-bar}$B%3%^%s%I$r;H$$$^$9!#(B

@node Menu Bars
@c @section Menu Bars
@c @cindex Menu Bar mode
@c @cindex mode, Menu Bar
@section $B%a%K%e!<%P!<(B
@cindex $B%a%K%e!<%P!<%b!<%I!J(BMenu Bar mode$B!K(B
@cindex $B%b!<%I!"(BMenu Bar

@c   You can turn display of menu bars on or off with @kbd{M-x
@c menu-bar-mode}.  With no argument, this command toggles Menu Bar mode, a
@c minor mode.  With an argument, the command turns Menu Bar mode on if the
@c argument is positive, off if the argument is not positive.  You can use
@c the X resource @samp{menuBarLines} to control the initial setting of
@c Menu Bar mode.  @xref{Resources X}.  Expert users often turn off the
@c menu bar, especially on text-only terminals, where this makes one
@c additional line available for text.
@kbd{M-x menu-bar-mode}$B$G%a%K%e!<%P!<$NI=<($r%*%s!?%*%U$G$-$^$9!#(B
$B0z?t$r;XDj$7$J$$$H!"$3$N%3%^%s%I$O%^%$%J%b!<%I$G$"$k(B
$B%a%K%e!<%P!<!J(Bmenu-bar$B!K%b!<%I$r%H%0%k$7$^$9!#(B
$B0z?t$r;XDj$7$?>l9g!"0z?t$,@5$J$i%a%K%e!<%P!<!J(Bmenu-bar$B!K%b!<%I$r%*%s$K$7!"(B
$B0z?t$,@5$G$J$$$J$i%*%U$K$7$^$9!#(B
X$B$N%j%=!<%9(B@samp{menuBarLines}$B$r;H$C$F!"(B
$B%a%K%e!<%P!<!J(Bmenu-bar$B!K%b!<%I$N=i4|@_Dj$r@)8f$G$-$^$9!#(B
@xref{Resources X}$B!#(B
$B=ON}$7$?%f!<%6!<$O!"%a%K%e!<%P!<$r$7$P$7$P%*%U$K$7!"(B
$BFC$KJ8;zC<Kv>e$G$O$=$&$7$^$9!#(B
$B$H$$$&$N$O!"%F%-%9%HI=<($K(B1$B9TM>J,$K;H$($k$+$i$G$9!#(B

@c   @xref{Menu Bar}, for information on how to invoke commands with the
@c menu bar.
$B%a%K%e!<%P!<$G%3%^%s%I$r5/F0$9$kJ}K!$K$D$$$F$O!"(B@xref{Menu Bar}$B!#(B

@node Faces
@c @section Using Multiple Typefaces
@c @cindex faces
@section $BJ#?t%?%$%W%U%'%$%9$NMxMQ(B
@cindex $B%U%'%$%9(B

@c   When using Emacs with X, you can set up multiple styles of displaying
@c characters.  The aspects of style that you can control are the type
@c font, the foreground color, the background color, and whether to
@c underline.  Emacs on MS-DOS supports faces partially by letting you
@c control the foreground and background colors of each face
@c (@pxref{MS-DOS}).
X$B$G(BEmacs$B$r;H$C$F$$$k$H$-!"J8;zI=<($KJ#?t$N%9%?%$%k$r@_Dj$G$-$^$9!#(B
$B@)8f$G$-$k%9%?%$%k$O!"%U%)%s%H$N<oN`!"A07J?'!"GX7J?'!"2<@~$r0z$/$+$I$&$+$G$9!#(B
MS-DOS$BMQ(BEmacs$B$O!"3F%U%'%$%9$NA07J?'$HGX7J?'$r@)8f$7$F!"(B
$B%U%'%$%9$N0lIt$@$1$r07$($^$9!J(B@pxref{MS-DOS}$B!K!#(B

@c   The way you control display style is by defining named @dfn{faces}.
@c Each face can specify a type font, a foreground color, a background
@c color, and an underline flag; but it does not have to specify all of
@c them.  Then by specifying the face or faces to use for a given part
@c of the text in the buffer, you control how that text appears.
$BI=<(%9%?%$%k$r@)8f$9$kJ}K!$O!"L>A0IU$-(B@dfn{$B%U%'%$%9(B}$B$rDj5A$9$k$3$H$G$9!#(B
$B3F%U%'%$%9$G$O!"%U%)%s%H$N<oN`!"A07J?'!"GX7J?'!"2<@~%U%i%0$r;XDj$G$-$^$9!#(B
$B$7$+$7!"$3$l$i$9$Y$F$r;XDj$9$kI,MW$O$"$j$^$;$s!#(B
$B%P%C%U%!Fb$N%F%-%9%H$N0lItJ,$KBP$7$F;HMQ$9$k%U%'%$%9$r;XDj$9$k$3$H$G!"(B
$B$=$N%F%-%9%H$N8+$?L\$r@)8f$G$-$^$9!#(B

@c   The style of display used for a given character in the text is
@c determined by combining several faces.  Any aspect of the display style
@c that isn't specified by overlays or text properties comes from the frame
@c itself.
$B%F%-%9%HCf$N$"$kJ8;z$KBP$7$F;H$&I=<(%9%?%$%k$O!"(B
$B$$$/$D$+$N%U%'%$%9$rAH$_9g$o$;$F7hDj$5$l$^$9!#(B
$B=E$M9g$o$;$d%F%-%9%HB0@-$G;XDj$5$l$F$$$J$$I=<(%9%?%$%k$O!"(B
$B%U%l!<%`$=$N$b$N$+$iF@$^$9!#(B

@c   Enriched mode, the mode for editing formatted text, includes several
@c commands and menus for specifying faces.  @xref{Format Faces}, for how
@c to specify the font for text in the buffer.  @xref{Format Colors}, for
@c how to specify the foreground and background color.
$B@07A:Q$_%F%-%9%H$rJT=8$9$k%b!<%I$G$"$k%(%s%j%C%A!J(Benriched$B!K%b!<%I$K$O!"(B
$B%U%'%$%9$r;XDj$9$k$?$a$N%3%^%s%I$d%a%K%e!<$,$"$j$^$9!#(B
$B%P%C%U%!Fb$N%F%-%9%H$KBP$9$k%U%)%s%H$N;XDjJ}K!$K$D$$$F$O!"(B@xref{Format Faces}$B!#(B
$BA07J?'$HGX7J?'$N;XDjJ}K!$K$D$$$F$O!"(B@xref{Format Colors}$B!#(B

@c   To alter the appearance of a face, use the customization buffer.
@c @xref{Face Customization}.  You can also use X resources to specify
@c attributes of particular faces (@pxref{Resources X}).
$B%U%'%$%9$N8+$?L\$rJQ99$9$k$K$O!"%+%9%?%^%$%:%P%C%U%!$r;H$$$^$9(B
@xref{Face Customization}$B!#(B
X$B$N%j%=!<%9$r;H$C$F!"FCDj$N%U%'%$%9$NB0@-$r;XDj$G$-$^$9(B
$B!J(B@pxref{Resources X}$B!K!#(B

@findex list-faces-display
@c   To see what faces are currently defined, and what they look like, type
@c @kbd{M-x list-faces-display}.  It's possible for a given face to look
@c different in different frames; this command shows the appearance in the
@c frame in which you type it.  Here's a list of the standardly defined
@c faces:
$B8=:_Dj5A$5$l$F$$$k%U%'%$%9$H$=$N8+$?L\$rD4$Y$k$K$O!"(B
@kbd{M-x list-faces-display}$B$HBG$A$^$9!#(B
$B$"$k%U%'%$%9$r0c$&%U%l!<%`$G$O0c$C$F8+$($k$h$&$K$G$-$^$9!#(B
$B$3$N%3%^%s%I$O!"%3%^%s%I$rBG$C$?%U%l!<%`>e$G$N8+$?L\$rI=<($7$^$9!#(B
$B$D$.$O!"I8=`E*$KDj5A$5$l$F$$$k%U%'%$%90lMw$G$9!#(B

@table @code
@item default
@c This face is used for ordinary text that doesn't specify any other face.
$B$3$N%U%'%$%9$O!"B>$N%U%'%$%9$r;XDj$7$F$$$J$$IaDL$N%F%-%9%H$K;H$o$l$k!#(B
@item modeline
@c This face is used for mode lines.  By default, it's set up as the
@c inverse of the default face.  @xref{Display Vars}.
$B$3$N%U%'%$%9$O%b!<%I9T$KBP$7$F;H$o$l$k!#(B
$B%G%U%)%k%H$G$O!"(B@code{default}$B%U%'%$%9$NH?E>I=<($r@_Dj!#(B
@pxref{Display Vars}$B!#(B
@item highlight
@c This face is used for highlighting portions of text, in various modes.
$B$3$N%U%'%$%9$O!"$5$^$6$^%b!<%I$G$N%F%-%9%H$N6/D4I=<(ItJ,$KBP$7$F;H$o$l$k!#(B
@item region
@c This face is used for displaying a selected region (when Transient Mark
@c mode is enabled---see below).
$B$3$N%U%'%$%9$O!"A*Br$5$l$F$$$k%j!<%8%g%s(B
$B!J;CDj%^!<%/!J(Btransient-mark$B!K%b!<%I$,%*%s$N$H$-!#2<5-;2>H!K(B
$B$NI=<($K;H$o$l$k!#(B
@item secondary-selection
@c This face is used for displaying a secondary selection (@pxref{Secondary
@c Selection}).
$B$3$N%U%'%$%9$O!"Fs<!%;%l%/%7%g%s$NI=<($K;H$o$l$k(B
$B!J(B@pxref{Secondary Selection}$B!K!#(B
@item bold
@c This face uses a bold variant of the default font, if it has one.
$B$3$N%U%'%$%9$O!"%\!<%k%IBN!JB@;zBN!K$,$"$k$J$i$P!"(B
$B%\!<%k%IBN$rMQ$$$?%G%U%)%k%H%U%)%s%H$NJQ<o!#(B
@item italic
@c This face uses an italic variant of the default font, if it has one.
$B$3$N%U%'%$%9$O!"%$%?%j%C%/BN!J<PBN!K$,$"$k$J$i$P!"(B
$B%$%?%j%C%/BN$rMQ$$$?%G%U%)%k%H%U%)%s%H$NJQ<o!#(B
@item bold-italic
@c This face uses a bold italic variant of the default font, if it has one.
$B$3$N%U%'%$%9$O!"%\!<%k%I%$%?%j%C%/BN!JB@;z<PBN!K$,$"$k$J$i$P!"(B
$B%\!<%k%I%$%?%j%C%/BN$rMQ$$$?%G%U%)%k%H%U%)%s%H$NJQ<o!#(B
@item underline
@c This face underlines text.
$B$3$N%U%'%$%9$O!"%F%-%9%H$K2<@~$r0z$/!#(B
@end table

@c @cindex @code{region} face
@cindex @code{region}$B%U%'%$%9(B
@cindex $B%U%'%$%9(B@code{region}
@c   When Transient Mark mode is enabled, the text of the region is
@c highlighted when the mark is active.  This uses the face named
@c @code{region}; you can control the style of highlighting by changing the
@c style of this face (@pxref{Face Customization}).  @xref{Transient Mark},
@c for more information about Transient Mark mode and activation and
@c deactivation of the mark.
$B;CDj%^!<%/!J(Btransient-mark$B!K%b!<%I$,%*%s$N$H$-$O!"(B
$B%^!<%/$,3h@-$J$i$P!"%j!<%8%g%s$N%F%-%9%H$O6/D4I=<($5$l$^$9!#(B
$B$3$l$K$O(B@code{region}$B$H$$$&L>A0$N%U%'%$%9$r;H$$$^$9!#(B
$B$3$N%U%'%$%9$N%9%?%$%k$rJQ99$9$k$3$H$G!"(B
$B6/D4I=<($N%9%?%$%k$r@)8f$G$-$^$9!J(B@pxref{Face Customization}$B!K!#(B
$B;CDj%^!<%/!J(Btransient-mark$B!K$H%^!<%/$N3h@-!?IT3h@-$K$D$$$F>\$7$/$O!"(B
@xref{Transient Mark}$B!#(B

@c   One easy way to use faces is to turn on Font Lock mode.  This minor
@c mode, which is always local to a particular buffer, arranges to
@c choose faces according to the syntax of the text you are editing.  It
@c can recognize comments and strings in most languages; in several
@c languages, it can also recognize and properly highlight various other
@c important constructs.  @xref{Font Lock}, for more information about
@c Font Lock mode and syntactic highlighting.
$B%U%'%$%9$r;H$&4JC1$JJ}K!$N(B1$B$D$O!"(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r;H$&$3$H$G$9!#(B
$BFCDj$N%P%C%U%!$K$D$M$K%m!<%+%k$G$"$k$3$N%^%$%J%b!<%I$O!"(B
$BJT=8$9$k%F%-%9%H$N9=J8$K=>$C$F%U%'%$%9$rA*Br$7$^$9!#(B
$B$3$N%b!<%I$O!"$[$H$s$I$N8@8l$N%3%a%s%H$HJ8;zNs$rG'<1$G$-$^$9!#(B
$B$$$/$D$+$N8@8l$G$O!"$=$l0J30$N$5$^$6$^$J=EMW$J9=B$$bG'<1$7$F!"(B
$BE,@Z$K6/D4I=<($7$^$9!#(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$H9=J8$N6/D4I=<($K$D$$$F>\$7$/$O!"(B
@xref{Font Lock}$B!#(B

@c   You can print out the buffer with the highlighting that appears
@c on your screen using the command @code{ps-print-buffer-with-faces}.
@c @xref{Postscript}.
$B2hLL>e$G6/D4I=<($5$l$?%P%C%U%!$O!"(B
$B%3%^%s%I(B@code{ps-print-buffer-with-faces}$B$r;H$C$F0u:~$G$-$^$9!#(B
@xref{Postscript}$B!#(B

@node Font Lock
@c @section Font Lock mode
@c @cindex Font Lock mode
@c @cindex mode, Font Lock
@c @cindex syntax highlighting
@section $B%U%)%s%H%m%C%/%b!<%I(B
@cindex $B%U%)%s%H%m%C%/%b!<%I!J(BFont Lock mode$B!K(B
@cindex $B%b!<%I!"(BFont Lock
@cindex $B9=J8$N6/D4I=<((B

@c   Font Lock mode is a minor mode, always local to a particular
@c buffer, which highlights (or ``fontifies'') using various faces
@c according to the syntax of the text you are editing.  It can
@c recognize comments and strings in most languages; in several
@c languages, it can also recognize and properly highlight various other
@c important constructs---for example, names of functions being defined
@c or reserved keywords.
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$O%^%$%J%b!<%I$G$9!#(B
$BFCDj$N%P%C%U%!$K$D$M$K%m!<%+%k$G$"$j!"(B
$BJT=8$7$F$$$k%F%-%9%H$N9=J8$K=>$C$F$5$^$6$^$J%U%'%$%9$r(B
$B;H$C$F6/D4I=<(!J$^$?$O!X%U%)%s%HI=<(2=!Y!K$7$^$9!#(B
$B$3$N%b!<%I$O!"$[$H$s$I$N8@8l$N%3%a%s%H$dJ8;zNs$rG'<1$G$-$^$9!#(B
$B$$$/$D$+$N8@8l$G$O!"B>$N$5$^$6$^$J=EMW$J9=@.MWAG$bG'<1$7!"(B
$B@5$7$/6/D4I=<($7$^$9!#(B 
$B$?$H$($P!"Dj5A$5$l$F$$$k4X?tL>$dM=Ls8l$G$9!#(B

@findex font-lock-mode
@findex turn-on-font-lock
@c   The command @kbd{M-x font-lock-mode} turns Font Lock mode on or off
@c according to the argument, and toggles the mode when it has no argument.
@c The function @code{turn-on-font-lock} unconditionally enables Font Lock
@c mode.  This is useful in mode-hook functions.  For example, to enable
@c Font Lock mode whenever you edit a C file, you can do this:
$B%3%^%s%I(B@kbd{M-x font-lock-mode}$B$O!"(B
$B0z?t$K=>$C$F%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r%*%s!?%*%U$7!"(B
$B0z?t$,$J$1$l$P%b!<%I$r%H%0%k$7$^$9!#(B
$B4X?t(B@code{turn-on-font-lock}$B$O!"(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$rL5>r7o$G%*%s$K$7$^$9!#(B
$B$3$N%3%^%s%I$O!"%b!<%I%U%C%/4X?t$G;H$&$HJXMx$G$9!#(B
$B$?$H$($P!"(BC$B$N%U%!%$%k$rJT=8$7$F$$$k$H$-$K$O$$$D$G$b(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r%*%s$K$9$k$K$O!"(B
$B$D$.$N$h$&$K$7$^$9!#(B

@example
(add-hook 'c-mode-hook 'turn-on-font-lock)
@end example

@findex global-font-lock-mode
@c   To turn on Font Lock mode automatically in all modes which support it,
@c use the function @code{global-font-lock-mode}, like this:
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r07$($k(B
$B$9$Y$F$N!J%a%8%c!<!K%b!<%I$G<+F0E*$K%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r(B
$B%*%s$K$9$k$K$O!"(B
$B4X?t(B@code{global-font-lock-mode}$B$r$D$.$N$h$&$K;H$$$^$9!#(B

@example
(global-font-lock-mode 1)
@end example

@kindex M-g M-g
@findex font-lock-fontify-block
@c   In Font Lock mode, when you edit the text, the highlighting updates
@c automatically in the line that you changed.  Most changes don't affect
@c the highlighting of subsequent lines, but occasionally they do.  To
@c rehighlight a range of lines, use the command @kbd{M-g M-g}
@c (@code{font-lock-fontify-block}).
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$G$O!"(B
$B%F%-%9%H$rJT=8$7$F$$$k$H!"<+F0E*$KJQ99$7$?9T$N6/D4I=<($r99?7$7$^$9!#(B
$B$[$H$s$I$NJQ99$O!"8eB39T$N6/D4I=<($K$O1F6A$7$^$;$s$,!"(B
$B;~@^!"1F6A$9$k$3$H$b$"$j$^$9!#(B
$B$"$kHO0O$N9T$r6/D4I=<($7D>$9$K$O!"%3%^%s%I(B@kbd{M-g M-g}$B$r;H$$$^$9(B
$B!J(B@code{font-lock-fontify-block}$B!K!#(B

@vindex font-lock-mark-block-function
@c   In certain major modes, @kbd{M-g M-g} refontifies the entire current
@c function.  (The variable @code{font-lock-mark-block-function} controls
@c how to find the current function.)  In other major modes, @kbd{M-g M-g}
@c refontifies 16 lines above and below point.
$B$"$k<o$N%a%8%c!<%b!<%I$G$O!"(B@kbd{M-g M-g}$B$O!"(B
$B8=:_$N4X?tDj5AA4BN$r%U%)%s%HI=<(2=$7D>$7$^$9!#(B
$B!JJQ?t(B@code{font-lock-mark-block-function}$B$O!"(B
$B8=:_$N4X?tDj5A$NC5$7J}$r@)8f$9$k!#!K(B
$BJL$N%a%8%c!<%b!<%I$G$O!"(B @kbd{M-g M-g}$B$O!"(B
$B%]%$%s%H$N$^$($H$"$H$N(B16$B9T$r%U%)%s%HI=<(2=$7D>$7$^$9!#(B

@c   With a prefix argument @var{n}, @kbd{M-g M-g} refontifies @var{n}
@c lines above and below point, regardless of the mode.
$B?t0z?t(B@var{n}$B$r;XDj$9$k$H!"(B@kbd{M-g M-g}$B$O!"(B
$B%b!<%I$K4X78$J$/!"(B $B%]%$%s%H$N$^$($H$"$H$N(B@var{n}$B9T$r%U%)%s%HI=<(2=$7D>$7$^$9!#(B

@c   To get the full benefit of Font Lock mode, you need to choose a
@c default font which has bold, italic, and bold-italic variants; or else
@c you need to have a color or gray-scale screen.
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$NMxE@$r==J,$K3hMQ$9$k$K$O!"(B
$B%\!<%k%IBN!"%$%?%j%C%/BN!"%\!<%k%I%$%?%j%C%/BN$N%G%U%)%k%H%U%)%s%H$r(B
$BA*$VI,MW$,$"$j$^$9!#(B
$B$"$k$$$O!"%+%i!<$d%0%l!<%9%1!<%k$N2hLL$,I,MW$G$9!#(B

@vindex font-lock-maximum-decoration
@c   The variable @code{font-lock-maximum-decoration} specifies the
@c preferred level of fontification, for modes that provide multiple
@c levels.  Level 1 is the least amount of fontification; some modes
@c support levels as high as 3.  The normal default is ``as high as
@c possible.''  You can specify an integer, which applies to all modes, or
@c you can specify different numbers for particular major modes; for
@c example, to use level 1 for C/C++ modes, and the default level
@c otherwise, use this:
$BJQ?t(B@code{font-lock-maximum-decoration}$B$O!"(B
$BJ#?t$N%l%Y%k$rDs6!$9$k%b!<%I$G$N%U%)%s%HI=<(2=$N9%$^$7$$%l%Y%k$r;XDj$7$^$9!#(B
$B%l%Y%k(B1$B$O:GDc8B$N%U%)%s%HI=<(2=$G$9!#(B
$B$$$/$D$+$N%b!<%I$G$O!"$b$C$H$b9b$$(B3$B$N%l%Y%k$^$G$"$j$^$9!#(B
$BDL>o%G%U%)%k%H$O!X2DG=$J8B$jBg$-$$?t!Y$G$9!#(B
$B$9$Y$F$N%b!<%I$KE,MQ$9$k@0?t$r;XDj$G$-$^$9!#(B
$B$"$k$$$O!"FCDj$N%a%8%c!<%b!<%I$KBP$7$F0[$J$k?t$r;XDj$G$-$^$9!#(B
$B$?$H$($P!"(BC/C++$B%b!<%I$G$O%l%Y%k(B1$B$r!"(B
$B$=$l0J30$G$O%G%U%)%k%H$N%l%Y%k$r;XDj$9$k$K$O!"$D$.$N$h$&$K$7$^$9!#(B

@example
(setq font-lock-maximum-decoration
      '((c-mode . 1) (c++-mode . 1)))
@end example

@vindex font-lock-maximum-size
@c   Fontification can be too slow for large buffers, so you can suppress
@c it.  The variable @code{font-lock-maximum-size} specifies a buffer size,
@c beyond which buffer fontification is suppressed.
$B%U%)%s%HI=<(2=$O!"Bg$-$J%P%C%U%!$KBP$7$F$O$H$F$bCY$/$J$j$($^$9$+$i!"(B
$BM^@)$9$k$3$H$b$G$-$^$9!#(B
$BJQ?t(B@code{font-lock-maximum-size}$B$K%P%C%U%!%5%$%:$r;XDj$9$k$H!"(B
$B$=$NCM$r1[$($k%P%C%U%!$K$D$$$F$O%U%)%s%HI=<(2=$rM^@)$7$^$9!#(B

@c @w is used below to prevent a bad page-break.
@vindex font-lock-beginning-of-syntax-function
@c   Comment and string fontification (or ``syntactic'' fontification)
@c relies on analysis of the syntactic structure of the buffer text.  For
@c the purposes of speed, some modes including C mode and Lisp mode rely on
@c a special convention: an open-parenthesis in the leftmost column always
@c defines the @w{beginning} of a defun, and is thus always outside any string
@c or comment.  (@xref{Defuns}.)  If you don't follow this convention,
@c then Font Lock mode can misfontify the text after an open-parenthesis in
@c the leftmost column that is inside a string or comment.
$B%3%a%s%H$HJ8;zNs$N%U%)%s%HI=<(2=!J$"$k$$$O!"!X9=J8$N!Y%U%)%s%HI=<(2=!K$O!"(B
$B%P%C%U%!$N%F%-%9%H$N9=J82r@O$KMj$C$F$$$^$9!#(B
$BB.EY8~>e$N$?$a$K!"(BC$B%b!<%I$d(BLisp$B%b!<%I$r4^$`$$$/$D$+$N%b!<%I$G$O!"(B
$BFCJL$J=,47$KMj$C$F$$$^$9!#(B
$B:G:87e$K$"$k3+$-3g8L$O!"$D$M$K4X?tDj5A$N(B@w{$B3+;O(B}$B$rI=$7!"(B
$B$=$N$?$a!"$D$M$KJ8;zNs$d%3%a%s%H$N30B&$@$H$$$&$3$H$G$9!#(B
$B!J(B@pxref{Defuns}$B!#!K(B
$B$3$N=,47$K=>$o$J$$$H!"%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$O!"(B
$BJ8;zNs$d%3%a%s%H$NFbB&$K$"$k:G:87e$N3+$-3g8L$N$&$7$m$G$O!"(B
$B0c$C$?%U%)%s%HI=<(2=$r$9$k$3$H$b$"$j$($^$9!#(B

@c   The variable @code{font-lock-beginning-of-syntax-function} (always
@c buffer-local) specifies how Font Lock mode can find a position
@c guaranteed to be outside any comment or string.  In modes which use the
@c leftmost column parenthesis convention, the default value of the variable
@c is @code{beginning-of-defun}---that tells Font Lock mode to use the
@c convention.  If you set this variable to @code{nil}, Font Lock no longer
@c relies on the convention.  This avoids incorrect results, but the price
@c is that, in some cases, fontification for a changed text must rescan
@c buffer text from the beginning of the buffer.
$BJQ?t(B@code{font-lock-beginning-of-syntax-function}
$B!J$D$M$K%P%C%U%!$K%m!<%+%k!K$O!"%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$,!"(B
$B%3%a%s%H$dJ8;zNs$N30B&$G$"$k$3$H$,J]>Z$5$l$k0LCV$r(B
$B$I$N$h$&$KC5$9$+$r;XDj$7$^$9!#(B
$B:G:87e$N3g8L$N=,47$r;H$&%b!<%I$G$O!"(B
$BJQ?t$N%G%U%)%k%HCM$O!"(B@code{beginning-of-defun}$B$G$9!#(B 
$B$D$^$j!"%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$O(B
$B=,47$r;H$&$h$&$K$H$$$&$3$H$G$9!#(B
$B$3$NJQ?t$K(B@code{nil}$B$r@_Dj$9$k$H!"(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$O!"$b$O$d=,47$KMj$j$^$;$s!#(B
$B$3$l$G$^$A$,$C$?7k2L$rHr$1$i$l$^$9$,!"$=$NBe=~$O!"(B
$BJQ99$7$?%F%-%9%H$r%U%)%s%HI=<(2=$9$k$K$O!"(B
$B%P%C%U%!$N%F%-%9%H$r%P%C%U%!$N@hF,$+$i:FAv::$9$kI,MW$,$"$k>l9g$b$"$j$^$9!#(B

@findex font-lock-add-keywords
@c   Font Lock highlighting patterns already exist for many modes, but you
@c may want to fontify additional patterns.  You can use the function
@c @code{font-lock-add-keywords}, to add your own highlighting patterns for
@c a particular mode.  For example, to highlight @samp{FIXME:} words in C
@c comments, use this:
$BB?$/$N%b!<%I$KBP$9$k%U%)%s%H%m%C%/$N6/D4I=<(%Q%?!<%s$O$9$G$K$"$j$^$9$,!"(B
$B%U%)%s%HI=<(2=$9$k%Q%?!<%s$rDI2C$7$?$$$3$H$b$"$k$G$7$g$&!#(B
$B4X?t(B@code{font-lock-add-keywords}$B$r;H$C$F!"(B
$BFCDj$N%b!<%I$KBP$9$k8D?MMQ$N6/D4I=<(%Q%?!<%s$rDI2C$G$-$^$9!#(B
$B$?$H$($P!"(BC$B$N%3%a%s%H$GC18l(B@samp{FIXME:}$B$r6/D4I=<($9$k$K$O!"(B
$B$D$.$N$h$&$K;H$$$^$9!#(B

@example
(font-lock-add-keywords
 'c-mode
 '(("\\<\\(FIXME\\):" 1 font-lock-warning-face t)))
@end example

@node Support Modes
@c @section Font Lock Support Modes
@section $B%U%)%s%H%m%C%/$N%b!<%I(B

@c   Font Lock support modes make Font Lock mode faster for large buffers.
@c There are two support modes: Fast Lock mode and Lazy Lock mode.  They
@c use two different methods of speeding up Font Lock mode.
$B%U%)%s%H%m%C%/$K$O!"Bg$-$J%P%C%U%!$KBP$7$F(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r9bB.$KF0:n$5$;$k%b!<%I$,$"$j$^$9!#(B
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$HCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$G$9!#(B
$B$3$l$i$O!"%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$NB.EY$r8~>e$9$k$?$a$K(B
2$B$D$N0[$J$kJ}K!$r;H$$$^$9!#(B

@menu
* Fast Lock Mode::      Saving font information in files.
* Lazy Lock Mode::      Fontifying only text that is actually displayed.
* Fast or Lazy::        Which support mode is best for you?
@end menu

@node Fast Lock Mode
@c @subsection Fast Lock Mode
@subsection $B9bB.%m%C%/%b!<%I(B

@c @cindex Fast Lock mode
@c @cindex mode, Fast Lock
@cindex $B9bB.%m%C%/%b!<%I!J(BFast Lock mode$B!K(B
@cindex $B%b!<%I!"(BFast Lock
@c   To make Font Lock mode faster for buffers visiting large files, you
@c can use Fast Lock mode.  Fast Lock mode saves the font information for
@c each file in a separate cache file; each time you visit the file, it
@c rereads the font information from the cache file instead of refontifying
@c the text from scratch.
$BBg$-$J%U%!%$%k$rK,Ld$7$?%P%C%U%!$KBP$7$F(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$rB.$/$9$k$K$O!"(B
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$r;H$($^$9!#(B
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$O!"(B
$B3F%U%!%$%k$KBP$9$k%U%)%s%H>pJs$r(B
$BJL$N%-%c%C%7%e%U%!%$%k!J(Bcache file$B!K$KJ]B8$7$^$9!#(B
$B%U%!%$%k$rK,Ld$9$k$?$S$K!":G=i$+$i%F%-%9%H$r%U%)%s%HI=<(2=$7D>$9$+$o$j$K!"(B
$B%-%c%C%7%e%U%!%$%k$+$i%U%)%s%H>pJs$rFI$_D>$7$^$9!#(B

@findex fast-lock-mode
@c   The command @kbd{M-x fast-lock-mode} turns Fast Lock mode on or off,
@c according to the argument (with no argument, it toggles).  You can also
@c arrange to enable Fast Lock mode whenever you use Font Lock mode, like
@c this:
$B%3%^%s%I(B@kbd{M-x fast-lock-mode}$B$O!"(B
$B0z?t$K=>$C$F9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$r%*%s!?%*%U$7$^$9(B
$B!J0z?t$,$J$$$1$l$P%H%0%k!K!#(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r;H$&$H$-$K!"(B
$B$$$D$G$b9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$r%*%s$K$9$k$K$O!"(B
$B$D$.$N$h$&$K$7$^$9!#(B

@example
(setq font-lock-support-mode 'fast-lock-mode)
@end example

@vindex fast-lock-minimum-size
@c   It is not worth writing a cache file for small buffers.  Therefore,
@c the variable @code{fast-lock-minimum-size} specifies a minimum file size
@c for caching font information.
$B>.$5$J%P%C%U%!$KBP$7$F$O!"%-%c%C%7%e%U%!%$%k$r=q$/2ACM$,$"$j$^$;$s!#(B
$B$=$l$f$(!"JQ?t(B@code{fast-lock-minimum-size}$B$O!"(B
$B%U%)%s%H>pJs$r%-%c%C%7%e$9$k:G>.$N%U%!%$%k%5%$%:$r;XDj$7$^$9!#(B

@vindex fast-lock-cache-directories
@c   The variable @code{fast-lock-cache-directories} specifies where to put
@c the cache files.  Its value is a list of directories to try; @code{"."}
@c means the same directory as the file being edited.  The default value is
@c @w{@code{("." "~/.emacs-flc")}}, which means to use the same directory if
@c possible, and otherwise the directory @file{~/.emacs-flc}.
$BJQ?t(B@code{fast-lock-cache-directories}$B$O!"(B
$B%-%c%C%7%e%U%!%$%k$r$I$3$KCV$/$+$r;XDj$7$^$9!#(B
$B$=$NCM$O!"%G%#%l%/%H%j72$N%j%9%H$G$9!#(B
@code{"."}$B$O!"JT=8$7$F$$$k%U%!%$%k$HF1$8%G%#%l%/%H%j$rI=$7$^$9!#(B
$B%G%U%)%k%HCM$O!"(B@w{@code{("." "~/.emacs-flc")}}$B$G!"(B
$B2DG=$J$i$PF1$8%G%#%l%/%H%j$r;H$$!"(B
$B$5$b$J$1$l$P%G%#%l%/%H%j(B@file{~/.emacs-flc}$B$r;H$&$H$$$&0UL#$G$9!#(B 

@vindex fast-lock-save-others
@c   The variable @code{fast-lock-save-others} specifies whether Fast Lock
@c mode should save cache files for files that you do not own.  A
@c non-@code{nil} value means yes (and that is the default).
$BJQ?t(B@code{fast-lock-save-others}$B$O!"(B
$B$"$J$?$,=j;}$7$F$$$J$$%U%!%$%k$KBP$9$k%-%c%C%7%e%U%!%$%k$r(B
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$,J]B8$9$Y$-$+$I$&$+$r;XDj$7$^$9!#(B
$BCM$,(B@code{nil}$B0J30$J$i$PJ]B8$7$^$9!J$3$l$,%G%U%)%k%H!K!#(B

@node Lazy Lock Mode
@c @subsection Lazy Lock Mode
@c @cindex Lazy Lock mode
@c @cindex mode, Lazy Lock
@subsection $BCY1d%m%C%/%b!<%I(B
@cindex $BCY1d%m%C%/%b!<%I!J(BLazy Lock mode$B!K(B
@cindex $B%b!<%I!"(BLazy Lock

@c   To make Font Lock mode faster for large buffers, you can use Lazy Lock
@c mode to reduce the amount of text that is fontified.  In Lazy Lock mode,
@c buffer fontification is demand-driven; it happens to portions of the
@c buffer that are about to be displayed.  And fontification of your
@c changes is deferred; it happens only when Emacs has been idle for a
@c certain short period of time.
$BBg$-$J%P%C%U%!$KBP$7$F%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$rB.$/$9$k$K$O!"(B
$B%U%)%s%HI=<(2=$9$k%F%-%9%H$NNL$r8:$i$9(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$r;H$($^$9!#(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$G$O!"%P%C%U%!$N%U%)%s%HI=<(2=$OMW5a6nF07?$G$9!#(B
$BI=<($5$l$h$&$H$7$F$$$k%P%C%U%!$NItJ,$@$1$r%U%)%s%HI=<(2=$7$^$9!#(B
$B$^$?!"JQ99ItJ,$N%U%)%s%HI=<(2=$O1d4|$5$l!"(B
Emacs$B$,$"$kC;$$;~4V%"%$%I%k$G$"$C$?$H$-$K$N$_%U%)%s%HI=<(2=$7$^$9!#(B

@findex lazy-lock-mode
@c   The command @kbd{M-x lazy-lock-mode} turns Lazy Lock mode on or off,
@c according to the argument (with no argument, it toggles).  You can also
@c arrange to enable Lazy Lock mode whenever you use Font Lock mode, like
@c this:
$B%3%^%s%I(B@kbd{M-x lazy-lock-mode}$B$O!"(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$r0z?t$K=>$C$F%*%s!?%*%U$7$^$9(B
$B!J0z?t$,$J$1$l$P%H%0%k!K!#(B
$B%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$r;H$&$H$-$K!"(B
$B$$$D$G$bCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$r%*%s$K$9$k$K$O!"(B
$B$D$.$N$h$&$K$7$^$9!#(B

@example
(setq font-lock-support-mode 'lazy-lock-mode)
@end example

@vindex lazy-lock-minimum-size
@c   It is not worth avoiding buffer fontification for small buffers.
@c Therefore, the variable @code{lazy-lock-minimum-size} specifies a
@c minimum buffer size for demand-driven buffer fontification.  Buffers
@c smaller than that are fontified all at once, as in plain Font Lock mode.
$B>.$5$J%P%C%U%!$KBP$7$F%P%C%U%!$N%U%)%s%HI=<(2=$rHr$1$k2ACM$O$"$j$^$;$s!#(B
$B$G$9$+$i!"JQ?t(B@code{lazy-lock-minimum-size}$B$O!"(B
$BMW5a6nF07?$G%P%C%U%!$N%U%)%s%HI=<(2=$r9T$&:G>.$N%P%C%U%!%5%$%:$r;XDj$7$^$9!#(B
$B$3$l$h$j>.$5$J%P%C%U%!$O!"IaDL$N%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$N$h$&$K(B
$B0lEY$K%U%)%s%HI=<(2=$7$^$9!#(B

@vindex lazy-lock-defer-time
@c   When you alter the buffer, Lazy Lock mode defers fontification of the
@c text you changed.  The variable @code{lazy-lock-defer-time} specifies
@c how many seconds Emacs must be idle before it starts fontifying your
@c changes.  If the value is 0, then changes are fontified immediately, as
@c in plain Font Lock mode.
$B%P%C%U%!$rJQ99$7$?$H$-!"CY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$O(B
$BJQ99$7$?%F%-%9%H$N%U%)%s%HI=<(2=$r1d4|$7$^$9!#(B
$BJQ?t(B@code{lazy-lock-defer-time}$B$O!"(B
$BJQ99ItJ,$N%U%)%s%HI=<(2=$r;O$a$k$^$G$K(B
Emacs$B$,%"%$%I%k$G$"$k$Y$-IC?t$G$9!#(B
$B$3$NCM$,(B0$B$J$i$O!"IaDL$N%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$HF1$8$h$&$K!"(B
$BJQ99$O$9$0$K%U%)%s%HI=<(2=$5$l$^$9!#(B

@vindex lazy-lock-defer-on-scrolling
@c   Lazy Lock mode normally fontifies newly visible portions of the buffer
@c before they are first displayed.  However, if the value of
@c @code{lazy-lock-defer-on-scrolling} is non-@code{nil}, newly visible
@c text is fontified only when Emacs is idle for
@c @code{lazy-lock-defer-time} seconds.
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$O!"DL>o!"(B
$B?7$?$K8+$($F$/$k%P%C%U%!ItJ,$,=i$a$FI=<($5$l$k$^$($K(B
$B$=$NItJ,$r%U%)%s%HI=<(2=$7$^$9!#(B
$B$7$+$7!"(B@code{lazy-lock-defer-on-scrolling}$B$NCM$,(B@code{nil}$B0J30$J$i$P!"(B
$B?7$?$K8+$($F$/$k%F%-%9%H$O!"(BEmacs$B$,(B@code{lazy-lock-defer-time}$BIC$@$1(B
$B%"%$%I%k$7$?$H$-$K$N$_%U%)%s%HI=<(2=$5$l$^$9!#(B

@vindex lazy-lock-defer-contextually
@c   In some modes, including C mode and Emacs Lisp mode, changes in one
@c line's contents can alter the context for subsequent lines, and thus
@c change how they ought to be fontified.  Ordinarily, you must type
@c @kbd{M-g M-g} to refontify the subsequent lines.  However, if you set
@c the variable @code{lazy-lock-defer-contextually} to non-@code{nil}, Lazy
@c Lock mode does this automatically, after @code{lazy-lock-defer-time}
@c seconds.
C$B$d(BEmacs Lisp$B%b!<%I$r4^$`$$$/$D$+$N%b!<%I$G$O!"(B
$B$"$k(B1$B9T$NFbMF$rJQ99$9$k$H8eB39T$NJ8L.$,JQ$o$j!"(B
$B$=$N$?$a!"8eB39T$r$I$&%U%)%s%HI=<(2=$9$k$+$bJQ$o$j$^$9!#(B
$BDL>o$O!"8eB39T$r:F%U%)%s%HI=<(2=$9$k$?$a$K(B@kbd{M-g M-g}$B$rBG$DI,MW$,$"$j$^$9!#(B
$B$7$+$7!"JQ?t(B@code{lazy-lock-defer-contextually}$B$K(B
@code{nil}$B0J30$r@_Dj$7$F$$$k$H!"CY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$G$O!"(B
@code{lazy-lock-defer-time}$BIC8e$K$3$l$r<+F0E*$K9T$$$^$9!#(B

@cindex stealth fontification
@c   When Emacs is idle for a long time, Lazy Lock fontifies additional
@c portions of the buffer, not yet displayed, in case you will display them
@c later.  This is called @dfn{stealth fontification}.
Emacs$B$,D9;~4V%"%$%I%k$@$H!"CY1d%m%C%/$O!"(B
$B%P%C%U%!$N$^$@I=<($5$l$F$$$J$$ItJ,$r!"(B
$B$N$A$NI=<($KHw$($F%U%)%s%HI=<(2=$7$^$9!#(B
$B$3$l$r(B@dfn{$BFbL)$N%U%)%s%HI=<(2=(B}$B!J(Bstealth fontification$B!K$H8F$S$^$9!#(B

@vindex lazy-lock-stealth-time
@vindex lazy-lock-stealth-lines
@vindex lazy-lock-stealth-verbose
@c   The variable @code{lazy-lock-stealth-time} specifies how many seconds
@c Emacs has to be idle before stealth fontification starts.  A value of
@c @code{nil} means no stealth fontification.  The variables
@c @code{lazy-lock-stealth-lines} and @code{lazy-lock-stealth-verbose}
@c specify the granularity and verbosity of stealth fontification.
$BJQ?t(B@code{lazy-lock-stealth-time}$B$O!"FbL)$N%U%)%s%HI=<(2=$r3+;O$9$k$^$G$K!"(B
Emacs$B$,2?IC4V%"%$%I%k$G$"$k$Y$-$+$r;XDj$7$^$9!#(B
$BCM$,(B@code{nil}$B$@$H!"FbL)$N%U%)%s%HI=<(2=$r$7$^$;$s!#(B
$BJQ?t(B@code{lazy-lock-stealth-lines}$B$H(B@code{lazy-lock-stealth-verbose}$B$O!"(B
$BFbL)$N%U%)%s%HI=<(2=$NN3EY$H>iD9@-$r;XDj$7$^$9!#(B

@node Fast or Lazy
@c @subsection Fast Lock or Lazy Lock?
@subsection $B9bB.%m%C%/$+CY1d%m%C%/$+!)(B

@c   Here is a simple guide to help you choose one of the Font Lock support
@c modes.
$B%U%)%s%H%m%C%/$G;H$($k%b!<%I$N(B1$B$D$rA*Br$9$kL\0B$H$J$k4JC1$J;X?K$r$"$2$^$9!#(B

@itemize @bullet
@item
@c Fast Lock mode intervenes only during file visiting and buffer
@c killing (and related events); therefore buffer editing and window
@c scrolling are no faster or slower than in plain Font Lock mode.
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$O!"(B
$B%U%!%$%k$NK,Ld$H%P%C%U%!$N:o=|!J$H4XO"$9$k;v>]!K$N:GCf$K:n6H$9$k!#(B
$B$=$l$f$(!"%P%C%U%!$NJT=8$d%&%#%s%I%&$N%9%/%m!<%k$O!"(B
$BIaDL$N%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$h$jB.$/$bCY$/$b$J$$!#(B

@item
@c Fast Lock mode is slower at reading a cache file than Lazy Lock
@c mode is at fontifying a window; therefore Fast Lock mode is slower at
@c visiting a file than Lazy Lock mode.
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$N%-%c%C%7%e%U%!%$%k$NFI$_9~$_$O!"(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$,%&%#%s%I%&$r%U%)%s%HI=<(2=$9$k$h$jCY$$!#(B
$B$h$C$F!"9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$O!"(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$h$j%U%!%$%k$NK,Ld$,CY$$!#(B

@item
@c Lazy Lock mode intervenes during window scrolling to fontify text that
@c scrolls onto the screen; therefore, scrolling is slower than in plain
@c Font Lock mode.
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$O!"(B
$B%&%#%s%I%&$r%9%/%m!<%k$9$k:GCf$K!"(B
$B2hLL>e$K8=$l$k%F%-%9%H$r%U%)%s%HI=<(2=$9$k!#(B
$B$h$C$F!"%9%/%m!<%k$O!"DL>o$N%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$h$jCY$$!#(B

@item
@c Lazy Lock mode doesn't fontify during buffer editing (it defers
@c fontification of changes); therefore, editing is faster than in plain
@c Font Lock mode.
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$O!"(B
$B%P%C%U%!$rJT=8Cf$O%U%)%s%HI=<(2=$7$J$$!JJQ99ItJ,$N%U%)%s%HI=<(2=$r1d4|$9$k!K!#(B
$B$h$C$F!"JT=8$O!"DL>o$N%U%)%s%H%m%C%/!J(Bfont-lock$B!K%b!<%I$h$jB.$$!#(B 

@item
@c Fast Lock mode can be fooled by a file that is kept under version
@c control software; therefore buffer fontification may occur even when
@c a cache file exists for the file.
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$O!"(B
$BHG4IM}$N2<$KCV$+$l$?%U%!%$%k$G$O$@$^$5$l$k$3$H$,$"$k!#(B
$B$h$C$F!"$=$N%U%!%$%k$KBP$9$k%-%c%C%7%e%U%!%$%k$,B8:_$7$F$$$F$b!"(B
$B%P%C%U%!$N%U%)%s%HI=<(2=$,5/$3$j$($k!#(B

@item
@c Fast Lock mode only works with a buffer visiting a file; Lazy Lock
@c mode works with any buffer.
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$O!"(B
$B%U%!%$%k$rK,Ld$7$F$$$k%P%C%U%!$G$N$_F0:n$9$k!#(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$O!"$I$N%P%C%U%!$G$bF0:n$9$k!#(B

@item
@c Fast Lock mode generates cache files; Lazy Lock mode does not.
$B9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$O!"%-%c%C%7%e%U%!%$%k$r@8@.$9$k!#(B
$BCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$O!"@8@.$7$J$$!#(B
@end itemize

@vindex font-lock-support-mode
@c   The variable @code{font-lock-support-mode} specifies which of these
@c support modes to use; for example, to specify that Fast Lock mode is
@c used for C/C++ modes, and Lazy Lock mode otherwise, set the variable
@c like this:
$BJQ?t(B@code{font-lock-support-mode}$B$O!"(B
$B$3$l$i$N$I$A$i$N%b!<%I$r;H$&$+$r;XDj$7$^$9!#(B
$B$?$H$($P!"(BC/C++$B%b!<%I$G$O9bB.%m%C%/!J(Bfast-lock$B!K%b!<%I$r;H$$!"(B
$B$=$l0J30$N%b!<%I$G$OCY1d%m%C%/!J(Blazy-lock$B!K%b!<%I$r;H$&$h$&$K;XDj$9$k$K$O!"(B
$BJQ?t$r$D$.$N$h$&$K@_Dj$7$^$9!#(B

@example
(setq font-lock-support-mode
      '((c-mode . fast-lock-mode) (c++-mode . fast-lock-mode)
        (t . lazy-lock-mode)))
@end example

@node Highlight Changes
@c @section Highlight Changes Mode
@section $BJQ99ItJ,6/D4I=<(%b!<%I(B

@findex highlight-changes-mode
@c   Use @kbd{M-x highlight-changes-mode} to enable a minor mode
@c that uses faces (colors, typically) to indicate which parts of
@c the buffer were changed most recently.
$B%P%C%U%!Fb$N:G6a$KJQ99$5$l$?ItJ,$r<($9$?$a$K%U%'%$%9!JE57?E*$K$OI=<(?'!K$r(B
$BMQ$$$k%^%$%J%b!<%I$r%*%s$K$9$k$K$O!"(B
@kbd{M-x highlight-changes-mode}$B$r;H$$$^$9!#(B

@node Misc X
@c @section Miscellaneous X Window Features
@section $B$=$NB>$N(BX$B%&%#%s%I%&%7%9%F%`$G$N5!G=(B

@c   The following commands let you create, delete and operate on frames:
$B$D$.$N%3%^%s%I$O!"%U%l!<%`$r:n@.$7$?$j:o=|$7$?$jA`:n$7$?$j$7$^$9!#(B

@table @kbd
@item C-z
@c @kindex C-z @r{(X windows)}
@kindex C-z @r{$B!J(BX$B%&%#%s%I%&%7%9%F%`!K(B}
@findex iconify-or-deiconify-frame
@c Iconify the selected Emacs frame (@code{iconify-or-deiconify-frame}).
@c The normal meaning of @kbd{C-z}, to suspend Emacs, is not useful under a
@c window system, so it has a different binding in that case.
$BA*Br$5$l$F$$$k(BEmacs$B%U%l!<%`$r%"%$%3%s2=$9$k(B
$B!J(B@code{iconify-or-deiconify-frame}$B!K!#(B
Emacs$B$r5Y;_$9$k$H$$$&(B@kbd{C-z}$B$NDL>o$N0UL#$O!"(B
$B%&%#%s%I%&%7%9%F%`$G$OM-MQ$G$O$J$$!#(B
$B$=$N$?$a!"JL$N%P%$%s%I$K$J$C$F$$$k!#(B

@c If you type this command on an Emacs frame's icon, it deiconifies the frame.
Emacs$B%U%l!<%`$N%"%$%3%s$G$3$N%3%^%s%I$rBG$D$H!"(B
$B%"%$%3%s$r%U%l!<%`$K3+$/!#(B

@item C-x 5 0
@kindex C-x 5 0
@findex delete-frame
@c Delete the selected frame (@code{delete-frame}).  This is not allowed if
@c there is only one frame.
$BA*Br$5$l$F$$$k%U%l!<%`$r:o=|$9$k!J(B@code{delete-frame}$B!K!#(B
$B%U%l!<%`$,$?$C$?(B1$B$D$N>l9g$K$O!"$3$N%3%^%s%I$O5v$5$l$J$$!#(B

@item C-x 5 o
@kindex C-x 5 o
@findex other-frame
@c Select another frame, raise it, and warp the mouse to it so that it
@c stays selected.  If you repeat this command, it cycles through all the
@c frames on your terminal.
$BJL$N%U%l!<%`$rA*Br$7!"$=$l$r$$$A$P$s<jA0$K$b$C$F$-$F!"(B
$B$=$N%U%l!<%`$,A*Br$5$l$k$h$&$K%^%&%9$rHt$S9~$^$;$k!#(B
$B$3$N%3%^%s%I$r7+$jJV$9$H!"C<Kv>e$N$9$Y$F$N%U%l!<%`$r=d2s$9$k!#(B
@end table

@node Non-Window Terminals
@c @section Non-Window Terminals
@c @cindex non-window terminals
@c @cindex single-frame terminals
@section $BHs%&%#%s%I%&C<Kv(B
@cindex $BHs%&%#%s%I%&C<Kv(B
@cindex $BC10l%U%l!<%`C<Kv(B

@c   If your terminal does not have a window system that Emacs supports,
@c then it can display only one Emacs frame at a time.  However, you can
@c still create multiple Emacs frames, and switch between them.  Switching
@c frames on these terminals is much like switching between different
@c window configurations.
Emacs$B$,07$($k%&%#%s%I%&%7%9%F%`$r;H$($J$$C<Kv$G$O!"(B
$B0lEY$K(B1$B$D$N%U%l!<%`$7$+I=<($G$-$^$;$s!#(B
$B$7$+$7!"J#?t$N(BEmacs$B%U%l!<%`$r:n$C$F!"$=$l$i$N%U%l!<%`4V$r@Z$jBX$($i$l$^$9!#(B
$B$3$N$h$&$JC<Kv$G$N%U%l!<%`$N@Z$jBX$($O!"(B
$B0[$J$k%&%#%s%I%&9=@.$NC<Kv$G$N@Z$jBX$($H$?$$$X$s$h$/;w$F$$$^$9!#(B

@c   Use @kbd{C-x 5 2} to create a new frame and switch to it; use @kbd{C-x
@c 5 o} to cycle through the existing frames; use @kbd{C-x 5 0} to delete
@c the current frame.
$B?7$7$$%U%l!<%`$r:n$j$=$l$K@Z$jBX$($k$K$O!"(B@kbd{C-x 5 2}$B$r;H$$$^$9!#(B
$B4{B8$N%U%l!<%`4V$r=d2s$9$k$K$O!"(B@kbd{C-x 5 o}$B$r;H$$$^$9!#(B
$B%+%l%s%H%U%l!<%`$r:o=|$9$k$K$O!"(B@kbd{C-x 5 0}$B$r;H$$$^$9!#(B

@c   Each frame has a number to distinguish it.  If your terminal can
@c display only one frame at a time, the selected frame's number @var{n}
@c appears near the beginning of the mode line, in the form
@c @samp{F@var{n}}.
$B3F%U%l!<%`$K$O$=$l$r6hJL$9$kHV9f$,$"$j$^$9!#(B
$B0lEY$K$O(B1$B$D$N%U%l!<%`$@$1$7$+I=<($G$-$J$$C<Kv$G$O!"(B
$BA*Br$5$l$F$$$k%U%l!<%`$NHV9f(B@var{n}$B$,!"(B
$B%b!<%I9T$N@hF,6a$/$K(B@samp{F@var{n}}$B$H$$$&7A<0$G8=$l$^$9!#(B

@findex set-frame-name
@findex select-frame-by-name
@c   @samp{F@var{n}} is actually the frame's name.  You can also specify a
@c different name if you wish, and you can select a frame by its name.  Use
@c the command @kbd{M-x set-frame-name @key{RET} @var{name} @key{RET}} to
@c specify a new name for the selected frame, and use @kbd{M-x
@c select-frame-by-name @key{RET} @var{name} @key{RET}} to select a frame
@c according to its name.  The name you specify appears in the mode line
@c when the frame is selected.
@samp{F@var{n}}$B$O!"<B:]$K$O%U%l!<%`$NL>A0$G$9!#(B
$BK>$`$J$iJL$NL>A0$r;XDj$G$-!"$=$NL>A0$G%U%l!<%`$rA*Br$G$-$^$9!#(B
$BA*Br$5$l$?%U%l!<%`$K?7$7$$L>A0$r;XDj$9$k$K$O!"(B
$B%3%^%s%I(B@kbd{M-x set-frame-name @key{RET} @var{name} @key{RET}}$B$r;H$$$^$9!#(B
$B$=$NL>A0$G%U%l!<%`$rA*Br$9$k$K$O!"(B
@kbd{M-x select-frame-by-name @key{RET} @var{name} @key{RET}}$B$r;H$$$^$9!#(B
$B;XDj$7$?L>A0$O!"%U%l!<%`$rA*Br$9$k$H%b!<%I9T$KI=<($5$l$^$9!#(B