From d9cdecde1177a67e13415ec6fa47ae8844728734 Mon Sep 17 00:00:00 2001 From: Robby Findler Date: Fri, 8 Aug 2008 13:58:23 +0000 Subject: [PATCH] updated searching parts of the manual svn: r11144 --- .../drscheme/interface-essentials.scrbl | 41 ++++++++++++++++++- .../scribblings/drscheme/keybindings.scrbl | 2 +- collects/scribblings/drscheme/menus.scrbl | 30 ++++++++++++-- 3 files changed, 66 insertions(+), 7 deletions(-) diff --git a/collects/scribblings/drscheme/interface-essentials.scrbl b/collects/scribblings/drscheme/interface-essentials.scrbl index 27906dd840..4e50b899d3 100644 --- a/collects/scribblings/drscheme/interface-essentials.scrbl +++ b/collects/scribblings/drscheme/interface-essentials.scrbl @@ -195,7 +195,7 @@ on the languages that DrScheme supports. @; ---------------------------------------------------------------------- -@section[#:tag "editor"]{The Editor} +@section[#:tag "editor"]{Editing with Parentheses} @index['("flashing parenthesis matches")]{@index['("gray highlight regions")]{In}} Scheme mode, especially, DrScheme's editor provides @@ -271,7 +271,44 @@ bracket converter. @; ------------------------------- -@subsection{Tabbed Editing} +@section{Searching} + +DrScheme's search and replace feature is interactive, +similar to those in Safari, Firefox, and Emacs, but with a +few differences. + +To start a search, first select the @onscreen{Find} menu +item from the @onscreen{Edit} menu. This will open a small +editor at the bottom of the DrScheme window. Start typing in +there and, as you type, all occurrences of the string you're +searching for will be circled in the editor window. Watch +the space right next to the search window to see how many +occurrences of the search string there are in your +file. When you're ready, you use the @onscreen{Find Again} +menu item to jump to the first occurrence of the search +string. This will color in one of the circles. Use +@onscreen{Find Again} a second time to jump to the next +occurrence. + +If you click back into the definitions window, the +@onscreen{Find Again} menu item, DrScheme will move the +selection to the next occurrence of the search string. + +DrScheme also supports a mode where typing in the search +editor takes you directly to the next occurrence of the +search string, without selecting the @onscreen{Find Again} +menu item. In the preference dialog, in the +@onscreen{Editing} sectino and then in the +@onscreen{General} section is a checkbox labelled +@onscreen{Search using anchors}. When it is checked, +DrScheme shows a little red dot and a red line indicating +where the @deftech{search anchor} is. When the search anchor +is enabled, typing in the search window jumps to the first +occurrence of the search string after the anchor. + +@; ------------------------------- + +@section{Tabbed Editing} DrScheme's allows you to edit multiple files in a single window via tabs. The @menuitem["File" "New Tab"] menu item creates a new tab to diff --git a/collects/scribblings/drscheme/keybindings.scrbl b/collects/scribblings/drscheme/keybindings.scrbl index faadd21b47..867af94a94 100644 --- a/collects/scribblings/drscheme/keybindings.scrbl +++ b/collects/scribblings/drscheme/keybindings.scrbl @@ -139,7 +139,7 @@ window to the interactions window (or the search window, if it is open).} @keybinding["C-x C-w"]{save file under new name} ] -@section{Searching} +@section{Search} @itemize[ @keybinding["C-s"]{search for string forward} diff --git a/collects/scribblings/drscheme/menus.scrbl b/collects/scribblings/drscheme/menus.scrbl index 4788125657..94845ce06f 100644 --- a/collects/scribblings/drscheme/menus.scrbl +++ b/collects/scribblings/drscheme/menus.scrbl @@ -123,15 +123,34 @@ blinking caret. Each window maintains its own Undo and Redo history. @item{@defmenuitem{Wrap Text} Toggles between wrapped text and unwrapped text in the window.} - @item{@defmenuitem{Find...} Opens a search dialog or, depending on the - preferences, an interactive searching window attached to the frame.} + @item{@defmenuitem{Find...} Opens an interactive search + window at the bottom of the frame and moves the insertion + point to the search string editor (or out of it, if the + insertion point is already there. + + See also @secref["Searching"]. + +} @item{@defmenuitem{Find Again} Finds the next occurrence of the text - that was last searched for.} + in the search window.} + + @item{@defmenuitem{Find Again Backwards} Finds the next occurrence of the text + in the search window, but searching backwards.} @item{@defmenuitem{Replace & Find Again} Replaces the selection with the replace string (if it matches the find string) and finds the next - occurrence of the text that was last searched for.} + occurrence of the text that was last searched for, looking forwards.} + +@item{@defmenuitem{Replace & Find Again Backwards} Replaces the selection with the + replace string (if it matches the find string) and finds the next + occurrence of the text that was last searched for, looking backwards.} + +@item{@defmenuitem{Replace All} Replaces all occurrences of +the search string with the replace string.} + +@item{@defmenuitem{Find Case Sensitive} Toggles between +case-sensitive and case-insensitive search.} @item{@defmenuitem{Keybindings} @itemize{ @@ -146,6 +165,9 @@ blinking caret. Each window maintains its own Undo and Redo history. }} +@item{@defmenuitem{Complete Word} Completes the word at the +insertion point, using the manuals as a source of completions.} + @item{@defmenuitem{Preferences...} Opens the preferences dialog. See @secref["prefs-explanation"]. (Under Mac OS X, this menu item is in the Apple menu.)} }