Agreed that this is at worst a doc issue.

[Antoine]
> and in all honesty I don't know the difference between the "**" operator
> and the built-in pow() function :-)

None, as far as I know, apart from the pow function's ability to take a 3rd argument.  Both ultimately call PyNumber_Power, and the various type-specific __pow__ methods take over from there.  [+1 for removing pow from the builtins and shunting three-argument pow to the math module in Python 5000000.]