fileutils|IOChannel: Don’t use @retval on out args [stable]
as it is for documenting particular values of the return variable.
Replace @retval with @param[out], and while here, reorder some arguments
in doc comments to match the order they have in function argument lists.
See gtkmm!9 (merged) for more disussion on the rationale for this.