NAME

pplist - Prints a list or a tree of Progress programs and includes.

SYNOPSIS

pplist [-a|-b|-t|-v|-x] file

DESCRIPTION

This program extracts program names and include names from a given file and performs the operation recursively on the names found. Program names/include names are of the following format: [\-_[:alnum:]]+\.[ivwp] (basically, any alphanum string followed by a dot followed by either i, v, w or p.)

When no parameters are passed then the default action is to print a list of full path names of the program and all subprograms/includes physically found in the PROPATH. If the main file name does not exist, and no parameters are passed then the output will be void.

The following parameters can be passed:
 

-a	Print all basenames of the program/subprograms/includes, inclusive the ones that were not found in the PROPATH.
-b	Print all basenames of the program/subprograms/includes, except the ones that were not found in the PROPATH.
-t	Same as -a, but printed in a tree format.
-v	Same as -a, but printed in a verbose format.
-x	Print only the basenames of the program/subprograms/includes that were not found in the PROPATH.

Pplist will strip the input files of all comments before extracting subprogram/include file names. It is smart enough to detect (and ignore) strings like "/*" (comment start/end within quotes), but parsing is limited to 1 file only. Thus, passing strings like the above to an include will not be detected in the include (but will be ignored in the calling program). This will most probably result in an "Unbalanced comments" error. If this is the case then the rest of the input file is discarded and parsing continues with the next file.

Pplist will also detect when a file is binary. In this case, pplist will generate an error, the contents of the current file will be discarded, and the next file will be parsed.

ENVIRONMENT

The PROPATH environment variable must be set before execution of pplist. If not then the program will exit.  The PROPATH environment variable acts just like the PATH variable, except that it is used to locate Progress source code (and executable) files. On MS/DOS systems, the separator between the tokens of the PROPATH must be ';'. On all other systems, the separator must be ':'.

AUTHOR

Koenraad Dejonghe
©jan 1999
Origin Technology in Business
Send money and bug reports to Koen.Dejonghe@origin-it.com