diff --git a/tsshbatch.rst b/tsshbatch.rst
index 7bbea08..1b53af2 100644
--- a/tsshbatch.rst
+++ b/tsshbatch.rst
@@ -9,8 +9,7 @@
 --------
 ::
 
-  tsshbatch.py [-EKNSaehktvxy -G 'file dest' -P 'file dest' -f cmdfile -n name -p pw ] -H 'host ..' | hostlistfile [command arg ... ]
-
+  tsshbatch.py [-EKNSTaehkvxy -G 'file dest' -P 'file dest' -f cmdfile -l logfile -n name -p pw ] -H 'host ..' | hostlistfile [command arg ... ]
 
 DESCRIPTION
 -----------
@@ -68,7 +67,7 @@
                    Since all the files have the same name, they would
                    overwrite each other if copied into the same
                    directory.  So, ``tsshbatch`` prepends the string
-                   ``hostname:`` to the name of each file it saves
+                   ``hostname-`` to the name of each file it saves
                    locally.
 
   -H hostlistfile  List of hosts on which to run the command.  This should
@@ -108,6 +107,8 @@
 
   -k               Use ssh keys instead of name/password credentials
 
+  -l logfile       Log diagnostic output to ``logfile`` (Default: /dev/null)
+
   -n name          Login name to use
 
   -p pw            Password to use when logging in and/or doing sudo
@@ -397,6 +398,28 @@
    password has been provided (interactive or ``-p``), you can accept
    this as the ``sudo`` password by just hitting ``Enter``.
 
+   .. NOTE:: ``tsshbatch`` makes a reasonable effort to scan your
+             command line and/or command file contents to spot
+             explicit invocations of the form ``sudo ...``.  It will
+             ignore these if they are inside single- or double quoted
+             strings, on the assumption that you're quoting the
+             literal string ``sudo ...`` for some other purpose.
+
+             However, this is not perfect because it is not a full
+             reimplementation of the shell quoting and aliasing
+             features.  For example, if you invoke an alias on the
+             remote machine that resolves to a ``sudo`` command, or
+             you run a script with a ``sudo`` command in it, ``tsshbatch``
+             has no way to determine what you're trying to do.  For
+             complex applications, it's best to write a true shell
+             script, push it all the machines in question via ``-P``,
+             and then have ``tsshbatch`` remotely invoke it with
+             ``sudo myscript`` or something similar.
+
+             As always, the best way to figure out what the program
+             thinks you're asking for is to run it in test mode
+             and look at the diagnostic output. 
+
 
 5) Precedence Of Authentication Options
 
@@ -436,7 +459,7 @@
   a file of the same name on every host.  To avoid having all
   but the last one clobber the previous one, ``tsshbatch`` makes
   forces the files you ``GET`` to be uniquely named by prepending
-  the hostname and a ":" to the actual file name::
+  the hostname and a "-" to the actual file name::
 
     tsshbatch.py -H myhost -G "foo ./"
 
@@ -774,7 +797,7 @@
 
 ::
 
-  $Id: tsshbatch.rst,v 1.139 2014/07/25 15:43:35 tundra Exp $
+  $Id: tsshbatch.rst,v 1.140 2014/12/02 18:14:03 tundra Exp $
 
 You can find the latest version of this program at: