add doc for misc functions