Remove superfluous comments and small docstrings improvements.
Add example: same output that ford_fulkerson pre 1.9 with the new interface.