Fix documentation references and some typos for email.utils module

[Viicos]

No description provided.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #32636521 | 📁 Comparing eba28c3 against main (bc1be4f)

  🔍 Preview build  

11 files changed · ± 11 modified

± Modified

• c-api/slots.html
• library/array.html
• library/binary.html
• library/ctypes.html
• library/email.utils.html
• library/json.html
• library/pathlib.html
• library/struct.html
• library/unittest.html
• whatsnew/3.16.html
• and 1 more...

[picnixz]

I don't understand this last sentence actually. Why do we have two classes one after the other?

[Viicos]

I wasn't entirely sure too. Having a second look, maybe only one was supposed to be written? Maybe it should be:

will be an aware ``datetime`` with the corresponding :attr:`~datetime.datetime.tzinfo attribute`

?

[picnixz]

Honestly, I don't know :') could you look at the code and see what it does please?

[bitdancer]

It's intentional. It is meant to say that a timezone instance is returned as the tzinfo. If you can think of a better why to phrase it, please do ;)

[picnixz]

offset, the datetime will be an aware datetime with the
corresponding a :class:~datetime.timezone :class:~datetime.tzinfo.
corresponding :class:~datetime.timezone :class:~datetime.tzinfo.

How about:

   offset, the ``datetime`` will be an aware ``datetime`` whose
   corresponding :attr:`~datetime.datetime.tzinfo` attribute is 
   a :class:`~datetime.timezone` object.

Should i understand it like that?

[bitdancer]

Yes, that sounds good.

[Viicos]

applied.