document some more functions