give more details on return values
in docs params go from 1 to 9, explain directed edges
typo
FIX/ENH for the duality gap check by @xianghang.