update inconsistent effective_principals docs

fixes #1196