Update documentation for Stream class

[alex.slesarev@…]

Please update documentation for render method (for example, in note section): it accepts strip_whitespace parameter (via kwargs), and in certain cases it is critical that whitespaces are not being stripped during rendering.

Unfortunately, now it is too difficult to find that this parameter even exists.

[jruigrok]

Generating the documentation via epydoc (python setup.py build_doc) does provide all the relevant documentation.

However, the documentation on the site for the generated API documentation uses a macro script, which has a few bugs and does not grab the full docstring from init() in some of the classes.

[cmlenz]

This information is in fact included on the documentation page on streams, see:

Serialization Options

Also, the docstring of Stream.render() says that “Any additional keyword arguments are passed to the serializer, and thus depend on the method parameter value.” The serializers in turn document the strip_whitespace option.

I could duplicate this information all over the place, but I'd rather not :P