? C/.totem.xml.swp
Index: C/totem.xml
===================================================================
RCS file: /cvs/gnome/totem/help/C/totem.xml,v
retrieving revision 1.4
diff -u -r1.4 totem.xml
--- C/totem.xml	12 Aug 2006 08:14:36 -0000	1.4
+++ C/totem.xml	17 Aug 2006 22:48:00 -0000
@@ -2,9 +2,9 @@
 <!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.997">
+  <!ENTITY appversion "1.6.0">
   <!ENTITY manrevision "2.0">
-  <!ENTITY date "November 2003">
+  <!ENTITY date "August 2006">
   <!ENTITY app "Totem Movie Player">
   <!-- Information about the entities
        The legal.xml file contains legal information, there is no need to edit the file. 
@@ -33,16 +33,6 @@
       <holder>Chee Bin HOH</holder> 
     </copyright> 
 
-<!-- translators: uncomment this:
-    <copyright>
-      <year>2002</year>
-      <holder>ME-THE-TRANSLATOR (Latin 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> GNOME Documentation Project </publishername> 
     </publisher> 
@@ -54,26 +44,23 @@
 
     <authorgroup> 
       <author> 
-	<firstname>Chee Bin</firstname> 
-	<surname>HOH</surname> 
-	<affiliation> 
-  	  <orgname>GNOME Documentation Project</orgname> 
-	  <address> <email>cbhoh@gnome.org</email> </address> 
-	</affiliation> 
+	    <firstname>Chee Bin</firstname> 
+	    <surname>HOH</surname> 
+	    <affiliation> 
+  	      <orgname>GNOME Documentation Project</orgname> 
+	      <address> <email>cbhoh@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> 
+      <othercredit role="author">
+	<firstname>Baptiste</firstname> 
+	<surname>Mille-Mathias</surname> 
 	<affiliation> 
-          <orgname>Latin Translation Team</orgname> 
-  	  <address> <email>translator@gnome.org</email> </address> 
+          <orgname>GNOME Documentation project</orgname> 
+  	  <address> <email>baptiste.millemathias@gmail.org</email> </address> 
         </affiliation>
-        <contrib>Latin translation</contrib>
+        <contrib>Update documentation</contrib>
       </othercredit>
--->
     </authorgroup>
 
 <!-- According to GNU FDL, revision history is mandatory if you are -->
@@ -109,7 +96,6 @@
         this manual, follow the directions in the 
         <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. 
       </para>
-<!-- Translators may also add here feedback address for translations -->
     </legalnotice> 
   </articleinfo> 
 
@@ -128,7 +114,7 @@
   <sect1 id="totem-introduction"> 
     <title>Introduction</title> 
     <para>The <application>&app;</application> application is a movie player for the GNOME desktop based on
-      xine library, it enables you to play movies or songs.
+      Gstreamer framework and xine library, it enables you to play movies or songs.
     </para>
     <para><application>&app;</application> provides the following features:</para>
     <itemizedlist> 
@@ -157,9 +143,6 @@
 	  <para>Video thumbnailer for GNOME.</para>
         </listitem>
 	<listitem>
-	  <para>Webcam utility.</para>
-        </listitem>
-	<listitem>
 	  <para>Nautilus properties tab.</para>
         </listitem>
       </itemizedlist>
@@ -225,16 +208,12 @@
 	    <imageobject>
 	      <imagedata fileref="figures/totem_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 <application>&app;</application> main window. Contains menubar, display area, 
-                time elapsed slider, seek control buttons, volume slider and statusbar.
-              </phrase>
+	      <phrase>Shows <application>&app;</application> main window with
+		  sidebar opened on playlist. Contains
+		  menubar, display area, sidebar, time elapsed slider, seek control
+		  buttons, volume slider and statusbar.
+          </phrase>
 	    </textobject> 
 	  </mediaobject> 
 	</screenshot> 
@@ -261,6 +240,14 @@
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
+	  <term>Sidebar.</term>
+	  <listitem>
+	    <para>The sidebar displays properties of file played and acts as
+		playlist.
+            </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
 	  <term>Time elapsed slider.</term>
 	  <listitem>
 	    <para>The time elapsed slider displays the elapsed time of movie or song that is playing.
@@ -342,43 +329,11 @@
     </sect2>
 
     <sect2 id="totem-usage-play">
-      <title>To Play a DVD, VCD or CD</title>
-      <variablelist>
-        <varlistentry>
-  	  <term>To play a DVD</term>
-	  <listitem>
-            <para>Insert the DVD in the DVD device of your computer, then choose
-              <menuchoice>
-		<guimenu>Movie</guimenu>
-		<guimenuitem>Play DVD</guimenuitem>
-              </menuchoice>.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-  	  <term>To play a VCD</term>
-	  <listitem>
-            <para>Insert the VCD in the VCD device of your computer, then choose
-              <menuchoice>
-	        <guimenu>Movie</guimenu>
-		<guimenuitem>Play VCD</guimenuitem>
-              </menuchoice>.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-  	  <term>To play a CD</term>
-	  <listitem>
-            <para>Insert the CD in the CD device of your computer, then choose
-              <menuchoice>
-	        <guimenu>Movie</guimenu>
-		<guimenuitem>Play CD</guimenuitem>
-              </menuchoice>.
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect2>
+      <title>To Play a Movie (DVD, VCD or CD)</title>
+	      <para>Insert the disc in the optical device of your computer, then choose
+          	<menuchoice><guimenu>Movie</guimenu><guimenuitem>Play Disc</guimenuitem>
+              </menuchoice>.</para>
+       </sect2>
 
     <sect2 id="totem-usage-eject">
       <title>To Eject a DVD, VCD or CD</title>
@@ -422,10 +377,10 @@
       <title>To View Properties of a Movie or Song</title>
       <para>To view properties of a movie or song, choose 
         <menuchoice>
-	  <guimenu>Movie</guimenu>
-	  <guimenuitem>Properties</guimenuitem>
-        </menuchoice>. The <guilabel>Properties</guilabel> dialog is displayed. The dialog contains the
-        following information:
+	  <guimenu>View</guimenu>
+	  <guimenuitem>Sidebar</guimenuitem></menuchoice> to make the sidebar
+	  appear, and choose <guimenu>Properties</guimenu> in the grop-down list.</para>
+	  <para>The dialog contains the following information:
         <variablelist>
 	  <varlistentry>
             <term>General</term>
@@ -529,72 +484,74 @@
 
     <sect2 id="totem-usage-change-zoom">
       <title>To Change the Zoom Factor</title>
+	  <sect3 id="totem-usage-change-size">
+		<title>To Change the Video Size</title>
       <para>To change the zoom factor of display area, you can use the 
         following methods:
       </para>
       <itemizedlist>
 	<listitem>
-	  <para>To zoom to full screen mode,
-            choose 
-            <menuchoice>
-	      <shortcut><keycap>F</keycap></shortcut>
-	      <guimenu>View</guimenu>
-              <guimenuitem>Fullscreen</guimenuitem>
-            </menuchoice>. To exit fullscreen mode, click on the <guibutton>Exit Fullscreen</guibutton>
-            button or press <keycap>Esc</keycap>.
+	  <para>To zoom to full screen mode, choose
+	  <menuchoice><shortcut><keycap>F</keycap></shortcut>
+	  <guimenu>View</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice>
+	  . To exit fullscreen mode, click on the
+			<guibutton>Leave Fullscreen</guibutton> button or press
+			<keycap>Esc</keycap> or <keycap>F</keycap>.
           </para>
-        </listitem>
+    </listitem>
 	<listitem>
 	  <para>To zoom to half size (50%) of the original movie or visualisation,
             choose 
             <menuchoice>
 	      <shortcut><keycap>0</keycap></shortcut>
-	      <guimenu>View</guimenu>
-              <guimenuitem>Zoom 1:2</guimenuitem>
+	      <guimenu>View</guimenu><guisubmenu>Fit Window to Movie</guisubmenu>
+              <guimenuitem>Resize 1:2</guimenuitem>
             </menuchoice>.
-          </para>
-        </listitem>
+      </para>
+    </listitem>
 	<listitem>
 	  <para>To zoom to size (100%) of the original movie or visualisation,
             choose 
             <menuchoice>
 	      <shortcut><keycap>1</keycap></shortcut>
-	      <guimenu>View</guimenu>
-              <guimenuitem>Zoom 1:1</guimenuitem>
+	      <guimenu>View</guimenu><guisubmenu>Fit Window to Movie</guisubmenu>
+              <guimenuitem>Resize 1:1</guimenuitem>
             </menuchoice>.
-          </para>
-        </listitem>
+      </para>
+    </listitem>
 	<listitem>
 	  <para>To zoom to double size (200%) of the original movie or visualisation,
             choose 
             <menuchoice>
 	      <shortcut><keycap>2</keycap></shortcut>
-	      <guimenu>View</guimenu>
-              <guimenuitem>Zoom 2:1</guimenuitem>
+	      <guimenu>View</guimenu><guisubmenu>Fit Window to Movie</guisubmenu>
+              <guimenuitem>Resize 2:1</guimenuitem>
             </menuchoice>.
           </para>
         </listitem>
-	<listitem>
-	  <para>To switch between different aspect ratios, choose
+	</itemizedlist>
+	</sect3>
+	 <sect3 id="totem-usage-change-ratio">
+		<title>To Change the Video Aspect Ratio</title>
+	      <para>To switch between different aspect ratios, choose
             <menuchoice>
 	      <shortcut><keycap>A</keycap></shortcut>
 	      <guimenu>View</guimenu>
-	      <guimenuitem>Toggle Aspect Ratio</guimenuitem>
-            </menuchoice>. The supported aspect ratios are:
+	      <guisubmenu>Aspect Ratio</guisubmenu>
+            </menuchoice>. The supported aspect ratios available are:
             <itemizedlist>
-              <listitem><para>Automatic Aspect</para></listitem>
-	      <listitem><para>Square Aspect (1:1)</para></listitem>
-              <listitem><para>4:3 Aspect (4:3)</para></listitem>
-              <listitem><para>Anamorphic Aspect (16:9)</para></listitem>
-              <listitem><para>DVB Aspect (2.11:1)</para></listitem>
+              <listitem><para>Auto</para></listitem>
+	          <listitem><para>Square</para></listitem>
+              <listitem><para>4:3 (TV)</para></listitem>
+              <listitem><para>16:9 (Widescreen)</para></listitem>
+              <listitem><para>2.11:1 (DVB)</para></listitem>
             </itemizedlist>
             <note>
-              <para>The default aspect ratio is Automatic Aspect.
+              <para>The default aspect ratio is Auto.
               </para>
             </note>
           </para>
-        </listitem>
-      </itemizedlist>
+	  </sect3>
     </sect2>
 
     <sect2 id="totem-usage-adjust-volume">
@@ -612,16 +569,8 @@
           <guimenuitem>Volume Down</guimenuitem>
         </menuchoice> or move the volume slider to the left.         
       </para>
-      <para>To turn the volume down to minimum, click on the 
-        <inlinemediaobject> 
-	  <imageobject><imagedata fileref="figures/totem_volume_mute_button.png" format="PNG"/></imageobject>
-	  <textobject><phrase>Shows a mute button</phrase></textobject>
-        </inlinemediaobject> button.
-        To turn the volume up to maximum, click on the
-        <inlinemediaobject> 
-	  <imageobject><imagedata fileref="figures/totem_volume_maximum_button.png" format="PNG"/></imageobject>
-	  <textobject><phrase>Shows a maximum volume button</phrase></textobject>
-        </inlinemediaobject> button.
+      <para>To adjust the sound volume, you can also use the volume button.
+	  Press the volume button and choose the volume level with the slider.
       </para>
     </sect2>
 
@@ -682,22 +631,13 @@
 	<title>To Show or Hide Playlist</title>
 	<para>To show playlist, choose 
           <menuchoice>
-	    <guimenu>View</guimenu>
-	    <guimenuitem>Show/Hide Playlist</guimenuitem>
-          </menuchoice>, or click on the 
-          <inlinemediaobject>
-	    <imageobject><imagedata fileref="figures/totem_show_playlist_button.png" format="PNG"/></imageobject>
-            <textobject><phrase>Shows a show/hide playlist button</phrase></textobject>
-          </inlinemediaobject> button. The <guilabel>Playlist</guilabel> dialog is displayed. To hide Playlist, 
-          choose
-          <menuchoice>
-	    <guimenu>View</guimenu>
-	    <guimenuitem>Show/Hide Playlist</guimenuitem>
-          </menuchoice> or click on the
-          <inlinemediaobject>
-	    <imageobject><imagedata fileref="figures/totem_show_playlist_button.png" format="PNG"/></imageobject>
-            <textobject><phrase>Shows a show/hide playlist button</phrase></textobject>
-          </inlinemediaobject> button again.
+	    <guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem>
+          </menuchoice>, or click the <guilabel>Sidebar</guilabel> button, and
+		  choose <guimenu>Playlist</guimenu> on the top of 
+		  the sidebar. The <guilabel>Playlist</guilabel> dialog is displayed.</para>
+		  <para>To hide Playlist, choose <menuchoice><guimenu>View</guimenu>
+	    <guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
+         <guilabel>Sidebar</guilabel> button again.
         </para>
       </sect3>
 
@@ -747,20 +687,6 @@
                 </para>
               </listitem>
 	    </varlistentry>
-	    <varlistentry>
-              <term>To set repeat mode</term>
-	      <listitem>
-		<para>Select the <guilabel>Repeat mode</guilabel> option to play the movies or songs repeatedly.
-                </para>
-              </listitem>
-	    </varlistentry>
-	    <varlistentry>
-	      <term>To set shuffle mode</term>
-	      <listitem>
-		<para>Select the <guilabel>Shuffle mode</guilabel> option to play the movies or songs randomly.
-                </para>
-              </listitem>
-            </varlistentry>
           </variablelist>
         </para>
       </sect3>
@@ -786,6 +712,21 @@
       </sect3>
     </sect2>
 
+    <sect2 id="totem-usage-subtitle">
+	  <title>To Choose Subtitle</title>
+	  <para>To choose
+	  the langage of the subtitles, select
+	  <menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu></menuchoice>
+	  and choose the subtitles langage that suit your needs.</para>
+	  <para>To disable the display of subtitles, select
+	  <menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu><guimenuitem>None</guimenuitem></menuchoice>.</para>
+	  <note><para>By default, &app; will choose the same langage for the
+	  subtitles that the one you use  on your computer.</para></note>
+	  <tip><para>&app; will automatically load subtitles file (with extension
+	  <filename>sub</filename> or <filename>foo</filename>) if it has the same
+	  name than the video file played.</para></tip>
+	</sect2>
+
     <sect2 id="totem-usage-take-screenshot">
       <title>To Take Screenshot</title>
       <para>To take screenshot of movie or visualisation of song that is playing, choose 
@@ -876,6 +817,21 @@
               </listitem>
             </itemizedlist>
           </listitem>
+        </varlistentry>
+		<varlistentry>
+	  <term>Text Subtitles</term>
+	  <listitem>
+	    <itemizedlist>
+	      <listitem>
+                <para><guilabel>Font</guilabel>: select this option to change
+				the font used to display subtitles.</para>
+              </listitem>
+	          <listitem>
+				<para><guilabel>Encoding</guilabel>: select this option to the
+				encoding used for subtitles.</para>
+              </listitem>
+            </itemizedlist>
+          </listitem>
         </varlistentry>	
       </variablelist>
     </sect2>
@@ -895,7 +851,7 @@
 	  <listitem>
 	    <itemizedlist>
 	      <listitem>
-                <para><guilabel>visual</guilabel>: select this option to show visual effects
+                <para><guilabel>Visual</guilabel>: select this option to show visual effects
                   while an audio file is playing.
                 </para>
               </listitem>
@@ -913,17 +869,25 @@
           </listitem>
         </varlistentry>
 	<varlistentry>
-	  <term>Brightness/Contrast</term>
+	  <term>Color balance</term>
 	  <listitem>
 	    <itemizedlist>
 	      <listitem>
-		<para><guilabel>Brightness</guilabel>: use the slider to specify the level of brightness.</para>
-              </listitem>
+		    <para><guilabel>Brightness</guilabel>: use the slider to specify the level of brightness.</para>
+          </listitem>
 	      <listitem>
-		<para><guilabel>Contrast</guilabel>: use the slider to specify the level of contrast.</para>
-              </listitem>
-	    </itemizedlist>
+		     <para><guilabel>Contrast</guilabel>: use the slider to specify the level of contrast.</para>
+          </listitem>
+	      <listitem>
+		    <para><guilabel>Saturation</guilabel>: use the slider to specify the
+			level of saturation.</para>
+          </listitem>
+	      <listitem>
+		     <para><guilabel>Hue</guilabel>: use the slider to specify the level
+			 of hue.</para>
           </listitem>
+	    </itemizedlist>
+      </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
Index: C/figures/totem_start_window.png
===================================================================
RCS file: /cvs/gnome/totem/help/C/figures/totem_start_window.png,v
retrieving revision 1.1
diff -u -r1.1 totem_start_window.png
Binary files /tmp/cvsSGp2Un and totem_start_window.png differ
