Fix problem where API doc gen misses some files

[mwichmann]

In doc/SConscript, the function in bootstrap.py to parse a manifest was called with an scons path (#src/engine) but bootstrap does not run in an scons context, it is run via subprocess.Popen. As a result, the glob matching failed to match files. The resulting list is passed to epydoc (at the moment) to generate the API docs, so the list should be correct (it was actually missing very little, since 14 of the missed files are later eliminated when the list is cleaned)

Preprocess the path before the call. Along the way, change the function to open the file itself instead of being passed a list already read from the file, update the comment, and clean some whitespace issues.

Did not updates src/CHANGES.txt since there was no change to scons source.

Signed-off-by: Mats Wichmann [email protected]

Contributor Checklist:

• I have created a new test or updated the unit tests to cover the new/changed functionality.
• I have updated master/src/CHANGES.txt directory (and read the README.txt in that directory)
• I have updated the appropriate documentation