doc: Document mutable function arguments

Document the new syntax implemented for #3488.