Noted ability to interweave options and rename targets.
Fixed formatting problem in options description.
1 parent 5f9739b commit 567601dbad29881dee8c6ced02cc213ebd038b6f
@tundra tundra authored on 25 Jan 2010
Showing 1 changed file
View
40
tren.rst
1) On the command line
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
 
(*Default*: This is the program default)
shell to create a list of files ending in ``.txt``.
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*: ".")
 
**tren** has to know what separates the "name" from the
-----------------------------
 
::
 
$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:
 
http://www.tundraware.com/Software/tren