Remove asserts from docstrings.

Also some other small docstring fixes.
Return both flow_value and {flow_dict|partition} when value_only is False.
Kwargs sanity check for maximum_flow and minimum_cut.

Check that kwargs is empty if flow_func is None, if not raise NetworkXError. This way users will nor rely on the default_flow_func.