fileutils|IOChannel: Don’t use @retval on out args [master]
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.
Edited by Daniel Boles