mention "Document font" in font preferences. Fixes #369160 Split section

  * goscustdesk.xml: mention "Document font" in font preferences. Fixes #369160
    Split section on font preferences more sensibly while I'm at it.

2 files changed, 123 insertions, 145 deletions

diff --git a/gnome2-user-guide/C/ChangeLog b/gnome2-user-guide/C/ChangeLog
index 70ae38e..37711e6 100644
--- a/gnome2-user-guide/C/ChangeLog
+++ b/gnome2-user-guide/C/ChangeLog
@@ -1,3 +1,8 @@
+2006-11-02  Joachim Noreiko  <jnoreiko@yahoo.com>
+
+  * goscustdesk.xml: mention "Document font" in font preferences. Fixes #369160
+    Split section on font preferences more sensibly while I'm at it.
+
 2006-09-06  Joachim Noreiko  <jnoreiko@yahoo.com>
 
   * gosnautilus.xml: better wording for writing CDs:
diff --git a/gnome2-user-guide/C/goscustdesk.xml b/gnome2-user-guide/C/goscustdesk.xml
index c79b338..96ee72b 100644
--- a/gnome2-user-guide/C/goscustdesk.xml
+++ b/gnome2-user-guide/C/goscustdesk.xml
@@ -442,151 +442,124 @@ on the preferences in the <guilabel>File Management</guilabel> preferences dialo
       <secondary>rendering</secondary>
     </indexterm>
     <para>Use the <application>Font</application> preference tool
-to select the fonts to use in your applications, windows, terminals, and desktop.</para>
-    <para><xref linkend="goscustdesk-TBL-26"/> lists the font preferences that
-you can modify.</para>
-    <table frame="topbot" id="goscustdesk-TBL-26">
-      <title>Font Preferences</title>
-      <tgroup cols="2" colsep="1" rowsep="1">
-        <colspec colname="colspec18" colwidth="19.21*"/>
-        <colspec colname="colspec19" colwidth="46.79*"/>
-        <thead>
-          <row>
-            <entry colsep="0" rowsep="1">
-              <para>Dialog Element</para>
-            </entry>
-            <entry colsep="0" rowsep="1">
-              <para>Description</para>
-            </entry>
-          </row>
-        </thead>
-        <tbody>
-          <row>
-            <entry colsep="0" rowsep="0" valign="top">
-              <para>
-                <guilabel>Application
-font</guilabel>
-              </para>
-            </entry>
-            <entry colsep="0" rowsep="0" valign="top">
-              <para>Click on the font selector button to select a font to use in your applications.</para>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
-              <para>
-                <guilabel>Desktop font</guilabel>
-              </para>
-            </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
-              <para>Click on the font selector button to select
-a font to use on your desktop only.</para>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
-              <para>
-                <guilabel>Window title font</guilabel>
-              </para>
-            </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
-              <para>Click on the font selector button to select
-a font to use in the titlebars of your windows.</para>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
-              <para>
-                <guilabel>Terminal font</guilabel>
-              </para>
-            </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
-              <para>Click on the font selector button to select
-a font to use in the <application>Terminal</application> application</para>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
-              <para>
-                <guilabel>Font Rendering</guilabel>
-              </para>
-            </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
-              <para>To specify how to render fonts on your screen,
-select one of the following options:</para>
-              <itemizedlist>
-                <listitem>
-                  <para><guilabel>Monochrome</guilabel>: Renders fonts in black and
-white only. The edges of characters might appear jagged in some cases because
-the characters  are not antialiased. <firstterm>Antialiasing</firstterm> is
-an effect that is applied to the edges of characters to make the characters
-look smoother.</para>
-                </listitem>
-                <listitem>
-                  <para><guilabel>Best shapes</guilabel>: Antialiases fonts where
-possible. Use this option for standard Cathode Ray Tube (CRT) monitors.</para>
-                </listitem>
-                <listitem>
-                  <para><guilabel>Best contrast</guilabel>: Adjusts fonts to give
-the sharpest possible contrast, and also antialiases fonts, so that characters
-have smooth edges. This option might enhance the accessibility of the GNOME
-Desktop to  users with visual impairments.</para>
-                </listitem>
-                <listitem>
-                  <para><guilabel>Subpixel smoothing (LCDs)</guilabel>: Uses techniques
-that exploit the shape of individual Liquid Crystal Display (LCD) pixels to
-render fonts smoothly. Use this option for LCD or flat-screen displays.</para>
-                </listitem>
-              </itemizedlist>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec18" colsep="0" rowsep="0" valign="top">
-              <para>
-                <guibutton>Details</guibutton>
-              </para>
-            </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0" valign="top">
-              <para>Click on this button to specify further details of how
-to render fonts on your screen.</para>
-              <itemizedlist>
-                <listitem>
-                  <para><guilabel>Resolution (dots per inch)</guilabel>: Use the spin
-box to specify the resolution to use when your screen renders fonts.</para>
-                </listitem>
-                <listitem>
-                  <para><guilabel>Smoothing</guilabel>: Select one of the options
-to specify how to antialias fonts.</para>
-                </listitem>
-                <listitem>
-                  <para><guilabel>Hinting</guilabel>:  <firstterm>Hinting</firstterm>
-is a font-rendering technique that improves the quality of fonts at small
-sizes and an at low screen resolutions. Select one of the options to specify
-how to apply hinting your fonts.</para>
-                </listitem>
-                <listitem>
-                  <para><guilabel>Subpixel order</guilabel>: Select one of the options
-to specify the subpixel color order for your fonts. Use this option for LCD
-or flat-screen displays.</para>
-                </listitem>
-              </itemizedlist>
-            </entry>
-          </row>
-          <row>
-            <entry colname="colspec18" colsep="0" rowsep="0">
-              <para>
-                <guibutton>Go
-to font folder</guibutton>
-              </para>
-            </entry>
-            <entry colname="colspec19" colsep="0" rowsep="0">
-              <para>Click on this button to open the <guilabel>Fonts</guilabel>
-folder.</para>
-            </entry>
-          </row>
-        </tbody>
-      </tgroup>
-    </table>
+to choose which fonts are used in different parts of the desktop, and the way in which fonts are displayed on the screen.</para>
+
+    <sect2 id="prefs-font-choose">
+      <title>Choosing Fonts</title>
+      
+      <para>The font selector button shows the name of the font and its point size. The name is also shown in bold, italic, or regular type.</para>
+      <para>To change the font, click the font selector button. The font picker dialog opens. Select the font family, style, and point size from the lists. The preview area shows your current choice. Click <guibutton>OK</guibutton> to accept the change and update the desktop.</para>
+      <para>You can choose fonts for the following parts of the desktop:</para>
+
+      <variablelist>
+       	<varlistentry>
+      	  <term><guilabel>Application font</guilabel></term>
+      	  <listitem>
+      	    <para>This font is used in the menus, toolbars, and dialog boxes of applications.</para>
+      	  </listitem>
+      	</varlistentry>
+      	<varlistentry>
+      	  <term><guilabel>Document font</guilabel></term>
+      	  <listitem>
+      	    <para>This font is used to display documents in applications.</para>
+      	    <note><para>In some applications, you can override this choice in the application's preferences dialog.</para></note>
+      	  </listitem>
+      	</varlistentry>
+       	<varlistentry>
+      	  <term><guilabel>Desktop font</guilabel></term>
+      	  <listitem>
+      	    <para>This font is used in icon labels on the desktop.</para>
+      	  </listitem>
+      	</varlistentry>
+       	<varlistentry>
+      	  <term><guilabel>Window title font</guilabel></term>
+      	  <listitem>
+      	    <para>This font is used in the titlebars of windows.</para>
+      	  </listitem>
+      	</varlistentry>
+       	<varlistentry>
+      	  <term><guilabel>Fixed width font</guilabel></term>
+      	  <listitem>
+      	    <para>This font is used in the <application>Terminal</application> application and applications to do with programming.</para>
+      	  </listitem>
+      	</varlistentry>
+      	</variablelist>
+  	</sect2>
+	
+  	<sect2 id="prefs-font-rendering">
+      <title>Font Rendering</title>
+      <para>You can set the following options relating to how fonts are displayed on the screen:</para>
+	
+    	<variablelist>
+     	<varlistentry>
+    	  <term><guilabel>Font Rendering</guilabel></term>
+    	  <listitem>
+    	    <para>To specify how to render fonts on your screen,
+    select one of the following options:</para>
+                  <itemizedlist>
+                    <listitem>
+                      <para><guilabel>Monochrome</guilabel>: Renders fonts in black and
+    white only. The edges of characters might appear jagged in some cases because
+    the characters  are not antialiased. <firstterm>Antialiasing</firstterm> is
+    an effect that is applied to the edges of characters to make the characters
+    look smoother.</para>
+                    </listitem>
+                    <listitem>
+                      <para><guilabel>Best shapes</guilabel>: Antialiases fonts where
+    possible. Use this option for standard Cathode Ray Tube (CRT) monitors.</para>
+                    </listitem>
+                    <listitem>
+                      <para><guilabel>Best contrast</guilabel>: Adjusts fonts to give
+    the sharpest possible contrast, and also antialiases fonts, so that characters
+    have smooth edges. This option might enhance the accessibility of the GNOME
+    Desktop to  users with visual impairments.</para>
+                    </listitem>
+                    <listitem>
+                      <para><guilabel>Subpixel smoothing (LCDs)</guilabel>: Uses techniques
+    that exploit the shape of individual Liquid Crystal Display (LCD) pixels to
+    render fonts smoothly. Use this option for LCD or flat-screen displays.</para>
+                    </listitem>
+                  </itemizedlist>
+    	  </listitem>
+    	</varlistentry>
+     	<varlistentry>
+    	  <term><guibutton>Details</guibutton></term>
+    	  <listitem>
+    	    <para>Click on this button to specify further details of how
+    to render fonts on your screen.</para>
+                  <itemizedlist>
+                    <listitem>
+                      <para><guilabel>Resolution (dots per inch)</guilabel>: Use the spin
+    box to specify the resolution to use when your screen renders fonts.</para>
+                    </listitem>
+                    <listitem>
+                      <para><guilabel>Smoothing</guilabel>: Select one of the options
+    to specify how to antialias fonts.</para>
+                    </listitem>
+                    <listitem>
+                      <para><guilabel>Hinting</guilabel>:  <firstterm>Hinting</firstterm>
+    is a font-rendering technique that improves the quality of fonts at small
+    sizes and an at low screen resolutions. Select one of the options to specify
+    how to apply hinting your fonts.</para>
+                    </listitem>
+                    <listitem>
+                      <para><guilabel>Subpixel order</guilabel>: Select one of the options
+    to specify the subpixel color order for your fonts. Use this option for LCD
+    or flat-screen displays.</para>
+                    </listitem>
+                  </itemizedlist>
+    	  </listitem>
+    	</varlistentry>
+     	<varlistentry>
+    	  <term><guibutton>Go to font folder</guibutton></term>
+    	  <listitem>
+    	    <para>Click on this button to open the <guilabel>Fonts</guilabel>
+    folder.</para>
+    	  </listitem>
+    	</varlistentry>
+    </variablelist>
+   
+    </sect2>
     <sect2 id="goscustdesk-83">
       <title>Previewing a Font</title>
       <indexterm>