removed gtkam section, added gtkam man page (patch by mjr)

git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@4998 67ed7778-7388-44ab-90cf-0a291f65f57c

1 files changed, 267 insertions, 149 deletions

diff --git a/doc/gphoto2.xml b/doc/gphoto2.xml
index 54fc921a3..ff6a9d66f 100644
--- a/doc/gphoto2.xml
+++ b/doc/gphoto2.xml
@@ -264,154 +264,6 @@ About this file:
 	</abstract>
       </section>
 
-      <section>
-	<title>Commands</title>
-	<variablelist>
-	  <varlistentry>
-	    <term><guimenu>File</guimenu></term>
-	    <listitem>
-	      <simpara>Menu item</simpara>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guimenuitem>Save Selected Photos...</guimenuitem></term>
-	    <listitem>
-	      <simpara>Opens the dialog for saving the selected photos.</simpara>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guisubmenu>Delete Photos</guisubmenu></term>
-	    <listitem>
-	      <variablelist>
-		<varlistentry>
-		  <term><guimenuitem>Selected</guimenuitem></term>
-		  <listitem>
-		    <simpara>Selected Deletes the photos that have been selected from the camera.</simpara>
-		  </listitem>
-		</varlistentry>
-		<varlistentry>
-		  <term><guimenuitem>All</guimenuitem></term>
-		  <listitem>
-		    <simpara>Deletes all photos in the camera</simpara>
-		  </listitem>
-		</varlistentry>
-	      </variablelist>
-	    </listitem>
-	  </varlistentry> 
-
-<!--Trying to get a sensible markup system going up to here. After this is just placeholders.-->
-
-	  <varlistentry>
-	    <term>Create</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry> 
-
-	  <varlistentry>
-	    <term>Remove</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Upload File</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Select</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-All </term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Inverse</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-None</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Camera</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Select Camera...</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Capture...</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Configure</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Information</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Manual</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-About the Driver...</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Help</term>
-	    <listitem>
-	      <simpara></simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-Debug... </term>
-	    <listitem>
-	      <simpara>
-Opens the logging window which allows the user to select the
- type of messages to log. 
-Error causes the logging of any error messages 
-Verbose
-Debug
-Data
-Save As... opens a dialog to allow the user to save the
- information logged in the debug window.
-Close Closes the debug window</simpara></listitem></varlistentry>
- <varlistentry>
-	    <term>
-About...</term>
-	    <listitem>
-	      <simpara>
-Opens the about gtKam window. This gives the current version,
- and tells you that:
-gtKam was written by:
-- Scott Fritzinger &lt;scottf@unr.edu&gt;,
-- Lutz Mueller &lt;urc8@rz.uni-carlsruhe.de&gt;,
-- and many others
-gtKam uses libgphoto2, a library to access a multitude of digital
- cameras. More information is available at http://www.gphoto.net.
-Enjoy the wonderful world of gphoto!</simpara></listitem></varlistentry></variablelist>
-
-      <simplelist>
-	<member><command>File</command></member>
-	<member><command>Folder</command></member>
-	<member><command>Select</command></member>
-	<member>Camera</member>
-	<member>Help</member>
-      </simplelist>
-    </section>
 
       </section>
     <section id="using-gphoto2">
@@ -1217,7 +1069,7 @@ Saving file as MVI_5418.AVI
     <section id="gphoto2fs">
       <title>The gPhoto2 file system</title>
 
-      <figure id="gphoto2fs">
+      <figure id="figgphoto2fs">
         <title>The gPhoto2 file system architecture</title>
         <mediaobject>
           <imageobject>
@@ -1978,6 +1830,272 @@ Saving file as MVI_5418.AVI
 
       <!-- &camera; -->
 
+    <refentry id="gtkam">
+      <refentryinfo>
+	<author>
+	  <firstname>The gPhoto2</firstname><surname>Team</surname>
+	</author>
+	<editor>
+	  <!-- one of (contrib authorblurb affiliation othername lineage surname firstname honorific) -->
+	  <firstname>Michael</firstname>
+	  <othername>J.</othername>
+	  <surname>Rensing</surname>
+	  <affiliation>
+	    <address><email>michael.rensing@shaw.ca</email></address>
+	  </affiliation>
+	</editor>
+	<date>August 2002</date>
+      </refentryinfo>
+      <refnamediv>
+	<refname>gtkam</refname>
+	<refpurpose>Graphical front end for gphoto2</refpurpose>
+      </refnamediv>
+      <refsect1>
+	<title>Commands</title>
+	<refsect2>
+	  <title><guimenu>File Menu</guimenu></title>
+	  <variablelist>
+	    <varlistentry>
+	      <term><menuchoice>
+		  <guimenu>File</guimenu>
+		  <guimenuitem>Save Selected Photos...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Opens the dialog for saving the selected photos.</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>File</guimenu>
+		  <guisubmenu>Delete Photos</guisubmenu>
+		  <guimenuitem>Selected</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Deletes selected photos from the camera.</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>File</guimenu>
+		  <guisubmenu>Delete Photos</guisubmenu>
+		  <guimenuitem>All</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Deletes all photos in the camera</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term><menuchoice>
+		  <guimenu>File</guimenu>
+		  <guimenuitem>Exit</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Exits gtkam.</simpara>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</refsect2>
+
+	<refsect2>
+	  <title>Folder Menu</title>
+	  <variablelist>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Folder</guimenu>
+		  <guimenuitem>Create</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Opens dialog to create new folder (directory).</simpara>
+	      </listitem>
+	    </varlistentry> 
+	  <varlistentry>
+	    <term>
+		<menuchoice>
+		  <guimenu>Folder</guimenu>
+		  <guimenuitem>Remove</guimenuitem>
+		</menuchoice>
+	      </term>
+	    <listitem>
+		<simpara>Opens a dialog to remove (delete) an existing folder (directory).</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	    <term>
+		<menuchoice>
+		  <guimenu>Folder</guimenu>
+		  <guimenuitem>Upload File...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Opens a dialog to identify an image file for uploading to the camera.</simpara>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</refsect2>
+	<refsect2>
+	  <title>Select Menu</title>
+	  <variablelist>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Select</guimenu>
+		  <guimenuitem>All</guimenuitem>
+		</menuchoice>
+	      </term>
+	    <listitem>
+	      <simpara>Selects all pictures in the camera.</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Select</guimenu>
+		  <guimenuitem>Inverse</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Inverts the selections already made so that previously 
+		  unselected images are now selected, and previously selected images
+		  are now unselected.</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Select</guimenu>
+		  <guimenuitem>None</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Undoes all selections so that no images are selected.</simpara>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</refsect2>
+	<refsect2>
+	  <title>Camera Menu</title>
+	  <variablelist>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Camera</guimenu>
+		  <guimenuitem>Select Camera...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>Opens a window to allow the user to define the camera and interface being used.</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Camera</guimenu>
+		  <guimenuitem>Capture...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara></simpara></listitem></varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Camera</guimenu>
+		  <guimenuitem>Configure</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara></simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Camera</guimenu>
+		  <guimenuitem>Information</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara></simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Camera</guimenu>
+		  <guimenuitem>Manual</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara></simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Camera</guimenu>
+		  <guimenuitem>About the Driver...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara></simpara>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</refsect2>
+	<refsect2>
+	  <title>Help Menu</title>
+	  <variablelist>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Help</guimenu>
+		  <guimenuitem>Debug...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>
+		  Opens the logging window which allows the user to select the
+		  type of messages to log. 
+		  Error causes the logging of any error messages 
+		  Verbose
+		  Debug
+		  Data
+		  Save As... opens a dialog to allow the user to save the
+		  information logged in the debug window.
+		  Close Closes the debug window</simpara>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>
+		<menuchoice>
+		  <guimenu>Help</guimenu>
+		  <guimenuitem>About...</guimenuitem>
+		</menuchoice>
+	      </term>
+	      <listitem>
+		<simpara>
+		  Opens the about gtKam window. This gives the current version,
+		  and tells you that:
+		  gtKam was written by:
+		  - Scott Fritzinger &lt;scottf@unr.edu&gt;,
+		  - Lutz Mueller &lt;urc8@rz.uni-carlsruhe.de&gt;,
+		  - and many others
+		  gtKam uses libgphoto2, a library to access a multitude of digital
+		  cameras. More information is available at http://www.gphoto.net.
+		  Enjoy the wonderful world of gphoto!</simpara>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</refsect2>
+      </refsect1>
+    </refentry>
   </reference>
 
   <!-- =========================================================== -->