Commenting Files Managed via Cfengine

[Brian E. Seppanen]

Hi Folks:

I have a large number of files that I'm managing via cfengine and over the 
two years that I've been using cfengine that number continues to grow. 
My coworkers are new to cfengine, and are struggling to understand which 
hosts, which files, etc cfengine is going to operate on.  I've been 
documenting these issues as I confront them, but one idea that I would 
really like to incorporate is a comment automatically added to each file 
by cfengine to indicate master repository, path, classes, last update and 
a warning that cfengine will clean up after them whether they like it or 
not.  Has anyone undertaken anything similar.  Cfengine is an awesome 
piece of software that has made my life easier, but I now have more 
problems just trying to document how it works, organize date so that 
others can better understand, and explaining.  I must confess that I often 
get lost in all of the mazes as well, so such efforts wouldn't be wasted 
on myself even if I understand cfengine fairly well.

Any other suggestions on how to take the already high level cfengine 
syntax and document it at an even higher level...

thanks.

Brian Seppanen
seppy@chartermi.net
608.826.1464