[gnome-terminal/wip/mallard-merge: 60/289] help: modified app-fonts.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 5f8586f981c90a48251f3dece7cbb86e839e6558
Author: Sindhu S <sindhus live in>
Date:   Wed Feb 6 16:03:28 2013 +0530

    help: modified app-fonts.page
    
    Polished help content and used appropriate mallard tags.
    
    Moved order of explanation of font settings available.
    Added note on Allow Bold Text option being shell specific.
    Mallard tags revised where appropriate.

 help/C/app-fonts.page |   72 ++++++++++++++++++++++++++++++-------------------
 1 files changed, 44 insertions(+), 28 deletions(-)
---
diff --git a/help/C/app-fonts.page b/help/C/app-fonts.page
index 96dfcf5..f091458 100644
--- a/help/C/app-fonts.page
+++ b/help/C/app-fonts.page
@@ -21,39 +21,55 @@
 
   </info>
 
-  <title>Change font</title>
+  <title>Change font and style</title>
 
-  <p>If you prefer to use a different font from the default <app>Terminal</app>
-  font, you can change it to any other font that is installed on your
-  computer.</p>
+  <p>If you prefer to use a font or font size other than the default
+  <app>Terminal</app>font, you have the following options...</p>
 
-  <steps>
+  <terms>
     <item>
-      <p><!--Select the option from the menu.--></p>
-    </item>
-    <item>
-      <p><!--Explain the two options--></p>
-      <list>
-        <item>
-          <p><!--system fonts--></p>
+      <title>Set custom font</title>
+      <p>To set a font of your choice...</p>
+        <steps>
+          <item><p>Select <guiseq><gui style="menu">Edit</gui>
+          <gui style="tab">General</gui></guiseq></p>
         </item>
-        <item>
-          <p><!--custom fonts--></p>
+          <!--It's very difficult to describe the button next to "Font" label as it behaves like a button 
but shows the previous set custom font for label. this label is subject to change upon user selection of 
font.-->
+          <item><p>Click on the button next to <gui>Font</gui>.</p>
+          </item>
+          <item><p>You now can type to search the desired font by name or
+          browse from the list.</p>
+          </item>
+          <item><p>Drag the slide rule to set the font size. Alternatively, you
+          can click on <gui style="button">+</gui> to increase font size or
+          <gui style="button">-</gui> to decrease selected font size.</p>
         </item>
-      </list>
+        <item><p>Click <gui style="button">Select</gui> to apply changes.</p>
+        </item>
+        <item><p>To discard changes and go back to previous dialog, click
+        <gui style="button">Cancel</gui>.</p>
+        </item>
+       </steps>
     </item>
-  </steps>
-
-<!-- The following should not be on this page unless the title is updated to
-     reflect this section -->
-
-  <p>Select <gui>allow bold text</gui> to display your <app>Terminal</app> text
-  output in bold. <guiseq><gui style="menu">Edit</gui>
-  <gui style="menuitem">Profile Preferences</gui>
-  <gui style="tab">Background</gui></guiseq> or press
-  <keyseq><key>Alt</key><key>E</key><key>P</key></keyseq>.</p>
-
-<!-- Allow bold text does not dispay text in bold, but allows it to be
-     displayed. Alt+E+P does not do anything for me.-->
+        <item>
+      <title>System fixed width font</title>
+      <p>To use system default fonts in <app>Terminal</app>, go to <guiseq><gui
+      style="menu">Edit</gui><gui style="menuitem">Profile Preferences</gui><gui
+      style="tab">General</gui></guiseq> and select <gui style="checkbox">Use
+      the system fixed width font</gui>.</p>
+    </item>
+    <item>
+      <title>Bold text</title>
+      <note style="important"><p><gui style="checkbox">Allow bold text</gui> is
+      a shell specific feature. If you are using a shell other than Bash, then
+      the described behaviour may not be similar.</p></note>
+      <p><app>Terminal</app> allows your shell to process text such as the
+      prompt, directory names, man page headings to appear in bold style. To set
+      this feature, navigate to <guiseq><gui style="menu">Edit</gui><gui
+      style="menuitem">Profile Preferences</gui><gui
+      style="tab">General</gui></guiseq> and select <gui>Allow bold
+      text</gui>.</p>
+    </item>
+  </terms>
 
 </page>