<?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 appname          "MY-GNOME-APPLICATION">
  <!ENTITY app "<application>MY-GNOME-APPLICATION</application>">
  <!ENTITY appversion   "2.0">
  <!ENTITY manrevision  "2.0">
  <!ENTITY date "March 2002">
  <!-- Information about the entities
       Use the app and appname entities to specify the name of the application.  
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
-->
]>
<!-- 
  This is a GNOME documentation template, designed by the GNOME
  Documentation Project Team. Please use it for writing GNOME
  documentation, making obvious changes, such as:
  - all the words written in UPPERCASE (with the exception of GNOME) 
    should be replaced. As for "legalnotice", please leave the reference
    unchanged.
  - all id attributes should have 'myapp' replaced

  Remember that this is a guide, rather than a perfect model to follow
  slavishly. Make your manual logical and readable: see the GDP Style Guide for
  more on this.
-->
<!--
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://live.gnome.org/DocumentationProject
  Template version: 3.0 beta
  Template last modified 2006-11-21

-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
  <articleinfo> 
    <title>&app; Manual</title>
    <abstract role="description">
      <para>&app; is ... <!-- insert brief description -->.</para>
    </abstract>         

    <copyright> 
      <year>2006</year> 
      <holder>GNOME Documentation Project</holder> 
    </copyright> 

    <!-- An address can be added to the publisher information. -->
    <publisher role="maintainer"> 
      <publishername>GNOME Documentation Project</publishername> 
    </publisher> 

	  <xi:include href="legal.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <!-- The file legal.xml contains link to license for the documentation, 
        and other legal stuff such as "NO WARRANTY" statement. 
        Please do not change any of this. -->

    <authorgroup> 
      <author> 
    		<firstname>Documentation</firstname> 
    		<surname>Writer 2</surname> 
    		<affiliation> 
    	  		<orgname>GNOME Documentation Project</orgname> 
    	  		<!-- The email address of the author is optional and is commented out by default. 
    			<address> <email>doc-writer2@gnome.org</email> </address> 
    			-->
    		</affiliation> 
      </author> 
      <author> 
    		<firstname>Documentation</firstname> 
    		<surname>Writer 1</surname> 
    		<affiliation> 
    	  		<orgname>GNOME Documentation Project</orgname> 
    	  		<!-- The email address of the author is optional and is commented out by default. 
    			<address> <email>doc-writer2@gnome.org</email> </address> 
    			-->
    		</affiliation> 
      </author> 
    </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>MY-GNOME-APPLICATION Manual V&manrevision;</revnumber> 
		<date>&date;</date> 
		<revdescription> 
	  		<para role="author">Documentation Writer 2
        <!-- The email address of the author is optional and is commented out by default.  
	    	<email>docwriter2@gnome.org</email> -->
	  		</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
      </revision> 
      <revision> 
		<revnumber>Full title of previous manual.</revnumber> 
		<date>Release date of previous manual.</date> 
		<revdescription> 
	  		<para role="author">Documentation Writer 1 
        <!-- The email address of the author is optional and is commented out by default. 
	    	<email>docwriter1@gnome.org</email> -->
	  		</para>
	  		<para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of MY-GNOME-APPLICATION.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
      this manual, follow the directions in the 
      <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>MY-GNOME-APP</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>mygnomeapp</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="myapp-introduction"> 
    <title>Introduction</title> 
    <para>Use &app; to view image files. 
    &app; provides the following features:</para> 
    <itemizedlist> 
      <listitem> 
		<para>Support for the following image file formats:</para> 
		<itemizedlist> 
	  		<listitem> 
	    	<para>BMP - Windows Bitmap</para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>GIF - Graphics Interchange Format</para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>ICO - Windows Icon</para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>JPEG - Joint Photographic Experts Group</para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>PNG - Portable Network Graphics </para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>PNM - Portable Anymap from the PPM Toolkit</para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>RAS - Sun Raster </para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>TIFF - Tagged Image File Format</para> 
	  		</listitem> 
	  		<listitem> 
	    	<para>XPM - X Pixmap</para> 
	  		</listitem> 
		</itemizedlist> 
      </listitem> 
      <listitem> 
	  <para>A variety of zoom levels and full screen viewing, with low usage
	  of memory regardless of the zoom level. </para> 
      </listitem> 
    </itemizedlist> 
    <note>
      <para>This is a note.</para>
    </note>
  </sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here. 
     If the information about how to get started is very short, you can 
     include it in the Introduction and omit this section. -->

  <sect1 id="myapp-getting-started"> 
    <title>Getting Started</title> 

    <sect2 id="myapp-start">
    <title>Starting &app;</title>
    <para>You can start &app; in the following ways:
    </para> 
    <variablelist>
    	<varlistentry>
    		<term><guimenu>Applications</guimenu> menu</term>
    		<listitem>
    		<para>Choose 
    		<menuchoice>
    		<guisubmenu>Submenu Name </guisubmenu>
    		<guimenuitem>My-GNOME-APPLICATION</guimenuitem>
    		</menuchoice>. </para>
    		</listitem>
    	</varlistentry>
    	<varlistentry>
    		<term>Command line</term>
    		<listitem>
    		<para>To start &app; from a command line, type the following command, 
    		then press <keycap>Return</keycap>:</para>
    		<para> 
			<command>myapp</command> 
			<replaceable>filename.jpg</replaceable>
    		</para> 
    		<para>where 
			<replaceable>filename.jpg</replaceable> is the name of the file you
			want to open.
    		</para> 
    		<para>&app; opens each file that you specify in a new window.</para> 
    		</listitem>
    	</varlistentry>
    </variablelist>
    </sect2>

    <sect2 id="myapp-when-start">
    <title>When You Start &app;</title>
    <para>When you start &app;, the following window is displayed.</para>

    <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
	<title>&app; Start Up Window</title> 
	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/myapp_start_window.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, display area, and
	      scrollbars. Menubar contains File, View, Settings, and Help menus. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

    <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
    <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->

    <para>The &app; window contains the following elements:
    </para>
      <variablelist>
	<varlistentry>
	<term>Menubar. </term>
	<listitem>
	<para>The menus on the menubar contain all of the commands you need to work with files in 
	&app;.</para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term>Toolbar. </term>
	<listitem>
	<para> The toolbar contains a subset of the commands that you can access from the menubar.</para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term>Statusbar. </term>
	<listitem>
	<para>The statusbar displays information about current &app; 
	activity and contextual information about the menu items. </para>
	</listitem>
	</varlistentry>
	</variablelist>
    </sect2>
  </sect1>
<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for which the application is designed.
     If this section runs to more than a few screens in Yelp, consider splitting it into several top-level sections.
  -->
  <sect1 id="myapp-usage"> 
    <title>Usage</title> 
    <para>You can use the &app; application to
      perform the following tasks: 
      <itemizedlist> 
	<listitem> 
	  <para> 
	    <xref linkend="myapp-open-image"/></para> 
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="myapp-manipulate-view"/></para> 
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="myapp-scroll-image"/></para>
	</listitem> 
	<listitem> 
	  <para> 
	    <xref linkend="myapp-close-image"/></para> 
	</listitem> 
      </itemizedlist> </para>
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="myapp-open-image"> 
      <title>Opening an Image</title> 
      <para>To open an image, choose 
	<menuchoice> 
	  <guimenu>File</guimenu> 
	  <guimenuitem>Open Image</guimenuitem> 
	</menuchoice>. The 
	<guilabel>Open Image</guilabel> dialog is displayed. Select the file
	that you want to open, then click 
	<guibutton>OK</guibutton>. To open another image in a new window,
	choose 
	<menuchoice> 
	  <guimenu>File</guimenu> 
	  <guimenuitem>Create New Window</guimenuitem> 
	</menuchoice>. Choose 
	<menuchoice> 
	  <guimenu>File</guimenu> 
	  <guimenuitem>Open Image</guimenuitem> 
	</menuchoice> 
	to select the file that you want to open. You can also drag an image
	from another application such as a file manager to the &app;
	window. If the &app; window is empty, the application displays
	the image in the window. If the window is not empty, the
	application starts a new window to display the file. The
	application displays the name of the image file and the size
	of the image in pixels in the titlebar of the window. </para>
      <para>
	If you try to open an image file format that &app; does
	not recognize, the application displays an error
	message.
      </para>
      <caution>
      <para>This is a caution.</para>
      </caution>
    </sect2> 
    <!-- ================ Usage Subsection ================================ -->
	 <sect2 id="myapp-manipulate-view"> 
      <title>Manipulating the View of an Image</title> 
      <para>You can use the following methods to resize the view of an image in
	the &app; window:</para> 
      <itemizedlist> 
	<listitem> 
	  <para>To enlarge the view of an image, choose 
	    <menuchoice> 
	      <guimenu>View</guimenu> 
	      <guimenuitem>Zoom In</guimenuitem> 
	    </menuchoice>.</para> 
	</listitem> 
	<listitem> 
	  <para>To shrink the view of an image, choose 
	    <menuchoice> 
	      <guimenu>View</guimenu> 
	      <guimenuitem>Zoom Out</guimenuitem> 
	    </menuchoice>.</para> 
	</listitem> 
	<listitem> 
	  <para>To view the image at its actual size, choose 
	    <menuchoice> 
	      <guimenu>View</guimenu> 
	      <guimenuitem>Zoom 1:1</guimenuitem> 
	    </menuchoice>. </para> 
	</listitem> 
	<listitem> 
	  <para>To enlarge or shrink the view of an image so that the image
	    fits the &app; window, choose 
	    <menuchoice> 
	      <guimenu>View</guimenu> 
	      <guimenuitem>Fit to Window</guimenuitem> 
	    </menuchoice>.</para> 
	</listitem> 
	<listitem> 
	  <para>To enlarge or shrink the image to a specific zoom factor,
	    choose 
	    <menuchoice> 
	      <guimenu>View</guimenu> 
	      <guimenuitem>Zoom factor</guimenuitem> 
	    </menuchoice>, then choose the appropriate zoom factor from the
	    drop-down list.</para> 
	</listitem> 
	<listitem> 
	  <para>To display the image in full screen mode, choose 
	    <menuchoice> 
	      <guimenu>View</guimenu> 
	      <guimenuitem>Full Screen</guimenuitem> 
	    </menuchoice>. Full screen mode displays the image in a window that
	    fills the full screen. The window does not contain a
	    window frame, titlebar, 
	    menubar, or toolbar. To exit from this mode, press the 
	    <keycap>Esc</keycap> key or 
	    <keycombo>
              <keycap>Ctrl</keycap>
	      <keycap>W</keycap>
	    </keycombo>.
	  </para> 
	</listitem> 
      </itemizedlist> 
      <tip>
      <para>This is a tip.</para>
      </tip>
    </sect2> 
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="myapp-scroll-image"> 
      <title>Scrolling an Image</title> 
      <para>To scroll around an image that is larger than the image window or
	full screen window, you can use the following methods:</para> 
      <itemizedlist> 
	<listitem> 
	  <para>Use the arrow keys on the keyboard.</para> 
	</listitem> 
	<listitem> 
	  <para>Drag the image in the opposite direction to the direction in
	    which you want to scroll. For example, if you want to
	      scroll down the image, 
	    drag the image upwards in the window.</para> 
	</listitem> 
	<listitem> 
	  <para>Use the scrollbars on the window.</para> 
	</listitem> 
      </itemizedlist> 
    </sect2>
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="myapp-close-image"> 
      <title>Closing an Image</title> 
      <para>To close an image, choose 
	<menuchoice> 
	  <guimenu>File</guimenu> 
	  <guimenuitem>Close This Window</guimenuitem> 
	</menuchoice>. If the window is the last
	&app; window open, the application exits. </para> 
      <para>To quit &app; and close all of the
	windows that you opened in the current session, choose 
	<menuchoice> 
	  <guimenu>File</guimenu> 
	  <guimenuitem>Exit</guimenuitem> 
	</menuchoice>. </para> 
      <warning>
      <para>This is a warning.</para>
      </warning>
    </sect2> 
  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="myapp-prefs"> 
    <title>Preferences</title> 
    <para>To configure &app;, choose 
      <menuchoice> 
	<guimenu>Edit</guimenu> 
	<guimenuitem>Preferences</guimenuitem> 
      </menuchoice>. The 
      <guilabel>Preferences</guilabel> dialog contains the following tabbed
      sections:</para> 
    <itemizedlist> 
      <listitem> 
	<para> 
	  <xref linkend="myapp-prefs-display"/></para> 
      </listitem> 
      <listitem> 
	<para> 
	  <xref linkend="myapp-prefs-viewers"/></para> 
      </listitem> 
    </itemizedlist>
<!-- =============== Customization Subsection ================ -->
<!-- Use a new section to describe different tabbed sections on the Preferences
	     dialog. -->
    <sect2 id="myapp-prefs-display"> 
      <title>Display</title> 
      <variablelist> 
	<varlistentry> 
	  <term> 
	    <guilabel>Interpolation type</guilabel> </term> 
	  <listitem> 
	    <para>Use this drop-down list box to specify the
	      interpolation method that
	      &app; uses when the
	      application resizes images. Select one of the following
	      options:</para>
	    <itemizedlist> 
	      <listitem> 
		<para> 
		  <guilabel>Nearest neighbor</guilabel> </para> 
		<para>This method of interpolation takes a location in the
		  original image and replicates the pixel that is
		  nearest to this location. When 
		  you zoom in on an image, the pixels are
		  replicated. When you zoom out of an 
		  image, the image loses some of its detail. </para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Bilinear</guilabel> </para> 
		<para>This is a simple and fast method of interpolation. When
		  you zoom in on an image, &app; uses up to four
		  adjacent pixels to compute the colors of the new
		  pixels. When you zoom out of 
		  an image, &app; averages regions of color in the
		  existing image to compute the colors of the pixels. </para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Hyperbolic</guilabel> </para> 
		<para>This is a high-quality, slow method of interpolation. The
		  application performs interpolation on the image in
		  the manner described in 
		  Digital Image Warping by George Wolberg.</para> 
	      </listitem> 
	    </itemizedlist> 
	    <para>Default: 
	      <guilabel>Nearest neighbor</guilabel>.</para> 
	  </listitem> 
	</varlistentry> 
	<varlistentry> 
	  <term> 
	    <guilabel>Transparency type</guilabel> </term> 
	  <listitem> 
	    <para>Use this drop-down list box to specify how
	      &app; displays transparent or partially opaque
	      backgrounds in images. Select one of the following options:</para> 
	    <itemizedlist> 
	      <listitem> 
		<para> 
		  <guilabel>Dark checks</guilabel> </para> 
		<para>This option displays black and dark gray checks.</para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Midtone checks</guilabel> </para> 
		<para>This option displays dark gray and light gray
		  checks.</para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Light checks</guilabel> </para> 
		<para>This option displays light gray and white checks.</para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Black only</guilabel> </para> 
		<para>This option displays solid black.</para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Gray only</guilabel> </para> 
		<para>This option displays solid gray.</para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>White only</guilabel> </para> 
		<para>This option displays solid white.</para> 
	      </listitem> 
	    </itemizedlist> 
	    <para>Default: 
	      <guilabel>Dark checks</guilabel>.</para> 
	  </listitem> 
	</varlistentry> 
	<varlistentry> 
	  <term> 
	    <guilabel>Check size</guilabel> </term> 
	  <listitem> 
	    <para>Use this drop-down list box to specify the size of the checks
	      to use to display transparent or partially opaque
	      backgrounds in images. This 
	      option is only relevant if you choose 
	      <guilabel>Dark checks</guilabel>, 
	      <guilabel>Midtone checks</guilabel>, or 
	      <guilabel>Light checks</guilabel> from the 
	      <guilabel>Transparency type</guilabel> drop-down list box.
	      Select one of the following options:</para> 
	    <itemizedlist> 
	      <listitem> 
		<para> 
		  <guilabel>Small</guilabel></para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Medium</guilabel></para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Large</guilabel></para> 
	      </listitem> 
	    </itemizedlist> 
	    <para>Default: 
	      <guilabel>Small</guilabel>.</para> 
	  </listitem> 
	</varlistentry> 
	<varlistentry> 
	  <term> 
	    <guilabel>Dither type</guilabel> </term> 
	  <listitem> 
	    <para>Use this drop-down list box to specify the dithering method
	      to use to display images. Dithering is a technique that
	      is used to simulate 
	      colors in the original image file but that your system
	      can not display. Select 
	      one of the following options:</para> 
	    <itemizedlist> 
	      <listitem> 
		<para> 
		  <guilabel>None</guilabel> </para> 
		<para>This option does not use dithering. </para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Normal (pseudocolor)</guilabel> </para> 
		<para>This option performs dithering on pseudocolor displays,
		  which use a limited palette of colors. </para> 
	      </listitem> 
	      <listitem> 
		<para> 
		  <guilabel>Maximum (high color)</guilabel> </para> 
		<para>This option performs dithering on pseudocolor and high
		  color displays. </para> 
	      </listitem> 
	    </itemizedlist> 
	    <para>Default: 
	      <guilabel>None</guilabel>.</para> 
	  </listitem> 
	</varlistentry> 
	<varlistentry> 
	  <term> 
	    <guilabel>Two-pass scrolling</guilabel> </term> 
	  <listitem> 
	    <para>Select this option to render an image in two passes
	      when you scroll the image quickly. The first pass
	      renders a low quality version of the image. The second
	      pass renders a full quality version of the image over
	      the low quality version. Two-pass scrolling enables you
	      to view at least a low quality version of the image at
	      all times regardless of how quickly you scroll the
	      image. 
	    </para>
	    <para>Default: unselected.</para> 
	  </listitem> 
	</varlistentry> 
      </variablelist> 
    </sect2>
    <!-- ============= Customization Subsection ===================== -->
    <!-- Another tabbed section on the Preferences dialog. -->
    <sect2 id="myapp-prefs-viewers"> 
      <title>Viewers</title> 
      <para>You can set the following viewer preferences: 
	<itemizedlist> 
	  <listitem> 
	    <para> 
	      <xref linkend="myapp-viewer-prefs-image-window"/></para> 
	  </listitem> 
	  <listitem> 
	    <para> 
	      <xref linkend="myapp-viewer-prefs-full-screen"/></para> 
	  </listitem> 
	</itemizedlist> </para> 
      <sect3 id="myapp-viewer-prefs-image-window"> 
	<title>Image Windows</title> 
	<para>The 
	  <guilabel>Image Windows</guilabel> group contains the preferences
	  that you can set to view images in image windows.</para> 
	<variablelist> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Use scrollbars</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list box to specify when to use
		scrollbars to scroll through an image. Select one of
		the following options:</para> 
	      <itemizedlist> 
		<listitem> 
		  <para> 
		    <guilabel>Never</guilabel> </para> 
		  <para>This option never displays scrollbars. You can use the
		    arrow keys on the keyboard or the mouse to scroll
		    through the image. </para>  
		</listitem> 
		<listitem> 
		  <para> 
		    <guilabel>Only if image does not fit</guilabel> </para> 
		  <para>This option displays scrollbars when the image is
		    larger than the image window.</para> 
		</listitem> 
	      </itemizedlist> 
	      <para>Default: 
		<guilabel>Never</guilabel>.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Pick window size and zoom factor
		automatically</guilabel> </term> 
	    <listitem> 
	      <para>Select this option to resize the image window to fit the
		image or to resize the image to fit the image
		window. If the image is small, 
		&app; resizes the image window to fit the image. If
		the image is large, &app; resizes the image to fit
		the image window. </para> 
	      <para>Default: unselected.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Open images in a new window</guilabel> </term> 
	    <listitem> 
	      <para>Select this option to open a new
		&app; window each time you open an image. If you do
		not select this option, &app; replaces the existing
		image with the new image when you open an image. </para> 
	      <para>Default: unselected.</para> 
	    </listitem> 
	  </varlistentry> 
	</variablelist> 
      </sect3> 
      <sect3 id="myapp-viewer-prefs-full-screen"> 
	<title>Full Screen</title> 
	<para>The 
	  <guilabel>Full Screen</guilabel> group contains the preferences that
	  you can set to view images in full screen mode.</para> 
	<variablelist> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Use scrollbars</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list box to specify when to use
		scrollbars to scroll through an image. Select one of the following
		options:</para> 
	      <itemizedlist> 
		<listitem> 
		  <para> 
		    <guilabel>Never</guilabel> </para> 
		  <para>This option never displays scrollbars. You can use the
		    arrow keys on the keyboard or the mouse to scroll
		    through the image. </para>  
		</listitem> 
		<listitem> 
		  <para> 
		    <guilabel>Only if image does not fit</guilabel> </para> 
		  <para>This option displays scrollbars when the image is
		    larger than the full screen. </para> 
		</listitem> 
	      </itemizedlist> 
	      <para>Default: 
		<guilabel>Never</guilabel>.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Use 1:1 zoom factor</guilabel> </term> 
	    <listitem> 
	      <para>Select this option to use the 1:1 zoom factor when you open
		an image. The 1:1 zoom factor displays the image at
		its actual size. </para>  
	      <para>Default: selected.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Use same zoom factor as image window</guilabel> </term>
	    
	    <listitem> 
	      <para>Select this option to use the same zoom factor that the
		application uses to display the image in an image
	      window. </para>  
	      <para>Default: unselected.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Fit all images to screen</guilabel> </term> 
	    <listitem> 
	      <para>Select this option to resize images to fill the full screen
		when you open the images in full screen mode. </para> 
	      <para>Default: unselected.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Fit standard-sized images to screen</guilabel> </term> 
	    <listitem> 
	      <para>Select this option to automatically resize images
		that are the same size as standard screens so that the
		images fill the full screen when you open them in full
		screen mode. If you select this option, &app; ignores
		the settings for the previous three options when you
		open an image that is the same size as a standard
		screen.  Examples of standard screen sizes are 640 x
		480 pixels, 1024 x 768 pixels, and so on. </para>
	      <para>Default: unselected.</para> 
	    </listitem> 
	  </varlistentry> 
	  <varlistentry> 
	    <term> 
	      <guilabel>Put a bevel around the edge of the screen</guilabel>
	    </term> 
	    <listitem> 
	      <para>Select this option to display a 3D beveled border around
		the full screen view of an image. </para> 
	      <para>Default: unselected.</para> 
	    </listitem> 
	  </varlistentry> 
	</variablelist> 
      </sect3> 
    </sect2> 
  </sect1>
<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default. 
     You can use it to describe known bugs and limitations of the 
	  program if there are any - please be frank and list all
     problems you know of. 
  
  <sect1 id="mayapp-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->
<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  <sect1 id="myapp-about"> 
    <title>About &app;</title> 
    <para> &app; was written by GNOME-HACKER
      (<email>hacker@gnome.org</email>). To find more information about
      &app;, please visit the 
      <ulink url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
	page</ulink>. </para>
    <para>
      To report a bug or make a suggestion regarding this application or
      this manual, follow the directions in the
      <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>.
    </para>

    <para> This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; either version 2 of the License, or (at your option)
      any later version. A 
      <ulink url="ghelp:gpl" type="help">copy of this license</ulink>
      is included with this documentation; another can be found in the file
      COPYING included with the source code of this program. </para>

  </sect1> 
</article>