[vinagre] Update manpage to cope with recent changes

[Jonh Wendell <jwendell src gnome org>]

commit 7516125d4114550bd051a2c648e1d1bd6465a8ee
Author: Emilio Pozuelo Monfort <pochu27 gmail com>
Date:   Tue Aug 11 17:14:37 2009 +0200

    Update manpage to cope with recent changes
    
    http://bugzilla.gnome.org/show_bug.cgi?id=591353

 data/vinagre.1 |   52 +++++++++++++++++++++++++++++++++++-----------------
 1 files changed, 35 insertions(+), 17 deletions(-)
---
diff --git a/data/vinagre.1 b/data/vinagre.1
index ad70164..9d4db26 100644
--- a/data/vinagre.1
+++ b/data/vinagre.1
@@ -1,12 +1,14 @@
-.TH VINAGRE "1" "June 23rd 2009" "User Commands"
+.TH VINAGRE "1" "August 12th 2009" "User Commands"
 .SH "NAME"
-vinagre \- a VNC client for the GNOME Desktop
+vinagre \- a remote desktop viewer for the GNOME Desktop
 .SH "SYNOPSYS"
 .PP
-\fBvinagre\fR [\fBOPTIONS\fR] [\fB\fIserver\fR[:\fIport\fR]\fR]
+\fBvinagre\fR [\fBOPTIONS\fR] [\fB\fIserver\fR]\fR[::\fIport\fR|:display\fR]
 .SH "DESCRIPTION"
 .PP
-\fBvinagre\fR is a VNC client for the GNOME desktop, featuring, among others:\&.
+\fBvinagre\fR is a remote desktop viewer for the GNOME desktop. It can support
+many protocols using a plugin system. Current plugins exist for VNC and SSH.
+Vinagre has many features, among others:\&.
 .PP
 - Support for multiple connections simultaneously
 .PP
@@ -29,15 +31,18 @@ Show help options
 Show all help options
 .TP
 \fB\-\-help\-gtk\fR
-Show GTK+ Options
+Show GTK+ options
 .SS "Application Options:"
 .TP
-\fB\-\-gtk\-vnc\-debug\fR
-Enables debug output
+\fB\-\-help\-vnc\fR
+Show VNC options
 .TP
-\fB\-f\fR, \fB\-\-file\fR=\fIfilename\fR
+\fB\-F\fR, \fB\-\-file\fR=\fIfilename\fR
 Opens a .vnc file
 .TP
+\fB\-f\fR, \fB\-\-fullscreen\fR
+Open vinagre in fullscreen mode
+.TP
 \-n, \fB\-\-new\-window\fR
 Create a new toplevel window in an existing instance of vinagre
 .TP
@@ -49,13 +54,19 @@ Run 'vinagre \fB\-\-help\fR' to see a full list of available command line option
 .PP
 The following operands are supported:
 .TP
-\fB\fB\fIserver\fR[:\fIport\fR]\fR\fR
+\fB\fB\fI\fR[server\fR]\fR[::\fIport|:display\fR]\fR\fR
 Specifies the VNC server to connect to\&. The VNC server can be either a
 hostname, or an IP address. If the server is an IPv6 address, it must be
-enclosed by square brackets. The address can optionally be followed by a
-colon (:) character and the VNC port number\&. If a port is not specified,
-default value of 5900 will be used\&. If the value is lower than 1024, 5900
-will be added to it\&. For example, ":0" means "5900" and ":1" means ":5901"\&.
+enclosed by square brackets. The address can optionally be followed by two
+colons (::) and the VNC port number\&, or alternatively by one colon (:) and
+the display where Vinagre should run. If a port is not specified, default
+value of 5900 will be used\&.
+If the value is lower than 1024, 5900 will be added to it\&. For example, ":0"
+means "5900" and ":1" means ":5901"\&. If only a port is specified, but not
+the hostname, localhost will be assumed.
+Possible values for the display are between 0 and 1024. If a display number
+greater than 1024 is specified, it will be assumed to be a port.
+Note that you can't specify the port and the display at the same time.
 .SH "EXAMPLES"
 .PP
 \fBExample 1: Start vinagre from the command line\fR
@@ -76,28 +87,35 @@ example% \fBvinagre \-\-new-window\fR
 .PP
 .PP
 .nf
-example% \fBvinagre snoopy:5900\fR
+example% \fBvinagre snoopy::5900\fR
 .fi
 .PP
 \fBExample 4: Connect to a specified IPv4 address and port\fR
 .PP
 .PP
 .nf
-example% \fBvinagre 192.168.1.35:2700
+example% \fBvinagre 192.168.1.35::2700
 .fi
 .PP
 \fBExample 5: Connect to a specified IPv6 address and port\fR
 .PP
 .PP
 .nf
-example% \fBvinagre [2001:0db8:0:0:0:0:1428:57ab]:2700
+example% \fBvinagre [2001:0db8:0:0:0:0:1428:57ab]::2700
 .fi
 .PP
 \fBExample 6: Connect to a VNC server specified by a \&.vnc file\fR
 .PP
 .PP
 .nf
-example% \fBvinagre \-f snoopy\&.vnc\fR
+example% \fBvinagre \-F snoopy\&.vnc\fR
+.fi
+.PP
+\fBExample 7: Connect to localhost on a specified port in fullscreen mode\fR
+.PP
+.PP
+.nf
+example% \fBvinagre -f ::5900
 .fi
 .SH "SEE ALSO"
 .PP