only include the basename in docs
add example use in rst docs