comparison man/display.texi @ 90813:e6fdae9180d4

Merge from emacs--devo--0 Patches applied: * emacs--devo--0 (patch 698-710) - Update from CVS - Merge from gnus--rel--5.10 * gnus--rel--5.10 (patch 216) - Update from CVS Revision: [e-mail]/emacs--unicode--0--patch-196

90812:6137cc8ddf90

  Some users like the full-screen scroll commands to keep point at the
same screen line.  To enable this behavior, set the variable
@code{scroll-preserve-screen-position} to a non-@code{nil} value.  In
this mode, when these commands would scroll the text around point off
the screen, or within @code{scroll-margin} lines of the edge, they
moves point to keep the same vertical position within the window.
This mode is convenient for browsing through a file by scrolling by
screenfuls; if you come back to the screen where you started, point
goes back to the line where it started.  However, this mode is
inconvenient when you move to the next screen in order to move point
to the text there.

color.  Changing the colors of the @code{default} face also changes
the foreground and background colors on all frames, both existing and
those to be created in the future.  (You can also set foreground and
background colors for the current frame only; see @ref{Frame
Parameters}.)

  Emacs can correctly display variable-width fonts, but Emacs commands
that calculate width and indentation do not know how to calculate
variable widths.  This can sometimes lead to incorrect results when
you use variable-width fonts.  In particular, indentation commands can

typically) to indicate which parts of the buffer were changed most
recently.

@cindex Hi Lock mode
@findex hi-lock-mode
  Hi Lock mode is another minor mode, which highlights text that
matches your specified regular expressions.  For example, you might
wish to see all the references to a certain variable in a program
source file, highlight certain parts in a voluminous output of some
program, or make certain names stand out in an article.  Use the
@kbd{M-x hi-lock-mode} command to enable (or disable) Hi Lock mode.
To enable Hi Lock mode for all buffers, use @kbd{M-x
global-hi-lock-mode} or place @code{(global-hi-lock-mode 1)} in your
@file{.emacs} file.

  Hi Lock mode works like Font Lock mode (@pxref{Font Lock}), except
that you specify explicitly the regular expressions to highlight.  You
control them with these commands:

Insert all the current highlighting regexp/face pairs into the buffer
at point, with comment delimiters to prevent them from changing your
program.  (This key binding runs the
@code{hi-lock-write-interactive-patterns} command.)

These patterns will be read the next time you visit the file while
Hi Lock mode is enabled, or whenever you use the @kbd{M-x
hi-lock-find-patterns} command.

@item C-x w i
@kindex C-x w i
@findex hi-lock-find-patterns
@vindex hi-lock-exclude-modes
Re-read regexp/face pairs in the current buffer
(@code{hi-lock-write-interactive-patterns}).  Users familiar with Font
Lock keywords might interactively enter patterns
(@code{highlight-regexp}), write them into the file
(@code{hi-lock-write-interactive-patterns}), edit them, perhaps
including different faces for different parenthesized parts of the
match, and finally use this command
(@code{hi-lock-write-interactive-patterns}) to have Hi Lock highlight
them.

This command does nothing if the current major mode's symbol is a member
of the list @code{hi-lock-exclude-modes}.
@end table

@node Fringes
@section Window Fringes
@cindex fringes

90813:e6fdae9180d4

  Some users like the full-screen scroll commands to keep point at the
same screen line.  To enable this behavior, set the variable
@code{scroll-preserve-screen-position} to a non-@code{nil} value.  In
this mode, when these commands would scroll the text around point off
the screen, or within @code{scroll-margin} lines of the edge, they
move point to keep the same vertical position within the window.
This mode is convenient for browsing through a file by scrolling by
screenfuls; if you come back to the screen where you started, point
goes back to the line where it started.  However, this mode is
inconvenient when you move to the next screen in order to move point
to the text there.

color.  Changing the colors of the @code{default} face also changes
the foreground and background colors on all frames, both existing and
those to be created in the future.  (You can also set foreground and
background colors for the current frame only; see @ref{Frame
Parameters}.)

  If you want to alter the appearance of all Emacs frames, you need to
customize the frame parameters in the variable
@code{default-frame-alist}; see @ref{Creating Frames,
default-frame-alist}.

  Emacs can correctly display variable-width fonts, but Emacs commands
that calculate width and indentation do not know how to calculate
variable widths.  This can sometimes lead to incorrect results when
you use variable-width fonts.  In particular, indentation commands can

typically) to indicate which parts of the buffer were changed most
recently.

@cindex Hi Lock mode
@findex hi-lock-mode
  Hi Lock mode highlights text that matches regular expressions you
specify.  For example, you might wish to see all the references to a
certain variable in a program source file, highlight certain parts in
a voluminous output of some program, or make certain names stand out
in an article.  Use the @kbd{M-x hi-lock-mode} command to enable (or
disable) Hi Lock mode.  To enable Hi Lock mode for all buffers, use
@kbd{M-x global-hi-lock-mode} or place @code{(global-hi-lock-mode 1)}
in your @file{.emacs} file.

  Hi Lock mode works like Font Lock mode (@pxref{Font Lock}), except
that you specify explicitly the regular expressions to highlight.  You
control them with these commands:

Insert all the current highlighting regexp/face pairs into the buffer
at point, with comment delimiters to prevent them from changing your
program.  (This key binding runs the
@code{hi-lock-write-interactive-patterns} command.)

These patterns are extracted from the comments, if appropriate, if you
invoke @kbd{M-x hi-lock-find-patterns}, or if you visit the file while
Hi Lock mode is enabled (since that runs @code{hi-lock-find-patterns}).

@item C-x w i
@kindex C-x w i
@findex hi-lock-find-patterns
Extract regexp/face pairs from comments in the current buffer
(@code{hi-lock-find-patterns}).  Thus, you can enter patterns
interactively with @code{highlight-regexp}, store them into the file
with @code{hi-lock-write-interactive-patterns}, edit them (perhaps
including different faces for different parenthesized parts of the
match), and finally use this command (@code{hi-lock-find-patterns}) to
have Hi Lock highlight the edited patterns.

@vindex hi-lock-file-patterns-policy
The variable @code{hi-lock-file-patterns-policy} controls whether Hi
Lock mode should automatically extract and highlight patterns found in
a file when it is visited.  Its value can be @code{nil} (never
highlight), @code{t} (highlight the patterns), @code{ask} (query the
user), or a function.  If it is a function,
@code{hi-lock-find-patterns} calls it with the patterns as argument;
if the function returns non-@code{nil}, the patterns are used.  The
default is @code{nil}.  Note that patterns are always highlighted if
you call @code{hi-lock-find-patterns} directly, regardless of the
value of this variable.

@vindex hi-lock-exclude-modes
Also, @code{hi-lock-find-patterns} does nothing if the current major
mode's symbol is a member of the list @code{hi-lock-exclude-modes}.
@end table

@node Fringes
@section Window Fringes
@cindex fringes