PPWIZARD Manual
[Bottom][Contents][Search][Prev]: /Define[Next]: /DependsOnComplete

Switch /DependsOn:[-]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 option requires a parameter which controls how the "InputFile" parameter is transformed into the name of a dependancy file. The default is that there is no dependancy file (therefore dependancies are not checked). If you use dependancy files then the output is only built if required (a source file has changed).

Unless you preceeded the EditMask parameter with a '-' the dependancy checking progress is displayed.

PPWIZARD knows how to create a complete dependancy file unless you access files directly (via rexx with "linein()", "lineout(), "charin()" or similar functions). If you do directly access a file you will need to help ppwizard by using the #DependsOn command or the AddInputFileToDependancyList() or AddOutputFileToDependancyList() rexx functions.

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.

EXAMPLE

In the following example the command will check/create a file called "OUT\DEPEND\IN.DEP":

    +-[ MAKEIT.CMD ]------------------------------------------------+
    | @echo off                                                     |
    | ppwizard IN.IT /Output:OUT\*.html /DependsOn:OUT\DEPEND\*.DEP |
    | if errorlevel 1 echo ERROR: Command failed!                   |
    +---------------------------------------------------------------+
    


[Top][Contents][Search][Prev]: /Define[Next]: /DependsOnComplete

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