[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/man/search.texi
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] Changes to emacs/man/search.texi |
Date: |
Sat, 01 Nov 2003 12:06:00 -0500 |
Index: emacs/man/search.texi
diff -c emacs/man/search.texi:1.40 emacs/man/search.texi:1.41
*** emacs/man/search.texi:1.40 Mon Sep 1 11:45:46 2003
--- emacs/man/search.texi Sat Nov 1 12:06:00 2003
***************
*** 19,32 ****
asks interactively which occurrences to replace.
@menu
! * Incremental Search:: Search happens as you type the string.
! * Nonincremental Search:: Specify entire string and then search.
! * Word Search:: Search for sequence of words.
! * Regexp Search:: Search for match for a regexp.
! * Regexps:: Syntax of regular expressions.
! * Search Case:: To ignore case while searching, or not.
! * Replace:: Search, and replace some or all matches.
! * Other Repeating Search:: Operating on all matches for some regexp.
@end menu
@node Incremental Search, Nonincremental Search, Search, Search
--- 19,33 ----
asks interactively which occurrences to replace.
@menu
! * Incremental Search:: Search happens as you type the string.
! * Nonincremental Search:: Specify entire string and then search.
! * Word Search:: Search for sequence of words.
! * Regexp Search:: Search for match for a regexp.
! * Regexps:: Syntax of regular expressions.
! * Search Case:: To ignore case while searching, or not.
! * Configuring Scrolling:: Scrolling within incremental search.
! * Replace:: Search, and replace some or all matches.
! * Other Repeating Search:: Operating on all matches for some regexp.
@end menu
@node Incremental Search, Nonincremental Search, Search, Search
***************
*** 226,231 ****
--- 227,260 ----
of bindings, look at the documentation of @code{isearch-mode} with
@kbd{C-h f isearch-mode @key{RET}}.
+ @subsection Scrolling During Incremental Search
+
+ Vertical scrolling during incremental search can be enabled by
+ setting the customizable variable @code{isearch-allow-scroll} to a
+ non-nil value.
+
+ You can then use the vertical scroll-bar or certain keyboard
+ commands such as @address@hidden (@code{scroll-down}),
+ @address@hidden (@code{scroll-up}) and @kbd{C-l} (@code{recenter})
+ within the search, thus letting you see more of the text near the
+ current match. You must run these commands via their key sequences to
+ stay in the search - typing M-x @var{comand-name} will always
+ terminate a search.
+
+ You can give prefix arguments to these commands in the usual way.
+ The current match cannot be scrolled out of the window - this is
+ intentional.
+
+ Several other commands, such as @kbd{C-x 2}
+ (@code{split-window-vertically}) and @kbd{C-x ^}
+ (@code{enlarge-window}) which don't scroll the window, are
+ nevertheless made available under this rubric, since they are likewise
+ handy during a search.
+
+ For a list of commands which are configured as scrolling commands by
+ default and instructions on how thus to configure other commands, see
+ @ref{Configuring Scrolling}.
+
@subsection Slow Terminal Incremental Search
Incremental search on a slow terminal uses a modified style of display
***************
*** 762,768 ****
for matching parens.)
@end ignore
! @node Search Case, Replace, Regexps, Search
@section Searching and Case
Incremental searches in Emacs normally ignore the case of the text
--- 791,797 ----
for matching parens.)
@end ignore
! @node Search Case, Configuring Scrolling, Regexps, Search
@section Searching and Case
Incremental searches in Emacs normally ignore the case of the text
***************
*** 792,798 ****
performed by the replace commands (@pxref{Replace}) and the minibuffer
history matching commands (@pxref{Minibuffer History}).
! @node Replace, Other Repeating Search, Search Case, Search
@section Replacement Commands
@cindex replacement
@cindex search-and-replace commands
--- 821,902 ----
performed by the replace commands (@pxref{Replace}) and the minibuffer
history matching commands (@pxref{Minibuffer History}).
! @node Configuring Scrolling, Replace, Search Case, Search
! @section Configuring Scrolling
! @cindex scrolling in incremental search
! @vindex isearch-allow-scroll
!
! Scrolling, etc., during incremental search is enabled by setting the
! customizable variable @code{isearch-allow-scroll} to a non-nil value.
!
! @c See Subject: Info file: How do I get an itemized list without blank lines?
! @c Date: Sat, 12 Apr 2003 09:45:31 +0000 in gnu.emacs.help
! @subsection Standard scrolling commands
! Here is the list of commands which are configured by default to be
! ``scrolling'' commands in an incremental search, together with their
! usual bindings:
! @subsubsection Commands which scroll the window:
! @table @asis
! @item @code{scroll-bar-toolkit-scroll} (@address@hidden@key{mouse-1}} in
X-Windows)
! @itemx @code{mac-handle-scroll-bar-event} (@address@hidden@key{mouse-1}} on a
Mac)
! @itemx @code{w32-handle-scroll-bar-event} (@address@hidden@key{mouse-1}} in
MS-Windows)
! @item @code{recenter} (@kbd{C-l}) @xref{Scrolling}.
! @itemx @code{reposition-window} (@kbd{C-M-l}) @xref{Scrolling}.
! @itemx @code{scroll-up} (@address@hidden) @xref{Scrolling}.
! @itemx @code{scroll-down} (@address@hidden) @xref{Scrolling}.
! @end table
!
! @subsubsection Commands which act on the other window:
! @table @asis
! @item @code{list-buffers} (@kbd{C-x C-b}) @xref{List Buffers}.
! @itemx @code{scroll-other-window} (@kbd{C-M-v}) @xref{Other Window}.
! @itemx @code{scroll-other-window-down} (@kbd{C-M-S-v}) @xref{Other Window}.
! @itemx @code{beginning-of-buffer-other-window} (@address@hidden)
! @itemx @code{end-of-buffer-other-window} (@address@hidden)
! @end table
!
! @subsubsection Commands which change the window layout:
! @table @asis
! @item @code{delete-other-windows} (@kbd{C-x 1}) @xref{Change Window}.
! @itemx @code{balance-windows} (@kbd{C-x +}) @xref{Change Window}.
! @itemx @code{split-window-vertically} (@kbd{C-x 2}) @xref{Split Window}.
! @itemx @code{enlarge-window} (@kbd{C-x ^}) @xref{Change Window}.
! @end table
!
! @subsection Configuring other commands as scrolling commands
! To do this, set a command's isearch-scroll property to the value t.
! For example:
!
! @example
! @code{(put 'my-command 'isearch-scroll t)}
! @end example
!
! You should only thus configure commands which are ``safe'': i.e., they
! won't leave emacs in an inconsistent state when executed within a
! search - that is to say, the following things may be changed by a
! command only temporarily, and must be restored before the command
! finishes:
!
! @enumerate
! @item
! Point.
! @item
! The buffer contents.
! @item
! The selected window and selected frame.
! @item
! The current match-data @xref{Match Data,,,elisp}.
! @end enumerate
!
! Additionally, the command must not delete the current window and must
! not itself attempt an incremental search. It may, however, change the
! window's size, or create or delete other windows and frames.
!
! Note that an attempt by a command to scroll the text
! @emph{horizontally} won't work, although it will do no harm - any such
! scrolling will be overriden and nullified by the display code.
!
! @node Replace, Other Repeating Search, Configuring Scrolling, Search
@section Replacement Commands
@cindex replacement
@cindex search-and-replace commands
***************
*** 814,823 ****
(@pxref{Expanding Abbrevs}).
@menu
! * Unconditional Replace:: Replacing all matches for a string.
! * Regexp Replace:: Replacing all matches for a regexp.
! * Replacement and Case:: How replacements preserve case of letters.
! * Query Replace:: How to use querying.
@end menu
@node Unconditional Replace, Regexp Replace, Replace, Replace
--- 918,927 ----
(@pxref{Expanding Abbrevs}).
@menu
! * Unconditional Replace:: Replacing all matches for a string.
! * Regexp Replace:: Replacing all matches for a regexp.
! * Replacement and Case:: How replacements preserve case of letters.
! * Query Replace:: How to use querying.
@end menu
@node Unconditional Replace, Regexp Replace, Replace, Replace
- [Emacs-diffs] Changes to emacs/man/search.texi,
Eli Zaretskii <=