improved doc for R_op
it all looks good. There is one line that I think does not respect PEP8 convention but I'll fix it in another pull request