File list generator
-------------------

GenFilelist is a tool for extracting file and directory lists out of MVS
project files. The tool is written in Python, so a python interpreter is
required for running this tool.

Operation

The tool reads a specified MVS project file (*.vcproj) and generates lists of
all files listed in .VisualStudioProject.Files.*.File elements. The file lists
are written to files named $NAME.files_$TYPE, where $NAME is the name of the
project and $TYPE is the extension of the file (normalized to lowercase).
Optionally, an additional file named $NAME.dirs is written, which contains all
(relative) directory names of directories containing the files.

Invocation

The tool accepts the following command line parameters:

GenFilelist.py [(options)] (project-file)

Options

-h|--help
	Write a help screen to the standard output an exit. If this document
	and the help screen are out of sync, then the help screen is right.
-t|--types TYPELIST
	A comma separated list of file types. The default is "c,cpp".
-d|--dirlist
	Generate a directory list.
-u|--updatep4
	Update the perforce repository. Note that the tool will call the P4
	command line client, so the client must be set up correctly (i.e. the
	P4CLIENT environment variable must be set to the correct workspace
	name).
--submit
	Automatically submit changes to P4. If this option is omitted, then
	the P4 changelist is created but not submitted.
-c|--comment COMMENT
	The P4 comment to be used for the P4 change. GenFilelist will use a
	sensible default comment if this option is omitted.

