[master] 37ad0f5 Minor cleanup of varnishadm man page.

[Lasse Karstensen]

commit 37ad0f5d6281a53007993f5ba91b82b42abadeae
Author: Lasse Karstensen <lkarsten at varnish-software.com>
Date:   Fri Dec 4 11:06:03 2015 +0100

    Minor cleanup of varnishadm man page.
    
    * Adhere to current style guide.
    * Sort argument list.
    * Add missing reference to related man pages.

diff --git a/doc/sphinx/reference/varnishadm.rst b/doc/sphinx/reference/varnishadm.rst
index 41e879a..4f24c2c 100644
--- a/doc/sphinx/reference/varnishadm.rst
+++ b/doc/sphinx/reference/varnishadm.rst
@@ -14,15 +14,16 @@ Control a running Varnish instance
 SYNOPSIS
 ========
 
-varnishadm [-t timeout] [-S secret_file] [-T address:port] [-n name] [command [...]]
+varnishadm [-n ident] [-t timeout] [-S secretfile] -T [address]:port [command [...]]
+
 
 DESCRIPTION
 ===========
 
-The varnishadm utility establishes a CLI connection to varnishd either
+The `varnishadm` utility establishes a CLI connection to varnishd either
 using -n *name* or using the -T and -S arguments. If -n *name* is
 given the location of the secret file and the address:port is looked
-up in shared memory. If neither is given varnishadm will look for an
+up in shared memory. If neither is given `varnishadm` will look for an
 instance without a given name.
 
 If a command is given, the command and arguments are sent over the CLI
@@ -34,16 +35,16 @@ replies between the CLI socket and stdin/stdout.
 OPTIONS
 =======
 
--t timeout
-    Wait no longer than this many seconds for an operation to finish.
+-n ident
+    Connect to the instance of `varnishd` with this name.
 
--S secret_file
+-S secretfile
     Specify the authentication secret file. This should be the same -S
-    argument as was given to varnishd. Only processes which can read
+    argument as was given to `varnishd`. Only processes which can read
     the contents of this file, will be able to authenticate the CLI connection.
 
--n name
-    Connect to the instance of varnishd with this name.
+-t timeout
+    Wait no longer than this many seconds for an operation to finish.
 
 -T <address:port>
     Connect to the management interface at the specified address and port.
@@ -60,7 +61,7 @@ the *param.show* command.
 EXIT STATUS
 ===========
 
-If a command is given, the exit status of the varnishadm utility is
+If a command is given, the exit status of the `varnishadm` utility is
 zero if the command succeeded, and non-zero otherwise.
 
 EXAMPLES
@@ -76,6 +77,7 @@ SEE ALSO
 ========
 
 * :ref:`varnishd(1)`
+* :ref:`varnish-cli(7)`
 
 HISTORY
 =======