gh-108198: Add Logger._log and Logger.manager documentation

[toxinu]

I just added some brief documentation for the Logger._log method and Logger.manager attribute.
I am unsure if we want the Logger.manager attribute documented since the whole logging.Manager class isn't documented.

This is my very first PR against cpython so please give any advice or feel free to just close the PR if it is useless.

I also fixed two double-back quotes on the same documentation page. Should I move that to another PR?

• Issue: Document 'manager' and '_log' attrs of Logging #108198

---

📚 Documentation preview 📚: https://cpython-previews--114248.org.readthedocs.build/

[ghost]

All commit authors signed the Contributor License Agreement.

[vsajip]

Thanks for your effort, Geoffrey, but those things are deliberately left undocumented as they are internal implementation details that could conceivably change in the future. Of course they haven't actually changed for a long time, but that doesn't change the logic of my statement. Please close this PR & issue, and if you found some typos related to back-quotes, please make a separate PR for that. Thanks!

[AA-Turner]

@vsajip have you seen the linked #108198? Ought that be closed too?

A

[vsajip]

Ought that be closed too?

Yes, I suppose so.

[toxinu]

Thanks for your effort, Geoffrey, but those things are deliberately left undocumented as they are internal implementation details that could conceivably change in the future. Of course they haven't actually changed for a long time, but that doesn't change the logic of my statement. Please close this PR & issue, and if you found some typos related to back-quotes, please make a separate PR for that. Thanks!

Thanks a lot for your explanation. That makes total sense to me. Let's close this PR and the related issue then. 👍

[erlend-aasland]

Thanks for your effort, Geoffrey, but those things are deliberately left undocumented as they are internal implementation details that could conceivably change in the future. Of course they haven't actually changed for a long time, but that doesn't change the logic of my statement. Please close this PR & issue, and if you found some typos related to back-quotes, please make a separate PR for that. Thanks!

@vsajip, is there a list of public but deliberately undocumented logging attributes anywhere?

[vsajip]

No, the reason they're not publicly listed is that they are considered internal.

[erlend-aasland]

No, the reason they're not publicly listed is that they are considered internal.

Perhaps a Sphinx comment or a comment in the Python source could be helpful, to avoid unneeded efforts like this.

[vsajip]

OK, it seems reasonable to add comments in the source.