document optional use of name parameter in File constructor

From SYNR-733. user confused that a default name of the entity comes from the file name minus the path. Document that in the top of the docstring, especially since the 'name' parameter comes very late in the parameter list.