The index (https://docs.python.org/3.6/genindex-Symbols.html) is missing an entry for the tilde operator ~ (there is also no entry under "tilde").

A relevant pointer could be to object.__invert__ (https://docs.python.org/3.6/reference/datamodel.html#object.__invert__).

Thanks Eric.  I think the reference should be added here, as we do for the other operators:

https://docs.python.org/3/library/stdtypes.html#bitwise-operations-on-integer-types

Good reference.

Another one would be https://docs.python.org/3/reference/expressions.html#unary-arithmetic-and-bitwise-operations, which explicitly indicates that it only makes sense for integer types (which is useful to keep in mind, as one may think that it could somehow apply to floating point numbers as well).

The one at https://docs.python.org/3.6/reference/datamodel.html#object.__invert__ is also important for learning that it is related to __invert__().

Looking at Doc/reference/expressions.rst and Doc/reference/datamodel.rst, I do not see any reference to the symbols, but only to the operator name (negation, minus, plus, inversion, etc.).  Therefore I think it is better to not change these files.

In the PR [*] I added (in Doc/library/stdtypes.rst) both a reference to the symbol and to the name.

Thank you very much 

[*] https://github.com/python/cpython/pull/1502/

New changeset 5eb7075915f0509c5027376bda0e6d9c1e505a2c by Serhiy Storchaka (Marco Buttu) in branch 'master':
bpo-30217: Add the operators ~ and | to the index (#1502)
https://github.com/python/cpython/commit/5eb7075915f0509c5027376bda0e6d9c1e505a2c

New changeset f59cac4b6458e5c47e24a39ba46fb178c3766577 by Mariatta (Marco Buttu) in branch '3.6':
bpo-30217: add the operators ~ and | to the index (GH-1502) (GH-2136)
https://github.com/python/cpython/commit/f59cac4b6458e5c47e24a39ba46fb178c3766577

New changeset bbb335891c2967bd13fbe2da775c0348260d95cb by Mariatta (Marco Buttu) in branch '2.7':
bpo-30217: add the operators ~ and | to the index (GH-1502) (GH-2137)
https://github.com/python/cpython/commit/bbb335891c2967bd13fbe2da775c0348260d95cb

New changeset 37e04153d5e331162608b33639ecd3c9a5ae2432 by Mariatta (Marco Buttu) in branch '3.5':
bpo-30217: add the operators ~ and | to the index (GH-1502) (GH-2138)
https://github.com/python/cpython/commit/37e04153d5e331162608b33639ecd3c9a5ae2432