Pyobjects documentation improvements

This makes a simple enhancement to the module documentation for
pyobjects and also updates inline comments throughout the renderer.