Cleanup: full sentences in comments, improve comment formatting

2 files changed, 30 insertions, 30 deletions

diff --git a/source/blender/python/generic/bgl.c b/source/blender/python/generic/bgl.c
index e9a58288c5e..22bea8f0273 100644
--- a/source/blender/python/generic/bgl.c
+++ b/source/blender/python/generic/bgl.c
@@ -41,7 +41,7 @@
 /** \name Local utility defines for wrapping OpenGL
  * \{ */
 
-/*@ By golly George! It looks like fancy pants macro time!!! */
+/* By golly George! It looks like fancy pants macro time! */
 
 /* TYPE_str is the string to pass to Py_ArgParse (for the format) */
 /* TYPE_var is the name to pass to the GL function */
@@ -161,7 +161,7 @@ typedef struct BufferOrOffset {
 #  define buffer_def(number) Buffer *bgl_buffer##number
 #endif
 
-/*@The standard GL typedefs are used as prototypes, we can't
+/* The standard GL typedefs are used as prototypes, we can't
  * use the GL type directly because Py_ArgParse expects normal
  * C types.
  *
@@ -505,13 +505,13 @@ static bool compare_dimensions(int ndim, const int *dim1, const Py_ssize_t *dim2
  * \{ */
 
 static PySequenceMethods Buffer_SeqMethods = {
-    (lenfunc)Buffer_len,              /*sq_length */
-    (binaryfunc)NULL,                 /*sq_concat */
-    (ssizeargfunc)NULL,               /*sq_repeat */
-    (ssizeargfunc)Buffer_item,        /*sq_item */
-    (ssizessizeargfunc)NULL,          /*sq_slice, deprecated, handled in Buffer_item */
-    (ssizeobjargproc)Buffer_ass_item, /*sq_ass_item */
-    (ssizessizeobjargproc)NULL,       /*sq_ass_slice, deprecated handled in Buffer_ass_item */
+    (lenfunc)Buffer_len,              /* sq_length */
+    (binaryfunc)NULL,                 /* sq_concat */
+    (ssizeargfunc)NULL,               /* sq_repeat */
+    (ssizeargfunc)Buffer_item,        /* sq_item */
+    (ssizessizeargfunc)NULL,          /* sq_slice, deprecated, handled in Buffer_item */
+    (ssizeobjargproc)Buffer_ass_item, /* sq_ass_item */
+    (ssizessizeobjargproc)NULL,       /* sq_ass_slice, deprecated handled in Buffer_ass_item */
     (objobjproc)NULL,                 /* sq_contains */
     (binaryfunc)NULL,                 /* sq_inplace_concat */
     (ssizeargfunc)NULL,               /* sq_inplace_repeat */
@@ -582,17 +582,17 @@ static PyGetSetDef Buffer_getseters[] = {
 };
 
 PyTypeObject BGL_bufferType = {
-    PyVarObject_HEAD_INIT(NULL, 0) "bgl.Buffer", /*tp_name */
-    sizeof(Buffer),                              /*tp_basicsize */
-    0,                                           /*tp_itemsize */
-    (destructor)Buffer_dealloc,                  /*tp_dealloc */
-    (printfunc)NULL,                             /*tp_print */
-    NULL,                                        /*tp_getattr */
-    NULL,                                        /*tp_setattr */
-    NULL,                                        /*tp_compare */
-    (reprfunc)Buffer_repr,                       /*tp_repr */
-    NULL,                                        /*tp_as_number */
-    &Buffer_SeqMethods,                          /*tp_as_sequence */
+    PyVarObject_HEAD_INIT(NULL, 0) "bgl.Buffer", /* tp_name */
+    sizeof(Buffer),                              /* tp_basicsize */
+    0,                                           /* tp_itemsize */
+    (destructor)Buffer_dealloc,                  /* tp_dealloc */
+    (printfunc)NULL,                             /* tp_print */
+    NULL,                                        /* tp_getattr */
+    NULL,                                        /* tp_setattr */
+    NULL,                                        /* tp_compare */
+    (reprfunc)Buffer_repr,                       /* tp_repr */
+    NULL,                                        /* tp_as_number */
+    &Buffer_SeqMethods,                          /* tp_as_sequence */
     &Buffer_AsMapping,                           /* PyMappingMethods *tp_as_mapping; */
 
     /* More standard operations (here for binary compatibility) */
diff --git a/source/blender/python/generic/idprop_py_api.c b/source/blender/python/generic/idprop_py_api.c
index 8560e7eb663..df6a55fdb9f 100644
--- a/source/blender/python/generic/idprop_py_api.c
+++ b/source/blender/python/generic/idprop_py_api.c
@@ -1305,7 +1305,7 @@ static void BPy_IDGroup_CorrectListLen(IDProperty *prop, PyObject *seq, int len,
     PyList_SET_ITEM(seq, j, Py_INCREF_RET(Py_None));
   }
 
-  /*set correct group length*/
+  /* Set correct group length. */
   prop->len = len;
 }
 
@@ -1326,8 +1326,8 @@ PyObject *BPy_Wrap_GetKeys(IDProperty *prop)
 
   if (i != prop->len) { /* if the loop didn't finish, we know the length is wrong */
     BPy_IDGroup_CorrectListLen(prop, list, i, __func__);
-    Py_DECREF(list); /*free the list*/
-    /*call self again*/
+    Py_DECREF(list); /* Free the list. */
+    /* Call self again. */
     return BPy_Wrap_GetKeys(prop);
   }
 
@@ -1346,8 +1346,8 @@ PyObject *BPy_Wrap_GetValues(ID *id, IDProperty *prop)
 
   if (i != prop->len) {
     BPy_IDGroup_CorrectListLen(prop, list, i, __func__);
-    Py_DECREF(list); /*free the list*/
-    /*call self again*/
+    Py_DECREF(list); /* Free the list. */
+    /* Call self again. */
     return BPy_Wrap_GetValues(id, prop);
   }
 
@@ -1369,8 +1369,8 @@ PyObject *BPy_Wrap_GetItems(ID *id, IDProperty *prop)
 
   if (i != prop->len) {
     BPy_IDGroup_CorrectListLen(prop, seq, i, __func__);
-    Py_DECREF(seq); /*free the list*/
-    /*call self again*/
+    Py_DECREF(seq); /* Free the list. */
+    /* Call self again. */
     return BPy_Wrap_GetItems(id, prop);
   }
 
@@ -1557,9 +1557,9 @@ static PySequenceMethods BPy_IDGroup_Seq = {
 };
 
 static PyMappingMethods BPy_IDGroup_Mapping = {
-    (lenfunc)BPy_IDGroup_Map_Len,           /*inquiry mp_length */
-    (binaryfunc)BPy_IDGroup_Map_GetItem,    /*binaryfunc mp_subscript */
-    (objobjargproc)BPy_IDGroup_Map_SetItem, /*objobjargproc mp_ass_subscript */
+    (lenfunc)BPy_IDGroup_Map_Len,           /* inquiry mp_length */
+    (binaryfunc)BPy_IDGroup_Map_GetItem,    /* binaryfunc mp_subscript */
+    (objobjargproc)BPy_IDGroup_Map_SetItem, /* objobjargproc mp_ass_subscript */
 };
 
 PyTypeObject BPy_IDGroup_Type = {