[vinagre] Review help for 3.8
- From: Ekaterina Gerasimova <egerasimov src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [vinagre] Review help for 3.8
- Date: Sat, 23 Mar 2013 21:52:46 +0000 (UTC)
commit 2a83a448aa426bafbc308c9bd43074a9d0487274
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date: Sat Mar 16 23:06:01 2013 +0000
Review help for 3.8
Improve wording and remove screenshots as they are difficult to
translate. Rename recerse-connections to connect-reverse to be
consistent with the naming of other connection related pages.
help/C/connect-file.page | 22 ++++++---
...verse-connections.page => connect-reverse.page} | 46 +++++++++----------
help/C/connect.page | 45 +++++++++----------
help/C/figures/vinagre-auth-needed.png | Bin 11167 -> 0 bytes
help/C/figures/vinagre-connect-dialog.png | Bin 31411 -> 0 bytes
help/C/figures/vinagre-connection-closed.png | Bin 9639 -> 0 bytes
help/C/figures/vinagre-fullscreen.png | Bin 465595 -> 0 bytes
help/C/figures/vinagre-no-scaling.png | Bin 315905 -> 0 bytes
help/C/figures/vinagre-reverse-connections.png | Bin 35162 -> 0 bytes
help/C/figures/vinagre-scaling.png | Bin 314163 -> 0 bytes
help/C/fullscreen.page | 22 +++++----
help/C/introduction.page | 26 ++++++-----
help/C/keyboard-shortcuts.page | 25 ++++++----
help/C/scaling.page | 29 ++++++-------
help/C/take-screenshot.page | 27 +++++++----
help/C/view-only.page | 16 +++++--
help/Makefile.am | 11 +----
17 files changed, 143 insertions(+), 126 deletions(-)
---
diff --git a/help/C/connect-file.page b/help/C/connect-file.page
index 2d488c7..88df105 100644
--- a/help/C/connect-file.page
+++ b/help/C/connect-file.page
@@ -6,36 +6,42 @@
<link type="guide" xref="index#connections"/>
<link type="seealso" xref="connect"/>
<title type="sort">2</title>
- <desc>Use a remote connection file to connect to a remote machine.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Use a remote connection file to connect to a remote machine.</desc>
</info>
- <title>Connect with a .vnc file</title>
+ <title>Connect using a <file>.vnc</file> file</title>
- <p>Some hosts distribute remote connection files (generally ending with
- suffix <file>.vnc</file>) instead of using a host address and port.</p>
+ <p>Some hosts distribute <em>remote connection files</em>, that generally end
+ with the suffix <file>.vnc</file>, instead of using a host address and
+ port.</p>
<steps>
<item>
- <p>Choose <guiseq><gui>Remote</gui> <gui>Open</gui></guiseq>.</p>
+ <p>Select <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Open</gui></guiseq>.</p>
</item>
<item>
<p>Select the file you want to open.</p>
</item>
<item>
- <p>Click the <gui>Open</gui> button.</p>
+ <p>Click the <gui style="button">Open</gui> button.</p>
</item>
</steps>
<note style="tip">
- <p>You can also double-click on a remote connection file in
- <app>Nautilus</app> to open it with <app>Vinagre</app>.</p>
+ <p>You can also open a remote connection file from <app>Files</app>.</p>
</note>
</page>
diff --git a/help/C/reverse-connections.page b/help/C/connect-reverse.page
similarity index 56%
rename from help/C/reverse-connections.page
rename to help/C/connect-reverse.page
index 84f19a5..4b133e6 100644
--- a/help/C/reverse-connections.page
+++ b/help/C/connect-reverse.page
@@ -1,60 +1,59 @@
<page xmlns="http://projectmallard.org/1.0/";
type="guide"
- id="reverse-connections">
+ id="connect-reverse">
<info>
<link type="guide" xref="index#connections"/>
<link type="seealso" xref="connect"/>
<title type="sort">3</title>
- <desc>Connect to computers not on your local network: bypassing firewall
- restrictions on remote host.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Connect to computers not on your local network: bypassing firewall restrictions on remote
host.</desc>
</info>
- <title>Reverse Connections…</title>
+ <title><gui>Reverse Connections…</gui></title>
<p>A reverse connection is usually used to bypass firewall restrictions on
open ports. A firewall usually blocks open ports, but does not block outgoing
- traffic. In a normal forward connection, a client connects to a server through
- the server's open port, but in the case of a reverse connection, the client
- opens the port that the server connects to.</p>
+ traffic. In a normal forward connection, a client connects to an open port on
+ the server. However, in the case of a reverse connection, the client opens
+ a port for the server to connect to.</p>
<section id="enable-reverse-connections">
<title>Enabling reverse connections</title>
<steps>
<item>
- <p>Open <guiseq><gui>Remote</gui><gui>Reverse Connections...</gui>
- </guiseq>.</p>
+ <p>Select <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Reverse Connections…</gui></guiseq>.</p>
</item>
<item>
- <p>Select <gui>Enable Reverse Connections</gui>.</p>
+ <p>Check <gui>Enable Reverse Connections</gui>.</p>
</item>
</steps>
-<figure>
- <title>Reverse Connections dialog</title>
- <media type="image" mime="image/png" src="figures/vinagre-reverse-connections.png"/>
-</figure>
-
</section>
<section id="accessing-behind-firewall">
<title>Access a computer behind a firewall</title>
- <p>The remote computer needs to connect to your machine using your IP
- address and port number, which are in the <gui>Reverse Connections...</gui>
- dialog, under <gui>Connectivity</gui>.</p>
+ <p>The remote machine needs to connect to your machine using your <em>IP
+ address</em> and port number, which can be found in the
+ <gui>Reverse Connections…</gui> dialog, under <gui>Connectivity</gui>.</p>
<note>
<p>Currently, <app>Vino</app>, the GNOME VNC server, does not support
- reverse connections (also known as "listen mode"). Some other
+ reverse connections which are also known as "listen mode". Some other
applications, such as <app>UltraVNC</app>, <app>RealVNC</app> and
<app>TightVNC</app>, do have support for reverse connections.</p>
</note>
@@ -62,11 +61,10 @@
<p>Once the remote computer connects to your machine, <app>Vinagre</app>
will establish the reverse connection.</p>
- <note>
- <p>When connecting to a machine which is not on your local network, you
- will need to provide your externally visible IP address and port number to
- the remote server.</p>
- </note>
+ <p>When connecting to a machine which is not on your local network, you
+ will need to provide your externally visible IP address and port number to
+ the remote server.</p>
+
</section>
</page>
diff --git a/help/C/connect.page b/help/C/connect.page
index f9134c7..689daca 100644
--- a/help/C/connect.page
+++ b/help/C/connect.page
@@ -5,14 +5,19 @@
<info>
<link type="guide" xref="index#connections"/>
<title type="sort">1</title>
- <desc>Establish a connection to another computer on your local network.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Connect to another computer on your local network.</desc>
</info>
<title>Establish a connection</title>
@@ -22,51 +27,45 @@
<steps>
<item>
- <p>Choose <guiseq><gui>Remote</gui><gui>Connect</gui></guiseq>.</p>
- <figure>
- <title>Connect dialog</title>
- <media type="image" mime="image/png" src="figures/vinagre-connect-dialog.png"/>
- </figure>
+ <p>Select <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Connect</gui></guiseq>.</p>
</item>
<item>
<p>Choose the <gui>Protocol</gui> and the <gui>Host</gui> for the
connection.</p>
<note>
<p>Some protocols allow you to see all available computers on your
- local network by clicking the <gui>Find</gui> button. Without
- <app>Avahi</app> support, this button will not be displayed.</p>
+ local network by clicking the <gui style="button">Find</gui> button.
+ This buttons will not be displayed if you do not have <app>Avahi</app>
+ support.</p>
</note>
</item>
<item>
<p>Select the options which you want enabled when the connection is
- made. Options will vary depending on the protocol you use.</p>
+ made. Options will vary depending on the protocol that you use.</p>
</item>
<item>
- <p>Click the <gui>Connect</gui> button.</p>
- <note>
- <p>At this point, the remote desktop may need to confirm the
- connection. If this is the case, the viewer may remain black until the
- connection is confirmed.</p>
- </note>
+ <p>Click the <gui style="button">Connect</gui> button.</p>
+ <p>At this point, the remote desktop may need to confirm the connection.
+ If this is the case, the viewer may remain black until the connection is
+ confirmed.</p>
<note>
<p>Some computers may require a secure connection: an authentication
dialog will be displayed, asking for the credentials. The type of
- credentials depend on the remote host, it may be a password and a
+ credentials depend on the remote host; it may be a password and a
username. If you select <gui>Remember this credential</gui>,
<app>Vinagre</app> will store the information using
<app>GNOME Keyring</app>.</p>
</note>
- <figure>
- <title>Authentication dialog</title>
- <media type="image" mime="image/png" src="figures/vinagre-auth-needed.png"/>
- </figure>
</item>
</steps>
<p>If the connection has been used previously, you can also access it
- through <guiseq><gui>Remote</gui><gui>Recent Connections</gui></guiseq>.</p>
+ through <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Recent Connections</gui></guiseq>.</p>
- <p>To close a connection, choose <guiseq><gui>Remote</gui>
- <gui>Close</gui></guiseq> or click the <gui>Close</gui> button.</p>
+ <p>To close a connection, choose <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Close</gui></guiseq> or click the
+ <gui style="button">Close</gui> button.</p>
</page>
diff --git a/help/C/fullscreen.page b/help/C/fullscreen.page
index e53843e..434e947 100644
--- a/help/C/fullscreen.page
+++ b/help/C/fullscreen.page
@@ -4,14 +4,19 @@
<info>
<link type="guide" xref="index#options"/>
- <desc>View the remote desktop in fullscreen mode.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>View the remote desktop in fullscreen mode.</desc>
</info>
<title>Fullscreen mode</title>
@@ -21,21 +26,18 @@
<steps>
<item>
- <p>Choose <guiseq><gui>View</gui><gui>Fullscreen</gui></guiseq>, or press
- the corresponding toolbar button, to view the display area in fullscreen
+ <p>Choose <guiseq><gui style="menu">View</gui>
+ <gui style="menuitem">Fullscreen</gui></guiseq>, or press the
+ corresponding toolbar button, to view the display area in fullscreen
mode.</p>
</item>
</steps>
<note>
<p>While in fullscreen mode, move the mouse to the top-center of the screen
- to display a hidden toolbar, which has a <gui>Leave Fullscreen</gui> button,
- <gui>Disconnect</gui> and other options.</p>
+ to display a hidden toolbar, which has
+ <gui style="button">Leave Fullscreen</gui>,
+ <gui style="button">Disconnect</gui> and other buttons.</p>
</note>
- <figure>
- <title>Fullscreen mode with overlay toolbar</title>
- <media type="image" mime="image/png" src="figures/vinagre-fullscreen.png"/>
- </figure>
-
</page>
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 0d922d3..c96a826 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -4,36 +4,40 @@
<info>
<link type="guide" xref="index"/>
- <desc>Introduction to the <app>Vinagre</app> remote desktop viewer.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Introduction to the <app>Vinagre</app> remote desktop viewer.</desc>
</info>
<title>Introduction</title>
- <p><app>Vinagre</app> is a remote desktop viewer application for the GNOME
- desktop which uses Virtual Network Computing (VNC), and other
- protocols, to remotely control another computer.</p>
-
- <p><app>Vinagre</app> can be used to control another computer and interact
- with its desktop.</p>
+ <p><app>Vinagre</app> is a remote desktop viewer application for GNOME for
+ accessing other machines using Virtual Network Computing (VNC) and other
+ protocols. It can be used to control and interact with another computer or to
+ just view the desktop.</p>
<p><app>Vinagre</app> provides the following features:</p>
<list>
<item><p>connect to several machines at the same time</p></item>
- <item><p>store recent connections and allows them to be bookmarked</p>
- </item>
- <item><p>browse local network for machines</p></item>
+ <item><p>store recent connections and bookmark them</p></item>
+ <item><p>browse the local network for other machines</p></item>
</list>
<figure>
<title>Vinagre in action</title>
- <media type="image" mime="image/png" src="figures/vinagre-connected.png"/>
+ <media type="image" mime="image/png" src="figures/vinagre-connected.png" width="825">
+ <p>Vinagre running in GNOME 3, connected to a machine running GNOME 2</p>
+ </media>
</figure>
</page>
diff --git a/help/C/keyboard-shortcuts.page b/help/C/keyboard-shortcuts.page
index d67c647..b74db85 100644
--- a/help/C/keyboard-shortcuts.page
+++ b/help/C/keyboard-shortcuts.page
@@ -4,37 +4,42 @@
<info>
<link type="guide" xref="index#options"/>
- <revision pkgversion="3.4" date="2011-12-26" status="review"/>
- <desc>Disable the sending of keyboard shortcuts to the remote machine.</desc>
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Disable the sending of keyboard shortcuts to the remote machine.</desc>
</info>
<title>Keyboard shortcuts</title>
- <p>You can enable or disable keyboard shortcuts by clicking
- <guiseq><gui>View</gui><gui>Keyboard shortcuts</gui></guiseq>.</p>
+ <p>You can enable or disable keyboard shortcuts by selecting
+ <guiseq><gui style="menu">View</gui>
+ <gui style="menuitem">Keyboard shortcuts</gui></guiseq>.</p>
<p>Enabling this option allows the use of keyboard shortcuts (like
- <keyseq><key>Ctrl</key><key>D</key></keyseq>), menu accelerators and
- mnemonics (such as <keyseq><key>Alt</key><key>M</key></keyseq>), with
+ <keyseq><key>Ctrl</key><key>N</key></keyseq>), menu accelerators (such as
+ <keyseq><key>Alt</key><key>M</key></keyseq>) and mnemonics, with
<app>Vinagre</app>. This means that <app>Vinagre</app> will catch those key
combinations instead of sending them to the remote machine. This option is
disabled by default because most of the time, you will be interacting with
- the computer which you have connected to.</p>
+ the computer to which you are connected.</p>
<note>
<p>When the <gui>Keyboard shortcuts</gui> option is disabled,
- <keyseq><key>Ctrl</key><key>Alt</key> <key>Delete</key></keyseq> is the
+ <keyseq><key>Ctrl</key><key>Alt</key><key>Delete</key></keyseq> is the
only key combination which will not be 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>
+ <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Send Ctrl-Alt-Delete</gui></guiseq>, or use the
+ corresponding toolbar button, to send this key combination.</p>
</note>
</page>
diff --git a/help/C/scaling.page b/help/C/scaling.page
index f88431f..4d05606 100644
--- a/help/C/scaling.page
+++ b/help/C/scaling.page
@@ -4,14 +4,19 @@
<info>
<link type="guide" xref="index#options"/>
- <desc>Scale the remote desktop to fit the display area.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Scale the remote desktop to fit the display area.</desc>
</info>
<title>Scale the remote desktop</title>
@@ -21,14 +26,16 @@
<steps>
<item>
- <p>Choose <guiseq><gui>View</gui><gui>Scaling</gui></guiseq>, or click the
+ <p>Select <guiseq><gui style="menu">View</gui>
+ <gui style="menuitem">Scaling</gui></guiseq>, or click the
<gui>Scaling</gui> toolbar button.</p>
</item>
<item>
- <p>Select <guiseq><gui>View</gui><gui>Keep Aspect Ratio</gui></guiseq> if
- you want to constrain the aspect ratio of the remote desktop inside the
- display area, or deselect the option to stretch the remote desktop to fill
- the available space.</p>
+ <p>Select <guiseq><gui style="menu">View</gui>
+ <gui style="menuitem">Keep Aspect Ratio</gui></guiseq> if you want to
+ constrain the aspect ratio of the remote desktop inside the display area,
+ or deselect the option to stretch the remote desktop to fill the
+ available space.</p>
<note>
<p>This option can be toggled only if <gui>Scaling</gui> has already
been enabled.</p>
@@ -36,14 +43,4 @@
</item>
</steps>
- <figure>
- <title>Unscaled desktop</title>
- <media type="image" mime="image/png" src="figures/vinagre-no-scaling.png"/>
- </figure>
-
- <figure>
- <title>Scaled desktop</title>
- <media type="image" mime="image/png" src="figures/vinagre-scaling.png"/>
- </figure>
-
</page>
diff --git a/help/C/take-screenshot.page b/help/C/take-screenshot.page
index f0634f4..333b8b0 100644
--- a/help/C/take-screenshot.page
+++ b/help/C/take-screenshot.page
@@ -4,37 +4,44 @@
<info>
<link type="guide" xref="index#options"/>
- <desc>Take a screenshot of a remote desktop.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Take a screenshot of a remote desktop.</desc>
</info>
<title>Take a screenshot</title>
- <p>You can take screenshots of only the desktop you have connected to by using
- the tool provided by <app>Vinagre</app>.</p>
+ <p>You can take screenshots of only the desktop that you are commected to by
+ using the tool provided by <app>Vinagre</app>.</p>
<steps>
<item>
- <p>Choose <guiseq><gui>Remote</gui><gui>Take screenshot</gui></guiseq>, or
- click the <gui>Take Screenshot</gui> button in the toolbar.</p>
+ <p>Select <guiseq><gui style="menu">Remote</gui>
+ <gui style="menuitem">Take screenshot</gui></guiseq>, or click the
+ <gui>Take Screenshot</gui> button in the toolbar.</p>
</item>
<item>
- <p>In the <gui>Name</gui> field, enter the name you want the screenshot to
- be saved under.</p>
+ <p>In the <gui>Name</gui> field, enter the filename that you want the
+ screenshot to be saved under.</p>
</item>
<item>
<p>From the <gui>Save in folder</gui> drop down list, select the folder
- you want the screenshot to be saved in. You can also click <gui>Browse for
- other folder</gui> to select one which is not in the drop down list.</p>
+ that you want the screenshot to be saved in. You can also click
+ <gui>Browse for other folder</gui> to select one which is not in the drop
+ down list.</p>
</item>
<item>
- <p>Click <gui>Save</gui> to save the screenshot.</p>
+ <p>Click <gui style="button">Save</gui> to save the screenshot.</p>
</item>
</steps>
diff --git a/help/C/view-only.page b/help/C/view-only.page
index 2b24285..c6a3e49 100644
--- a/help/C/view-only.page
+++ b/help/C/view-only.page
@@ -4,21 +4,27 @@
<info>
<link type="guide" xref="index#options"/>
- <desc>Disable interaction with the remote desktop.</desc>
+
+ <revision version="0.2" pkgversion="3.8" date="2013-03-23" status="final"/>
+
<credit type="author">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756 googlemail com</email>
</credit>
+
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
+
+ <desc>Disable interaction with the remote desktop.</desc>
</info>
- <title>View only mode</title>
+ <title>View-only mode</title>
<p>Some protocols allow you to enable a <gui>View Only</gui> mode. This mode
- allows you to block all interaction with the remote.</p>
- <p>Choose <guiseq><gui>View</gui><gui>View Only</gui></guiseq> or click the
- corresponding toolbar button to enable this mode.</p>
+ allows you to disable all interaction with the remote.</p>
+ <p>Choose <guiseq><gui style="menu">View</gui>
+ <gui style="menuitem">View Only</gui></guiseq> or click the corresponding
+ toolbar button to enable this mode.</p>
</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index ef92559..1903e5c 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -3,23 +3,16 @@
HELP_ID = vinagre
HELP_MEDIA = \
- figures/vinagre-auth-needed.png \
- figures/vinagre-connect-dialog.png \
- figures/vinagre-connected.png \
- figures/vinagre-connection-closed.png \
- figures/vinagre-fullscreen.png \
- figures/vinagre-no-scaling.png \
- figures/vinagre-reverse-connections.png \
- figures/vinagre-scaling.png
+ figures/vinagre-connected.png
HELP_FILES = \
connect.page \
connect-file.page \
+ connect-reverse.page \
fullscreen.page \
index.page \
introduction.page \
keyboard-shortcuts.page \
- reverse-connections.page \
scaling.page \
take-screenshot.page \
view-only.page
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
