Update Preferences dialogue help pages

delphidabbler · delphidabbler · commit e6c734a3df25 · 2021-12-30T13:37:40.000Z
Changed to take account of new appearance of dialogue box now that
tabs have been removed.
diff --git a/Src/Help/HTML/dlg_preferences.htm b/Src/Help/HTML/dlg_preferences.htm
@@ -31,8 +31,10 @@ <h1>
       dialogue box is accessed via the <em>Tools | Preferences</em> menu option.
     </p>
     <p>
-      The dialogue box is divided into several sections, accessed by tabs across
-      the top of the page. These are:
+      The dialogue box is divided into different &quot;pages&quot;. Each page is listed by name in the pane on the left hand side of the dialogue box. Selecting one of these names displays the related page of options on the right.
+    </p>
+    <p>
+      The sections are:
     </p>
     <ul class="unspaced">
       <li>
@@ -61,12 +63,15 @@ <h1>
       Click <em>OK</em> to accept all the changes or <em>Cancel</em> to close
       the dialogue without making changes.
     </p>
+    <p>
+      The last page you selected is remembered and is displayed again the next time you open the dialogue box. This happens regardless of whether you close the dialogue box with <em>OK</em> or <em>Cancel</em>.
+    </p>
     <p>
       <strong>Note:</strong> On some occasions this dialogue box may be
-      displayed with just one tab visible. An example of this is when the
+      displayed with just one page visible. An example of this is when the
       <em>Default Options</em> button of the <a href="dlg_print.htm">Print</a>
       dialogue box is clicked &ndash; only the
-      <a href="dlg_prefs_printing.htm">Printing</a> tab is displayed.
+      <a href="dlg_prefs_printing.htm">Printing</a> page is displayed.
     </p>
   </body>
 </html>
diff --git a/Src/Help/HTML/dlg_prefs_codegen.htm b/Src/Help/HTML/dlg_prefs_codegen.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2010-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Code Generation tab of Preferences dialogue box.
+ * Help topic for Code Generation page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -24,19 +24,22 @@
       <param name="ALink Name" value="CodeGenPrefs">
     </object>
     <h1>
-      <a name="dlg_prefs_codegen"></a>Code Generation Preferences
+      <a name="dlg_prefs_codegen"></a>Code Generation Preferences Page
     </h1>
     <p>
-      This tab of the <a href="dlg_preferences.htm">Preferences</a> dialogue box
-      is used to customise the source code emitted by the code generator when
-      creating test compilations and when outputting units.
+      This page of the <a href="dlg_preferences.htm">Preferences</a> dialogue
+      box is used to customise the source code emitted by the code generator
+      when creating test compilations and when outputting units.
     </p>
     <p>
-      The tab is accessed by selecting the <em>Tools | Preferences</em> menu
-      item then clicking the <em>Code Generation</em> tab.
-      <strong>Note:</strong> This tab is not used to modify the <em>style</em>
+      The page is accessed by selecting the <em>Tools | Preferences</em> menu
+      item then clicking on <em>Code Generation</em> in the list on the left of
+      the window.
+    </p>
+    <p>
+      <strong>Note:</strong> This page is not used to modify the <em>style</em>
       of the source code: use the <a href="dlg_prefs_sourcecode.htm">Code
-      Formatting</a> tab for that.
+      Formatting</a> page for that.
     </p>
     <p>
       The Code Generator can be configured to generate <code>$WARN</code>
@@ -107,7 +110,7 @@ <h1>
       supported compiler version is 14.0.
     </p>
     <p>
-      The <em>Preview</em> button at the top right of the tab displays the
+      The <em>Preview</em> button at the top right of the page displays the
       source code that will be emitted by the code generator.
     </p>
     <p>
diff --git a/Src/Help/HTML/dlg_prefs_display.htm b/Src/Help/HTML/dlg_prefs_display.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2012-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Display tab of Preferences dialogue box.
+ * Help topic for Display page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -24,15 +24,15 @@
       <param name="ALink Name" value="DisplayPrefs">
     </object>
     <h1>
-      <a name="dlg_prefs_display"></a>Display Preferences
+      <a name="dlg_prefs_display"></a>Display Preferences Page
     </h1>
     <p>
-      Using this tab of the <a
+      Using this page of the <a
         href="dlg_preferences.htm"
       >Preferences</a> dialogue box you can configure various aspects of the
-      program's display. The tab is accessed by selecting the
-      <em>Tools | Preferences</em> menu item then clicking the <em>Display</em>
-      tab.
+      program's display. The page is accessed by selecting the
+      <em>Tools | Preferences</em> menu item then clicking on <em>Display</em>
+      in the list on the left of the window.
     </p>
     <p>
       The options are:
diff --git a/Src/Help/HTML/dlg_prefs_general.htm b/Src/Help/HTML/dlg_prefs_general.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2007-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Miscellaneous tab of Preferences dialogue box.
+ * Help topic for Miscellaneous page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -24,18 +24,18 @@
       <param name="ALink Name" value="GeneralPrefs">
     </object>
     <h1>
-      <a name="dlg_prefs_general"></a>Miscellaneous Preferences
+      <a name="dlg_prefs_general"></a>Miscellaneous Preferences Page
     </h1>
     <p>
-      This tab of the <a
+      This page of the <a
         href="dlg_preferences.htm"
       >Preferences</a> dialogue box is used for miscellaneous preferences that
-      don't merit a tab of their own. The tab is accessed by selecting the
-      <em>Tools | Preferences</em> menu item then clicking the <em>Misc.</em>
-      tab.
+      don't merit a page of their own. The page is accessed by selecting the
+      <em>Tools | Preferences</em> menu item then clicking on <em>Misc.</em> in
+      the list on the left of the window.
     </p>
     <p>
-      There is only a single option that can be set on this tab.
+      There is only a single option that can be set on this page.
     </p>
     <h2>
       Measurement
diff --git a/Src/Help/HTML/dlg_prefs_hiliter.htm b/Src/Help/HTML/dlg_prefs_hiliter.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2007-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Syntax Highlighter tab of Preferences dialogue box.
+ * Help topic for Syntax Highlighter page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -25,13 +25,14 @@
     </object>
     <h1>
       <a name="dlg_prefs_hiliter"></a>
-      Syntax Highlighter Preferences
+      Syntax Highlighter Preferences Page
     </h1>
     <p>
       The appearance of syntax highlighted source files can be customised using
-      this tab of the <a href="dlg_preferences.htm">Preferences</a> dialogue
-      box. The tab is accessed by selecting the <em>Tools | Preferences</em>
-      menu item then clicking the <em>Syntax Highlighter</em> tab.
+      this page of the <a href="dlg_preferences.htm">Preferences</a> dialogue
+      box. The page is accessed by selecting the <em>Tools | Preferences</em>
+      menu item then clicking on <em>Syntax Highlighter</em> in the list on the 
+      left of the window.
     </p>
     <h3>
       Note
@@ -40,7 +41,8 @@ <h3>
       Syntax highlighter customisation applies to the
       <a href="detail_pane.htm">Detail Pane</a>, exported files and source
       code copied to the clipboard. Highlighting used in printed documents is
-      configured from the <a href="dlg_prefs_printing.htm">Printing</a> tab.
+      configured from the <a href="dlg_prefs_printing.htm">Printing</a>
+      preferences page.
     </p>
     <p>
       Different syntax highlighter styles can be saved and given identifying
@@ -56,7 +58,7 @@ <h2>
     </p>
     <p>
       <strong>Note:</strong> The highlighter font is ignored in code previews in
-      other tabs of the <a href="dlg_preferences.htm">Preferences</a> dialogue
+      other pages of the <a href="dlg_preferences.htm">Preferences</a> dialogue
       box to ensure that previews fit the available space.
     </p>
     <h2>
diff --git a/Src/Help/HTML/dlg_prefs_printing.htm b/Src/Help/HTML/dlg_prefs_printing.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2007-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Printing tab of Preferences dialogue box.
+ * Help topic for Printing page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -24,22 +24,24 @@
       <param name="ALink Name" value="PrintingPrefs">
     </object>
     <h1>
-      <a name="dlg_prefs_printing"></a>Printing Preferences
+      <a name="dlg_prefs_printing"></a>Printing Preferences Page
     </h1>
     <p>
-      This tab of the <a href="dlg_preferences.htm">Preferences</a> dialogue box
-      is used customise the default appearance of printed output.
-     </p>
-     <p>
-      The tab is accessed by selecting the <em>Tools | Preferences</em> menu
-      item then clicking the <em>Printing</em> tab. You can also display this
-      tab from the <a href="dlg_print.htm">Print</a> dialogue box.
+      This page of the <a href="dlg_preferences.htm">Preferences</a> dialogue
+      box is used customise the default appearance of printed output.
     </p>
     <p>
-      <strong class="warning">Warning:</strong> Options set in this tab usually take effect the
-      next time the application is started. The exception is when the tab is
-      displayed from the <em>Print</em> dialogue box, when you can choose to
-      apply the new options straight away.
+      The page is accessed by selecting the <em>Tools | Preferences</em> menu
+      item then clicking on <em>Printing</em> in the list on the left of the
+      window. You can also display this page from the
+      <a href="dlg_print.htm">Print</a> dialogue box.
+    </p>
+    <p>
+      <strong class="warning">Warning:</strong> When this page is displayed via
+      the <em>Tools | Preferences</em> menu option options usually only take
+      effect the next time the application is started. But when the page is
+      displayed from the <em>Print</em> dialogue box, the changed options take
+      effect straight away.
     </p>
     <h2>
       Document Formatting Options
@@ -64,9 +66,9 @@ <h2>
     </p>
     <p>
       When syntax highlighting is enabled the style used is as specified in the
-      <a href="dlg_prefs_hiliter.htm">Syntax Highlighter</a> tab. When black and
-      white printing is specified the highlighter's font styles are used but
-      colours are ignored.
+      <a href="dlg_prefs_hiliter.htm">Syntax Highlighter</a> peferences page.
+      When black and white printing is specified the highlighter's font styles
+      are used but colours are ignored.
     </p>
     <h2>
       Page Margins
@@ -79,7 +81,8 @@ <h2>
       Margins are displayed and entered either in inches or millimeters. The
       units being used are displayed in the group box caption.
       <strong>Note:</strong> measurement units can be changed on the
-      <a href="dlg_prefs_general.htm">Misc.</a> tab, if it is visible.
+      <a href="dlg_prefs_general.htm">Misc.</a> preferences page, if it is
+      visible.
     </p>
   </body>
 </html>
diff --git a/Src/Help/HTML/dlg_prefs_snippetlayout.htm b/Src/Help/HTML/dlg_prefs_snippetlayout.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2012-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Snippet Layout tab of Preferences dialogue box.
+ * Help topic for Snippet Layout page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -24,10 +24,10 @@
       <param name="ALink Name" value="SnippetLayoutPrefs">
     </object>
     <h1>
-      <a name="dlg_prefs_snippetlayout"></a>Snippet Layout Preferences
+      <a name="dlg_prefs_snippetlayout"></a>Snippet Layout Preferences Page
     </h1>
     <p>
-      This tab of the <a
+      This page of the <a
         href="dlg_preferences.htm"
       >Preferences</a> dialogue box is used to customise the layout of pages
       that display the various <a
@@ -38,10 +38,9 @@ <h1>
       >Detail Pane</a>.
     </p>
     <p>
-      The tab is accessed by selecting the <em>Tools | Preferences</em> menu
-      item then clicking the <em>Snippet Layout</em> tab in the <a
-        href="dlg_preferences.htm"
-      >Preferences</a> dialogue box.
+      The page is accessed by selecting the <em>Tools | Preferences</em> menu
+      item then clicking on <em>Snippet Layout</em> in the list on the left of
+      the window.
     </p>
     <h2>
       Overview
diff --git a/Src/Help/HTML/dlg_prefs_sourcecode.htm b/Src/Help/HTML/dlg_prefs_sourcecode.htm
@@ -6,7 +6,7 @@
  *
  * Copyright (C) 2007-2020, Peter Johnson (gravatar.com/delphidabbler).
  *
- * Help topic for Code Formatting tab of Preferences dialogue box.
+ * Help topic for Code Formatting page of Preferences dialogue box.
 -->
 <html>
   <head>
@@ -26,14 +26,14 @@
     <h1>
       <!-- Note the file name is a hang-over from when the tab was named
          'Source Code' -->
-      <a name="dlg_prefs_sourcecode"></a>Code Formatting Preferences
+      <a name="dlg_prefs_sourcecode"></a>Code Formatting Preferences Page
     </h1>
     <p>
-      This tab of the <a href="dlg_preferences.htm">Preferences</a> dialogue box
-      is used to configure the format of source code that <em>CodeSnip</em>
-      writes to file or copies to the clipboard. The tab is accessed by
-      selecting the <em>Tools | Preferences</em> menu item then clicking the
-      <em>Code Formatting</em> tab.
+      This page of the <a href="dlg_preferences.htm">Preferences</a> dialogue
+      box is used to configure the format of source code that <em>CodeSnip</em>
+      writes to file or copies to the clipboard. The page is accessed by
+      selecting the <em>Tools | Preferences</em> menu item then clicking on
+      <em>Code Formatting</em> in the list on the left of the window.
     </p>
     <h2>
       Source code formatting
@@ -87,7 +87,7 @@ <h2>
       HTML and rich text file types can be syntax highlighted. To enable this
       option check the <em>Enable syntax highlighting</em> check box. The
       highlighting can be customised using the
-      <a href="dlg_prefs_hiliter.htm">Syntax Highlighter</a> tab.
+      <a href="dlg_prefs_hiliter.htm">Syntax Highlighter</a> preferences page.
     </p>
     <p>
       You can override the default format when saving source code to file by
