the wip warning is not helpful
minor optimizations to user's manual