[gnome-terminal/wip/mallard-merge: 2/194] help: added help to pref-encoding.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 6f2cb6f8ad844a15f12a37a180f99cc1b8a12abd
Author: Sindhu S <sindhus live in>
Date:   Thu Feb 7 20:40:46 2013 +0530

    help: added help to pref-encoding.page
    
    Added explanation on situations where a user would like to change
    the character encoding support in Terminal.
    Included appropriate mallard tags.
    
    Help: Added more scenarios where user would want to change encoding.

 help/C/pref-encoding.page |   26 +++++++++++++++-----------
 1 files changed, 15 insertions(+), 11 deletions(-)
---
diff --git a/help/C/pref-encoding.page b/help/C/pref-encoding.page
index 5724baf..385183f 100644
--- a/help/C/pref-encoding.page
+++ b/help/C/pref-encoding.page
@@ -18,16 +18,20 @@
 
   <title>Character encoding</title>
 
-<!-- Start by explaining why one may want to edit this. -->
-
-  <p>Go to Menu:: Terminal > Set Character Encoding and select your character
-  encoding from the menu. Press Alt + T + C to reach the menu
-  alternatively.</p>
-
-  <p>If can add more encodings to the menu by clicking on "Add or Remove" in
-  the menu. Select the encoding you want to be added to the menu and click on
-  the right pointing arrow button. If you wish to remove any encoding from the
-  menu, select the encoding from the list and click on the left pointing arrow
-  button.</p>
+  <p>You may want to change character encoding in <app>Terminal</app> in the following scenarios...</p>
+
+  <list>
+    <item><p>You work with CLI applications that output text in languages other than English.</p></item>
+    <item><p>You want to input text in languages other than English.</p></item>
+    <item><p>You are working with file or directory names that use characters unavailable in the default 
UTF-8 encoding.</p></item>
+    <item><p>You are using an external hard disk that has contents that use different encoding.</p></item>
+    <item><p>You are connecting to a remote computer that uses a different encoding.</p></item>
+  </list>
+
+  <p>Go to <guiseq><gui style="menu">Terminal</gui><gui style="menuitem">Set
+  Character Encoding</gui></guiseq> and select the desired character encoding.
+  To add more encoding choices to this menu by <gui style="menuitem">Add or
+  Remove...</gui>. Browsing from the available encodings, select the encoding
+  you want to be added to the menu.</p>
 
 </page>