tidy up documentation of tree_to_graph_pm() a little