it would be real nice to have some documentation for these methods, maybe even an example :)