is opened for writing; this closes SF bug #485342.

Added notes that file objects are also accepted in the place of file
descriptors.