- improve documentation for return_defaults() and returned_defaults.  [ticket:2852]