diff --git a/tren.rst b/tren.rst
index 930c657..9bb271a 100644
--- a/tren.rst
+++ b/tren.rst
@@ -20,10 +20,24 @@
   2) In an "include" file specified with ``-I filename`` on the command line
   3) Via the ``$TREN`` environment variable
 
-Note that options specified on the command line are evaluated from
-left to right and supercede any options specified in the environment
-variable.  Think of any options set in ``$TREN`` as the "leftmost
-command line options".
+Options specified on the command line are evaluated from left to right
+and supercede any options specified in the environment variable.
+Think of any options set in ``$TREN`` as the "leftmost command line
+options".
+
+You may interweave option and file/dir name specifications on
+the command line::
+
+  tren.py -opt1 -opt2 -opt3 file|dir.. -opt4 -opt5 -opt6 file|dir ...
+
+This allows you to rename different files and directories with
+different options.  *However*, keep in mind that all the options to
+the left of the file or directory being renamed are in force.  That
+is, options are *cumulative*.  In the example above, the rightmost
+files and directory would be renamed with all the options 1-6 in
+force.  This is why there are "toggles" in the options below - they
+allow you to selectively turn features on- and off as you move to the
+right on the command line.
 
   -1   Rename only the first instance of the specified string
 
@@ -189,7 +203,7 @@
             However, the ``*`` metacharacter has no such meaning when
             used inside an arguments file.
 
- -l string   File "extension" delimiter string.
+  -l string   File "extension" delimiter string.
 
                (*Default*: ".")
 
@@ -1070,7 +1084,7 @@
 
 ::
 
-  $Id: tren.rst,v 1.135 2010/01/23 00:52:27 tundra Exp $
+  $Id: tren.rst,v 1.136 2010/01/25 20:49:26 tundra Exp $
 
 You can find the latest version of this program at: