Documented return value behavior that I noticed.
Removed a no-op condition.  The previous if statement was the same condition, and exited the function.
Rename 'used' to 'bytes_used' so I wouldn't get confused about it.