PPWIZARD Manual
[Bottom][Contents][Search][Prev]: /Option[Next]: /Pack

Switch /Output:EditMask

This is a PPWIZARD command line switch. You can set up your own default switches in the "PPWIZARD_OPTIONS" environment variable or in project files.

This parameter controls how the "InputFile" parameter is transformed to generate the correct name for the generated output file.

An edit mask is basically much like a file (with path if required) and will contain zero or one special characters as follows:

  1. * or {$BASE}
    This gets replaced with the short filename (less extension) of the current input file.

  2. ? or {$PATH}
    This gets replaced with the path (including terminating slash) of the current input file. This is most likely to be of use if you want to position generated files relative to the input file and your mask scans subdirectories. For example "?OUT\*.HTM".

  3. {$path}
    This allows you to set up a separate tree for generated filenames, the input mask and file are examined and the relative path extracted, the result is either blank ('') or a relative path that ends with a path separator. Note for this to work the input mask must either use an absolute path, begin with '.' or '..' followed by slash or not have a path attached at all otherwise ppwizard will abort. It would be pointless to use this sort of path unless subdirectories are being scanned.

Note that unix type operating systems will probably have problems with "$path" etc (to unix this means replace with the "path" environment variable's contents). You need to hide or escape the dollar sign, so use either "{x24}path" or "\$path" instead.

The "EditMask" can be absolute or relative (your exact circumstances will determine your choice).

Note that resultant relative filenames are always relative to the current directory.

While you control the case of the mask you can't control the case of the part that replaces the '*'. What you can do is ensure the whole name is either in upper or lower case with the /FileNames switch.

The default mask is "*.htm". I place all my output into a separate "OUT" directory and use "/Output:OUT\*.htm" instead.


[Top][Contents][Search][Prev]: /Option[Next]: /Pack

PPWIZARD Manual
My whole website and this manual itself was developed using PPWIZARD (free preprocessor written by Dennis Bareis)
Tuesday January 02 2001 at 7:37am