Updated documentation as return values have changed