diff --git a/intern/ghost/intern/GHOST_ContextVK.cc b/intern/ghost/intern/GHOST_ContextVK.cc index 2e189323ca1..030d822c7c4 100644 --- a/intern/ghost/intern/GHOST_ContextVK.cc +++ b/intern/ghost/intern/GHOST_ContextVK.cc @@ -881,7 +881,7 @@ GHOST_TSuccess GHOST_ContextVK::recreateSwapchain() } /* Use double buffering when using FIFO. Increasing the number of images could stall when doing - * actions that require low latency (paint cursor, UI resizing). MAILBOX prefers tripple + * actions that require low latency (paint cursor, UI resizing). MAILBOX prefers triple * buffering. */ uint32_t image_count_requested = present_mode == VK_PRESENT_MODE_MAILBOX_KHR ? 3 : 2; /* NOTE: maxImageCount == 0 means no limit. */ diff --git a/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc b/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc index a085a8aeb4f..7f9de0e4feb 100644 --- a/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc +++ b/source/blender/blenkernel/intern/grease_pencil_convert_legacy.cc @@ -1064,7 +1064,7 @@ static void legacy_gpencil_to_grease_pencil(ConversionData &conversion_data, SET_FLAG_FROM_TEST( new_layer.base.flag, (gpl->flag & GP_LAYER_USE_MASK) == 0, GP_LAYER_TREE_NODE_HIDE_MASKS); - /* Copy Dopesheet channel color. */ + /* Copy Dope-sheet channel color. */ copy_v4_v4(new_layer.base.color, gpl->color); new_layer.blend_mode = int8_t(gpl->blend_mode); diff --git a/source/blender/blenkernel/intern/subsurf_ccg.cc b/source/blender/blenkernel/intern/subsurf_ccg.cc index c6a68557fbf..02558b89175 100644 --- a/source/blender/blenkernel/intern/subsurf_ccg.cc +++ b/source/blender/blenkernel/intern/subsurf_ccg.cc @@ -1632,16 +1632,16 @@ DerivedMesh *subsurf_make_derived_from_derived(DerivedMesh *dm, smd->levels; CCGSubSurf *ss; - /* It is quite possible there is a much better place to do this. It + /* NOTE(@zr): It is quite possible there is a much better place to do this. It * depends a bit on how rigorously we expect this function to never * be called in edit-mode. In semi-theory we could share a single * cache, but the handles used inside and outside edit-mode are not * the same so we would need some way of converting them. Its probably * not worth the effort. But then why am I even writing this long - * comment that no one will read? Hmm. - zr + * comment that no one will read? Hmm. * - * Addendum: we can't really ensure that this is never called in edit - * mode, so now we have a parameter to verify it. - brecht + * NOTE(@brecht): Addendum: we can't really ensure that this is never called in edit + * mode, so now we have a parameter to verify it. */ if (!(flags & SUBSURF_IN_EDIT_MODE) && smd->emCache) { ccgSubSurf_free(static_cast(smd->emCache)); @@ -1729,8 +1729,8 @@ void subsurf_calculate_limit_positions(Mesh *mesh, float (*r_positions)[3]) add_v3_v3(face_sum, static_cast(ccgSubSurf_getFaceCenterData(f))); } - /* ad-hoc correction for boundary vertices, to at least avoid them - * moving completely out of place (brecht) */ + /* NOTE(@brecht): ad-hoc correction for boundary vertices, to at least avoid them + * moving completely out of place. */ if (numFaces && numFaces != N) { mul_v3_fl(face_sum, float(N) / float(numFaces)); } diff --git a/source/blender/blenlib/intern/math_matrix_c.cc b/source/blender/blenlib/intern/math_matrix_c.cc index a96f248d173..3e1b825a91e 100644 --- a/source/blender/blenlib/intern/math_matrix_c.cc +++ b/source/blender/blenlib/intern/math_matrix_c.cc @@ -2724,7 +2724,7 @@ void svd_m4(float U[4][4], float s[4], float V[4][4], float A_[4][4]) for (j = k; j < p - 1; j++) { float t = hypotf(f, g); - /* division by zero checks added to avoid NaN (brecht) */ + /* NOTE(@brecht): division by zero checks added to avoid NaN. */ float cs = (t == 0.0f) ? 0.0f : f / t; float sn = (t == 0.0f) ? 0.0f : g / t; if (j != k) { @@ -2742,7 +2742,7 @@ void svd_m4(float U[4][4], float s[4], float V[4][4], float A_[4][4]) } t = hypotf(f, g); - /* division by zero checks added to avoid NaN (brecht) */ + /* NOTE(@brecht): division by zero checks added to avoid NaN. */ cs = (t == 0.0f) ? 0.0f : f / t; sn = (t == 0.0f) ? 0.0f : g / t; s[j] = t; diff --git a/source/blender/draw/engines/eevee/eevee_defines.hh b/source/blender/draw/engines/eevee/eevee_defines.hh index 505d4bbfea6..874e8c97cec 100644 --- a/source/blender/draw/engines/eevee/eevee_defines.hh +++ b/source/blender/draw/engines/eevee/eevee_defines.hh @@ -125,7 +125,7 @@ #define SHADOW_ROG_ID 0 /* Gbuffer. */ -/** IMPORTANT: Make sure all Gbuffer framebuffer setup matches this. */ +/** IMPORTANT: Make sure all Gbuffer frame-buffer setup matches this. */ #define GBUF_HEADER_FB_LAYER_COUNT 1 #define GBUF_CLOSURE_FB_LAYER_COUNT 2 #define GBUF_NORMAL_FB_LAYER_COUNT 1 diff --git a/source/blender/draw/engines/eevee/eevee_gbuffer.hh b/source/blender/draw/engines/eevee/eevee_gbuffer.hh index b6e1aec0d8e..3dbd121ef4f 100644 --- a/source/blender/draw/engines/eevee/eevee_gbuffer.hh +++ b/source/blender/draw/engines/eevee/eevee_gbuffer.hh @@ -141,12 +141,12 @@ struct GBuffer { /* References to optional GBuffer layers that are not always required or written to. * These will point to either the dummy textures bellow or to a layer range view of the above * textures. In the later case, these layers are written with imageStore instead of being part - * of the Framebuffer. */ + * of the #Framebuffer. */ GPUTexture *closure_opt_layers_ = nullptr; GPUTexture *normal_opt_layers_ = nullptr; GPUTexture *header_opt_layers_ = nullptr; - /* Textures used to fullfil the GBuffer optional layers binding when textures do not have enough + /* Textures used to fulfill the GBuffer optional layers binding when textures do not have enough * layers for the optional layers image views. The shader are then expected to never write to * them. */ Texture dummy_header_tx_ = {"GBufferDummyHeader"}; @@ -156,7 +156,7 @@ struct GBuffer { public: void acquire(int2 extent, int header_count, int data_count, int normal_count) { - /* Always allocate enough layers so that the framebuffer attachments are always valid. */ + /* Always allocate enough layers so that the frame-buffer attachments are always valid. */ header_count = max_ii(header_fb_layer_count, header_count); data_count = max_ii(closure_fb_layer_count, data_count); normal_count = max_ii(normal_fb_layer_count, normal_count); diff --git a/source/blender/draw/engines/gpencil/gpencil_render.cc b/source/blender/draw/engines/gpencil/gpencil_render.cc index 07ffe1e816c..7d93369907d 100644 --- a/source/blender/draw/engines/gpencil/gpencil_render.cc +++ b/source/blender/draw/engines/gpencil/gpencil_render.cc @@ -24,7 +24,7 @@ namespace blender::draw::gpencil { -/* Remap depth from viewspace to [0..1] to be able to use it with as GPU depth buffer. */ +/* Remap depth from views-pace to [0..1] to be able to use it with as GPU depth buffer. */ static void remap_depth(const View &view, MutableSpan pix_z) { if (view.is_persp()) { @@ -274,7 +274,7 @@ void Engine::render_to_image(RenderEngine *engine, RenderLayer *render_layer, co /* Weight of this render SSAA sample. The sum of previous samples is weighted by `1 - weight`. * This diminishes after each new sample as we want all samples to be equally weighted inside * the final result (inside the combined buffer). This weighting scheme allows to always store - * the resolved result making it ready for in-progress display or readback. */ + * the resolved result making it ready for in-progress display or read-back. */ const float weight = 1.0f / (1.0f + i); inst.antialiasing_accumulate(manager, weight); } diff --git a/source/blender/editors/interface/view2d/view2d.cc b/source/blender/editors/interface/view2d/view2d.cc index 3de87eb7c0b..cb7c1daeda7 100644 --- a/source/blender/editors/interface/view2d/view2d.cc +++ b/source/blender/editors/interface/view2d/view2d.cc @@ -1097,7 +1097,7 @@ void UI_view2d_view_ortho(const View2D *v2d) * correspondence with pixels for smooth UI drawing, * but only applied where requested. */ - /* XXX brecht: instead of zero at least use a tiny offset, otherwise + /* XXX(@brecht): instead of zero at least use a tiny offset, otherwise * pixel rounding is effectively random due to float inaccuracy */ if (sizex > 0) { xofs = eps * BLI_rctf_size_x(&v2d->cur) / sizex; diff --git a/source/blender/nodes/NOD_geometry_nodes_closure.hh b/source/blender/nodes/NOD_geometry_nodes_closure.hh index cd1b528209d..654e8c1be4d 100644 --- a/source/blender/nodes/NOD_geometry_nodes_closure.hh +++ b/source/blender/nodes/NOD_geometry_nodes_closure.hh @@ -43,7 +43,7 @@ struct ClosureFunctionIndices { * A #GeometryNodesReferenceSet input for a subset of the outputs. This is used to tell the * closure which attributes it has to propagate to the outputs. * - * Main output index -> input lf socket index. + * Main output index -> input `lf` socket index. */ Map output_data_reference_sets; } inputs; diff --git a/source/blender/python/intern/bpy_gizmo_wrap.cc b/source/blender/python/intern/bpy_gizmo_wrap.cc index 054886ddd1e..dbad3ce4b10 100644 --- a/source/blender/python/intern/bpy_gizmo_wrap.cc +++ b/source/blender/python/intern/bpy_gizmo_wrap.cc @@ -108,9 +108,9 @@ static void gizmo_properties_init(wmGizmoType *gzt) /* Extract target property definitions from 'bl_target_properties' */ { - /* Picky developers will notice that 'bl_targets' won't work with inheritance - * get direct from the dict to avoid raising a load of attribute errors - * (yes this isn't ideal) - campbell. */ + /* NOTE(@ideasman42): Picky developers will notice that `bl_targets` + * won't work with inheritance get direct from the dict to avoid + * raising a load of attribute errors (yes this isn't ideal). */ PyObject *py_class_dict = py_class->tp_dict; PyObject *bl_target_properties = PyDict_GetItem(py_class_dict, bpy_intern_str_bl_target_properties); @@ -146,7 +146,7 @@ static void gizmo_properties_init(wmGizmoType *gzt) void BPY_RNA_gizmo_wrapper(wmGizmoType *gzt, void *userdata) { /* take care not to overwrite anything set in - * WM_gizmomaptype_group_link_ptr before opfunc() is called */ + * #WM_gizmomaptype_group_link_ptr before `opfunc()` is called. */ StructRNA *srna = gzt->srna; *gzt = *((wmGizmoType *)userdata); gzt->srna = srna; /* restore */ diff --git a/source/blender/python/intern/bpy_operator_wrap.cc b/source/blender/python/intern/bpy_operator_wrap.cc index 59f5e8b6acf..811fb752e58 100644 --- a/source/blender/python/intern/bpy_operator_wrap.cc +++ b/source/blender/python/intern/bpy_operator_wrap.cc @@ -44,9 +44,9 @@ static void operator_properties_init(wmOperatorType *ot) /* set the default property: ot->prop */ { - /* Picky developers will notice that 'bl_property' won't work with inheritance - * get direct from the dict to avoid raising a load of attribute errors (yes this isn't ideal) - * - campbell. */ + /* NOTE(@ideasman42): Picky developers will notice that `bl_property` + * won't work with inheritance get direct from the dict to avoid + * raising a load of attribute errors (yes this isn't ideal). */ PyObject *py_class_dict = py_class->tp_dict; PyObject *bl_property = PyDict_GetItem(py_class_dict, bpy_intern_str_bl_property); if (bl_property) { diff --git a/source/blender/python/intern/bpy_rna.cc b/source/blender/python/intern/bpy_rna.cc index f8ea1dc6511..3a2c5d8a619 100644 --- a/source/blender/python/intern/bpy_rna.cc +++ b/source/blender/python/intern/bpy_rna.cc @@ -8351,8 +8351,8 @@ PyObject *pyrna_struct_CreatePyObject(PointerRNA *ptr) BPy_StructRNA *pyrna = nullptr; - /* New in 2.8x, since not many types support instancing - * we may want to use a flag to avoid looping over all classes. - campbell */ + /* NOTE(@ideasman42): New in 2.8x, since not many types support instancing + * we may want to use a flag to avoid looping over all classes. */ void **instance = ptr->data ? RNA_struct_instance(ptr) : nullptr; if (instance && *instance) { pyrna = static_cast(*instance); diff --git a/source/blender/render/intern/texture_image.cc b/source/blender/render/intern/texture_image.cc index 005e8d2fcc3..851a634c542 100644 --- a/source/blender/render/intern/texture_image.cc +++ b/source/blender/render/intern/texture_image.cc @@ -1301,7 +1301,7 @@ static int imagewraposa_aniso(Tex *tex, * so for now commented out also disabled in #imagewraposa() * to be able to compare results with blender's default texture filtering */ - /* brecht: tried to fix this, see "TXF alpha" comments */ + /* NOTE(@brecht): tried to fix this, see "TXF alpha" comments. */ /* do not de-pre-multiply for generated alpha, it is already in straight */ if (texres->trgba[3] != 1.0f && texres->trgba[3] > 1e-4f && !(tex->imaflag & TEX_CALCALPHA)) { diff --git a/tools/check_source/check_spelling_config.py b/tools/check_source/check_spelling_config.py index 91c7b2de200..01f0df715db 100644 --- a/tools/check_source/check_spelling_config.py +++ b/tools/check_source/check_spelling_config.py @@ -48,6 +48,7 @@ dict_custom = { "adjugate", "affectable", "alignable", + "bakeable", "bindable", "branchless", "allocatable",