Edit and correct help topics relating to three search related dialogue boxes

The dialogue boxes are: Find Text, Find Cross Refs and Select Snippets

Author: delphidabbler

Src/Help/HTML/dlg_findtext.htm

@@ -41,36 +41,39 @@ <h1>
     </p>
     <p>
       Enter the text you want to search for in the <em>Text to find</em> combo
-      box.
+      box. Recent search text can be accessed from the drop down list.
     </p>
     <p>
       When more than one search word is entered you have a choice of whether to
       search for snippets containing all the words, or any of them. You specify
       which of these options you want by choosing the relevant radio button in
       the <em>Search logic</em> group box. For example, choosing the <em>Find
-      all words</em> option and searching for &quot;Foo Bar&quot; would match
-      the text &quot;Foo and Bar&quot; but would not match &quot;Foo&quot; or
-      &quot;Bar&quot;. Choosing <em>Find and word</em> instead and again
-      searching for &quot;Foo Bar&quot; would match all the previous examples.
+      all words</em> option and searching for &quot;<code>Foo Bar</code>&quot;
+      would match the text &quot;Foo and Bar&quot; but would not match
+      &quot;Foo&quot; or &quot;Bar&quot;. Choosing <em>Find any word</em>
+      instead and again searching for &quot;<code>Foo Bar</code>&quot; would
+      match all the previous examples.
     </p>
     <p>
       There are two more options for further refining the search:
     </p>
     <ol>
       <li>
         Use the <em>Whole words only</em> check box to ensure that the search
-        only looks up words that exactly match those specified. If the check box
+        only matches words that exactly match those specified. If the check box
         is cleared then words containing the specified text will also be found.
-        For example when the check box is ticked search for &quot;Foo&quot; will
-        not match &quot;FooBar&quot;, but when the check box is cleared, the two
-        words will match.
+        For example when the check box is ticked a search for
+        &quot;<code>Foo</code>&quot; will match &quot;Foo&quot; in
+        &quot;Foo Bar&quot; but will not match &quot;FooBar&quot;. When the
+        check box is cleared, &quot;<code>Foo</code>&quot; will match both
+        examples.
       </li>
       <li>
         Make the search case sensitive by checking the <em>Case sensitive</em>
-        check box. In this case searching for &quot;Foo&quot; would only match
-        the exact text and would not match &quot;foo&quot or &quot;FOO&quot;.
-        If the check box is cleared then case is ignored. Now searching for
-        &quot;Foo;&quot; will match both &quot;foo&quot and &quot;FOO&quot;.
+        check box. In this case searching for &quot;<code>Foo</code>&quot; will
+        match &quot;Foo&quot; but not &quot;foo&quot; or &quot;FOO&quot;. If the
+        check box is cleared then case is ignored and searching for
+        &quot;<code>Foo</code>&quot; again will match all three examples.
       </li>
     </ol>
     <p>
@@ -88,10 +91,9 @@ <h1>
       remains unchanged.
     </p>
     <p>
-      The <em>Search scope</em> group box is disabled if there was no existing
-      search when this dialogue box was opened, and the search operates on the
-      entire database.
+      The <em>Search scope</em> group box is disabled if there was no previous
+      search active when this dialogue box was opened. The search will operate
+      on the entire database.
     </p>
   </body>
 </html>
-

Src/Help/HTML/dlg_findxrefs.htm

@@ -28,56 +28,97 @@ <h1>
     </h1>
     <p>
       Use this dialogue box to find snippets that are referenced by the
-      currently selected snippet and / or those snippets reference that snippet.
-      The dialogue is displayed from the <em>Search | Find Cross Refs</em> menu
-      option.
+      currently selected snippet and / or those snippets that reference the
+      snippet. The dialogue is displayed from the <em>Search | Find Cross
+      Refs</em> menu option.
     </p>
     <p>
-      The search can be customised by checking or clearing the following check
+      The dialogue enables two kinds of cross-references to be found:
+    </p>
+    <ol>
+      <li>
+        Snippet dependencies, which are snippets that the selected snippet
+        depends upon in order to compile. Alternatively the search can find
+        snippets that depend on the selected one.
+      </li>
+      <li>
+        &quot;See also&quot; references, which are snippets that are related to
+        the selected snippet conceptually. Such snippets are not necessarily
+        needed to compile the selected snippet. Alternatively the search can
+        find snippets that refer to the selected one as a &quot;see also&quot;
+        snippet.
+      </li>
+    </ol>
+    <p>
+      The search is customised by checking or clearing the following check
       boxes:
     </p>
     <ul>
       <li>
-        <em>Search for required snippets</em>. Selecting this option causes
-        all snippets that are needed to compile the selected snippet to be
-        included in the search result. If the related <em>Search
-        recursively</em> box is checked the search continues through the found
-        snippets.
+        <p>
+          <em>Search for required snippets</em>
+        </p>
+        <p>
+          Selecting this option includes all snippets that the selected snippet
+          depends upon in the search result.
+        </p>
+        <p>
+          If the related <em>Search recursively</em> box is checked the search
+          is applied recursively to all the found snippets.
+        </p>
       </li>
       <li>
-        <em>Search for snippets that depend on this one</em>. Choose this option
-        to include in the search results all snippets that depend upon (i.e.
-        require) this one.
+        <p>
+          <em>Search for snippets that depend on this one</em>
+        </p>
+        <p>
+          Choose this option to include in the search results all snippets that
+          depend upon this one.
+        </p>
       </li>
       <li>
-        <em>Search for &quot;see also&quot; cross references</em>. This option
-        includes snippets referenced as &quot;see also&quot; to be included in
-        the search result. These snippets are not necessarily needed to compile
-        the selected snippet, but are related to it conceptually. Again,
-        checking the related <em>Search recursively</em> check box causes the
-        search to recurse through the found &quot;see also&quot; cross
-        references.
+        <p>
+          <em>Search for &quot;see also&quot; cross references</em>
+        </p>
+        <p>
+          This option includes all snippets referenced as &quot;see also&quot;
+          in the search result.
+        </p>
+        <p>
+          Checking the related <em>Search recursively</em> check box causes the
+          search to recurse through all the found snippets' &quot;see also&quot;
+          cross references.
+        </p>
       </li>
       <li>
-        <em>Search for snippets that cross-reference this one</em>. Choose this
-        option to include in the search results all snippets that
-        cross-reference this one.
+        <p>
+          <em>Search for snippets that cross-reference this one</em>
+        </p>
+        <p>
+          Choose this option to include all snippets that cross-reference this
+          one in the search results.
+        </p>
       </li>
       <li>
-        <em>Include &quot;xxxx&quot; in search</em> (where xxxx is the name of
-        the selected snippet). Checking this box simply includes the selected
-        snippet in the search results.
+        <p>
+          <em>Include &quot;xxxx&quot; in search</em> (where xxxx is the name of
+          the selected snippet).
+        </p>
+        <p>
+          Checking this box simply includes the selected snippet in the search
+          results.
+        </p>
       </li>
     </ul>
     <p>
       You must check at least one of the <em>Search for required snippets</em>
       or <em>Search for &quot;see also&quot; cross references</em> options.
     </p>
     <p>
-      <strong>NOTE:</strong> Any cross references selected using this dialogue
-      box will replace any search results that were previously displayed. A
+      <strong>Note:</strong> Snippets selected by the use of this dialogue box
+      will replace any search results that were previously displayed. A
       message to this effect will be displayed in the dialogue box if it is
-      displayed when search results are being displayed.
+      opened while a previous search is active.
     </p>
   </body>
 </html>

Src/Help/HTML/dlg_selectroutines.htm

@@ -41,48 +41,51 @@ <h1>
       Snippets are displayed sorted under categories. When the dialogue box
       opens only the categories are shown. They can be expanded and collapsed
       in the usual way: by clicking the arrow symbols (or plus/minus symbols)
-      that appear to the left of the categories; by double clicking the
-      category; by using the <span class="smallcaps">Left</span>,
+      that appear to the left of the categories, by double clicking the
+      category or by using the <span class="smallcaps">Left</span>,
       <span class="smallcaps">Right</span> and
       <span class="smallcaps">Enter</span> keys. Alternatively use the
       <em>Expand All</em> and <em>Collapse All</em> buttons on the right of
       the dialogue box.
     </p>
     <p>
-      Snippets are selected simply by placing a check mark next to the name of
-      the required snippets. Checking or unchecking a category will select or
+      Snippets are selected by placing a check mark next to the name of the
+      required snippets. Checking or unchecking a category will select or
       de-select all the snippets in the category. When the dialogue box appears
-      all snippets currently displayed by the program are selected.
+      all snippets currently displayed by the program are pre-selected.
     </p>
     <p>
       There are also four buttons that can be used to select or deselect groups
       of snippets. The options are:
     </p>
     <ul>
       <li>
-        <em>Select All</em> selects all the snippets in the database.
+        <em>Select All</em><br>
+        Selects all the snippets in the database.
       </li>
       <li>
-        <em>Clear All</em> deselects all the snippets in the database.
+        <em>Clear All</em><br>
+        Deselects all the snippets in the database.
       </li>
       <li>
-        <em>User Defined</em> selects all the user defined snippets in the
-        database. The button will be disabled if there are no user defined
-        snippets.
+        <em>User Defined</em><br>
+        Selects all the user defined snippets in the database. The button will
+        be disabled if there are no user defined snippets.
       </li>
       <li>
-        <em>Main</em> selects all the snippets in the main database.
+        <em>Main</em><br>
+        Selects all the snippets in the main database.
       </li>
     </ul>
     <p>
-      When the selection has been made, click the <em>OK</em> to accept the
-      changes. At least one snippet must be selected. Click <em>Cancel</em> to
-      abort your selection.
+      When the selection has been made, click the <em>OK</em> button to accept
+      the changes. At least one snippet must be selected. Click <em>Cancel</em>
+      to abort your selection.
     </p>
     <p>
-      <strong>NOTE:</strong> Any selection made using this dialogue box will
+      <strong>Note:</strong> Any selection made using this dialogue box will
       replace any search results that were previously displayed. A message to
-      this effect will be displayed in the dialogue box if it is displayed when
+      this effect will be displayed in the dialogue box if it is opened while
       search results are being displayed.
     </p>
     <p>