-Certain operations invoked from menus will use a window system dialog
-box to get information via the mouse if such dialog boxes are supported.
-This includes yes/no questions and file selection under Motif/LessTif
-and MS Windows. Customize the option @code{use-dialog-box} to suppress
-the use of dialog boxes.
-
-@node Faces
-@section Using Multiple Typefaces
-@cindex faces
-
- When using Emacs with X, you can set up multiple styles of displaying
-characters. The aspects of style that you can control are the type
-font, the foreground color, the background color, and whether to
-underline. Emacs on MS-DOS supports faces partially by letting you
-control the foreground and background colors of each face
-(@pxref{MS-DOS}). On non-windowed terminals faces are supported to the
-extent the terminal can display them.
-
- The way you control display style is by defining named @dfn{faces}.
-Each face can specify a type font, a foreground color, a background
-color, and an underline flag; but it does not have to specify all of
-them. Then by specifying the face or faces to use for a given part
-of the text in the buffer, you control how that text appears.
-
- The style of display used for a given character in the text is
-determined by combining several faces. Any aspect of the display style
-that isn't specified by overlays or text properties comes from the frame
-itself.
-
- Enriched mode, the mode for editing formatted text, includes several
-commands and menus for specifying faces. @xref{Format Faces}, for how
-to specify the font for text in the buffer. @xref{Format Colors}, for
-how to specify the foreground and background color.
-
- To alter the appearance of a face, use the customization buffer.
-@xref{Face Customization}. You can also use X resources to specify
-attributes of particular faces (@pxref{Resources X}).
-
-@cindex face colors, setting
-@findex set-face-foreground
-@findex set-face-background
- Alternatively, you could change the foreground and background colors
-of a specific face with @kbd{M-x set-face-foreground} and @kbd{M-x
-set-face-background}. These commands prompt in the minibuffer for a
-face name and a color name, with completion, and then setup that face to
-use the specified color.
-
-@findex list-faces-display
- To see what faces are currently defined, and what they look like, type
-@kbd{M-x list-faces-display}. It's possible for a given face to look
-different in different frames; this command shows the appearance in the
-frame in which you type it. Here's a list of the standardly defined
-faces:
-
-@table @code
-@item default
-This face is used for ordinary text that doesn't specify any other face.
-@item modeline
-This face is used for mode lines. By default, it's drawn with shadows
-for a `raised' effect under X and set up as the inverse of the default
-face on non-windowed terminals. @xref{Display Vars}.
-@item header-line
-Similar to @code{modeline} for a window's header line.
-@item highlight
-This face is used for highlighting portions of text, in various modes.
-@item region
-This face is used for displaying a selected region (when Transient Mark
-mode is enabled---see below).
-@item secondary-selection
-This face is used for displaying a secondary selection (@pxref{Secondary
-Selection}).
-@item bold
-This face uses a bold variant of the default font, if it has one.
-@item italic
-This face uses an italic variant of the default font, if it has one.
-@item bold-italic
-This face uses a bold italic variant of the default font, if it has one.
-@item underline
-This face underlines text.
-@item fixed-pitch
-The basic fixed-pitch face.
-@item fringe
-The face for the fringes to the left and right of windows under X.
-@item scroll-bar
-This face determines the colors of the scroll bar.
-@item border
-This face determines the color of the frame border.
-@item cursor
-This face determines the color of the cursor.
-@item mouse
-This face determines the color of the mouse pointer.
-@item tool-bar
-The basic tool-bar face.
-@item menu
-This face determines the colors and font of Emacs's menus. Setting the
-font of LessTif/Motif menus is currently not supported; attempts to set
-the font are ignored in this case.
-@item trailing-whitespace
-The face for highlighting trailing whitespace when
-@code{show-trailing-whitespace} is non-nil.
-@item variable-pitch
-The basic variable-pitch face.
-@end table
-
-@cindex @code{region} face
- When Transient Mark mode is enabled, the text of the region is
-highlighted when the mark is active. This uses the face named
-@code{region}; you can control the style of highlighting by changing the
-style of this face (@pxref{Face Customization}). @xref{Transient Mark},
-for more information about Transient Mark mode and activation and
-deactivation of the mark.
-
- One easy way to use faces is to turn on Font Lock mode. This minor
-mode, which is always local to a particular buffer, arranges to
-choose faces according to the syntax of the text you are editing. It
-can recognize comments and strings in most languages; in several
-languages, it can also recognize and properly highlight various other
-important constructs. @xref{Font Lock}, for more information about
-Font Lock mode and syntactic highlighting.
-
- You can print out the buffer with the highlighting that appears
-on your screen using the command @code{ps-print-buffer-with-faces}.
-@xref{PostScript}.
-
-@node Font Lock
-@section Font Lock mode
-@cindex Font Lock mode
-@cindex mode, Font Lock
-@cindex syntax highlighting
-@cindex syntax coloring
-
- Font Lock mode is a minor mode, always local to a particular
-buffer, which highlights (or ``fontifies'') using various faces
-according to the syntax of the text you are editing. It can
-recognize comments and strings in most languages; in several
-languages, it can also recognize and properly highlight various other
-important constructs---for example, names of functions being defined
-or reserved keywords.
-
-@findex font-lock-mode
-@findex turn-on-font-lock
- The command @kbd{M-x font-lock-mode} turns Font Lock mode on or off
-according to the argument, and toggles the mode when it has no argument.
-The function @code{turn-on-font-lock} unconditionally enables Font Lock
-mode. This is useful in mode-hook functions. For example, to enable
-Font Lock mode whenever you edit a C file, you can do this:
-
-@example
-(add-hook 'c-mode-hook 'turn-on-font-lock)
-@end example
-
-@findex global-font-lock-mode
-@vindex global-font-lock-mode
- To turn on Font Lock mode automatically in all modes which support it,
-customize the user option @code{global-font-lock-mode} or use the
-function @code{global-font-lock-mode}, like this:
-
-@example
-(global-font-lock-mode 1)
-@end example
-
- To change the colors or the fonts used by Font Lock mode to fontify
-different parts of text, you can use one of the following:
-
-@itemize @bullet
-@item
-Invoke @kbd{M-x set-face-foreground} or @kbd{M-x set-face-background} to
-change the colors of a particular face, such as
-@code{font-lock-variable-name-face}, used by Font Lock. @xref{Faces}.
-The command @kbd{M-x list-faces-display} displays all the faces
-currently known to Emacs, including those used by Font Lock.
-
-@item
-Customize the faces interactively with @kbd{M-x customize-face}, as
-described in @ref{Face Customization}.
-@end itemize
-
-@kindex M-g M-g
-@findex font-lock-fontify-block
- In Font Lock mode, when you edit the text, the highlighting updates
-automatically in the line that you changed. Most changes don't affect
-the highlighting of subsequent lines, but occasionally they do. To
-rehighlight a range of lines, use the command @kbd{M-g M-g}
-(@code{font-lock-fontify-block}).
-
-@vindex font-lock-mark-block-function
- In certain major modes, @kbd{M-g M-g} refontifies the entire current
-function. (The variable @code{font-lock-mark-block-function} controls
-how to find the current function.) In other major modes, @kbd{M-g M-g}
-refontifies 16 lines above and below point.
-
- With a prefix argument @var{n}, @kbd{M-g M-g} refontifies @var{n}
-lines above and below point, regardless of the mode.
-
- To get the full benefit of Font Lock mode, you need to choose a
-default font which has bold, italic, and bold-italic variants; or else
-you need to have a color or gray-scale screen.
-
-@vindex font-lock-maximum-decoration
- The variable @code{font-lock-maximum-decoration} specifies the
-preferred level of fontification, for modes that provide multiple
-levels. Level 1 is the least amount of fontification; some modes
-support levels as high as 3. The normal default is ``as high as
-possible.'' You can specify an integer, which applies to all modes, or
-you can specify different numbers for particular major modes; for
-example, to use level 1 for C/C++ modes, and the default level
-otherwise, use this:
-
-@example
-(setq font-lock-maximum-decoration
- '((c-mode . 1) (c++-mode . 1)))
-@end example
-
-@vindex font-lock-maximum-size
- Fontification can be too slow for large buffers, so you can suppress
-it. The variable @code{font-lock-maximum-size} specifies a buffer size,
-beyond which buffer fontification is suppressed.
-
-@c @w is used below to prevent a bad page-break.
-@vindex font-lock-beginning-of-syntax-function
- Comment and string fontification (or ``syntactic'' fontification)
-relies on analysis of the syntactic structure of the buffer text. For
-the purposes of speed, some modes including C mode and Lisp mode rely on
-a special convention: an open-parenthesis in the leftmost column always
-defines the @w{beginning} of a defun, and is thus always outside any string
-or comment. (@xref{Defuns}.) If you don't follow this convention,
-then Font Lock mode can misfontify the text after an open-parenthesis in
-the leftmost column that is inside a string or comment.
-
- The variable @code{font-lock-beginning-of-syntax-function} (always
-buffer-local) specifies how Font Lock mode can find a position
-guaranteed to be outside any comment or string. In modes which use the
-leftmost column parenthesis convention, the default value of the variable
-is @code{beginning-of-defun}---that tells Font Lock mode to use the
-convention. If you set this variable to @code{nil}, Font Lock no longer
-relies on the convention. This avoids incorrect results, but the price
-is that, in some cases, fontification for a changed text must rescan
-buffer text from the beginning of the buffer.
-
-@findex font-lock-add-keywords
- Font Lock highlighting patterns already exist for many modes, but you
-may want to fontify additional patterns. You can use the function
-@code{font-lock-add-keywords}, to add your own highlighting patterns for
-a particular mode. For example, to highlight @samp{FIXME:} words in C
-comments, use this:
-
-@example
-(font-lock-add-keywords
- 'c-mode
- '(("\\<\\(FIXME\\):" 1 font-lock-warning-face t)))
-@end example
-
-@node Support Modes
-@section Font Lock Support Modes
-
- Font Lock support modes make Font Lock mode faster for large buffers.
-There are two support modes: Fast Lock mode and Lazy Lock mode. They
-use two different methods of speeding up Font Lock mode.