_sdl2.video docs rewrite, minor reorderings & method signature changes

[Mega-JC]

(based on #2092)

This commit effectively rewrites all the documentation of the pygame._sdl2.video module, by either adding new information for undocumented content, or extracting information from existing docstrings in the codebase. Along with the documentation changes, some function signatures were modified to adhere to the snake case naming convention described in PEP 8.

[Starbuck5]

Looks good.

Thanks for this!

[Mega-JC]

Alright, I took another good look at the changes made in this PR, and took some time to address all the complaints. Should have done that earlier, but I think it the PR should be ready now.

[Matiiss]

LGTM (apart from that minor thing that's out of the scope of this PR)

EDIT: that minor thing is also now fixed 👍

Changes made.

[Starbuck5]

This has the approvals to merge, but the cython should be regenerated to sync the default window title change. And to be sure that's safe the branch should be rebased against main to not wipe out any existing cython changes since the inception of this branch.

Also the commit history of the branch is a lot at this point, it could "squash and merge"d or Mega could squash down some commits into each other.

[Mega-JC]

All done and completed, Squash and Merge sounds good, now I have to figure out why CI is failing -_-

Edit: Seems like recompilation with Python 3.11 was needed, CI is happy now.

[Starbuck5]

Edit: Seems like recompilation with Python 3.11 was needed, CI is happy now.

Since Cython is a code generator, the only relevant thing is the version of Cython.

I didn't like how the Cython version changed in your regen, and how every file was regenerated (even ones that shouldn't have any change), so I changed the Cython regen commit a bit.

But now if I squash and merge we'll both be equal authors on this PR, from a commit perspective. Which isn't accurate. I'd like you to squash the first 14 commits into 1 or several commits authored exclusively by you, then we can do a normal merge.

[Mega-JC]

Alright, commits have now been squashed down to 2.