PyDoc: use Python's type annotation syntax for doc-strings

Replace plain-text type information with the type syntax used
for Python's type annotations as it's more concise, especially for
callbacks which often didn't include useful type information.

Note that this change only applies to inline doc-strings,
generated doc-strings from RNA need to be updated separately.

Details:

- Many minor corrections were made when "list" was incorrectly used
  instead of "sequence".
- Some type information wasn't defined in the doc-strings and has been
  added.
- Verbose type info would benefit from support for type aliases.

source/blender/python/gpu/gpu_py_shader.cc

@@ -261,7 +261,7 @@ PyDoc_STRVAR(
     "   :arg location: Location of the uniform variable to be modified.\n"
     "   :type location: int\n"
     "   :arg buffer: The data that should be set. Can support the buffer protocol.\n"
-    "   :type buffer: sequence of floats\n"
+    "   :type buffer: Sequence[float]\n"
     "   :arg length: Size of the uniform data type:\n"
     "\n"
     "      - 1: float\n"
@@ -331,7 +331,7 @@ PyDoc_STRVAR(
     "   :arg name: Name of the uniform variable whose value is to be changed.\n"
     "   :type name: str\n"
     "   :arg value: Value that will be used to update the specified uniform variable.\n"
-    "   :type value: bool or sequence of bools\n");
+    "   :type value: bool | Sequence[bool]\n");
 static PyObject *pygpu_shader_uniform_bool(BPyGPUShader *self, PyObject *args)
 {
   const char *error_prefix = "GPUShader.uniform_bool";
@@ -406,7 +406,7 @@ PyDoc_STRVAR(
     "   :arg name: Name of the uniform variable whose value is to be changed.\n"
     "   :type name: str\n"
     "   :arg value: Value that will be used to update the specified uniform variable.\n"
-    "   :type value: single number or sequence of floats\n");
+    "   :type value: float | Sequence[float]\n");
 static PyObject *pygpu_shader_uniform_float(BPyGPUShader *self, PyObject *args)
 {
   const char *error_prefix = "GPUShader.uniform_float";
@@ -478,7 +478,7 @@ PyDoc_STRVAR(
     "   :arg name: name of the uniform variable whose value is to be changed.\n"
     "   :type name: str\n"
     "   :arg seq: Value that will be used to update the specified uniform variable.\n"
-    "   :type seq: sequence of ints\n");
+    "   :type seq: Sequence[int]\n");
 static PyObject *pygpu_shader_uniform_int(BPyGPUShader *self, PyObject *args)
 {
   const char *error_prefix = "GPUShader.uniform_int";
@@ -689,7 +689,7 @@ PyDoc_STRVAR(
     "   Information about the attributes used in the Shader.\n"
     "\n"
     "   :return: tuples containing information about the attributes in order (name, type)\n"
-    "   :rtype: tuple\n");
+    "   :rtype: tuple[tuple[str, str | None], ...]\n");
 static PyObject *pygpu_shader_attrs_info_get(BPyGPUShader *self, PyObject * /*arg*/)
 {
   uint attr_len = GPU_shader_get_attribute_len(self->shader);