document more functions