replace pydoc with pydoc3

[mwermelinger]

Documentation

The 3.11 docs and 3.10 docs state that pydoc can be invoked as a script, giving as examplepydoc sys. However, there's no such command after installing those versions on macOS: there's only pydoc3.

BTW, I also have Python 3.8 installed with Anaconda and it creates symlinks pydoc and pydoc3 both pointing to pydoc3.8.

It thus seems either the documentation should be updated to replace pydoc with pydoc3 or the 3.10 and 3.11 installers should create a pydoc symlink.

Linked PRs

• gh-100583: Improving the pydoc doc #100590
• [3.11] gh-100583: Improve the pydoc documentation (GH-100590) #100606
• [3.10] gh-100583: Improve the pydoc documentation (GH-100590) #100607

[Fidget-Spinner]

The recommended way that is platform agnostic is probably <python you are using> -m pydoc. So the docs should reflect that.