updated searching parts of the manual

svn: r11144

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

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}

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.)}  }