Document exceptions raised by functions in utils

[MrMino]

Closes #543.

Added :raises ...: clauses to documentation of functions from packaging.utils.
Class names have been given by their full import path, since they are not mentioned anywhere else in the documentation.

[brettcannon]

Class names have been given by their full import path, since they are not mentioned anywhere else in the documentation.

Maybe we should change that? No reason to keep the exceptions undocumented.

[MrMino]

Done. Here's the outcome:

Class names in raises clauses of parse_... functions are clickable

Exception classes descriptions:

[MrMino]

@brettcannon Anything else? Is the style / wording acceptable?

[brettcannon]

Anything else?

Nope, just me not being sick so I had time to review. 😅

[brettcannon]

It's best to keep the docs for exceptions generic in case other code uses the exceptions in the future.

[brettcannon]

Apologies for taking so long to get to this! Luckily 3.11.0.rc1 is getting cut today and I caught up to my review queue so I'm apparently only backed up until PRs created in May 😅.

[MrMino]

Fixed. Thanks :).

Edit: also linearized the log, fixed a missing word.

[brettcannon]

Thanks!