Issue 9717: Segregate and improve the documentation of "in-place" operators

in the operator module.