From f1e49038543cf75766f4a220f62cdc6cdbc0e27d Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Sat, 26 Jun 2021 21:35:18 +1000 Subject: Cleanup: full sentences in comments, improve comment formatting --- source/blender/python/generic/bgl.c | 40 +++++++++++++-------------- source/blender/python/generic/idprop_py_api.c | 20 +++++++------- 2 files changed, 30 insertions(+), 30 deletions(-) (limited to 'source/blender/python/generic') 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 = { -- cgit v1.2.3