[nautilus-actions] Update NACT user's manual



commit ea775813a35b4c075e2a141359df6824c0f69dcf
Author: Pierre Wieser <pwieser trychlos org>
Date:   Sun Aug 1 19:06:50 2010 +0200

    Update NACT user's manual

 TODO                                        |    3 -
 doc/nact/C/nautilus-actions-config-tool.xml | 1050 +++++++--------------------
 2 files changed, 253 insertions(+), 800 deletions(-)
---
diff --git a/TODO b/TODO
index 875bc73..38ddcce 100644
--- a/TODO
+++ b/TODO
@@ -493,6 +493,3 @@ Parameter 	Description
   instead of terminating the edition and letting the old value
 
 - 2010-06-20: TODO: is_candidate_for_show_in: get current environment
-
-- 2010-08-01: BUG: select a profile, create new action -> the new action is inserted just before
-  current profile ! should be just before current NAObjectItem
diff --git a/doc/nact/C/nautilus-actions-config-tool.xml b/doc/nact/C/nautilus-actions-config-tool.xml
index 4e8e91b..2188bf0 100644
--- a/doc/nact/C/nautilus-actions-config-tool.xml
+++ b/doc/nact/C/nautilus-actions-config-tool.xml
@@ -507,24 +507,167 @@
         </menuchoice>.
       </para>
       <para>
-        A new action is inserted in the items list just before the current action or menu.
-        It is also displayed in right tabs.
+        A new action is inserted in the items list. The exact place where the
+        action is inserted depends of the current sort order of the items list.
       </para>
+      <variablelist>
+        <varlistentry>
+          <term>
+            Manual order
+          </term>
+          <listitem>
+            <para>
+              The new action is inserted just before the current action or menu.
+            </para>
+            <para>
+              This place will not change when you later modify the label of the action.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>
+            Ascending (resp. descending) alphabetical order
+          </term>
+          <listitem>
+            <para>
+              The new action is inserted at the correct place, regarding the default
+              "New Nautilus action" label.
+            </para>
+            <para>
+              This place will be automatically changed, each time you modify the
+              label of the action.
+            </para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
       <para>
-        In items list, the new action is displayed in italic characters. Italics are used
-        as a reminder that the item has not yet been saved.
+        Properties of this new action are also displayed in right tabs.
       </para>
+      <note>
+        <para>
+          In items list, the new action is displayed in italic characters. Italics are used
+          as a reminder that the item has not yet been saved.
+        </para>
+      </note>
+      <note>
+        <para>
+          The new action is also displayed in red color in items list.
+          Red color is used as an indicator that the item
+          is invalid, that is that the item cannot be candidate to be displayed in a
+          &nautilus; context menu because some of its informations are missing or erroneous.
+          Here, adn though this newly inserted action has some suitable defaults, it lacks a 
+          command to be executed to be considered valid by &appname;
+        </para>
+      </note>
+
+      <sect3 id="usage-create-action-where">
+        <title>Where should appear the action ?</title>
+        <para>
+        </para>
+      </sect3>
+
+      <sect3 id="usage-create-action-display">
+        <title>How the action will it appear ?</title>
+        <para>
+        </para>
+      </sect3>
+
+      <sect3 id="usage-create-action-when">
+        <title>When the action will it be displayed ?</title>
+        <para>
+        </para>
+
+        <sect4 id="usage-create-action-when-basenames">
+          <title>Basenames</title>
+          <para>
+          </para>
+        </sect4>
+
+        <sect4 id="usage-create-action-when-mimetypes">
+          <title>Basenames</title>
+          <para>
+          </para>
+        </sect4>
+
+        <sect4 id="usage-create-action-when-folders">
+          <title>Basenames</title>
+          <para>
+          </para>
+        </sect4>
+
+        <sect4 id="usage-create-action-when-schemes">
+          <title>Basenames</title>
+          <para>
+          </para>
+        </sect4>
+
+        <sect4 id="usage-create-action-when-capabilities">
+          <title>Basenames</title>
+          <para>
+          </para>
+        </sect4>
+
+        <sect4 id="usage-create-action-when-environment">
+          <title>Basenames</title>
+          <para>
+          </para>
+        </sect4>
+
+      </sect3>
+
+      <sect3 id="usage-create-action-what">
+        <title>What the action should it execute ?</title>
+        <para>
+        </para>
+      </sect3>
+
+      <sect3 id="usage-create-action-how">
+        <title>How the action should it be executed ?</title>
+        <para>
+        </para>
+      </sect3>
+
+    </sect2>
+    <!-- end of creating an action -->
+
+    <sect2 id="usage-organize-action">
+      <title>Organizing actions in menus</title>
+      <para>
+      </para>
+    </sect2>
+
+    <sect2 id="usage-profile">
+      <title>Defining more profiles</title>
+      <para>
+      </para>
+    </sect2>
+
+    <sect2 id="usage-edit">
+      <title>Editing</title>
+      <para>
+      </para>
+    </sect2>
+
+    <sect2 id="usage-save">
+      <title>Saving</title>
+      <para>
+      </para>
+    </sect2>
+
+    <sect2 id="usage-import">
+      <title>Importing</title>
+      <para>
+      </para>
+    </sect2>
+
+    <sect2 id="usage-export">
+      <title>Exporting</title>
       <para>
-        It is also displayed in red color. Red color is used as an indicator that the item
-        is invalid, that is that the item cannot be candidate to be displayed in a
-        &nautilus; context menu because some of its informations are missing or erroneous.
-        Though this newly inserted action has some suitable defaults, it lacks a command
-        to be executed to be considered valid by &appname;
       </para>
-        
+    </sect2>
+    
+      <!--
         The <application>Select Movies or Playlists</application> dialog is displayed.
-  Select the file or files you want to open, then click
- <guibutton>OK</guibutton>.
       </para>
       <para>You can drag a file from another application such as a file manager to the
         <application>
@@ -544,56 +687,11 @@
  the <ulink url="http://projects.gnome.org/totem/#codecs"; type="http"><application>
 &appname;          </application> website</ulink>.
       </para>
-      <tip>
-        <para>You can double-click on a video or an audio file in the <application>Nautilus</application>
-          file manager to open it in the <application>
-&appname;          </application> window.
-        </para>
-      </tip>
-    </sect2>
-    
-    <sect2 id="totem-usage-open-location">
-      <title>To Open a Location</title>
-      <para>To open a file by URI (location), choose
-        <menuchoice>
-          <shortcut>
-            <keycombo>
-              <keycap>Ctrl</keycap>
-              <keycap>L</keycap>
-            </keycombo>
-          </shortcut>
-          <guimenu>Movie</guimenu>
-          <guimenuitem>Open Location</guimenuitem>
-        </menuchoice>. The <application>Open Location</application> dialog is displayed. Use the drop-down
-        combination box to specify the URI you would like to open (it lists URIs which have
-        previously been opened) â?? or type one in directly â?? then click on the <guibutton>Open</guibutton> button.
-      </para>
-      <para>If you have a URI in the clipboard already, it will automatically be pasted into the combination box.</para>
     </sect2>
-    
-    <sect2 id="totem-usage-play">
-      <title>To Play a Movie (DVD or VCD)</title>
-      <para>Insert the disc in the optical device of your computer, then choose
-           <menuchoice>
-          <guimenu>Movie</guimenu>
-          <guimenuitem>Play Disc</guimenuitem>
-        </menuchoice>.</para>
-      <para>To eject a DVD or VCD, choose
-        <menuchoice>
-          <shortcut>
-            <keycombo>
-              <keycap>Ctrl</keycap>
-              <keycap>E</keycap>
-            </keycombo>
-          </shortcut>
-          <guimenu>Movie</guimenu>
-          <guimenuitem>Eject</guimenuitem>
-        </menuchoice>.
-      </para>
       
-    </sect2>
-    <sect2 id="totem-usage-pause">
-      <title>To Pause a Movie or Song</title>
+  Select the file or files you want to open, then click
+ <guibutton>OK</guibutton>.
+
       <para>To pause a movie or song that is playing, click on the
         <inlinemediaobject>
           <imageobject>
@@ -614,146 +712,6 @@
           <guimenuitem>Play / Pause</guimenuitem>
         </menuchoice>. You may also use the <keycap>P</keycap> key to pause or play a movie.
       </para>
-      <para>To resume playing a movie or song, click on the
-        <inlinemediaobject>
-          <imageobject>
-            <imagedata fileref="figures/totem_play_button.png" format="PNG"/>
-          </imageobject>
-          <textobject>
-            <phrase>Shows play button.</phrase>
-          </textobject>
-        </inlinemediaobject> button again, or choose
-        <menuchoice>
-          <shortcut>
-            <keycombo>
-              <keycap>Ctrl</keycap>
-              <keycap>Space</keycap>
-            </keycombo>
-          </shortcut>
-          <guimenu>Movie</guimenu>
-          <guimenuitem>Play / Pause</guimenuitem>
-        </menuchoice>.
-      </para>
-    </sect2>
-    
-    <sect2 id="totem-usage-view-properties">
-      <title>To View Properties of a Movie or Song</title>
-      <para>To view the properties of a movie or song, choose
-        <menuchoice>
-          <guimenu>View</guimenu>
-          <guimenuitem>Sidebar</guimenuitem>
-        </menuchoice> to make the sidebar
-   appear, and choose <guimenu>Properties</guimenu> in the drop-down list at the top of the sidebar.</para>
-    </sect2>
-    
-    <sect2 id="totem-usage-seek">
-      <title>To Seek Through Movies or Songs</title>
-      <para>To seek through movies or songs, you can use the following methods:
-      </para>
-      <variablelist>
-        <varlistentry>
-          <term>To skip forward</term>
-          <listitem>
-            <para>To skip forward through a movie or song, choose
-              <menuchoice>
-                <shortcut>
-                  <keycap>Right</keycap>
-                </shortcut>
-                <guimenu>Go</guimenu>
-                <guimenuitem>Skip Forward</guimenuitem>
-              </menuchoice>.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>To skip backward</term>
-          <listitem>
-            <para>To skip backwards through a movie or song, choose
-              <menuchoice>
-                <shortcut>
-                  <keycap>Left</keycap>
-                </shortcut>
-                <guimenu>Go</guimenu>
-                <guimenuitem>Skip Backwards</guimenuitem>
-              </menuchoice>.
-             </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>To skip to a time</term>
-          <listitem>
-            <para>To skip to a specific elapsed time in the movie or song, choose
-              <menuchoice>
-                <shortcut>
-                  <keycombo>
-                    <keycap>Ctrl</keycap>
-                    <keycap>K</keycap>
-                  </keycombo>
-                </shortcut>
-                <guimenu>Go</guimenu>
-                <guimenuitem>Skip to</guimenuitem>
-              </menuchoice>. The <application>Skip to</application> dialog is displayed. Use the
-              spin box to specify the elapsed time (in seconds) to skip to, then
-              click <guibutton>OK</guibutton>.
-            </para>
-            <para>The spin box also allows more natural language to be used. You can enter a time in the
-            formats &quot;hh:mm:ss&quot;, &quot;mm:ss&quot; or &quot;ss&quot;; where &quot;hh&quot; is the hour, &quot;mm&quot; is the minute and &quot;ss&quot; is the
-            second to skip to.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>To move to the next movie or song</term>
-          <listitem>
-            <para>To move to the next movie or song, choose
-              <menuchoice>
-                <shortcut>
-                  <keycombo>
-                    <keycap>Alt</keycap>
-                    <keycap>Right</keycap>
-                  </keycombo>
-                </shortcut>
-                <guimenu>Go</guimenu>
-                <guimenuitem>Next Chapter/Movie</guimenuitem>
-              </menuchoice> or click on the
-              <inlinemediaobject>
-                <imageobject>
-                  <imagedata fileref="figures/totem_next_button.png" format="PNG"/>
-                </imageobject>
-                <textobject>
-                  <phrase>Shows a seek next button</phrase>
-                </textobject>
-              </inlinemediaobject> button.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>To move to the previous movie or song</term>
-          <listitem>
-            <para>To move to the previous movie or song, choose
-              <menuchoice>
-                <shortcut>
-                  <keycombo>
-                    <keycap>Alt</keycap>
-                    <keycap>Left</keycap>
-                  </keycombo>
-                </shortcut>
-                <guimenu>Go</guimenu>
-                <guimenuitem>Previous Chapter/Movie</guimenuitem>
-              </menuchoice> or click on the
-              <inlinemediaobject>
-                <imageobject>
-                  <imagedata fileref="figures/totem_previous_button.png" format="PNG"/>
-                </imageobject>
-                <textobject>
-                  <phrase>Shows a seek previous button</phrase>
-                </textobject>
-              </inlinemediaobject> button.
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect2>
     
     <sect2 id="totem-usage-change-zoom">
       <title>To Change the Zoom Factor</title>
@@ -795,184 +753,7 @@
           </listitem>
         </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>
-            <guisubmenu>Aspect Ratio</guisubmenu>
-          </menuchoice>.</para>
-      </sect3>
-    </sect2>
-    <sect2 id="totem-usage-adjust-volume">
-      <title>To Adjust the Volume</title>
-      <para>To increase the volume, choose
-        <menuchoice>
-          <shortcut>
-            <keycap>Up</keycap>
-          </shortcut>
-          <guimenu>Sound</guimenu>
-          <guimenuitem>Volume Up</guimenuitem>
-        </menuchoice>.
-        To decrease the volume, choose
-        <menuchoice>
-          <shortcut>
-            <keycap>Down</keycap>
-          </shortcut>
-          <guimenu>Sound</guimenu>
-          <guimenuitem>Volume Down</guimenuitem>
-        </menuchoice>.
-      </para>
-      <para>You can also use the volume button: click on the volume button and choose the volume level with the slider.</para>
-    </sect2>
-    <sect2 id="totem-usage-on-top">
-      <title>To Make the Window Always on Top</title>
-      <para>To make the <application>
-&appname;        </application> window always on top of other application windows,
-        choose
-        <menuchoice>
-          <guimenu>Edit</guimenu>
-          <guimenuitem>Plugins</guimenuitem>
-        </menuchoice>. Select the <guilabel>Always on Top</guilabel> plugin to enable it. The <application>
-&appname;        </application> window will now stay on
-        top of all other windows while a movie is playing, but not while audio or visualizations are playing.
-       </para>
-      <para>To stop the window from always being on top, disable the <guilabel>Always on Top</guilabel> plugin again.
-       See <xref linkend="totem-plugins-always-on-top"/> for more information.</para>
-    </sect2>
-    <sect2 id="totem-usage-show-control">
-      <title>To Show or Hide Controls</title>
-      <para>To show or hide the <application>
-&appname;        </application> window controls, choose
-        <menuchoice>
-          <shortcut>
-            <keycombo>
-              <keycap>Ctrl</keycap>
-              <keycap>H</keycap>
-            </keycombo>
-          </shortcut>
-          <guimenu>View</guimenu>
-          <guimenuitem>Show Controls</guimenuitem>
-        </menuchoice>, or press the <keycap>H</keycap> key.
-        You can also right-click on the <application>
-&appname;        </application> window, then choose
-        <menuchoice>
-          <shortcut>
-            <keycombo>
-              <keycap>Ctrl</keycap>
-              <keycap>H</keycap>
-            </keycombo>
-          </shortcut>
-          <guimenuitem>Show Controls</guimenuitem>
-        </menuchoice> from the popup menu.
-      </para>
-      <para>If the <guilabel>Show Controls</guilabel> option is selected,
-        <application>
-&appname;        </application> will show the menubar, elapsed time slider,
-        seek control buttons, volume slider and statusbar on the window. If
-        the <guilabel>Show Controls</guilabel> option is unselected, the application
-        will hide these controls and show only the display area.
-      </para>
-    </sect2>
-    <sect2 id="totem-usage-playlist">
-      <title>To Manage the Playlist</title>
-      <sect3 id="totem-usage-playlist-show-hide">
-        <title>To Show or Hide the Playlist</title>
-        <para>To show or hide the playlist, choose
-          <menuchoice>
-            <guimenu>View</guimenu>
-            <guimenuitem>Sidebar</guimenuitem>
-          </menuchoice> or click on the <guibutton>Sidebar</guibutton> button, and
-    choose <guimenu>Playlist</guimenu> on the top of
-    the sidebar.</para>
-      </sect3>
-      <sect3 id="totem-usage-playlist-manage">
-        <title>Manage a Playlist</title>
-        <para>You can use the <application>Playlist</application> dialog to do the following:
-          <variablelist>
-            <varlistentry>
-              <term>To add a track or movie</term>
-              <listitem>
-                <para>To add a track or movie to the playlist, click on the <guibutton>Add</guibutton>
-                  button. The <application>Select Movies or Playlists</application> dialog is displayed. Select the file that you
-                  want to add to the playlist, then click <guibutton>Add</guibutton>.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>To remove a track or movie</term>
-              <listitem>
-                <para>To remove a track or movie from the playlist, select the item or items to remove from the
-                  playlist, then click on the <guibutton>Remove</guibutton> button.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>To save the playlist to a file</term>
-              <listitem>
-                <para>To save the playlist to a file, click on the <guibutton>Save Playlist</guibutton>
-                  button. The <application>Save Playlist</application> dialog is displayed; specify
-                  the filename as which you want to save the playlist, and click <guibutton>Save</guibutton>.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>To move a track or movie up the playlist</term>
-              <listitem>
-                <para>To move a track or movie up the playlist, select the item from the
-                  playlist, then click on the <guibutton>Move Up</guibutton> button.
-                </para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>To move a track or movie down the playlist</term>
-              <listitem>
-                <para>To move a track or movie down the playlist, select the item from the
-                  playlist, then click on the <guibutton>Move Down</guibutton> button.
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </para>
-      </sect3>
-      <sect3 id="totem-usage-playlist-repeat">
-        <title>To Select or Unselect Repeat Mode</title>
-        <para>To enable or disable repeat mode, choose
-          <menuchoice>
-            <guimenu>Edit</guimenu>
-            <guimenuitem>Repeat Mode</guimenuitem>
-          </menuchoice>.
-        </para>
-      </sect3>
-      <sect3 id="totem-usage-playlist-shuffle">
-        <title>To Select or Unselect Shuffle Mode</title>
-        <para>To enable or disable shuffle mode, choose
-          <menuchoice>
-            <guimenu>Edit</guimenu>
-            <guimenuitem>Shuffle Mode</guimenuitem>
-          </menuchoice>.
-        </para>
-      </sect3>
-    </sect2>
-    <sect2 id="totem-usage-subtitle">
-      <title>To Choose Subtitles</title>
-      <para>To choose
-   the language of the subtitles, select
-   <menuchoice>
-          <guimenu>View</guimenu>
-          <guisubmenu>Subtitles</guisubmenu>
-        </menuchoice>
-   and choose the subtitle language you want to display.</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, <application>
 &appname;          </application> will choose the same language for the
    subtitles as the one you normally use on your computer.</para>
@@ -983,135 +764,16 @@
    <filename class="extension">sub</filename>, <filename class="extension">srt</filename>, <filename class="extension">smi</filename>,
    <filename class="extension">ssa</filename> or <filename class="extension">ass</filename>.
    </para>
-      <para>If the file containing the subtitles has a different name from the video being played, you can
-   right-click on the video in the playlist and choose <menuchoice>
-          <guimenuitem>Select Text Subtitles</guimenuitem>
-        </menuchoice>
-   from the popup menu to load the correct subtitle file. You may also choose subtitles by choosing
-   <menuchoice>
-          <guimenu>View</guimenu>
-          <guimenuitem>Select Text Subtitles</guimenuitem>
-        </menuchoice>.</para>
-      <para>Using the <guilabel>Subtitle Downloader</guilabel> plugin, you can also download subtitles from the OpenSubtitles service. See
-   <xref linkend="totem-plugins-opensubtitles"/> for more information.</para>
-    </sect2>
-    <sect2 id="totem-usage-take-screenshot">
-      <title>To Take a Screenshot</title>
-      <para>To take a screenshot of the movie or visualization that is playing, choose
-        <menuchoice>
-          <guimenu>Edit</guimenu>
-          <guimenuitem>Take Screenshot</guimenuitem>
-        </menuchoice>. The <application>Save Screenshot</application> dialog is displayed. Choose a location and
- insert the filename as which you want to save the screenshot, then click on the <guibutton>Save</guibutton> button
- to save the screenshot.
-      </para>
-      <tip>
-        <para><application>
-&appname;          </application> will display a preview of the screenshot which is to be saved on the left-hand side of the <application>Save Screenshot</application> dialog.</para>
-      </tip>
-    </sect2>
-    <sect2 id="totem-usage-create-screenshot-gallery">
-      <title>To Create a Screenshot Gallery</title>
-      <para>To create a gallery of screenshots of the movie or visualization that is playing, choose
-        <menuchoice>
-          <guimenu>Edit</guimenu>
-          <guimenuitem>Create Screenshot Gallery</guimenuitem>
-        </menuchoice>. The <application>Save Gallery</application> dialog is displayed. Choose a location and
- insert the filename as which you want to save the gallery image, then click on the <guibutton>Save</guibutton> button
- to save the screenshot.
-      </para>
-      <tip>
-        <para>You may specify the width of the individual screenshots in the gallery using the <guilabel>Screenshot width</guilabel> entry.
-      The default width is 128 pixels.</para>
-        <para>You may also specify the number of screenshots to be put in the gallery. By default, this is calculated based on the length of the movie;
-      however, this may be overridden by deselecting the <guilabel>Calculate the number of screenshots</guilabel> checkbox and entering the new
-      number in the <guilabel>Number of screenshots</guilabel> spin box.</para>
-      </tip>
-    </sect2>
-  </sect1>
-<!-- =========================== Plugins ============================== -->  <sect1 id="totem-plugins">
-    <title>Plugins</title>
-    <para><application>
-&appname;      </application> has many features which are present in the form of plugins � pieces of the software which are only loaded
-      if necessary.</para>
-    <sect2 id="totem-plugins-load">
-      <title>To Enable a Plugin</title>
-      <para>To view the list of installed plugins, choose <menuchoice>
-          <guimenu>Edit</guimenu>
-          <guimenuitem>Plugins</guimenuitem>
-        </menuchoice>. The
-        <application>Configure Plugins</application> dialog is displayed. On the left is a list of all the plugins you have installed, while on the right is
-        a description of the currently selected plugin. Plugins which have options which can be changed will have a sensitive <guibutton>Configure</guibutton>
-        button on the right.</para>
-      <para>To enable a plugin, simply select the checkbox to the left of its name in the plugin list, and the plugin will be loaded immediately. If
-        there is any error loading the plugin, an error dialog will also be displayed immediately.</para>
-      <para>To disable a plugin again, deselect its checkbox. Plugins will remain enabled or disabled as set even when <application>
-&appname;        </application> is
-        closed.</para>
-    </sect2>
-    <sect2 id="totem-plugins-always-on-top">
-      <title>Always on Top</title>
-      <para>When enabled, the <guilabel>Always on Top</guilabel> plugin will force the main <application>
-&appname;        </application> window to be on top of
-        all other windows while a movie is playing, but not while audio or visualizations are playing. To stop the window being on top, disable
-        the plugin again.</para>
-    </sect2>
-    <sect2 id="totem-plugins-coherence">
-      <title>Coherence DLNA/UPnP Client</title>
-      <para>The <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin allows <application>
-&appname;        </application> to play multimedia content from
-        UPnP media servers (such as Coherence servers) on the local network.</para>
+   
       <para>With the <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin enabled, choose
-        <menuchoice>
-          <shortcut>
-            <keycap>F9</keycap>
-          </shortcut>
-          <guimenu>View</guimenu>
-          <guimenuitem>Sidebar</guimenuitem>
-        </menuchoice> or click on the
-        <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Coherence DLNA/UPnP Client</guilabel> from the drop-down list at the
-        top of the sidebar to display the <guilabel>Coherence DLNA/UPnP Client</guilabel> sidebar.</para>
-      <para>The tree view in the sidebar will list the available media servers. Clicking on one will expand it to show the types of media it can serve,
-        and clicking on a media folder will expand it to list the media files available. Double-clicking on a media file will add it to
-        <application>
-&appname;        </application>&apos;s playlist and play it. You may alternatively right-click on a file and choose
-        <menuchoice>
-          <guimenuitem>Play</guimenuitem>
-        </menuchoice> or <menuchoice>
-          <guimenuitem>Enqueue</guimenuitem>
-        </menuchoice> to play the file
-        immediately or add it to the playlist, respectively.</para>
-      <para>If the media server allows it, choosing <menuchoice>
-          <guimenuitem>Delete</guimenuitem>
-        </menuchoice> from a file&apos;s context menu allows you to
-        delete that file from the media server.</para>
-    </sect2>
+
     <sect2 id="totem-plugins-gromit">
       <title>Gromit Annotations</title>
       <para>The <guilabel>Gromit Annotations</guilabel> plugin allows you to draw on top of movies as they are played using
         <ulink url="http://www.home.unix-ag.org/simon/gromit/"; type="http">
           <application>Gromit</application>
         </ulink>. You must have
-        <application>Gromit</application> installed before you can enable the plugin � consult your operating system documentation for
-        information on how to do this.</para>
-      <para>With the plugin enabled, press <keycombo>
-          <keycap>Ctrl</keycap>
-          <keycap>D</keycap>
-        </keycombo> to toggle <application>Gromit</application>
-        on or off. When <application>Gromit</application> is enabled, your pointer will change to a crosshair. To draw on the screen, hold down your
-        mouse button and drag your pointer around, before releasing your mouse button. Press <keycombo>
-          <keycap>Ctrl</keycap>
-          <keycap>D</keycap>
-        </keycombo>
-        again to toggle <application>Gromit</application> off.</para>
-      <para>To clear the screen of annotations, press <keycombo>
-          <keycap>Ctrl</keycap>
-          <keycap>E</keycap>
-        </keycombo>, or close
-        <application>
-&appname;        </application>.</para>
-    </sect2>
-    <sect2 id="totem-plugins-jamendo">
+
       <title>Jamendo</title>
       <para>The <guilabel>Jamendo</guilabel> plugin allows you to listen to the collection of Creative Commons-licensed music on the
         <ulink url="http://www.jamendo.com/en/"; type="http">Jamendo</ulink> service.</para>
@@ -1151,32 +813,7 @@
           Double-clicking an individual track will replace your playlist with just that track.</para>
       </sect3>
       <sect3 id="totem-plugins-jamendo-popular">
-        <title>Popular Albums and Latest Releases</title>
-        <para>Viewing the <guilabel>Popular</guilabel> page in the <guilabel>Jamendo</guilabel> sidebar will load a list of the most popular albums
-          on Jamendo at the moment, which can be played as with search results. Viewing the <guilabel>Latest Releases</guilabel> page will likewise
-          load a list of the latest albums released on Jamendo.</para>
-      </sect3>
-    </sect2>
-    <sect2 id="totem-plugins-tracker">
-      <title>Local Search</title>
-      <para>The <guilabel>Local Search</guilabel> plugin allows you to search for playable movies and audio files on your computer from within
-        <application>
-&appname;        </application>. With the plugin enabled, choose
-        <menuchoice>
-          <shortcut>
-            <keycap>F9</keycap>
-          </shortcut>
-          <guimenu>View</guimenu>
-          <guimenuitem>Sidebar</guimenuitem>
-        </menuchoice> or click on the
-        <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Local Search</guilabel> from the drop-down list at the top of the
-        sidebar to display the <guilabel>Local Search</guilabel> sidebar.</para>
-      <para>To perform a search, enter your search terms in the search entry at the top of the sidebar and click <guibutton>Find</guibutton>. Your
-        search terms may include wildcards such as <literal>*</literal>, which will match any character. For example, the search
-        <userinput>*.mpg</userinput> will find all movies with the <filename class="extension">.mpg</filename> file extension.</para>
-      <para>Search results may be browsed using the <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons at the bottom of the
-        sidebar, and you may jump to a specific results page by entering its number in the spin box.</para>
-    </sect2>
+
     <sect2 id="totem-plugins-publish">
       <title>Publish Playlist</title>
       <para>The <guilabel>Publish Playlist</guilabel> plugin allows you to publish playlists on your local network to allow other computers to access
@@ -1196,296 +833,115 @@
 &appname;                  </application>.</para>
               </listitem>
             </varlistentry>
-            <varlistentry>
-              <term>
-                <literal>%h</literal>
-              </term>
-              <listitem>
-                <para>Replaced with your computer&apos;s host name.</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>
-                <literal>%u</literal>
-              </term>
-              <listitem>
-                <para>Replaced with your username.</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>
-                <literal>%U</literal>
-              </term>
-              <listitem>
-                <para>Replaced with your real name.</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>
-                <literal>%%</literal>
-              </term>
-              <listitem>
-                <para>Replaced with a literal percent sign.</para>
-              </listitem>
-            </varlistentry>
           </variablelist>
  </para>
-        <para>You can also select the <guilabel>Use encrypted transport protocol</guilabel> checkbox if you wish to encrypt the shared playlists when
-   they&apos;re transmitted over the network.</para>
-        <para>Once you&apos;re done, click <guibutton>Close</guibutton>.</para>
-      </sect3>
-      <sect3 id="totem-plugins-publish-publishing">
-        <title>To Publish Playlists</title>
-        <para>With the plugin enabled, you do not need to explicitly publish playlists; they are automatically made available on the network as
-          a Zeroconf website.</para>
-      </sect3>
-      <sect3 id="totem-plugins-publish-neighborhood">
-        <title>To Browse your Neighborhood</title>
-        <para>To view the shared playlists of others on your network, select <guilabel>Neighborhood</guilabel> from the drop-down list at the top of the
-          sidebar. If any playlists have been published on the network, they will be listed here. Double-click on a playlist to load and play it on
-          your computer.</para>
-      </sect3>
+      -->
+
+  </sect1>
+  <!-- end of sect1 - using nautils-actions-config-tool -->
+
+<!-- ========================= Preferences ============================ -->
+
+  <sect1 id="prefs">
+    <title>Preferences</title>
+    <para>
+    </para>
+
+    <sect2 id="prefs-runtime">
+      <title>Runtime preferences</title>
+      <para>
+      </para>
     </sect2>
-    <sect2 id="totem-plugins-opensubtitles">
-      <title>Subtitle Downloader</title>
-      <para>The <guilabel>Subtitle Downloader</guilabel> plugin allows you to find and download subtitle files from the
-        <ulink url="http://www.opensubtitles.org/en"; type="http">OpenSubtitles</ulink> service.</para>
-      <para>Subtitles can only be downloaded for local movies; not audio files, DVDs, DVB streams, VCDs or HTTP streams. To search for subtitles for
-        the currently playing movie, choose <menuchoice>
-          <guimenu>View</guimenu>
-          <guimenuitem>Download Movie Subtitles</guimenuitem>
-        </menuchoice>, which
-        will display the <application>Download Movie Subtitles</application> dialog.</para>
-      <para>Select the language in which you wish to have your subtitles from the drop-down list at the top of the dialog, then click on the
-        <guibutton>Find</guibutton> button to search for subtitles for the current movie. Subtitles are found on the basis of the movie&apos;s content,
-        rather than its filename or tags.</para>
-      <para>Search results are listed in the tree view in the middle of the dialog. Currently, subtitles can only be used with a movie by
-        <emphasis>reloading</emphasis> the movie with the subtitles, so after selecting the subtitle file you wish to download, click on the
-        <guibutton>Play with Subtitle</guibutton> button to download the subtitles and reload the movie.</para>
-      <note>
-        <para>Downloaded subtitle files are cached (in <filename>~/.cache/totem/subtitles</filename>, by default) so that they do not need to be downloaded
-        again when playing the movie again. When downloading new subtitles for a movie, any previously downloaded subtitles for that movie are deleted.</para>
-      </note>
+
+    <sect2 id="prefs-ui">
+      <title>UI preferences</title>
+      <para>
+      </para>
     </sect2>
-    <sect2 id="totem-plugins-thumbnail">
-      <title>Thumbnail</title>
-      <para>The <guilabel>Thumbnail</guilabel> plugin sets <application>
-&appname;        </application>&apos;s main window icon to a thumbnail of the current movie,
-        and updates the icon when new movies are loaded.</para>
-      <note>
-        <para>If a thumbnail doesn&apos;t exist for the current movie (or if you&apos;re playing an audio file), the main window icon will be reset to the
-        <application>
-&appname;          </application> logo.</para>
-      </note>
+
+    <sect2 id="prefs-import">
+      <title>Import preferences</title>
+      <para>
+      </para>
     </sect2>
-    <sect2 id="totem-plugins-brasero">
-      <title>Video Disc Recorder</title>
-      <para>The <guilabel>Video Disc Recorder</guilabel> plugin allows you to burn the current playlist to a DVD or VCD using <application>Brasero</application>.</para>
-      <para>To burn the current playlist, choose <menuchoice>
-          <guimenu>Movie</guimenu>
-          <guimenuitem>Create Video Disc</guimenuitem>
-        </menuchoice>.
-        A <application>Brasero</application> dialog will be displayed, giving options for converting the movies to the appropriate format and burning them to disc. For more
-        information, see the <ulink url="ghelp:brasero?brasero-new-project-video" type="help">Brasero documentation</ulink>.</para>
+
+    <sect2 id="prefs-export">
+      <title>Export preferences</title>
+      <para>
+      </para>
     </sect2>
-    <sect2 id="totem-plugins-youtube">
-      <title>YouTube Browser</title>
-      <para>The <guilabel>YouTube Browser</guilabel> plugin allows you to search and browse
-        <ulink url="http://www.youtube.com/"; type="http">YouTube</ulink>, and play YouTube videos directly in
-        <application>
-&appname;        </application>. With the plugin enabled, choose
-        <menuchoice>
-          <shortcut>
-            <keycap>F9</keycap>
-          </shortcut>
-          <guimenu>View</guimenu>
-          <guimenuitem>Sidebar</guimenuitem>
-        </menuchoice> or click on the
-        <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>YouTube</guilabel> from the drop-down list at the top of the
-        sidebar to display the <guilabel>YouTube</guilabel> sidebar.</para>
-      <para>To search for a YouTube video, enter your search terms in the entry at the top of the sidebar, then click <guibutton>Find</guibutton>.
-        The search results will be listed in the tree view below. More results will be loaded automatically as you scroll down the list.</para>
-      <para>To play a video, double-click it in the results list, or choose <menuchoice>
-          <guimenuitem>Add to Playlist</guimenuitem>
-        </menuchoice> from
-        its context menu. When a video is played, a list of related videos will automatically be loaded in the <guilabel>Related Videos</guilabel>
-        page of the <guilabel>YouTube</guilabel> sidebar.</para>
-      <para>YouTube videos can be opened in a web browser by choosing <menuchoice>
-          <guimenuitem>Open in Web Browser</guimenuitem>
-        </menuchoice> from
-        their context menu. This will open the video in its original location on the YouTube website.</para>
+
+    <sect2 id="prefs-schemes">
+      <title>Schemes preferences</title>
+      <para>
+      </para>
     </sect2>
-    <sect2 id="totem-plugins-dbus-service">
-      <title>D-Bus Service</title>
-      <para>The <guilabel>D-Bus Service</guilabel> plugin broadcasts notifications of which track is playing in <application>
-&appname;        </application>
-        on the D-Bus session bus. Applications such as <application>Gajim</application> can listen for such notifications and respond accordingly by,
-        for example, updating your instant messaging status message to display the video currently being played in
-        <application>
-&appname;        </application>.</para>
+
+    <sect2 id="prefs-providers">
+      <title>I/O providers preferences</title>
+      <para>
+      </para>
     </sect2>
+
   </sect1>
-<!-- ========================= Usage ================================== --><!-- Use this section to describe how to customize the application. -->  <sect1 id="totem-prefs">
-    <title>Preferences</title>
-    <para>To modify the preferences of <application>
-&appname;      </application>, choose
-      <menuchoice>
-        <guimenu>Edit</guimenu>
-        <guimenuitem>Preferences</guimenuitem>
-      </menuchoice>.</para>
-    <sect2 id="totem-prefs-general">
-      <title>General</title>
-      <variablelist>
-        <varlistentry>
-          <term>Networking</term>
-          <listitem>
-            <para>Select network connection speed from the <guilabel>Connection speed</guilabel>
-              drop-down list.
-            </para>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Text Subtitles</term>
-          <listitem>
-            <itemizedlist>
-              <listitem>
-                <para><guilabel>Automatically load subtitle files</guilabel>: select this option to automatically load any subtitle
-        files with the same filename as a movie when the movie is loaded.</para>
-              </listitem>
-              <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 change the
-    encoding used to display subtitles.</para>
-              </listitem>
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect2>
-    <sect2 id="totem-prefs-display">
-      <title>Display</title>
-      <variablelist>
-        <varlistentry>
-          <term>Display</term>
-          <listitem>
-            <itemizedlist>
-              <listitem>
-                <para>Select the resize option if you want <application>
-&appname;                  </application>
-                  to automatically resize the window to the size of the video when a new video is loaded.
-                </para>
-              </listitem>
-              <listitem>
-                <para>Select the screensaver option if you want to allow the screensaver to activate when
-                  playing audio files. Some monitors with integrated speakers may stop playing music when the screensaver is activated.</para>
-              </listitem>
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Visual Effects</term>
-          <listitem>
-            <itemizedlist>
-              <listitem>
-                <para><guilabel>Visual</guilabel>: select this option to show visual effects
-                  while an audio file is playing.
-                </para>
-              </listitem>
-              <listitem>
-                <para><guilabel>Type of visualization</guilabel>: select type of visualization from the
-                  drop-down list.
-                </para>
-              </listitem>
-              <listitem>
-                <para><guilabel>Visualization size</guilabel>: select visualization size from the
-                  drop-down list.
-                </para>
-              </listitem>
-            </itemizedlist>
-          </listitem>
-        </varlistentry>
-        <varlistentry>
-          <term>Color balance</term>
-          <listitem>
-            <itemizedlist>
-              <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>
-              <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>
-            <tip>
-              <para>You may use the <guilabel>Reset to Defaults</guilabel> button to reset the color balance controls to their
-     default positions.</para>
-            </tip>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect2>
-    <sect2 id="totem-prefs-audio">
-      <title>Audio</title>
-      <variablelist>
-        <varlistentry>
-          <term>Audio Output</term>
-          <listitem>
-            <para>Select audio output type from the <guilabel>Audio output type</guilabel>
-              drop-down list.
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </sect2>
+  <!-- end of sect1 - preferences -->
+
+<!-- ============================ Misc ================================ -->
+<!-- informations I do not know where to put -->
+
+  <sect1 id="misc">
+    <title>Miscellaneous informations</title>
+    <para>
+    </para>
+
   </sect1>
-<!-- ============= Bugs ================================== --><!-- This section is optional and is commented out by default.
+  <!-- end of sect1 - misc -->
+
+<!-- ============================ 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
+     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
+  <sect1 id="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="totem-about">
-    <title>About <application>
-&appname;      </application></title>
-    <para><application>
-&appname;      </application> is written by
-      Bastien Nocera (<email>hadess hadess net</email>),
-      Julien Moutte (<email>julien moutte net</email>) for the GStreamer backend,
-      and Guenter Bartsch (<email>guenter users sourceforge net</email>).
-      To find more information about <application>
-&appname;      </application>, please visit the
-      <ulink url="http://projects.gnome.org/totem/"; type="http"><application>
-&appname;        </application> website</ulink>.
+      Alternatively, you can put this information in the title page.
+  -->
+
+  <sect1 id="about">
+    <title>About &appname;</title>
+    <para>
+      The first version of &prodname; was initially written by
+      Frederic Ruaudel (<email>grumz grumz net</email>) and
+      Rodrigo Moya (<email>rodrigo gnome-db org</email>).
+      It has been thoroughly improved and is currently maintained by
+      Pierre Wieser (<email>pwieser trychlos org</email>).
+    </para>
+    <para>
+      To find more information about &prodname;, please visit the
+      <ulink url="http://www.nautilus-actions.org/"; type="http">
+      &prodname; website</ulink>.
     </para>
     <para>
-      To report a bug or make a suggestion regarding the <application>
-&appname;      </application> application or
-      this manual, follow the directions in the
-      <ulink url="ghelp:user-guide#feedback" type="help">GNOME Feedback Page</ulink>.
+      To report a bug or make a suggestion regarding the &prodname;,
+      the &appname; or this manual, follow the directions in the
+      <ulink url="ghelp:user-guide#feedback" type="help">GNOME Feedback Page</ulink>,
+      or you may prefer, at your convenience, directly open a bug
+      or a request for enhancement to
+      <ulink
+       url="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions";
+       type="http">Bugzilla website</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 copy of this license can be found at this
-      <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
-      COPYING included with the source code of this program. </para>
   </sect1>
 </article>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]