Adding documentation to the return value or default feature.

Here it goes the first shot :-)