a little doc and renaming
add acyclic