add docs for o functions