"and", "or", bitwise or shortcircuit, what we get searching docs

Yes, based on recent discussions like this I don’t really think there is a practical limit to this phenomenon.

If something surprises someone because they did not read the manual and this is considered a sufficient reason to complain about the docs (both the docstrings and the manual), all kinds of things can and will be added.

Eg if ?and should take you to && just because Python has it, then it is difficult to explain why ?%*% (matrix multiplication in R) should not have a docstring that suggests *. Not all such operators will be documented (that is a very large universe), just those which happen to be of interest to somebody.

1 Like