Improve the docstring of split_leaflets

The split_leaflets function is the closest to an entry point if
splitleafs is used as a module. Improving its documentation is required
to make splitleafs a decent python module.

See issue #20.