fixed documentation and return values