Would be nice to at least explain the return values, and perhaps the parameters.