(#6937) Document the recurse parameter of File type.

Update the desc block with information gleaned from #1469 and the code
about recurse => remote and other types of recursion.

The auto generated documentation was sparse and this is an area that often
comes up on the mailing list/IRC.