[vinagre] Add using page and minor updates to help

[David King <davidk src gnome org>]

commit a865622bf97c3c3f15427aa053ba8d38066c60ed
Author: Ekaterina Gerasimova <kittykat3756 googlemail com>
Date:   Sun Apr 17 00:28:01 2011 +0200

    Add using page and minor updates to help
    
    Added help file for common Vinagre features. Arranged pages so that they
    appear in a logical order on the index page. Fixed typo in bookmarks
    description.

 help/C/bookmarks.page   |    3 +-
 help/C/connect.page     |    5 +++-
 help/C/preferences.page |    1 +
 help/C/using.page       |   52 +++++++++++++++++++++++++++++++++++++++++++++++
 help/C/using.page.stub  |   35 -------------------------------
 help/Makefile.am        |    3 +-
 6 files changed, 61 insertions(+), 38 deletions(-)
---
diff --git a/help/C/bookmarks.page b/help/C/bookmarks.page
index ca31afb..9f517a1 100755
--- a/help/C/bookmarks.page
+++ b/help/C/bookmarks.page
@@ -5,7 +5,8 @@
 
   <info>
     <link type="guide" xref="index"/>
-    <desc>Using bookmarks Vinagre.</desc>
+    <title type="sort">3</title>
+    <desc>Using bookmarks in Vinagre.</desc>
     <credit type="author">
       <name>Ekaterina Gerasimova</name>
       <email>kittykat3756 googlemail com</email>
diff --git a/help/C/connect.page b/help/C/connect.page
index 8bbe121..6c7cc51 100755
--- a/help/C/connect.page
+++ b/help/C/connect.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
       xmlns:e="http://projectmallard.org/experimental/";
       type="guide"
-      id="using">
+      id="connect">
 
   <info>
     <link type="guide" xref="index"/>
     <link type="seealso" xref="bookmarks"/>
+    <title type="sort">1</title>
     <desc>Learn about connecting to another computer with Vinagre.</desc>
     <credit type="author">
       <name>Ekaterina Gerasimova</name>
@@ -45,6 +46,8 @@
 </note>
 </section>
 
+<!-- TODO: "Reverse Connections..." -->
+
 <section id="close">
 <title>Closing a connection</title>
 <p>To close a connection, choose <guiseq><gui>Machine</gui><gui>Close</gui></guiseq>.</p>
diff --git a/help/C/preferences.page b/help/C/preferences.page
index c7976ff..0c636a5 100755
--- a/help/C/preferences.page
+++ b/help/C/preferences.page
@@ -5,6 +5,7 @@
 
   <info>
     <link type="guide" xref="index"/>
+    <title type="sort">4</title>
     <desc>Configuration options in Vinagre.</desc>
     <credit type="author">
       <name>Ekaterina Gerasimova</name>
diff --git a/help/C/using.page b/help/C/using.page
new file mode 100644
index 0000000..d543bb3
--- /dev/null
+++ b/help/C/using.page
@@ -0,0 +1,52 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="guide"
+      id="using">
+
+  <info>
+    <link type="guide" xref="index"/>
+    <link type="seealso" xref="bookmarks"/>
+    <title type="sort">2</title>
+    <desc>Features for working with remote desktops.</desc>
+    <credit type="author">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 googlemail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+<title>Using Vinagre</title>
+
+<section id="fullscreen">
+<title>Using Fullscreen mode</title>
+<p>Choose <guiseq><gui>View</gui><gui>Fullscreen</gui></guiseq>, or press corresponding toolbar button, to view the display area in Fullscreen mode.</p>
+<note>
+<p>While in Fullscreen mode, move the mouse to the centre-top of the screen to display a hidden toolbar, which has a <gui>Leave Fullscreen</gui> button, <gui>Disconnect</gui> and other options.</p>
+</note>
+</section>
+
+<section id="screenshot">
+<title>Taking a screenshot</title>
+<p>Choose <guiseq><gui>Remote</gui><gui>Take screenshot</gui></guiseq>, or press the <gui>Take Screenshot</gui> button in the toolbar, to take a screenshot of the current remote desktop. The <gui>Save Screenshot</gui> dialog is displayed, click the <gui>Save</gui> button to save the screenshot.</p>
+</section>
+
+<section id="scaling">
+<title>Scaling a remote desktop</title>
+<p>Choose <guiseq><gui>View</gui><gui>Scaling</gui></guiseq>, or press the <gui>Scaling</gui> toolbar button, to scale the remote desktop to the current display area size.</p>
+<note>
+<p>You can constrain the aspect ratio of the remote desktop inside the display area by selecting <guiseq><gui>View</gui><gui>Keep Aspect Ratio</gui></guiseq>, or deselect the option to stretch the remote desktop to fill the available space.</p>
+</note>
+</section>
+
+<section id="view-only">
+<title>Using view only mode</title>
+<p>Some protocols allow you to enable a <gui>View Only</gui> mode. Choose <guiseq><gui>View</gui><gui>View Only</gui></guiseq> or press the corresponding toolbar button to enable this mode.</p>
+</section>
+
+<section id="ctrl-alt-delete">
+<title>Sending <keyseq><key>Ctrl</key><key>Alt</key><key>Delete</key></keyseq></title>
+<p><keyseq><key>Ctrl</key><key>Alt</key><key>Delete</key></keyseq> is the only key combination which will not be automatically sent to the remote desktop. Choose <guiseq><gui>Remote</gui><gui>Send Ctrl-Alt-Delete</gui></guiseq>, or use the corresponding toolbar button, to send this key combination.</p>
+</section>
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 16e59f1..6d47f3d 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -15,4 +15,5 @@ DOC_PAGES = \
 	bookmarks.page \
 	connect.page \
 	index.page \
-	preferences.page
+	preferences.page \
+	using.page