bpo-38159: Clarify documentation of PyState_AddModule (GH-16101)

This was never intented to be called manually from PyInit_*.

Also, clarify PyState_RemoveModule return value.