[dots] Add Help in Mallard format. Hook it into the UI

[Fernando Herrera de las Heras <fherrera src gnome org>]

commit ee7573ceb76671262bc433c3a19889876a47a997
Author: Fernando Herrera <fherrera onirica com>
Date:   Fri Jul 16 00:31:23 2010 +0200

    Add Help in Mallard format. Hook it into the UI

 configure.ac            |    1 +
 data/app_window.xml     |   14 ++++++++++++++
 dots/app_window.py      |    3 +++
 help/C/format.page      |   11 +++++++++++
 help/C/index.page       |    5 +++++
 help/C/legal.xml        |    9 +++++++++
 help/C/printing.page    |   14 ++++++++++++++
 help/C/translating.page |   14 ++++++++++++++
 help/C/view.page        |   10 ++++++++++
 help/Makefile.am        |   16 ++++++++++++++++
 10 files changed, 97 insertions(+), 0 deletions(-)
---
diff --git a/configure.ac b/configure.ac
index bc2ca3e..c65b4f9 100644
--- a/configure.ac
+++ b/configure.ac
@@ -49,5 +49,6 @@ dots/Makefile
 dots/host_settings.py
 data/Makefile
 data/icons/Makefile
+help/Makefile
 po/Makefile.in
 ])
diff --git a/data/app_window.xml b/data/app_window.xml
index 1766b07..433d500 100644
--- a/data/app_window.xml
+++ b/data/app_window.xml
@@ -196,6 +196,14 @@
                         <property name="use_stock">True</property>
                       </object>
                     </child>
+    		    <child>
+                      <object class="GtkImageMenuItem" id="imagemenuitem12">
+                      	<property name="related_action">action_help</property>
+                        <property name="visible">True</property>
+                        <property name="use_underline">True</property>
+                        <property name="use_stock">True</property>
+                      </object>
+                    </child>
                   </object>
                 </child>
               </object>
@@ -315,5 +323,11 @@
     <property name="stock_id">gtk-about</property>
     <signal name="activate" handler="_onAbout" swapped="no"/>
   </object>
+  <object class="GtkAction" id="action_help">
+    <property name="stock_id">gtk-help</property>
+    <signal name="activate" handler="_onHelp" swapped="no"/>
+  </object>
+
+
 
 </interface>
diff --git a/dots/app_window.py b/dots/app_window.py
index bb9b169..b7dd574 100644
--- a/dots/app_window.py
+++ b/dots/app_window.py
@@ -328,6 +328,9 @@ class AppWindow(object):
         self.main_xml.get_object('reviewentry').hide()
         gtk.main()
 
+    def _onHelp(self, action):
+	gtk.show_uri(None, "ghelp:dots", gtk.gdk.CURRENT_TIME)
+
     def _onQuit(self, window, event=None):
 	self.saveConfig()
         gtk.main_quit()
diff --git a/help/C/format.page b/help/C/format.page
new file mode 100644
index 0000000..6bf05e3
--- /dev/null
+++ b/help/C/format.page
@@ -0,0 +1,11 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="format">
+<info>
+  <link type="guide" xref="index"/>
+</info>
+<title>Output format</title>
+<p>You can use the Translation menu to change the translation table and the output format</p>
+<p>The table submenu allows you to select between all installed translation tables and to choose and external one. The format menu entry will show up a dialog to change the page number positions, the number of lines per page and the number of cells per line.</p>
+<p>Any change in the translation options will update automatically the document</p>
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..d19f488
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,5 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="index">
+<title>Dots Help</title>
+</page>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..86d6173
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,9 @@
+<license xmlns="http://projectmallard.org/1.0/";
+         href="http://creativecommons.org/licenses/by-sa/3.0/";>
+<p>This work is licensed under a
+<link href="http://creativecommons.org/licenses/by-sa/3.0/";>Creative Commons
+Attribution-Share Alike 3.0 Unported License</link>.</p>
+<p>As a special exception, the copyright holders give you permission to copy,
+modify, and distribute the example code contained in this document under the
+terms of your choosing, without restriction.</p>
+</license>
diff --git a/help/C/printing.page b/help/C/printing.page
new file mode 100644
index 0000000..90c13dd
--- /dev/null
+++ b/help/C/printing.page
@@ -0,0 +1,14 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="printing">
+<info>
+  <link type="guide" xref="index"/>
+</info>
+<title>Printing</title>
+<p>To print a document:</p>
+<steps>
+  <item><p>Open the document.</p></item>
+  <item><p>Press the Print button or the File --> Print menu entry.</p></item>
+  <item><p>Select the printer from the printing dialog and press the print button.</p></item>
+</steps>
+</page>
diff --git a/help/C/translating.page b/help/C/translating.page
new file mode 100644
index 0000000..5d18b78
--- /dev/null
+++ b/help/C/translating.page
@@ -0,0 +1,14 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="translating">
+<info>
+  <link type="guide" xref="index"/>
+</info>
+<title>Translating a document</title>
+<p>To translate a document:</p>
+<steps>
+  <item><p>Press the Open button from the toolbar of the menu entry File --> Open.</p></item>
+</steps>
+<p>Then you can change the output format or the viewing options.
+See <link xref="format"/> and <link xref="view"/></p>
+</page>
diff --git a/help/C/view.page b/help/C/view.page
new file mode 100644
index 0000000..1f9a12b
--- /dev/null
+++ b/help/C/view.page
@@ -0,0 +1,10 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="view">
+<info>
+  <link type="guide" xref="index"/>
+</info>
+<title>Viewing the document</title>
+<p>The view menu allows you to switch between ASCII and Braille on-screen representation.</p>
+<p>It also allows you to show the revision line: a bottom line in the window showing the ASCII representation of the line where the cursor is placed on</p>
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
new file mode 100644
index 0000000..6a9df07
--- /dev/null
+++ b/help/Makefile.am
@@ -0,0 +1,16 @@
+include $(top_srcdir)/gnome-doc-utils.make
+
+DOC_ID = dots
+DOC_INCLUDES = legal.xml
+
+
+DOC_PAGES = \
+	index.page	\
+	format.page	\
+	printing.page	\
+	translating.page	\
+	view.page
+
+DOC_LINGUAS = es
+
+dist-hook: doc-dist-hook