fix up graph theory functions; document them; add tests for them
add note about node styles & performance