There are a few documents distributed with PyMek that to some extent explain how it works. I've listed them here:

 * [wiki:Reference Reference]
 * [wiki:Tutorial Tutorial]
 * [wiki:README README]
 * [source:trunk/doc/pymekfile.xsd/ PyMekfile XML Schema]