documentation enhancements to new_from_fd