[passepartout] added screenshots for user interface documentation

[Sven Herzberg <herzi src gnome org>]

commit ef652292d32211c48707d6e778793bfefafedecf
Author: Sven Herzberg <herzi lanedo com>
Date:   Sun Apr 26 13:41:37 2009 +0200

    added screenshots for user interface documentation
    
    * .gitignore: remove the passepartout.xml that we have for the documentation
    * help/C/passepartout.xml: added user interface documentation
    * help/C/figures/passepartout-document-properties.png,
    * help/C/figures/passepartout-main-window.png,
    * help/C/figures/passepartout-object-properties-basic.png,
    * help/C/figures/passepartout-object-properties-eps.png,
    * help/C/figures/passepartout-object-properties-text.png,
    * help/C/figures/passepartout-preferences-environment.png,
    * help/C/figures/passepartout-preferences-files.png,
    * help/C/figures/passepartout-preferences-font-info.png,
    * help/C/figures/passepartout-text-streams.png: added initial screenshots
---
 .gitignore                                         |    1 -
 .../C/figures/passepartout-document-properties.png |  Bin 0 -> 24152 bytes
 help/C/figures/passepartout-main-window.png        |  Bin 0 -> 24651 bytes
 .../passepartout-object-properties-basic.png       |  Bin 0 -> 30608 bytes
 .../figures/passepartout-object-properties-eps.png |  Bin 0 -> 14023 bytes
 .../passepartout-object-properties-text.png        |  Bin 0 -> 17202 bytes
 .../passepartout-preferences-environment.png       |  Bin 0 -> 17851 bytes
 help/C/figures/passepartout-preferences-files.png  |  Bin 0 -> 36286 bytes
 .../figures/passepartout-preferences-font-info.png |  Bin 0 -> 35776 bytes
 help/C/figures/passepartout-text-streams.png       |  Bin 0 -> 27426 bytes
 help/C/passepartout.xml                            |  134 ++++++++++++++++++++
 11 files changed, 134 insertions(+), 1 deletions(-)

diff --git a/.gitignore b/.gitignore
index f979987..b9d65b5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,5 +16,4 @@ Makefile.in
 missing
 mkinstalldirs
 passepartout-*.tar.*
-passepartout.xml
 stamp-*
diff --git a/help/C/figures/passepartout-document-properties.png b/help/C/figures/passepartout-document-properties.png
new file mode 100644
index 0000000..23c0bfc
Binary files /dev/null and b/help/C/figures/passepartout-document-properties.png differ
diff --git a/help/C/figures/passepartout-main-window.png b/help/C/figures/passepartout-main-window.png
new file mode 100644
index 0000000..e726d14
Binary files /dev/null and b/help/C/figures/passepartout-main-window.png differ
diff --git a/help/C/figures/passepartout-object-properties-basic.png b/help/C/figures/passepartout-object-properties-basic.png
new file mode 100644
index 0000000..d9f606c
Binary files /dev/null and b/help/C/figures/passepartout-object-properties-basic.png differ
diff --git a/help/C/figures/passepartout-object-properties-eps.png b/help/C/figures/passepartout-object-properties-eps.png
new file mode 100644
index 0000000..71653a1
Binary files /dev/null and b/help/C/figures/passepartout-object-properties-eps.png differ
diff --git a/help/C/figures/passepartout-object-properties-text.png b/help/C/figures/passepartout-object-properties-text.png
new file mode 100644
index 0000000..92489e8
Binary files /dev/null and b/help/C/figures/passepartout-object-properties-text.png differ
diff --git a/help/C/figures/passepartout-preferences-environment.png b/help/C/figures/passepartout-preferences-environment.png
new file mode 100644
index 0000000..489fae6
Binary files /dev/null and b/help/C/figures/passepartout-preferences-environment.png differ
diff --git a/help/C/figures/passepartout-preferences-files.png b/help/C/figures/passepartout-preferences-files.png
new file mode 100644
index 0000000..bce65af
Binary files /dev/null and b/help/C/figures/passepartout-preferences-files.png differ
diff --git a/help/C/figures/passepartout-preferences-font-info.png b/help/C/figures/passepartout-preferences-font-info.png
new file mode 100644
index 0000000..c10b7c4
Binary files /dev/null and b/help/C/figures/passepartout-preferences-font-info.png differ
diff --git a/help/C/figures/passepartout-text-streams.png b/help/C/figures/passepartout-text-streams.png
new file mode 100644
index 0000000..b34379c
Binary files /dev/null and b/help/C/figures/passepartout-text-streams.png differ
diff --git a/help/C/passepartout.xml b/help/C/passepartout.xml
index 9ccc6b5..3e108d2 100644
--- a/help/C/passepartout.xml
+++ b/help/C/passepartout.xml
@@ -38,6 +38,140 @@
   </bookinfo>
 
   <xi:include href="users_guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; />
+
+  <chapter>
+    <title>The User Interface</title>
+
+    <para>
+      This chapter will make you familiar with the user interface of
+      passepartout. It will explain the user interface elements so you'll have
+      complete knowledge about the way things work with passepartout.
+    </para>
+
+    <section>
+      <title>The Main Window</title>
+
+      <para>
+	When you started Passepartout, the main window will be presented to
+	you. It looks like this:
+      </para>
+
+      <figure id="figure-passepartout-main-window">
+	<title>Passepartout's startup window</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-main-window.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+
+      <para>
+	As you can see, the main window consists of four main parts:
+	<orderedlist>
+	  <listitem><para>the main menu (on the top)</para></listitem>
+	  <listitem><para>the toolbar (on the left)</para></listitem>
+	  <listitem><para>the statusbar (on the bottom)</para></listitem>
+	  <listitem><para>the document view (the large area)</para></listitem>
+	</orderedlist>
+      </para>
+
+      <para>
+	<emphasis>The main menu</emphasis> provides access to all actions in
+	passepartout. Use it to create, open and save files, to manipulate
+	objects and to access the documentation.
+      </para>
+
+      <para>
+	<emphasis>The toolbar</emphasis> provides quick access to the most
+	important actions, like adding text or image frames, changing the
+	stacking order, etc.
+      </para>
+
+      <para>
+	<emphasis>The statusbar</emphasis> provides status information about
+	passepartout and provides access to the details of the view (which page
+	to display and which zoom level to use).
+      </para>
+
+      <para>
+	<emphasis>The document view</emphasis> provides the editable preview
+	of the document. You can select items, to be grouped, stacked, moved
+	or resized.
+      </para>
+    </section>
+
+    <section>
+      <title>The Preferences Dialog</title>
+
+      <figure>
+	<title>The Files Tab</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-preferences-files.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+
+      <figure>
+	<title>The Environment Tab</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-preferences-environment.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+
+      <figure>
+	<title>The Font Info Tab</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-preferences-font-info.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+    </section>
+
+    <section>
+      <title>The Document Properties Dialog</title>
+
+      <figure>
+	<title>The Document Properties Dialog</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-document-properties.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+    </section>
+
+    <section>
+      <title>The Object Properties Dialog</title>
+
+      <figure>
+	<title>The Basic Tab</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-object-properties-basic.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+
+      <figure>
+	<title>The EPS Tab</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-object-properties-eps.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+
+      <figure>
+	<title>The Text Tab</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-object-properties-text.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+    </section>
+
+    <section>
+      <title>The Text Streams Dialog</title>
+
+      <figure>
+	<title>The Text Streams Dialog</title>
+	<screenshot><mediaobject><imageobject>
+	      <imagedata fileref="figures/passepartout-text-streams.png" format="PNG" scalefit="1" />
+	</imageobject></mediaobject></screenshot>
+      </figure>
+    </section>
+
+  </chapter>
+
   <xi:include href="faq.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; />
 </book>
 <!-- vim:set sw=2: -->