X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/b26533d6dd98c4986dee5b23712f390ff511585b..cedf175b492f299fac0e8165730472a731915248:/man/display.texi diff --git a/man/display.texi b/man/display.texi index ea8bb79d83..a0cb73c03b 100644 --- a/man/display.texi +++ b/man/display.texi @@ -258,37 +258,36 @@ Some special modes, such as Occur mode and Info mode, have completely specialized ways of assigning fonts for Font Lock mode. @findex font-lock-mode -@findex turn-on-font-lock - The command @kbd{M-x font-lock-mode} turns Font Lock mode on with -positive argument, off with negative or zero 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 + Font Lock mode is turned on by default in all modes which support it. +You can toggle font-lock for each buffer with the command @kbd{M-x +font-lock-mode}. Using a positive argument unconditionally turns Font +Lock mode on, and a negative or zero argument turns it off. @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 variable @code{global-font-lock-mode} using the -Customize interface (@pxref{Easy Customization}) or use the function + If you do not wish Font Lock mode to be turned on by default, +customize the variable @code{global-font-lock-mode} using the Customize +interface (@pxref{Easy Customization}), or use the function @code{global-font-lock-mode} in your @file{.emacs} file, like this: @example -(global-font-lock-mode 1) +(global-font-lock-mode 0) @end example -@noindent -You can also specify this using the menu bar Options menu, specifying -first Syntax Highlighting and then Save Options. +@findex turn-on-font-lock + If you have disabled Global Font Lock mode, you can still enable font +lock for specific major modes by adding the function +@code{turn-on-font-lock} to the mode hooks (@pxref{Hooks}). For +example, to enable Font Lock mode for editing C files, you can do this: + +@example +(add-hook 'c-mode-hook 'turn-on-font-lock) +@end example Font Lock mode uses several specifically named faces to do its job, including @code{font-lock-string-face}, @code{font-lock-comment-face}, -and others. The easiest way to find them all is to use completion -on the face name in @code{set-face-foreground}. +and others. The easiest way to find them all is to use +@kbd{M-x customize-group @key{RET} font-lock-faces @key{RET}}. To change the colors or the fonts used by Font Lock mode to fontify different parts of text, just change these faces. There are @@ -390,35 +389,48 @@ group @samp{jit-lock}. @xref{Specific Customization}. @cindex highlighting by matching @cindex interactive highlighting - It is sometimes useful to highlight the strings that match a certain -regular expression. For example, you might wish to see all the -references to a certain variable in a program source file, or highlight -certain parts in a voluminous output of some program, or make certain -cliches stand out in an article. + It is sometimes useful to temporarily highlight text that +matches a certain regular expression. 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. @findex hi-lock-mode Use the @kbd{M-x hi-lock-mode} command to turn on a minor mode that -allows you to specify regular expressions of the text to be -highlighted. Hi-lock mode works like Font Lock (@pxref{Font Lock}), -except that it lets you specify explicitly what parts of text to -highlight. You control Hi-lock mode with these commands: +allows you to interactively add and remove regular expressions +specifying text to be highlighted. Hi Lock mode works like Font Lock +mode (@pxref{Font Lock}), except that it lets you easily add and +remove regular expressions while you are editing a buffer. 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. + +You control Hi Lock mode with these commands: @table @kbd @item C-x w h @var{regexp} @key{RET} @var{face} @key{RET} @kindex C-x w h @findex highlight-regexp -Highlight text that matches -@var{regexp} using face @var{face} (@code{highlight-regexp}). -By using this command more than once, you can highlight various -parts of the text in different ways. +Highlight text that matches @var{regexp} using face @var{face} +(@code{highlight-regexp}). By using this command more than once, you +can highlight various parts of the text in different ways. The +highlighting will remain as long as the buffer is loaded. For +example, to highlight all occurrences of the word ``whim'' using the +default face (a yellow background) @kbd{C-x w h whim @key{RET} +@key{RET}}. Any face can be used for highlighting, Hi Lock provides +several of its own and these are pre-loaded into a history list. While +being prompted for a face use @kbd{C-p} and @kbd{C-n} to cycle through +them. @item C-x w r @var{regexp} @key{RET} @kindex C-x w r @findex unhighlight-regexp -Unhighlight @var{regexp} (@code{unhighlight-regexp}). You must enter -one of the regular expressions currently specified for highlighting. -(You can use completion, or choose from a menu, to enter one of them -conveniently.) +Unhighlight @var{regexp} (@code{unhighlight-regexp}). +When activated from the menu select the expression to unhighlight from +a list. When activated from the keyboard the most recently added +expression will be shown. Use @kbd{C-p} to show the next older +expression and @kbd{C-n} to select the next newer expression. When +the expression to unhighlight appears press @kbd{@key{RET}} to unhighlight +it. The expression can also be typed and completion is available. @item C-x w l @var{regexp} @key{RET} @var{face} @key{RET} @kindex C-x w l @@ -437,7 +449,7 @@ 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 mode is enabled, or whenever you use the @kbd{M-x hi-lock-find-patterns} command. @item C-x w i @@ -445,8 +457,14 @@ hi-lock-find-patterns} command. @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}). The list of pairs is -found no matter where in the buffer it may be. +(@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 major mode is a member of the list @code{hi-lock-exclude-modes}.