documented a few more functions