1. Escape sequences
Destination and some other file names are scanned for escape sequences
beginning with the escape character '%'. The accepted format is:
'%cX' or '%mcX' or '%n-mcX'
-
'n' is the number of skipped characters of the field.
-
'm' is the zero based index of the last copied character.
-
'c' is an optional character. If c is 'u' then the source will be
converted into upper case and if c is 'l' into lower case.
-
'X' selects the source and is one of (ignoring case):
- 'Q' : The full qualified path of the source file.
'%Q' is the same as '%P/%F'.
- 'P' : The path (all upto the last '/') of the source file.
- 'F' : The filename (start behind the last '/') of the source file.
'%F' is the same as '%N.%E'.
- 'N' : The filename (start behind the last '/') of the source file,
but not the last extension (.*).
- 'E' : The extension of the of the source file.
- 'T' : The default extension (type) of the destination file.
-
To use the '%' sign itself just type '%%'.
1.1 Alternative escape character
Instead of
'%' an alternative escape character can be used.
It is defined by the option
--esc (
-E).
This makes live easier if using the cygwin version together
with the windows shell 'cmd'.
Define the
environment variable 'WIIMMS_SZS_TOOLS'
for a new default definition.
Example for Unix bash: export WIIMMS_SZS_TOOLS="--esc=$"
Example for Windows: set WIIMMS_SZS_TOOLS=--esc=$
