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 for more
disussion on the rationale for this.