missing documentation for a couple new functions