diff --git a/scripts/modules/rna_keymap_ui.py b/scripts/modules/rna_keymap_ui.py index ba7c96d3487..65674f3d70d 100644 --- a/scripts/modules/rna_keymap_ui.py +++ b/scripts/modules/rna_keymap_ui.py @@ -66,7 +66,7 @@ def draw_km(display_keymaps, kc, km, children, layout, level): if km.is_user_modified: subrow.operator("preferences.keymap_restore", text="Restore") - # Add margin to space the button from the scrollbar. + # Add margin to space the button from the scroll-bar. subrow.separator() if km.is_modal: subrow.label(text="", icon='LINKED') @@ -159,7 +159,7 @@ def draw_kmi(display_keymaps, kc, km, kmi, layout, level): icon=('TRACKING_CLEAR_BACKWARDS' if kmi.is_user_defined else 'X') ).item_id = kmi.id - # Add margin to space the buttons from the scrollbar. + # Add margin to space the buttons from the scroll-bar. row.separator(factor=0.25 if kmi.show_expanded else 1.0) # Expanded, additional event settings @@ -350,7 +350,7 @@ def draw_filtered(display_keymaps, filter_type, filter_text, layout): subrow = row.row() subrow.alignment = 'RIGHT' subrow.operator("preferences.keymap_restore", text="Restore") - # Add margin to space the button from the scrollbar. + # Add margin to space the button from the scroll-bar. subrow.separator() for kmi in filtered_items: diff --git a/source/blender/animrig/intern/fcurve.cc b/source/blender/animrig/intern/fcurve.cc index 8d305800fd0..1386410e1c5 100644 --- a/source/blender/animrig/intern/fcurve.cc +++ b/source/blender/animrig/intern/fcurve.cc @@ -153,7 +153,7 @@ int insert_bezt_fcurve(FCurve *fcu, const BezTriple *bezt, eInsertKeyFlags flag) /* Replace an existing keyframe? */ if (replace) { - /* 'i' may in rare cases exceed arraylen. */ + /* `i` may in rare cases exceed array bounds. */ if ((i >= 0) && (i < fcu->totvert)) { if (flag & INSERTKEY_OVERWRITE_FULL) { fcu->bezt[i] = *bezt; @@ -683,11 +683,11 @@ bool fcurve_frame_has_keyframe(const FCurve *fcu, const float frame) bool replace; const int i = BKE_fcurve_bezt_binarysearch_index(fcu->bezt, frame, fcu->totvert, &replace); - /* BKE_fcurve_bezt_binarysearch_index will set replace to be 0 or 1 + /* #BKE_fcurve_bezt_binarysearch_index will set replace to be 0 or 1 * - obviously, 1 represents a match */ if (replace) { - /* 'i' may in rare cases exceed arraylen. */ + /* `i` may in rare cases exceed array bounds. */ if ((i >= 0) && (i < fcu->totvert)) { return true; } diff --git a/source/blender/blenkernel/BKE_editmesh.hh b/source/blender/blenkernel/BKE_editmesh.hh index 915d5c70cd2..b1271b877e7 100644 --- a/source/blender/blenkernel/BKE_editmesh.hh +++ b/source/blender/blenkernel/BKE_editmesh.hh @@ -97,7 +97,7 @@ BMEditMesh *BKE_editmesh_copy(BMEditMesh *em); BMEditMesh *BKE_editmesh_from_object(Object *ob); /** - * Return whether the evaluated mesh is a "descendent" of the original mesh: whether it is a + * Return whether the evaluated mesh is a "descendant" of the original mesh: whether it is a * version of the original mesh propagated during evaluation. This will be false if the mesh was * taken from from an different object during evaluation, with the object info node for example. */ diff --git a/source/blender/blenkernel/BKE_screen.hh b/source/blender/blenkernel/BKE_screen.hh index f65660da5c8..31737c79a51 100644 --- a/source/blender/blenkernel/BKE_screen.hh +++ b/source/blender/blenkernel/BKE_screen.hh @@ -434,7 +434,8 @@ struct ARegionRuntime { * The visible part of the region, use with region overlap not to draw * on top of the overlapping regions. * - * Lazy initialize, zero'd when unset, relative to #ARegion.winrct x/y min. */ + * Lazy initialize, zeroed when unset, relative to #ARegion.winrct x/y min. + */ rcti visible_rect = {}; /* The offset needed to not overlap with window scroll-bars. Only used by HUD regions for now. */ diff --git a/source/blender/blenkernel/intern/image.cc b/source/blender/blenkernel/intern/image.cc index d0b9f73475c..c7329ab7e3c 100644 --- a/source/blender/blenkernel/intern/image.cc +++ b/source/blender/blenkernel/intern/image.cc @@ -1063,7 +1063,7 @@ Image *BKE_image_load_in_lib(Main *bmain, int file; char filepath_abs[FILE_MAX]; - /* If no owner library is explicitely given, use the current library from the given Main. */ + /* If no owner library is explicitly given, use the current library from the given #Main. */ Library *owner_lib = owner_library.value_or(bmain->curlib); image_abs_path(bmain, owner_lib, filepath, filepath_abs); @@ -1105,12 +1105,12 @@ Image *BKE_image_load_exists_in_lib(Main *bmain, Image *ima; char filepath_abs[FILE_MAX], filepath_test[FILE_MAX]; - /* If not owner library is explicitely given, use the current library from the given Main. */ + /* If not owner library is explicitly given, use the current library from the given Main. */ Library *owner_lib = owner_library.value_or(bmain->curlib); image_abs_path(bmain, owner_lib, filepath, filepath_abs); - /* first search an identical filepath */ + /* First search an identical filepath. */ for (ima = static_cast(bmain->images.first); ima; ima = static_cast(ima->id.next)) { diff --git a/source/blender/blenlib/BLI_math_matrix.h b/source/blender/blenlib/BLI_math_matrix.h index 2b6eb7c5c90..93d1b73b197 100644 --- a/source/blender/blenlib/BLI_math_matrix.h +++ b/source/blender/blenlib/BLI_math_matrix.h @@ -371,7 +371,7 @@ void invert_m4_m4_safe(float inverse[4][4], const float mat[4][4]); void invert_m3_m3_safe_ortho(float inverse[3][3], const float mat[3][3]); /** - * A safe version of invert that uses valid axes, calculating the zero'd axis + * A safe version of invert that uses valid axes, calculating the zeroed axis * based on the non-zero ones. * * This works well for transformation matrices, when a single axis is zeroed. diff --git a/source/blender/blenlib/intern/scanfill.c b/source/blender/blenlib/intern/scanfill.c index ad8a99e5fe7..6a7bdd44db3 100644 --- a/source/blender/blenlib/intern/scanfill.c +++ b/source/blender/blenlib/intern/scanfill.c @@ -846,8 +846,8 @@ uint BLI_scanfill_calc_ex(ScanFillContext *sf_ctx, const int flag, const float n #ifndef NDEBUG for (eve = sf_ctx->fillvertbase.first; eve; eve = eve->next) { - /* these values used to be set, - * however they should always be zero'd so check instead */ + /* These values used to be set, + * however they should always be zeroed so check instead. */ BLI_assert(eve->f == 0); BLI_assert(sf_ctx->poly_nr || eve->poly_nr == 0); BLI_assert(eve->edge_count == 0); diff --git a/source/blender/bmesh/operators/bmo_edgenet.cc b/source/blender/bmesh/operators/bmo_edgenet.cc index 5fdb59fd1af..aca7facc3d1 100644 --- a/source/blender/bmesh/operators/bmo_edgenet.cc +++ b/source/blender/bmesh/operators/bmo_edgenet.cc @@ -51,7 +51,7 @@ void bmo_edgenet_fill_exec(BMesh *bm, BMOperator *op) if (use_smooth) { BM_elem_flag_enable(f, BM_ELEM_SMOOTH); } - /* normals are zero'd */ + /* Normals are zeroed. */ BM_face_normal_update(f); } diff --git a/source/blender/bmesh/operators/bmo_fill_holes.cc b/source/blender/bmesh/operators/bmo_fill_holes.cc index 1b85630f13a..f742c681e9d 100644 --- a/source/blender/bmesh/operators/bmo_fill_holes.cc +++ b/source/blender/bmesh/operators/bmo_fill_holes.cc @@ -59,7 +59,7 @@ void bmo_holes_fill_exec(BMesh *bm, BMOperator *op) BMFace *f; BMO_ITER (f, &siter, op_attr.slots_out, "faces_fail.out", BM_FACE) { - BM_face_normal_update(f); /* normals are zero'd */ + BM_face_normal_update(f); /* Normals are zeroed. */ } BMO_op_callf(bm, op->flag, "recalc_face_normals faces=%S", &op_attr, "faces_fail.out"); diff --git a/source/blender/bmesh/tools/bmesh_bevel.cc b/source/blender/bmesh/tools/bmesh_bevel.cc index d7f5e6c2567..31152aded54 100644 --- a/source/blender/bmesh/tools/bmesh_bevel.cc +++ b/source/blender/bmesh/tools/bmesh_bevel.cc @@ -7554,10 +7554,10 @@ static float geometry_collide_offset(BevelParams *bp, EdgeHalf *eb) float sin2 = sinf(th2); float cos1 = cosf(th1); float cos2 = cosf(th2); - /*the side offsets, overlap at the two corners, to create two corner vectors. - *the intersection of these two corner vectors is the collapse point. - *The length of edge B divided by the projection of these vectors onto edge B - *is the number of 'offsets' that can be accomodated*/ + /* The side offsets, overlap at the two corners, to create two corner vectors. + * The intersection of these two corner vectors is the collapse point. + * The length of edge B divided by the projection of these vectors onto edge B + * is the number of 'offsets' that can be accommodated. */ float offsets_projected_on_B = (ka + cos1 * kb) / sin1 + (kc + cos2 * kb) / sin2; if (offsets_projected_on_B > BEVEL_EPSILON) { offsets_projected_on_B = bp->offset * (len_v3v3(vb->co, vc->co) / offsets_projected_on_B); diff --git a/source/blender/draw/engines/overlay/overlay_next_base.hh b/source/blender/draw/engines/overlay/overlay_next_base.hh index 7d9173c8c96..d9340690660 100644 --- a/source/blender/draw/engines/overlay/overlay_next_base.hh +++ b/source/blender/draw/engines/overlay/overlay_next_base.hh @@ -37,7 +37,7 @@ struct Overlay { * on a per object-data basis. * * IMPORTANT: Synchronization must be view agnostic. That is, not rely on view position, - * projection matrix or framebuffer size to do conditional pass creation. This is because, by + * projection matrix or frame-buffer size to do conditional pass creation. This is because, by * design, syncing can happen once and rendered multiple time (multi view rendering, stereo * rendering, orbiting view ...). Conditional pass creation, must be done in the drawing * callbacks, but they should remain the exception. Also there will be no access to object data @@ -92,10 +92,10 @@ struct Overlay { virtual void pre_draw(Manager & /*manager*/, View & /*view*/){}; /** - * Drawing can be split into multiple passes. Each callback draws onto a specific framebuffer. + * Drawing can be split into multiple passes. Each callback draws onto a specific frame-buffer. * The order between each draw function is guaranteed. But it is not guaranteed that no other - * overlay will render in between. The overlay can render to a temporary framebuffer before - * resolving to the given framebuffer. + * overlay will render in between. The overlay can render to a temporary frame-buffer before + * resolving to the given frame-buffer. */ virtual void draw_on_render(GPUFrameBuffer * /*fb*/, Manager & /*manager*/, View & /*view*/){}; diff --git a/source/blender/draw/engines/overlay/overlay_next_instance.cc b/source/blender/draw/engines/overlay/overlay_next_instance.cc index a9a42d0ed18..e7631fbf8e1 100644 --- a/source/blender/draw/engines/overlay/overlay_next_instance.cc +++ b/source/blender/draw/engines/overlay/overlay_next_instance.cc @@ -192,7 +192,7 @@ void Instance::object_sync(ObjectRef &ob_ref, Manager &manager) case OB_MESH: /* TODO(fclem): Make it part of a #Meshes. */ layer.paints.object_sync(manager, ob_ref, resources, state); - /* For wireframes. */ + /* For wire-frames. */ layer.mesh_uvs.edit_object_sync(manager, ob_ref, resources, state); break; case OB_GREASE_PENCIL: diff --git a/source/blender/draw/engines/overlay/shaders/overlay_extra_point_vert.glsl b/source/blender/draw/engines/overlay/shaders/overlay_extra_point_vert.glsl index 3277f891b29..856f2601e84 100644 --- a/source/blender/draw/engines/overlay/shaders/overlay_extra_point_vert.glsl +++ b/source/blender/draw/engines/overlay/shaders/overlay_extra_point_vert.glsl @@ -26,7 +26,7 @@ void main() outlineColor = colorOutline; #ifdef SELECT_ENABLE - /* Selection framebuffer can be very small. + /* Selection frame-buffer can be very small. * Make sure to only rasterize one pixel to avoid making the selection radius very big. */ gl_PointSize = 1.0; #endif diff --git a/source/blender/draw/engines/workbench/shaders/CMakeLists.txt b/source/blender/draw/engines/workbench/shaders/CMakeLists.txt index 7112f585e1b..e2f7daa5299 100644 --- a/source/blender/draw/engines/workbench/shaders/CMakeLists.txt +++ b/source/blender/draw/engines/workbench/shaders/CMakeLists.txt @@ -97,6 +97,6 @@ if (WITH_GPU_SHADER_CPP_COMPILATION) compile_sources_as_cpp(workbench_cpp_shaders_frag "${SRC_GLSL_FRAG}" "GPU_FRAGMENT_SHADER") compile_sources_as_cpp(workbench_cpp_shaders_comp "${SRC_GLSL_COMP}" "GPU_COMPUTE_SHADER") # Only enable to make sure they compile on their own. - # Otherwise it creates a warning about pragma once. + # Otherwise it creates a warning about `pragma once`. # compile_sources_as_cpp(workbench_cpp_shaders_lib "${SRC_GLSL_LIB}" "GPU_LIBRARY_SHADER") endif() diff --git a/source/blender/draw/intern/draw_cache_impl_mesh.cc b/source/blender/draw/intern/draw_cache_impl_mesh.cc index 6a2cfe4bb47..23748f816f1 100644 --- a/source/blender/draw/intern/draw_cache_impl_mesh.cc +++ b/source/blender/draw/intern/draw_cache_impl_mesh.cc @@ -1690,7 +1690,7 @@ void DRW_mesh_batch_cache_create_requested(TaskGraph &task_graph, mbuflist = (do_cage) ? &cache.cage.buff : &cache.final.buff; - /* When the msh doesn't correspond to the object's original mesh (i.e. the mesh was replaced by + /* When the mesh doesn't correspond to the object's original mesh (i.e. the mesh was replaced by * another with the object info node during evaluation), don't extract edit mode data for it. * That data can be invalid because any original indices (#CD_ORIGINDEX) on the evaluated mesh * won't correspond to the correct mesh. */ diff --git a/source/blender/editors/animation/anim_draw.cc b/source/blender/editors/animation/anim_draw.cc index eb8ece1b7e7..b25fc024513 100644 --- a/source/blender/editors/animation/anim_draw.cc +++ b/source/blender/editors/animation/anim_draw.cc @@ -249,7 +249,7 @@ bool ANIM_nla_mapping_allowed(const bAnimListElem *ale) /* I (Sybren) don't _think_ masks can use the NLA. */ return false; default: - /* NLA time remapping is the default behaviour, and only should be + /* NLA time remapping is the default behavior, and only should be * prohibited for the above types. */ return true; } diff --git a/source/blender/editors/animation/anim_filter.cc b/source/blender/editors/animation/anim_filter.cc index 6d0cfaac0b0..754c249cd65 100644 --- a/source/blender/editors/animation/anim_filter.cc +++ b/source/blender/editors/animation/anim_filter.cc @@ -2829,7 +2829,7 @@ static size_t animdata_filter_ds_modifiers(bAnimContext *ac, * use to walk through the dependencies of the modifiers * * Assumes that all other unspecified values (i.e. accumulation buffers) - * are zero'd out properly! + * are zeroed out properly! */ afm.ac = ac; afm.ads = ac->ads; /* TODO: Remove this pointer from the struct and just use afm.ac->ads. */ diff --git a/source/blender/editors/asset/ED_asset_list.hh b/source/blender/editors/asset/ED_asset_list.hh index 28c134afcb0..e24637fc911 100644 --- a/source/blender/editors/asset/ED_asset_list.hh +++ b/source/blender/editors/asset/ED_asset_list.hh @@ -54,7 +54,7 @@ void iterate(const AssetLibraryReference &library_reference, AssetListHandleIterFn fn, FunctionRef prefilter_fn = nullptr); /** - * \note This override avoids the file caching system, so it's more performant and avoids pitfals + * \note This override avoids the file caching system, so it's more performant and avoids pitfalls * from the other override. Prefer this when access to #AssetRepresentation is enough, and no * #AssetHandle is needed. */ diff --git a/source/blender/editors/curve/editcurve_paint.cc b/source/blender/editors/curve/editcurve_paint.cc index 5755912dc3a..3a32bf2d915 100644 --- a/source/blender/editors/curve/editcurve_paint.cc +++ b/source/blender/editors/curve/editcurve_paint.cc @@ -73,7 +73,7 @@ struct StrokeElem { float location_world[3]; float location_local[3]; - /* surface normal, may be zero'd */ + /* Surface normal, may be zeroed. */ float normal_world[3]; float normal_local[3]; diff --git a/source/blender/editors/curves/intern/curves_draw.cc b/source/blender/editors/curves/intern/curves_draw.cc index a0567f132dc..c5e36fd42c2 100644 --- a/source/blender/editors/curves/intern/curves_draw.cc +++ b/source/blender/editors/curves/intern/curves_draw.cc @@ -60,7 +60,7 @@ struct StrokeElem { float location_world[3]; float location_local[3]; - /* surface normal, may be zero'd */ + /* Surface normal, may be zeroed. */ float normal_world[3]; float normal_local[3]; diff --git a/source/blender/editors/grease_pencil/intern/grease_pencil_image_render.cc b/source/blender/editors/grease_pencil/intern/grease_pencil_image_render.cc index 71f0a1ea7d4..2ee5bd5714c 100644 --- a/source/blender/editors/grease_pencil/intern/grease_pencil_image_render.cc +++ b/source/blender/editors/grease_pencil/intern/grease_pencil_image_render.cc @@ -354,9 +354,9 @@ static void draw_grease_pencil_stroke(const float4x4 &transform, immEnd(); - /* Expanded drawcall. */ + /* Expanded `drawcall`. */ GPUPrimType expand_prim_type = GPUPrimType::GPU_PRIM_TRIS; - /* Hardcoded in shader. */ + /* Hard-coded in shader. */ const uint expand_prim_len = 12; /* Do not count adjacency info for start and end primitives. */ const uint final_vert_len = ((batch->vertex_count_get() - 2) * expand_prim_len) * 3; diff --git a/source/blender/editors/include/ED_transform_snap_object_context.hh b/source/blender/editors/include/ED_transform_snap_object_context.hh index 1b348923d45..8adeaf51ff3 100644 --- a/source/blender/editors/include/ED_transform_snap_object_context.hh +++ b/source/blender/editors/include/ED_transform_snap_object_context.hh @@ -59,7 +59,7 @@ struct SnapObjectParams { eSnapTargetOP snap_target_select; /** Geometry for snapping in edit mode. */ eSnapEditType edit_mode_type; - /** Snap to or ignore the frontmost object. */ + /** Snap to or ignore the front-most object. */ eSnapOcclusionTest occlusion_test; /** Grid unit size. "0.0" is automatic. */ float grid_size; diff --git a/source/blender/editors/interface/interface_anim.cc b/source/blender/editors/interface/interface_anim.cc index 01df77a658d..1ecc44ebe38 100644 --- a/source/blender/editors/interface/interface_anim.cc +++ b/source/blender/editors/interface/interface_anim.cc @@ -107,7 +107,7 @@ void ui_but_anim_flag(uiBut *but, const AnimationEvalContext *anim_eval_context) /* This feature is not implemented at all for the NLA. However, if the NLA just consists of * stashed (i.e. deactivated) Actions, it doesn't do anything, and we can treat it as - * non-existant here. Note that this is mostly to play nice with stashed Actions, and doesn't + * non-existent here. Note that this is mostly to play nice with stashed Actions, and doesn't * fully look at all the track & strip flags. */ if (adt) { LISTBASE_FOREACH (NlaTrack *, nla_track, &adt->nla_tracks) { diff --git a/source/blender/editors/screen/workspace_edit.cc b/source/blender/editors/screen/workspace_edit.cc index ce2c4fed0ba..c85841e1eea 100644 --- a/source/blender/editors/screen/workspace_edit.cc +++ b/source/blender/editors/screen/workspace_edit.cc @@ -257,7 +257,7 @@ bool ED_workspace_delete(WorkSpace *workspace, Main *bmain, bContext *C, wmWindo } } - /* Also delete managed sceens if they have no other users. */ + /* Also delete managed screens if they have no other users. */ LISTBASE_FOREACH (WorkSpaceLayout *, layout, &workspace->layouts) { BKE_id_free_us(bmain, layout->screen); layout->screen = nullptr; diff --git a/source/blender/editors/sculpt_paint/paint_image_2d.cc b/source/blender/editors/sculpt_paint/paint_image_2d.cc index 3c494ccd46c..bf58aed94e1 100644 --- a/source/blender/editors/sculpt_paint/paint_image_2d.cc +++ b/source/blender/editors/sculpt_paint/paint_image_2d.cc @@ -1156,7 +1156,7 @@ static void paint_2d_lift_smear(ImBuf *ibuf, ImBuf *ibufb, int *pos, short paint static ImBuf *paint_2d_lift_clone(ImBuf *ibuf, ImBuf *ibufb, const int *pos) { - /* NOTE: allocImbuf returns zero'd memory, so regions outside image will + /* NOTE: #allocImbuf returns zeroed memory, so regions outside image will * have zero alpha, and hence not be blended onto the image */ int w = ibufb->x, h = ibufb->y, destx = 0, desty = 0, srcx = pos[0], srcy = pos[1]; ImBuf *clonebuf = IMB_allocImBuf(w, h, ibufb->planes, ibufb->flags); diff --git a/source/blender/editors/sculpt_paint/sculpt.cc b/source/blender/editors/sculpt_paint/sculpt.cc index 0dba4bcdd0d..2c39f2c051d 100644 --- a/source/blender/editors/sculpt_paint/sculpt.cc +++ b/source/blender/editors/sculpt_paint/sculpt.cc @@ -5039,11 +5039,11 @@ void flush_update_step(bContext *C, UpdateType update_type) if (update_type == UpdateType::Position && !ss.shapekey_active) { if (pbvh.type() == bke::pbvh::Type::Mesh) { - /* Various operations inside sculpt mode can cause either the MeshRuntimeData or the entire + /* Various operations inside sculpt mode can cause either the #MeshRuntimeData or the entire * Mesh to be changed (e.g. Undoing the very first operation after opening a file, performing * remesh, etc). * - * This is an unideal fix for the core issue here, but to mitigate the drastic performance + * This isn't an ideal fix for the core issue here, but to mitigate the drastic performance * falloff, we refreeze the cache before we do any operation that would tag this runtime * cache as dirty. * diff --git a/source/blender/editors/sculpt_paint/sculpt_undo.cc b/source/blender/editors/sculpt_paint/sculpt_undo.cc index 060b1dfd141..71bd0a7e6d1 100644 --- a/source/blender/editors/sculpt_paint/sculpt_undo.cc +++ b/source/blender/editors/sculpt_paint/sculpt_undo.cc @@ -1658,8 +1658,9 @@ static void save_active_attribute(Object &object, SculptAttrRef *attr) } /** - * Does not save topology counts, as that data is unneded for full geometry pushes and - * requires the PBVH to exist. */ + * Does not save topology counts, as that data is unneeded for full geometry pushes and + * requires the PBVH to exist. + */ static void save_common_data(Object &ob, SculptUndoStep *us) { us->data.object_name = ob.id.name; diff --git a/source/blender/editors/space_image/image_ops.cc b/source/blender/editors/space_image/image_ops.cc index a7d0272a9e8..67fb6943a0f 100644 --- a/source/blender/editors/space_image/image_ops.cc +++ b/source/blender/editors/space_image/image_ops.cc @@ -1595,7 +1595,7 @@ static int image_file_browse_exec(bContext *C, wmOperator *op) char filepath[FILE_MAX]; RNA_string_get(op->ptr, "filepath", filepath); if (BLI_path_is_rel(filepath)) { - /* Relative path created by the filebrowser are always relative to the current blendfile, need + /* Relative path created by the file-browser are always relative to the current blendfile, need * to be made relative to the library blendfile path in case image is an editable linked data. */ BLI_path_abs(filepath, BKE_main_blendfile_path(CTX_data_main(C))); diff --git a/source/blender/editors/space_view3d/view3d_ops.cc b/source/blender/editors/space_view3d/view3d_ops.cc index 1d3a41140ae..989a15d30a2 100644 --- a/source/blender/editors/space_view3d/view3d_ops.cc +++ b/source/blender/editors/space_view3d/view3d_ops.cc @@ -73,9 +73,9 @@ static int view3d_copybuffer_exec(bContext *C, wmOperator *op) } CTX_DATA_END; - /* Explicitely adding an object to the copypaste buffer _may_ add others as dependencies (e.g. a + /* Explicitly adding an object to the copy/paste buffer _may_ add others as dependencies (e.g. a * parent object). So count to total amount of objects added, to get a matching number with the - * one reported by the 'paste' operation. */ + * one reported by the "paste" operation. */ const int num_copied = BLI_listbase_count(©buffer.bmain.objects); char filepath[FILE_MAX]; diff --git a/source/blender/editors/transform/transform_convert_curves.cc b/source/blender/editors/transform/transform_convert_curves.cc index 1be590c58d1..524f17f1338 100644 --- a/source/blender/editors/transform/transform_convert_curves.cc +++ b/source/blender/editors/transform/transform_convert_curves.cc @@ -45,7 +45,7 @@ static void create_aligned_handles_masks( CurvesTransformData &transform_data = *static_cast(custom_data.data); IndexMaskMemory memory; - /* When control point is selected both handles are treaded as selected and transformed together. + /* When control point is selected both handles are threaded as selected and transformed together. * So these will be excluded from alignment. */ const IndexMask &selected_points = points_to_transform_per_attr[0]; const IndexMask selected_left_handles = IndexMask::from_difference( diff --git a/source/blender/geometry/intern/mesh_triangulate.cc b/source/blender/geometry/intern/mesh_triangulate.cc index cd5d38992fb..2c977e416f3 100644 --- a/source/blender/geometry/intern/mesh_triangulate.cc +++ b/source/blender/geometry/intern/mesh_triangulate.cc @@ -771,11 +771,11 @@ std::optional mesh_triangulate(const Mesh &src_mesh, const IndexRange unselected_range(tris_range.one_after_last(), unselected.size()); /* Create a mesh with no face corners. - * - We haven't yet counted the number of corners from unselected faces. Creating the final face - * offsets will give us that number anyway, so wait to create the edges. - * - The number of edges is a guess that doesn't include deduplication of new edges with - * existing edges. If those are found, the mesh will be resized later. - * - Don't create attributes to facilite implicit sharing of the positions array. */ + * - We haven't yet counted the number of corners from unselected faces. Creating the final face + * offsets will give us that number anyway, so wait to create the edges. + * - The number of edges is a guess that doesn't include deduplication of new edges with + * existing edges. If those are found, the mesh will be resized later. + * - Don't create attributes to facilitate implicit sharing of the positions array. */ Mesh *mesh = bke::mesh_new_no_attributes(src_mesh.verts_num, src_edges.size() + tri_edges_range.size(), tris_range.size() + unselected.size(), @@ -828,7 +828,7 @@ std::optional mesh_triangulate(const Mesh &src_mesh, edges_with_duplicates.take_front(src_edges.size()).copy_from(src_edges); - /* Vertex attributes are totally unnaffected and can be shared with implicit sharing. + /* Vertex attributes are totally unaffected and can be shared with implicit sharing. * Use the #CustomData API for simpler support for vertex groups. */ CustomData_merge(&src_mesh.vert_data, &mesh->vert_data, CD_MASK_MESH.vmask, mesh->verts_num); diff --git a/source/blender/gpu/intern/gpu_shader_create_info.cc b/source/blender/gpu/intern/gpu_shader_create_info.cc index 1bb023456d8..e6b17f4512f 100644 --- a/source/blender/gpu/intern/gpu_shader_create_info.cc +++ b/source/blender/gpu/intern/gpu_shader_create_info.cc @@ -486,7 +486,7 @@ void gpu_shader_create_info_init() } if (GPU_stencil_clasify_buffer_workaround()) { - /* WORKAROUND: Adding a dummy buffer that isn't used fixes a bug inside the Qualcom driver. */ + /* WORKAROUND: Adding a dummy buffer that isn't used fixes a bug inside the Qualcomm driver. */ eevee_deferred_tile_classify.storage_buf( 12, Qualifier::READ_WRITE, "uint", "dummy_workaround_buf[]"); } diff --git a/source/blender/gpu/intern/gpu_storage_buffer.cc b/source/blender/gpu/intern/gpu_storage_buffer.cc index 6276168540b..c620bf3a8e1 100644 --- a/source/blender/gpu/intern/gpu_storage_buffer.cc +++ b/source/blender/gpu/intern/gpu_storage_buffer.cc @@ -66,7 +66,7 @@ GPUStorageBuf *GPU_storagebuf_create_ex(size_t size, } else if (G.debug & G_DEBUG_GPU) { /* Fill the buffer with poison values. - * (NaN for floats, -1 for ints and "max value" for uints). */ + * (NaN for floats, -1 for `int` and "max value" for `uint`). */ blender::Vector uninitialized_data(size, 0xFF); ssbo->update(uninitialized_data.data()); } diff --git a/source/blender/gpu/intern/gpu_uniform_buffer.cc b/source/blender/gpu/intern/gpu_uniform_buffer.cc index 9d42381175c..121a1aa8e9c 100644 --- a/source/blender/gpu/intern/gpu_uniform_buffer.cc +++ b/source/blender/gpu/intern/gpu_uniform_buffer.cc @@ -199,7 +199,7 @@ GPUUniformBuf *GPU_uniformbuf_create_ex(size_t size, const void *data, const cha } else if (G.debug & G_DEBUG_GPU) { /* Fill the buffer with poison values. - * (NaN for floats, -1 for ints and "max value" for uints). */ + * (NaN for floats, -1 for `int` and "max value" for `uint`). */ blender::Vector uninitialized_data(size, 0xFF); ubo->update(uninitialized_data.data()); } diff --git a/source/blender/gpu/shaders/CMakeLists.txt b/source/blender/gpu/shaders/CMakeLists.txt index 7195bb81b75..16f99a7af0f 100644 --- a/source/blender/gpu/shaders/CMakeLists.txt +++ b/source/blender/gpu/shaders/CMakeLists.txt @@ -85,7 +85,7 @@ set(SRC_GLSL_FRAG ) set(SRC_GLSL_COMP - # TODO rename them properly to enable compilatio + # TODO rename them properly to enable compilation. # gpu_shader_index_2d_array_lines.glsl # gpu_shader_index_2d_array_points.glsl # gpu_shader_index_2d_array_tris.glsl diff --git a/source/blender/gpu/shaders/gpu_shader_2D_node_socket_frag.glsl b/source/blender/gpu/shaders/gpu_shader_2D_node_socket_frag.glsl index d24e125e11d..20211ccdfa3 100644 --- a/source/blender/gpu/shaders/gpu_shader_2D_node_socket_frag.glsl +++ b/source/blender/gpu/shaders/gpu_shader_2D_node_socket_frag.glsl @@ -35,7 +35,7 @@ vec2 rotate_45(vec2 co) return from_rotation(Angle(M_PI * 0.25)) * co; } -/* Calculates an upper and lower limit for an antialiased cutoff of the squared distance. */ +/* Calculates an upper and lower limit for an anti-aliased cutoff of the squared distance. */ vec2 calculate_thresholds(float threshold) { /* Use the absolute on one of the factors to preserve the sign. */ diff --git a/source/blender/gpu/shaders/gpu_shader_2D_node_socket_vert.glsl b/source/blender/gpu/shaders/gpu_shader_2D_node_socket_vert.glsl index 9295e727d9a..a0ee8b04c12 100644 --- a/source/blender/gpu/shaders/gpu_shader_2D_node_socket_vert.glsl +++ b/source/blender/gpu/shaders/gpu_shader_2D_node_socket_vert.glsl @@ -18,7 +18,7 @@ VERTEX_SHADER_CREATE_INFO(gpu_shader_2D_node_socket_inst) void main() { - /* Scale the original rectangle to accomodate the diagonal of the diamond shape. */ + /* Scale the original rectangle to accommodate the diagonal of the diamond shape. */ vec2 originalRectSize = rect.yw - rect.xz; float offset = 0.125 * min(originalRectSize.x, originalRectSize.y) + outlineOffset * outlineThickness; diff --git a/source/blender/gpu/vulkan/render_graph/tests/vk_render_graph_test_scheduler.cc b/source/blender/gpu/vulkan/render_graph/tests/vk_render_graph_test_scheduler.cc index 1633c9476d9..672c8503eac 100644 --- a/source/blender/gpu/vulkan/render_graph/tests/vk_render_graph_test_scheduler.cc +++ b/source/blender/gpu/vulkan/render_graph/tests/vk_render_graph_test_scheduler.cc @@ -956,7 +956,7 @@ TEST(vk_render_graph, begin_update_draw_update_draw_update_draw_end) * When drawing, copying and continue drawing to an attachment, the attachment layout should be * transitioned. * - * This case happens when updating the swapchain image with the result of editors. + * This case happens when updating the swap-chain image with the result of editors. */ TEST(vk_render_graph, begin_draw_copy_to_attachment_draw_end) { diff --git a/source/blender/gpu/vulkan/vk_framebuffer.cc b/source/blender/gpu/vulkan/vk_framebuffer.cc index e1d8ff0e2ae..b1631e028cc 100644 --- a/source/blender/gpu/vulkan/vk_framebuffer.cc +++ b/source/blender/gpu/vulkan/vk_framebuffer.cc @@ -225,7 +225,7 @@ void VKFrameBuffer::clear(const eGPUFrameBufferBits buffers, needed_mask |= GPU_WRITE_STENCIL; } - /* Clearing depth via vkCmdClearAttachments requires a render pass with write depth or stencil + /* Clearing depth via #vkCmdClearAttachments requires a render pass with write depth or stencil * enabled. When not enabled, clearing should be done via texture directly. */ /* WORKAROUND: Clearing depth attachment when using dynamic rendering are not working on AMD * official drivers. @@ -616,7 +616,7 @@ void VKFrameBuffer::rendering_ensure_render_pass(VKContext &context) VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL; uint32_t attachment_reference = color_attachment_index - GPU_FB_COLOR_ATTACHMENT0; /* Depth attachment should always be right after the last color attachment. If not shaders - * cannot be reused between framebuffers with and without depth/stencil attachment*/ + * cannot be reused between frame-buffers with and without depth/stencil attachment. */ depth_attachment_reference.attachment = attachment_reference + 1; VkAttachmentDescription vk_attachment_description = {}; @@ -713,7 +713,7 @@ void VKFrameBuffer::rendering_ensure_render_pass(VKContext &context) } } - /* Subpass description */ + /* Sub-pass description. */ VkSubpassDescription vk_subpass_description = {}; vk_subpass_description.pipelineBindPoint = VK_PIPELINE_BIND_POINT_GRAPHICS; vk_subpass_description.colorAttachmentCount = color_attachments.size(); @@ -725,7 +725,7 @@ void VKFrameBuffer::rendering_ensure_render_pass(VKContext &context) } VKDevice &device = VKBackend::get().device; - /* Renderpass create info */ + /* Render-pass create info. */ VkRenderPassCreateInfo vk_render_pass_create_info = {}; vk_render_pass_create_info.sType = VK_STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO; vk_render_pass_create_info.subpassCount = 1; @@ -757,13 +757,14 @@ void VKFrameBuffer::rendering_ensure_render_pass(VKContext &context) context.render_graph.add_node(begin_rendering); - /* Load store operations are not supported inside a render pass. It requires duplicating render - * passes and framebuffers to support suspend/resume rendering. After suspension all the graphics - * pipelines needs to be created using the resume handles. Due to command reordering it is - * unclear when this switch needs to be made and would require to double the graphics pipelines. + /* Load store operations are not supported inside a render pass. + * It requires duplicating render passes and frame-buffers to support suspend/resume rendering. + * After suspension all the graphics pipelines needs to be created using the resume handles. + * Due to command reordering it is unclear when this switch needs to be made and would require + * to double the graphics pipelines. * * This all adds a lot of complexity just to support clearing ops on legacy platforms. An easier - * solution is to use vkCmdClearAttachments right after the begin rendering. + * solution is to use #vkCmdClearAttachments right after the begin rendering. */ if (use_explicit_load_store_) { render_graph::VKClearAttachmentsNode::CreateInfo clear_attachments = {}; diff --git a/source/blender/gpu/vulkan/vk_shader.cc b/source/blender/gpu/vulkan/vk_shader.cc index 8ebc095937b..96e553211a0 100644 --- a/source/blender/gpu/vulkan/vk_shader.cc +++ b/source/blender/gpu/vulkan/vk_shader.cc @@ -1058,9 +1058,9 @@ std::string VKShader::fragment_interface_declare(const shader::ShaderCreateInfo int fragment_out_location = 0; for (const ShaderCreateInfo::FragOut &output : info.fragment_outputs_) { /* When using dynamic rendering the attachment location doesn't change. When using render - * passes and subpasses the location refers to the color attachment of the subpass. + * passes and sub-passes the location refers to the color attachment of the sub-pass. * - * LIMITATION: dual source blending cannot be used together with subpasses. + * LIMITATION: dual source blending cannot be used together with sub-passes. */ const bool use_dual_blending = output.blend != DualBlend::NONE; BLI_assert_msg(!(use_dual_blending && !info.subpass_inputs_.is_empty()), diff --git a/source/blender/gpu/vulkan/vk_shader_interface.hh b/source/blender/gpu/vulkan/vk_shader_interface.hh index f21c200aabe..34c9fe35873 100644 --- a/source/blender/gpu/vulkan/vk_shader_interface.hh +++ b/source/blender/gpu/vulkan/vk_shader_interface.hh @@ -23,8 +23,9 @@ namespace blender::gpu { /** * Bind types to bind resources to a shader. * - * Keep in sync with gpu::shader::ShaderCreateInfo::Resource::BindType. - * We add the term `INPUT_ATTACHMENT` as it is stored as a subpass input in the shader create info. + * Keep in sync with #gpu::shader::ShaderCreateInfo::Resource::BindType. + * We add the term `INPUT_ATTACHMENT` as it is stored as a sub-pass + * input in the shader create info. */ /* TODO: Investigate if `TEXEL_BUFFER` can be added as well.*/ enum VKBindType { diff --git a/source/blender/io/usd/intern/usd_writer_material.cc b/source/blender/io/usd/intern/usd_writer_material.cc index 65ee69fe735..9e5d83a3940 100644 --- a/source/blender/io/usd/intern/usd_writer_material.cc +++ b/source/blender/io/usd/intern/usd_writer_material.cc @@ -992,9 +992,11 @@ static bNode *find_bsdf_node(Material *material) return nullptr; } -/* Returns the first occurrence of a scalar Displacment node found in the given - * material's node tree. Vector Displacement is not supported in the UsdPreviewSurface. - * Returns null if no instance of either type was found. */ +/** + * Returns the first occurrence of a scalar Displacement node found in the given + * material's node tree. Vector Displacement is not supported in the #UsdPreviewSurface. + * Returns null if no instance of either type was found. + */ static bNode *find_displacement_node(Material *material) { for (bNode *node : material->nodetree->all_nodes()) { diff --git a/source/blender/io/usd/intern/usd_writer_volume.cc b/source/blender/io/usd/intern/usd_writer_volume.cc index 92adb03ec84..fd5d4db7880 100644 --- a/source/blender/io/usd/intern/usd_writer_volume.cc +++ b/source/blender/io/usd/intern/usd_writer_volume.cc @@ -144,7 +144,7 @@ std::optional USDVolumeWriter::resolve_vdb_file(const Volume *volum const bool needs_vdb_save = volume->filepath[0] == '\0' || has_modifiers; if (needs_vdb_save) { /* Entering this section means that the Volume object contains OpenVDB data that is not - * obtained soley from external `.vdb` files but is generated or modified inside of Blender. + * obtained solely from external `.vdb` files but is generated or modified inside of Blender. * Write this data as a new `.vdb` files. */ vdb_file_path = construct_vdb_file_path(volume); diff --git a/source/blender/makesdna/DNA_sequence_types.h b/source/blender/makesdna/DNA_sequence_types.h index 5b82dc6ee7a..e5f08a3aa04 100644 --- a/source/blender/makesdna/DNA_sequence_types.h +++ b/source/blender/makesdna/DNA_sequence_types.h @@ -230,7 +230,7 @@ typedef struct Sequence { /* pointers for effects: */ struct Sequence *seq1, *seq2; - /* This strange padding is needed due to how seqbasep deserialization is + /* This strange padding is needed due to how `seqbasep` de-serialization is * done right now in #scene_blend_read_data. */ void *_pad7; int _pad8[2]; diff --git a/source/blender/modifiers/intern/MOD_grease_pencil_build.cc b/source/blender/modifiers/intern/MOD_grease_pencil_build.cc index 1a29ed2d345..9d228abf35c 100644 --- a/source/blender/modifiers/intern/MOD_grease_pencil_build.cc +++ b/source/blender/modifiers/intern/MOD_grease_pencil_build.cc @@ -507,7 +507,7 @@ static float get_factor_from_draw_speed(const bke::CurvesGeometry &curves, accumulated_shift_delta_time += math::max(shifted_start_time - start_times[curve], 0.0f); } - /* Caclulates the maximum time of this frame, which is the time between the beginning of the + /* Calculates the maximum time of this frame, which is the time between the beginning of the * first stroke and the end of the last stroke. `start_times.last()` gives the starting time of * the last stroke related to frame beginning, and `delta_time.last()` gives how long that stroke * lasted. */ diff --git a/source/blender/nodes/composite/nodes/node_composite_displace.cc b/source/blender/nodes/composite/nodes/node_composite_displace.cc index cc07294d8bd..e2bf508e017 100644 --- a/source/blender/nodes/composite/nodes/node_composite_displace.cc +++ b/source/blender/nodes/composite/nodes/node_composite_displace.cc @@ -112,7 +112,7 @@ class DisplaceOperation : public NodeOperation { /* In order to perform EWA sampling, we need to compute the partial derivative of the displaced * coordinates along the x and y directions using a finite difference approximation. But in - * order to avoid loading multiple neighbouring displacement values for each pixel, we operate + * order to avoid loading multiple neighboring displacement values for each pixel, we operate * on the image in 2x2 blocks of pixels, where the derivatives are computed horizontally and * vertically across the 2x2 block such that odd texels use a forward finite difference * equation while even invocations use a backward finite difference equation. */ diff --git a/source/blender/nodes/composite/nodes/node_composite_map_uv.cc b/source/blender/nodes/composite/nodes/node_composite_map_uv.cc index 49dc23248c7..671dc584890 100644 --- a/source/blender/nodes/composite/nodes/node_composite_map_uv.cc +++ b/source/blender/nodes/composite/nodes/node_composite_map_uv.cc @@ -166,7 +166,7 @@ class MapUVOperation : public NodeOperation { /* In order to perform EWA sampling, we need to compute the partial derivative of the UV * coordinates along the x and y directions using a finite difference approximation. But in - * order to avoid loading multiple neighbouring UV coordinates for each pixel, we operate on + * order to avoid loading multiple neighboring UV coordinates for each pixel, we operate on * the image in 2x2 blocks of pixels, where the derivatives are computed horizontally and * vertically across the 2x2 block such that odd texels use a forward finite difference * equation while even invocations use a backward finite difference equation. */ diff --git a/source/blender/nodes/composite/nodes/node_composite_tonemap.cc b/source/blender/nodes/composite/nodes/node_composite_tonemap.cc index d46845ffacc..f188c0b21bf 100644 --- a/source/blender/nodes/composite/nodes/node_composite_tonemap.cc +++ b/source/blender/nodes/composite/nodes/node_composite_tonemap.cc @@ -282,7 +282,7 @@ class ToneMapOperation : public NodeOperation { float4 adaptation_level = math::interpolate( global_adaptation_level, local_adaptation_level, light_adaptation); - /* Equation (1) from Reinhard's 2005 paper, assuming Vmax is 1. */ + /* Equation (1) from Reinhard's 2005 paper, assuming `Vmax` is 1. */ float4 semi_saturation = math::pow(intensity * adaptation_level, contrast); float4 tone_mapped_color = input_color / (input_color + semi_saturation); diff --git a/source/blender/python/bmesh/bmesh_py_ops.cc b/source/blender/python/bmesh/bmesh_py_ops.cc index 6864a456aa9..5a27d03d2f2 100644 --- a/source/blender/python/bmesh/bmesh_py_ops.cc +++ b/source/blender/python/bmesh/bmesh_py_ops.cc @@ -47,7 +47,7 @@ static char *bmp_slots_as_args(const BMOSlotType slot_types[BMO_OP_MAX_SLOTS], c while (*slot_types[i].name) { quoted = false; set = false; - /* cut off '.out' by using a string size arg */ + /* Cut off `.out` by using a string size argument. */ const int name_len = is_out ? (strchr(slot_types[i].name, '.') - slot_types[i].name) : sizeof(slot_types[i].name); const char *value = ""; diff --git a/source/blender/python/bmesh/bmesh_py_ops_call.cc b/source/blender/python/bmesh/bmesh_py_ops_call.cc index 624e4d02e98..c598ae54db1 100644 --- a/source/blender/python/bmesh/bmesh_py_ops_call.cc +++ b/source/blender/python/bmesh/bmesh_py_ops_call.cc @@ -837,7 +837,7 @@ PyObject *BPy_BMO_call(BPy_BMeshOpFunc *self, PyObject *args, PyObject *kw) } #if 1 - /* temp code, strip off '.out' while we keep this convention */ + /* Temporary code, strip off `.out` while we keep this convention. */ { char slot_name_strip[MAX_SLOTNAME]; const char *ch = strchr(slot->slot_name, '.'); /* can't fail! */ diff --git a/source/blender/python/intern/bpy_rna.cc b/source/blender/python/intern/bpy_rna.cc index 72ba02e4263..f1403be0595 100644 --- a/source/blender/python/intern/bpy_rna.cc +++ b/source/blender/python/intern/bpy_rna.cc @@ -6825,7 +6825,7 @@ PyTypeObject pyrna_struct_meta_idprop_Type = { * create property objects without initializing them, which avoids double-initialization from * functions like #pyrna_struct_CreatePyObject etc. * - * \note: Subclassingfrom python isn't common since it's NOT related to registerable subclasses. + * \note: Subclassing from Python isn't common since it's NOT related to registerable sub-classes. * eg: * * \code{.unparsed} @@ -6939,7 +6939,7 @@ static PyObject *pyrna_struct_new(PyTypeObject *type, PyObject *args, PyObject * * #pyrna_struct_init. */ } - /* Only allocate the pyobject data, do not construct/initialize anything else. */ + /* Only allocate the #PyObject data, do not construct/initialize anything else. */ PyObject *self = type->tp_alloc(type, 0); BPy_StructRNA *self_struct = reinterpret_cast(self); if (self) { @@ -7338,7 +7338,7 @@ static PyObject *pyrna_property_new(PyTypeObject *type, PyObject *args, PyObject * #pyrna_property_init. */ } - /* Only allocate the pyobject data, do not construct/initialize anything else. */ + /* Only allocate the #PyObject data, do not construct/initialize anything else. */ PyObject *self = type->tp_alloc(type, 0); BPy_PropertyRNA *self_property = reinterpret_cast(self); if (self) { @@ -7565,7 +7565,7 @@ static PyObject *pyrna_prop_collection_iter_new(PyTypeObject *type, return nullptr; } - /* Only allocate the pyobject data, do not construct/initialize anything else. */ + /* Only allocate the #PyObject data, do not construct/initialize anything else. */ PyObject *self = type->tp_alloc(type, 0); BPy_PropertyCollectionIterRNA *self_prop_iter = reinterpret_cast(self); @@ -7795,7 +7795,7 @@ static PyObject *pyrna_function_new(PyTypeObject *type, PyObject *args, PyObject return nullptr; } - /* Only allocate the pyobject data, do not construct/initialize anything else. */ + /* Only allocate the #PyObject data, do not construct/initialize anything else. */ PyObject *self = type->tp_alloc(type, 0); BPy_FunctionRNA *self_function = reinterpret_cast(self); if (self_function) { diff --git a/source/blender/sequencer/intern/effects.cc b/source/blender/sequencer/intern/effects.cc index 5d0bedb93a5..636d2fce863 100644 --- a/source/blender/sequencer/intern/effects.cc +++ b/source/blender/sequencer/intern/effects.cc @@ -1621,7 +1621,8 @@ static void glow_blur_bitmap( Array temp(width * height); - /* Initialize the gaussian filter. @TODO: use code from RE_filter_value */ + /* Initialize the gaussian filter. + * TODO: use code from #RE_filter_value. */ Array filter(halfWidth * 2); const float k = -1.0f / (2.0f * float(M_PI) * blur * blur); float weight = 0; diff --git a/source/creator/creator.cc b/source/creator/creator.cc index 2366060622e..053d94a3dda 100644 --- a/source/creator/creator.cc +++ b/source/creator/creator.cc @@ -310,7 +310,7 @@ int main(int argc, _putenv_s("OMP_WAIT_POLICY", "PASSIVE"); # endif /* Ensure the OpenMP runtime is initialized as soon as possible to make sure duplicate - * libomp/libiomp5 runtime conflicts are detected as soon as a second runtime is initialized. + * `libomp/libiomp5` runtime conflicts are detected as soon as a second runtime is initialized. * Initialization must be done after setting any relevant environment variables, but before * installing signal handlers. */ omp_get_max_threads(); diff --git a/tools/check_blender_release/check_static_binaries.py b/tools/check_blender_release/check_static_binaries.py index 692f5157e4a..b3e47fa570e 100644 --- a/tools/check_blender_release/check_static_binaries.py +++ b/tools/check_blender_release/check_static_binaries.py @@ -33,7 +33,7 @@ ALLOWED_LIBS = [ "libcrypt.so", "libuuid.so", - # Bundled python ncurses deps + # Bundled Python NCURSES dependencies. "libpanelw.so", "libncursesw.so", "libtinfo.so", @@ -195,7 +195,7 @@ class UnitTesting(unittest.TestCase): # Add all libraries the we bundle to the allowed list global ALLOWED_LIBS ALLOWED_LIBS += glob.glob("*.so", root_dir=args.directory + "/lib") - # Add OIDN libs that do not have a .so symlink + # Add OIDN libs that do not have an `.so` symbolic-link. for oidn_lib in glob.glob("libOpenImageDenoise_*.so*", root_dir=args.directory + "/lib"): ALLOWED_LIBS.append(stripLibraryABI(oidn_lib)) # Add all bundled python libs diff --git a/tools/check_source/check_spelling_config.py b/tools/check_source/check_spelling_config.py index 683e08f2b0e..f2cc6c0dbef 100644 --- a/tools/check_source/check_spelling_config.py +++ b/tools/check_source/check_spelling_config.py @@ -327,6 +327,7 @@ dict_custom = { "reimplemented", "reimplementing", "relink", + "relinked", "relinking", "remappable", "remapper", @@ -849,6 +850,7 @@ dict_ignore = { # Company names. "Logitech", + "Qualcomm", "Wacom", # Project Names. diff --git a/tools/utils_build/wheel_cleanup.py b/tools/utils_build/wheel_cleanup.py index b34ba0a6295..06616629710 100644 --- a/tools/utils_build/wheel_cleanup.py +++ b/tools/utils_build/wheel_cleanup.py @@ -26,8 +26,8 @@ from string import digits from typing import Generator -# Regex matchers for libraries that might be seen in the libs folder, not directly referenced, but -# yet are still required for the proper operation of the bpy module. +# REGEX matching for libraries that might be seen in the libs folder, not directly referenced, +# but yet are still required for the proper operation of the `bpy` module. KEEP_MATCHERS = ( # libOpenImageDenoise.so loads core, device_cuda, etc libraries at runtime. re.compile("libOpenImageDenoise_.*"), @@ -52,7 +52,7 @@ def get_direct_elf_dependencies(elf: Path) -> set[str]: """ Get direct dependencies of the given library or executable in ELF format - Uses readelf command and parses its output. + Uses ``readelf`` command and parses its output. """ output = subprocess.check_output(("readelf", "-d", elf)) deps = set() @@ -74,7 +74,7 @@ def name_strip_abi_suffix(name: str) -> str: """ Strip any ABI suffix from the given file name - For example: libfoo.so.1.2-3 -> linfoo.so + For example: ``libfoo.so.1.2-3`` -> ``linfoo.so``. """ while name[-1] in digits: