[libgda] GdaBrowser: improved help to data manager perspective

[Vivien Malerba <vivien src gnome org>]

commit 472316715f6e1f63fd102e7e82d5e33baf53e0ba
Author: Vivien Malerba <malerba gnome-db org>
Date:   Thu Jan 20 22:34:15 2011 +0100

    GdaBrowser: improved help to data manager perspective

 tools/browser/help/C/data-manager-perspective.page |   23 +++++++++++++------
 .../browser/help/C/data-manager-source-editor.page |   11 +++++++++
 .../browser/help/C/figures/data-man-uicompose.png  |  Bin 0 -> 113705 bytes
 .../browser/help/C/figures/data-man-xmlcompose.png |  Bin 43932 -> 76761 bytes
 tools/browser/help/Makefile.am                     |    2 +
 5 files changed, 29 insertions(+), 7 deletions(-)
---
diff --git a/tools/browser/help/C/data-manager-perspective.page b/tools/browser/help/C/data-manager-perspective.page
index a1610d8..7c3d7c9 100644
--- a/tools/browser/help/C/data-manager-perspective.page
+++ b/tools/browser/help/C/data-manager-perspective.page
@@ -50,15 +50,24 @@
   </p>
   <p>
     The following figure shows the data sources editing mode (switch to editing mode using the
-    <media type="image" mime="image/png" src="figures/data-man-mode.png"/> toolbar button)
-    at the moment data sources can only be
-    defined using an <link xref="data-manager-xml-syntax">XML syntax</link>.
+    <media type="image" mime="image/png" src="figures/data-man-mode.png"/> toolbar button).
+  </p>
+  <p>
+    Data sources can be defined using an <link xref="data-manager-xml-syntax">XML syntax</link>, or
+    using the <link xref="data-manager-source-editor">default interface</link>.
   </p>
   <figure>
     <title>Data sources edition</title>
-    <desc>Editing data sources in the data manager perspective</desc>
+    <desc>Editing data sources in the data manager perspective, from the XML syntax</desc>
     <media type="image" mime="image/png" src="figures/data-man-xmlcompose.png"/>
   </figure>
+  <figure>
+    <title>Data sources edition</title>
+    <desc>Editing data sources in the data manager perspective, using the default interface:
+      two data sources are defined, which list the contents of the "customers" and "orders"
+      tables. The setup is the same as the figure above showing the XML syntax</desc>
+    <media type="image" mime="image/png" src="figures/data-man-uicompose.png"/>
+  </figure>
 
   <p>
     The commands available through the command buttons are:
@@ -66,9 +75,9 @@
   <list>
     <item><p><gui>Reset</gui>: resets the XML editor to a default XML template, only available when the XML
     view is currently displayed</p></item>
-    <item><p><gui>Add</gui>: displays a popup menu with an entry per table to quickly add
-    the whole contents of a table as a data source, only available when the UI
-    editor is currently displayed</p></item>
+    <item><p><gui>Add</gui>: displays a popup menu with shortcuts to quickly define new data sources
+	as whole table contents (also analyses the database schema to propose relevant choices),
+	only available when the XML edition mode is not selected</p></item>
     <item><p><gui>Variables</gui>: shows/hide the <link xref="variables-syntax">variables</link> panel where you can give values to the variables
     present in the SQL code of any data source's definition. The panel is automatically shown when a variable is detected in 
     the SQL code.</p></item>
diff --git a/tools/browser/help/C/data-manager-source-editor.page b/tools/browser/help/C/data-manager-source-editor.page
new file mode 100644
index 0000000..39f554a
--- /dev/null
+++ b/tools/browser/help/C/data-manager-source-editor.page
@@ -0,0 +1,11 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="data-manager-source-editor">
+<info>
+  <title type="sort">1</title>
+</info>
+<title>The data manager's data sources editor</title>
+<p>
+  To be done.
+</p>
+</page>
diff --git a/tools/browser/help/C/figures/data-man-uicompose.png b/tools/browser/help/C/figures/data-man-uicompose.png
new file mode 100644
index 0000000..c1fb966
Binary files /dev/null and b/tools/browser/help/C/figures/data-man-uicompose.png differ
diff --git a/tools/browser/help/C/figures/data-man-xmlcompose.png b/tools/browser/help/C/figures/data-man-xmlcompose.png
index ecb0e4c..c66e1ca 100644
Binary files a/tools/browser/help/C/figures/data-man-xmlcompose.png and b/tools/browser/help/C/figures/data-man-xmlcompose.png differ
diff --git a/tools/browser/help/Makefile.am b/tools/browser/help/Makefile.am
index c413b7e..143f266 100644
--- a/tools/browser/help/Makefile.am
+++ b/tools/browser/help/Makefile.am
@@ -12,6 +12,7 @@ DOC_FIGURES = \
 	figures/data-man-mode.png \
 	figures/data-man-persp.png \
 	figures/data-man-xmlcompose.png \
+	figures/data-man-uicompose.png \
 	figures/diagram.png \
 	figures/mainwin.png \
 	figures/query-exec-persp.png \
@@ -24,6 +25,7 @@ DOC_PAGES = \
 	actions.page \
 	data-manager-perspective.page \
 	data-manager-xml-syntax.page \
+	data-manager-source-editor.page \
 	diagram.page \
 	features.page \
 	general-ui.page \