doc for a few more functions