<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "0.1.5">
  <!ENTITY manrevision "0.2">
  <!ENTITY date "September 2006">
  <!ENTITY app "vMovieDB">
]>

<!-- modified by Vladimir Paskov (vlado.paskov@gmail.com) -->
<!-- for vMovieDB project. -->

<!-- 
  (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->

<!-- Document Header -->
<article id="index" lang="en">
<!-- do not change the ID for translations, change "lang" to -->
<!-- the appropriate code -->
	<articleinfo>
		<title><application>&app;</application> Manual V&manrevision;</title>
		
		<copyright>
			<year>2006</year>
			<holder>Vladimir Paskov</holder>
		</copyright>
		
		<!--
		<copyright>
    			<year>Year</year>
   			<holder>Holder (Translation)</holder>
     		</copyright>-->
		
		<!-- An address can be added to the publisher information.  If a role is 
     		not specified, the publisher/author is the same for all versions of the 
     		document.  -->
		<publisher>
			<publishername>Vladimir Paskov</publishername>
		</publisher>
		
		<!-- do not remove this -->
		&legal;
		
		<authorgroup>
			<author>
				<firstname>Vladimir</firstname>
				<surname>Paskov</surname>
				<affiliation>
					<address><email>vlado.paskov@gmail.com</email></address>
				</affiliation>
			</author>
			
			<!--
			<author> 
				<firstname>Documentation</firstname> 
				<surname>Writer 1</surname> 
				<affiliation> 
	  				<orgname>GNOME Documentation Project</orgname> 
	  				<address><email>doc-writer1@gnome.org</email></address> 
				</affiliation> 
      			</author>-->
			
			<!-- This is appropriate place for other contributors: translators,
     			maintainers,  etc. Commented out by default.
			<othercredit role="translator">
				<firstname>Latin</firstname> 
				<surname>Translator 1</surname> 
				<affiliation> 
	  				<orgname>Latin Translation Team</orgname> 
	  				<address><email>translator@gnome.org</email></address> 
				</affiliation>
				<contrib>Latin translation</contrib>
      			</othercredit> -->
		</authorgroup>
		
		<!-- According to GNU FDL, revision history is mandatory if you are -->
      		<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
      		<!-- Remember to remove the &manrevision; entity from the revision entries other -->
      		<!-- than the current revision. -->
      		<!-- The revision numbering system for GNOME manuals is as follows: -->
      		<!-- * the revision number consists of two components -->
      		<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
      		<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
      		<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
      		<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
      		<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
      		<!-- to V3.0, and so on. -->
		
		<revhistory>
			<revision>
				<revnumber>&app; Manual V&manrevision;</revnumber>
				<date>&date;</date>
				<revdescription>
					<para role="author">Vladimir Paskov <email>vlado.paskov@gmail.com</email></para>
				</revdescription>
			</revision>
			<revision>
				<revnumber>&app; Manual V0.1</revnumber>
				<date>August 2006</date>
				<revdescription>
					<para role="author">Vladimir Paskov <email>vlado.paskov@gmail.com</email></para>
				</revdescription>
			</revision>
		</revhistory>
		
		<releaseinfo>This manual describes version &appversion; of &app;.</releaseinfo>
		
		<legalnotice>
			<title>Feedback</title>
			<para>To report a bug or make a suggestion regarding the &app; application or
      			this manual, visit &app; 
			<ulink url="http://vmoviedb.sf.net" type="http">home page</ulink>.
			</para>
			
			<!-- Translators may also add here feedback address for translations -->
		</legalnotice>	
	</articleinfo>
	
	<indexterm zone="index"><primary>&app;</primary></indexterm>
	<indexterm zone="index"><primary>vmoviedb</primary></indexterm>
	
	<!-- ============= Document Body ============================= -->
	
	<!-- ============= Introduction ============================== -->
	<!-- Use the Introduction section to give a brief overview of what the 
	application is and what it does. -->
	<sect1 id="vmoviedb-introduction">
		<title>Introduction</title>
		
		<para>The <application>&app;</application> application is a movie collection manager
		for the GNOME desktop.</para>
		<para><application>&app;</application> provides the following features:</para>
		
		<!-- application features -->
		<itemizedlist>
			<listitem>
				<para>Play selected movie with your favorite video player.</para>
			</listitem>
			<listitem> 
	    			<para>Manage various types of information for your movies such as: title, 
				year, media type, quality, subtitles, location, genre, 
				comment and movie image.</para>
	  		</listitem>
			<listitem> 
	    			<para>Movie rating.</para> 
	  		</listitem>
			<listitem>
				<para>Movie tags.</para>
			</listitem>
			<listitem> 
	    			<para>Movie comment.</para> 
	  		</listitem>
			<listitem> 
	    			<para>Movie serch. Local and on ImDB.com.</para> 
	  		</listitem>
			<listitem> 
	    			<para>Export your movies to html or text document.</para> 
	  		</listitem>
		</itemizedlist>
		
		<note>
			<para><application>&app;</application> also comes with additional functionalities 
			such as Genre Editor and Movie Image Viewer.</para>
		</note>
		<note>
			<para><application>&app;</application> has a fast and light database based on XML.</para>
		</note>
	</sect1>
	
	<!-- =========== Getting Started ============================== -->
	<sect1 id="vmoviedb-getting-started">
		<title>Getting Started</title>
		
		<sect2 id="vmoviedb-start">
			<title>To Start &app;</title>
			
			<para>You can start <application>&app;</application> in the following ways:</para>
			<variablelist>
				<varlistentry>
					<term><guimenu>Applications</guimenu> menu</term>
					<listitem>
						<para>
						Choose
						<menuchoice>
						<guisubmenu>Sound &amp; Video</guisubmenu>
						<guimenuitem>&app;</guimenuitem>
						</menuchoice>
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>Command line</term>
					<listitem>
						<para>To start <application>&app;</application> from a 
						command line, type the following command, 
						then press <keycap>Return</keycap>:</para>
						
						<para><command>vmoviedb</command></para>
						
						<tip>
						<para>To view other command line options that are 
						available, type <command>vmoviedb --help</command>,
						then press <keycap>Return</keycap>.</para>
						</tip>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect2>
		
		<sect2 id="vmoviedb-when-start">
			<title>When You Start &app;</title>
			
			<para>When you start <application>&app;</application>, 
			the following window is displayed.</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-start-fig">
				<title>&app; Main Window</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_main.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; main window. Contains titlebar, menubar, toolbar, 
					view pane, movie area, and statusbar. Menubar contains File, Edit, 
					View ,Movie, Tools and Help menus.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>Table 1 describes the components of 
			<application>&app;</application> main window.</para>
			
			<table frame="topbot" id="vmoviedb-main-window-table">
				<title><application>&app;</application> 
				main window components.</title>
				<colspec colname="COLSPEC0"/>
          			<colspec colname="COLSPEC1"/>
				<tgroup cols="3" colsep="0" rowsep="0">
					<thead>
					<row rowsep="1">
						<entry valign="top">Id</entry>
						<entry valign="top">Component</entry>
						<entry valign="top">Description</entry>
					</row>
					</thead>
					
					<tbody>
						<row>
						<entry valign="top">1</entry>
						<entry valign="top">Menubar</entry>
						<entry valign="top">
						The menus on the menubar contain all of the 
						commands you need to use in 
						<application>&app;</application>.
						</entry>
						</row>
						
						<row>
						<entry valign="top">2</entry>
						<entry valign="top">Toolbar</entry>
						<entry valign="top">
						The toolbar contains a subset of the commands 
						that you can access from the menubar.
						</entry>
						</row>
						
						<row>
						<entry valign="top">3</entry>
						<entry valign="top">View Pane</entry>
						<entry valign="top">
						The view pane displays information about all movies in 
						your database and may contain the following columns:
						<itemizedlist>
							<listitem>
							<para>Title - display movie title</para>
							</listitem>
							
							<listitem>
							<para>Year - display movie release date or 
							when no movie year is set display "N/A".</para>
							</listitem>
							
							<listitem>
							<para>Genre - display movie genre or when no movie 
							genre is set display "N/A".</para>
							</listitem>
							
							<listitem>
							<para>Rating - display movie rating.</para>
							</listitem>
							
							<listitem>
							<para>Format - display movie file format such as 
							avi, mpg or when no movie format is 
							set display "N/A".</para>
							</listitem>
							
							<listitem>
							<para>Quality - display movie quality such as "Bad", 
							"Good" or when no movie quality is 
							set display "N/A".</para>
							</listitem>
							
							<listitem>
							<para>Subtitles - display "Yes" if movie have subtitles, 
							"No" when movie don't have subtitles or "N/A" when 
							no subtitles information is set.</para>
							</listitem>
							
							<listitem>
							<para>Playlist - enables you to select movies you want to 
							play one after another.</para>
							</listitem>
						</itemizedlist>
						</entry>
						</row>
						
						<row>
						<entry valign="top">4</entry>
						<entry valign="top">Movie Area</entry>
						<entry valign="top">The movie area provide access to 
						details about the currently selected movie.</entry>
						</row>
						
						<row>
						<entry valign="top">5</entry>
						<entry valign="top">Statusbar</entry>
						<entry valign="top">
						The statusbar displays the number of movies that your
						database contain.
						</entry>
						</row>
					</tbody>
				</tgroup>
			</table>
			
			<note>
			<para>Information presented in the View Pane as "N/A" means that the information
			is not available.</para>
			</note>
		</sect2>
		
		<sect2 id="intro-movie-box">
			<title>The Movie Area</title>
			
			<para>The movie area provide access to 
			details about the currently selected movie. When no movie is selected this area is
			inactive. When movie is selected, the movie title, the movie genre, the tags 
			under wich selected movie is listed, the movie database record, the movie image,
			the movie comment and the movie location are active.</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-movie-area">
				<title>&app; Movie Area</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_mbox.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; movie area.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<tip>
			<para>You can show or hide the movie area by selecting <menuchoice><guimenu>View</guimenu>
			<guimenuitem>Movie Information Box</guimenuitem></menuchoice> or pressing
			<keycap>F9</keycap> key.</para>
			</tip>
			
			<para>Clicking on the movie title will open your default web browser and take you
			to the ImDB.com website, presenting you with information about the selected movie.</para>
			
			<para>Clicking on the movie genre will show you all movies listed under the same genre
			as the currently selected movie. 
			To display all movies again click on the 
			<inlinemediaobject id="vmoviedb-ma-refresh">
			<imageobject><imagedata fileref="figures/figure_refresh_button.png" format="PNG"/></imageobject>
			<textobject><phrase>Shows refresh button.</phrase></textobject>
			</inlinemediaobject> button.</para>
			
			<para>
			Clicking on some of the active movie tags will show you all movie listed under the selected
			tag.
			</para>
			
			<note>
			<para>When you click on active movie tag the tag information box 
			(<xref linkend="vmoviedb-tag-info-box"/>) is displayed under the
			toolbar. To display all movies again close the box by clicking 
			<inlinemediaobject id="vmoviedb-tag-refresh">
			<imageobject><imagedata fileref="figures/figure_tag_close_button.png" format="PNG"/></imageobject>
			</inlinemediaobject> button.</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-tag-info-box">
				<title>Tag Information Box</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_tag_note.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; tag information box.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			</note>
			
			<para>Clicking on the movie image will start the <link linkend="vmoviedb-img-viewer">Movie Image Viewer</link> and will display the movie
			image in it's original size.</para>
		</sect2>
	</sect1>
	
	<sect1 id="vmoviedb-usage">
		<title>Using &app;</title>
		
		<sect2 id="vmoviedb-play">
			<title>To Play Movie</title>
			
			<para>To play movie select the movie you want to be played from the View Pane and then click
			on the "Play" button located on the toolbar. Doing this will present you with the
			"Play Movie dialog" (<xref linkend="vmoviedb-play-dialog"/>).</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-play-dialog">
				<title>&app; Play Movie dialog</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_play.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Play Movie dialog.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>Play Movie dialog contains information for the movie you are about to play.
			Click the "Play" button to start playing or "Cancel" button to quit the dialog.</para>
			
			<tip>
			<para>You can also play movie by selecting <menuchoice><guimenu>Movie</guimenu>
			<guimenuitem>Play</guimenuitem></menuchoice> from the menubar, pressing 
			<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo> or
			you can click on the selected movie with the right mouse button and choose
			"Play" from the popup menu.</para>
			</tip>
		</sect2>
		
		<sect2 id="vmoviedb-add">
			<title>To Add Movie</title>
			
			<para>To add move click on the "Add movie" button located on the toolbar. Doing this
			will present you with the "Add Movie" dialog.</para>
			
			<para>The "Add Movie" dialog has two tabs - 
			"Movie details"(<xref linkend="vmoviedb-add-dialog-main"/>) and 
			"Comment" (<xref linkend="vmoviedb-add-dialog-comment"/>).</para>
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-add-dialog-main">
				<title>&app; Add Movie dialog "Movie details" tab</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_add_main.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Add Movie dialog "Movie Details" tab.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>In the "Movie details" tab you can enter general information about the
			movie you want to add. Set the movie rating, location, tag categorization and image.</para>
			
			<important>
			<para>The title field is requied. You won't be able to add movie withought entering
			information in this field. All other fields and settings are optional.</para>
			</important>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-add-dialog-comment">
				<title>&app; Add Movie dialog main section</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_add_cm.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Add Movie dialog "Comment" tab.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>In the "Comment" tab you are able to enter comment for the movie.</para>
			<para>You can save you comment to text document by clicking "Save to file" button.</para>
			<para>To clear you whole comment click on the <inlinemediaobject id="vmoviedb-cm-clear">
			<imageobject><imagedata fileref="figures/figure_comment_clr.png" format="PNG"/></imageobject>
			<textobject><phrase>Shows clear button.</phrase></textobject>
			</inlinemediaobject> button.</para>
			
			<note>
			<para>There are no restrictions about the comment lenght but it's recommeded to keep
			your comment's in the lenght between 0 and 5000 characters, for 
			application preformance reasons.</para>
			</note>
			
			<para>To add your movie click on the "Add" button, or to cancel the operation click 
			"Cancel" button.</para>
			
			<tip>
			<para>You can also add movie by selecting <menuchoice><guimenu>Movie</guimenu>
			<guimenuitem>Add Movie</guimenuitem></menuchoice> from the menubar, pressing 
			<keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo> or
			you can use the popup menu accessible from view pane and select "Add Movie"</para>
			</tip>
		</sect2>
		
		<sect2 id="vmoviedb-edit">
			<title>To Edit Movie</title>
			
			<para>To edit movie, select the movie you want to edit from the view pane and click
			"Edit movie" toolbar button. Doing this will present you with the "Edit movie" dialog.
			</para>
			
			<para>The "Edit Movie" dialog has two tabs - 
			"Movie Details"(<xref linkend="vmoviedb-edit-dialog-main"/>) and 
			"Comment"(<xref linkend="vmoviedb-edit-dialog-cm"/>).</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-edit-dialog-main">
				<title>&app; Edit Movie dialog "Movie details" tab</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_edit.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Edit Movie dialog "Movie details" tab.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>In the "Movie details" tab you can change general information about the
			selected movie. Ajust the movie rating, correct the location, change tag categorization 
			and image.</para>
			
			<important>
			<para>The title field is requied. You won't be able to save your changes to the 
			movie withought entering information in this field. All other fields and settings 
			are optional.</para>
			</important>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-edit-dialog-cm">
				<title>&app; Edit Movie dialog "Comment" tab</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_edit_cm.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Edit Movie dialog "Comment" tab.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>In the "Comment" tab you are able to change or clear the movie comment.</para>
			<para>You can save you comment to text document by clicking "Save to file" button.</para>
			<para>To clear you whole comment click on the <inlinemediaobject id="vmoviedb-ecm-clear">
			<imageobject><imagedata fileref="figures/figure_comment_clr.png" format="PNG"/></imageobject>
			<textobject><phrase>Shows clear button.</phrase></textobject>
			</inlinemediaobject> button.</para>
			
			<note>
			<para>There are no restrictions about the comment lenght but it's recommeded to keep
			your comment's in the lenght between 0 and 5000 characters, for 
			application preformance reasons.</para>
			</note>
			
			<para>To save the changes to the edited movie click the "Save" button, or to cancel
			the operation click "Cancel".</para>
			
			<tip>
			<para>You can also edit movie by selecting <menuchoice><guimenu>Movie</guimenu>
			<guimenuitem>Edit Movie</guimenuitem></menuchoice> from the menubar, or
			you can use the popup menu accessible from view pane and select "Edit Movie"</para>
			</tip>
		</sect2>
		
		<sect2 id="vmoviedb-delete">
			<title>To Delete Movie</title>
			
			<para>To delete movie select the movie you want to delete and click "Delete movie"
			toolbar button. You will be asked for confirmation. Click "Yes"
			to delete the movie or "No" to cancel the operation.</para>
			
			<tip>
			<para>You can also delete movie by selecting <menuchoice><guimenu>Movie</guimenu>
			<guimenuitem>Delete Movie</guimenuitem></menuchoice> from the menubar, or
			you can use the popup menu accessible from view pane and select "Delete Movie"</para>
			</tip>
		</sect2>
		
		<sect2 id="vmoviedb-search">
			<title>To Search For A Movie</title>
			
			<para>To search for a movie in the movie database click "Find" toolbar button.
			Doing this will present you with the "Find" dialog 
			(<xref linkend="vmoviedb-find-dialog"/>).</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-find-dialog">
				<title>&app; Find dialog.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_find.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Find dialog.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>Select the criteria by wich you want to do your search. Type the keyword in the 
			entry and click "Find" button. If there are any movies maching the selected criteria 
			they will be displayed in the list below the search box.</para>

			<para>When you click with the right mouse button on some result from the search operation, a
			popup menu is displayed, from wich you can preform one of the listed operation on the
			result.</para>
			
			<para>Table 2 describes the available movie search criterias and shows example for
			each of them.</para>
			
			<table frame="topbot" id="vmoviedb-find-table">
				<title><application>&app;</application> find dialog
				search criterias.</title>
				<colspec colname="COLSPEC0"/>
          			<colspec colname="COLSPEC1"/>
				<tgroup cols="3" colsep="0" rowsep="0">
					<thead>
					<row rowsep="1">
						<entry valign="top">Criteria</entry>
						<entry valign="top">Description</entry>
						<entry valign="top">Example usage</entry>
					</row>
					</thead>
					
					<tbody>
						<row>
						<entry valign="top">Title</entry>
						<entry valign="top">Search for movie by it's title.</entry>
						<entry valign="top">
						EXAMPLE: "R" will return all movies
						having "R" in their titles, "Rambo" will return all movies 
						wich have that name in their titles.
						</entry>
						</row>
						
						<row>
						<entry valign="top">Year</entry>
						<entry valign="top">Search for movie by year.</entry>
						<entry valign="top">
						EXAMPLE: "1994" will return all movies released in 1994.
						</entry>
						</row>
						
						<row>
						<entry valign="top">Format</entry>
						<entry valign="top">Search by format</entry>
						<entry valign="top">
						EXAMPLE: "avi" will return all movies in avi format.
						</entry>
						</row>
						
						<row>
						<entry valign="top">Quality</entry>
						<entry valign="top">Search for mobie by it's quality.</entry>
						<entry valign="top">
						EXAMPLE: "Good" will return all movie in the database listed to have a
						good quality.
						</entry>	
						</row>
						
						<row>
						<entry valign="top">Subtitles</entry>
						<entry valign="top">Search for movie by subtitles.</entry>
						<entry valign="top">
						EXAMPLE: "Yes" will return all movies having subtitles.	
						</entry>
						</row>

						<row>
						<entry valign="top">Genre</entry>
						<entry valign="top">Search fot movie by it's genre.</entry>
						<entry valign="top">
						EXAMPLE: "Comedy" will return wall movies listed under this genre.
						</entry>
						</row>
					</tbody>
				</tgroup>
			</table>

			<note>
			<para>&app; do not determin the movie quality by it self. The movie quality is set by the user and may not have the same
			values as shown in the search example.</para>
			</note>
		</sect2>
		
		<sect2 id="vmoviedb-export-html">
			<title>To Export Your Movies Database To HTML Document.</title>

			<para>To export your movies database to an HTML document select <menuchoice><guimenu>File</guimenu><guimenu>Export</guimenu>
			<guimenuitem>Export to HTML document</guimenuitem></menuchoice> from the menubar. Doing this will present you with the 
			"Export to HTML document" (<xref linkend="vmoviedb-html-dialog"/>) dialog.</para>

			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-html-dialog">
				<title>&app; Export to HTML document dialog.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_export_html.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Export to HTML document dialog.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->

			<para>In the "Header" field type the title of your document, in the "File name" field type the name of your document followed by
			".html" extention. When you are redy press the "Export" button.</para>
			<para>Message showing the result of the operation will be displayed.</para>
		</sect2>
		
		<sect2 id="vmoviedb-export-txt">
			<title>To Export Your Movies Database To Text Document</title>

			<para>To export your movies database to text document select <menuchoice><guimenu>File</guimenu><guimenu>Export</guimenu>
			<guimenuitem>Export to text document</guimenuitem></menuchoice> from the menubar. Doing this will present you with the 
			"Export to text document"(<xref linkend="vmoviedb-txt-dialog"/>) dialog.</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-txt-dialog">
				<title>&app; Export to text document dialog.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_export_txt.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Export to text document dialog.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
			
			<para>In the "File name" field type the name of your document followed by ".txt" extention. When you are ready press the 
			"Export" button.</para>
			<para>Message showing the result of the operation will be displayed.</para>
		</sect2>
	</sect1>
	
	<sect1 id="vmoviedb-genre-editor">
		<title>Using &app; Genre Editor</title>
		
		<sect2 id="genre-editor-intro">
			<title>Genre Editor Introduction</title>

			<para>Using the &app; Genre Editor the user can manage a collection of movie genres, and use them when adding or editing 
			movie record as predefined templates accessible from the "Genre" field of "Add movie" or "Edit movie" dialogs.</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-genre-editor-fig">
				<title>&app; Genre Editor.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_geditor.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; Genre Editor.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
		</sect2>

		<sect2 id="genre-editor-add">
			<title>To Add Genre</title>

			<para>To add genre click on the "Add" button. Doing this will present you with the "Add genre"(<xref linkend="vmoviedb-genre-editor-add"/>) 
			dialog.</para>
		 	
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-genre-editor-add">
				<title>Add genre dialog.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_add_genre.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows add genre dialog.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->

			<para>In the "Genre name" field type the name of the genre you want to add, and then click on the "Add" button. If
			you want to cancel the operation click "Cancel"</para>
		</sect2>

		<sect2 id="genre-editor-edit">
			<title>To Edit Genre</title>

			<para>To edit genre, selectit from the genre list and click on the "Edit" button. Doing this will present you with the
			"Edit genre" (<xref linkend="vmoviedb-genre-editor-edit"/>) dialog.</para>
			
			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-genre-editor-edit">
				<title>Edit genre dialog.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_edit_genre.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows edit genre dialog.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->

			<para>In the "Genre name" field change the genre name as appropriate, and click on the "Save" button. If you want to
			cancel the operation click "Cancel".</para>
		</sect2>

		<sect2 id="genre-editor-delete">
			<title>To Delete Genre</title>

			<para>To delete genre, selectit from the genre list and click on the "Delete" button. You will be asked for confirmation
			click "Yes" to delete the selected genre or "No" to cancel the operation.</para>
		</sect2>
	</sect1>
	
	<sect1 id="vmoviedb-img-viewer">
		<title>Using &app; Movie Image Viewer</title>
		
		<sect2 id="img-viewer-intro">
			<title>Movie Image Viewer Introcuction</title>

			<para>Using the &app; Movie Image Viewer user can view all movie covers in his/her database in actual size.</para>

			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-img-viewer-fig">
				<title>&app; Movie Image Viewer.</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_img_view.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; movie image viewer.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
		</sect2>

		<sect2 id="img-viewer-back-forward">
			<title>Scrolling movies back and forward</title>

			<para>To browse the movie covers in your database using the Movie Image Viewer use the "Back" and "Forward" buttons.</para>
			<para>Pressing the "Back" button will go up in the movie list with one record, and pressing the "Forward" button will
			go down in the movie list with one record.</para>
		</sect2>
	</sect1>
	
	<sect1 id="vmoviedb-config">
		<title>Customizing &app;</title>
		
		<para>You can customize &app; to suit your requirements and preferences. This section describes how to customize &app;</para>
		<para>To customize &app; use the Preferences dialog. To display preferences dialog choose 
		<menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
		
		<sect2 id="vmoviedb-config-general">
			<title>General Preferences</title>
			
			<para>This section of the dialog allows you to set the default video player wich will be used, and to set if the "Play movie" dialog is
			visible or not.</para>

			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-pref-general">
				<title>General Preferences</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_pref_main.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; general preferences.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
		</sect2>

		<sect2 id="vmoviedb-config-list">
			<title>Movie List Preferences</title>

			<para>This section of the dialog allows you to set wich movie list column will be displayed and the default 
			action associated with movie list double click.</para>

			<!-- ==== Figure ==== -->
			<figure id="vmoviedb-pref-list">
				<title>Movie List Preferences</title>
				<screenshot>
					<mediaobject>
					<imageobject>
					<imagedata fileref="figures/figure_vmoviedb_pref_list.png" format="PNG"/>
					</imageobject>
					<!-- EPS versions of the figures are not required at the moment. -->
            				<!-- 
		    			<imageobject>
      					<imagedata fileref="figures/image.eps" format="EPS"/>
    		    			</imageobject>-->
					<textobject>
					<phrase>Shows &app; movie list preferences.</phrase>
					</textobject>
					</mediaobject>
				</screenshot>
			</figure>
			<!-- ==== End of Figure ==== -->
		</sect2>
	</sect1>
</article>
