From e62b5e867d164d6ee822e369885d979d94ac4106 Mon Sep 17 00:00:00 2001
From: Campbell Barton <campbell@blender.org>
Date: Tue, 3 May 2022 15:11:27 +1000
Subject: Cleanup: spelling in comments

---
 source/blender/blenkernel/BKE_lib_principle_properties.h       |  2 +-
 source/blender/blenkernel/BKE_modifier.h                       |  2 +-
 source/blender/blenkernel/BKE_paint.h                          |  2 +-
 source/blender/blenkernel/intern/blendfile_link_append.c       |  2 +-
 source/blender/draw/engines/eevee/eevee_cryptomatte.c          |  2 +-
 source/blender/draw/engines/eevee/eevee_private.h              |  4 ++--
 source/blender/draw/engines/eevee_next/eevee_defines.hh        |  8 +++++---
 source/blender/draw/engines/eevee_next/eevee_instance.cc       |  4 ++--
 source/blender/draw/engines/eevee_next/eevee_material.hh       |  6 +++---
 source/blender/draw/engines/eevee_next/eevee_shader.cc         | 10 +++++-----
 source/blender/draw/engines/eevee_next/eevee_shader.hh         |  2 +-
 source/blender/draw/engines/eevee_next/eevee_shader_shared.hh  |  2 +-
 source/blender/draw/engines/eevee_next/eevee_sync.hh           |  2 +-
 source/blender/draw/engines/eevee_next/eevee_view.cc           | 10 +++++-----
 source/blender/draw/engines/eevee_next/eevee_view.hh           |  4 ++--
 source/blender/draw/engines/eevee_next/eevee_world.hh          |  2 +-
 .../engines/eevee_next/shaders/infos/eevee_material_info.hh    |  2 +-
 .../blender/draw/engines/overlay/shaders/infos/extra_info.hh   |  2 +-
 .../blender/draw/engines/overlay/shaders/infos/volume_info.hh  |  2 +-
 .../draw/engines/overlay/shaders/infos/wireframe_info.hh       |  2 +-
 .../draw/engines/select/shaders/infos/select_id_info.hh        |  2 +-
 source/blender/editors/gpencil/gpencil_sculpt_paint.c          |  2 +-
 source/blender/editors/sculpt_paint/paint_vertex.cc            |  2 +-
 source/blender/gpu/metal/mtl_texture.hh                        |  2 +-
 source/blender/gpu/metal/mtl_texture.mm                        |  4 ++--
 .../gpu/shaders/infos/gpu_shader_3D_uniform_color_info.hh      |  2 +-
 .../io/wavefront_obj/importer/obj_import_file_reader.cc        |  4 ++--
 source/blender/makesdna/DNA_layer_types.h                      |  2 +-
 source/blender/windowmanager/WM_types.h                        |  5 +++--
 29 files changed, 50 insertions(+), 47 deletions(-)

(limited to 'source/blender')

diff --git a/source/blender/blenkernel/BKE_lib_principle_properties.h b/source/blender/blenkernel/BKE_lib_principle_properties.h
index 10d0d33a0c4..42177204efb 100644
--- a/source/blender/blenkernel/BKE_lib_principle_properties.h
+++ b/source/blender/blenkernel/BKE_lib_principle_properties.h
@@ -40,7 +40,7 @@ struct ReportList;
 struct IDPrincipleProperties *BKE_lib_principleprop_init(struct ID *id);
 #if 0
 /**
- * Shallow or deep copy of a whole princple properties from \a src_id to \a dst_id.
+ * Shallow or deep copy of a whole principle properties from \a src_id to \a dst_id.
  */
 void BKE_lib_principleprop_copy(struct ID *dst_id, const struct ID *src_id, bool do_full_copy);
 #endif
diff --git a/source/blender/blenkernel/BKE_modifier.h b/source/blender/blenkernel/BKE_modifier.h
index 881e86ccc54..a38bfb497a2 100644
--- a/source/blender/blenkernel/BKE_modifier.h
+++ b/source/blender/blenkernel/BKE_modifier.h
@@ -113,7 +113,7 @@ typedef enum ModifierApplyFlag {
   /** Render time. */
   MOD_APPLY_RENDER = 1 << 0,
   /** Result of evaluation will be cached, so modifier might
-   * want to cache data for quick updates (used by subsurf) */
+   * want to cache data for quick updates (used by subdivision-surface) */
   MOD_APPLY_USECACHE = 1 << 1,
   /** Modifier evaluated for undeformed texture coordinates */
   MOD_APPLY_ORCO = 1 << 2,
diff --git a/source/blender/blenkernel/BKE_paint.h b/source/blender/blenkernel/BKE_paint.h
index 0e976f04dd1..03cbcf575c3 100644
--- a/source/blender/blenkernel/BKE_paint.h
+++ b/source/blender/blenkernel/BKE_paint.h
@@ -733,7 +733,7 @@ enum {
 /* paint_vertex.cc */
 
 /**
- * Fills the object's active color atribute layer with the fill color.
+ * Fills the object's active color attribute layer with the fill color.
  *
  * \param[in] ob: The object.
  * \param[in] fill_color: The fill color.
diff --git a/source/blender/blenkernel/intern/blendfile_link_append.c b/source/blender/blenkernel/intern/blendfile_link_append.c
index 555c4690308..e2f22ef00d3 100644
--- a/source/blender/blenkernel/intern/blendfile_link_append.c
+++ b/source/blender/blenkernel/intern/blendfile_link_append.c
@@ -1564,7 +1564,7 @@ void BKE_blendfile_library_relocate(BlendfileLinkAppendContext *lapp_context,
       }
 
       if (GS(old_id->name) == ID_KE) {
-        /* Shape Keys are handled as part of their owning obdata (see below). This implies thar
+        /* Shape Keys are handled as part of their owning obdata (see below). This implies that
          * there is no way to know when the old pointer gets invalid, so just clear it immediately.
          */
         item->userdata = NULL;
diff --git a/source/blender/draw/engines/eevee/eevee_cryptomatte.c b/source/blender/draw/engines/eevee/eevee_cryptomatte.c
index 50302eaa87a..161555208f3 100644
--- a/source/blender/draw/engines/eevee/eevee_cryptomatte.c
+++ b/source/blender/draw/engines/eevee/eevee_cryptomatte.c
@@ -68,7 +68,7 @@ BLI_INLINE int eevee_cryptomatte_layers_count(const ViewLayer *view_layer)
 }
 
 /* The number of render result passes are needed to store a single cryptomatte layer. Per
- * renderpass 2 cryptomatte samples can be stored. */
+ * render-pass 2 cryptomatte samples can be stored. */
 BLI_INLINE int eevee_cryptomatte_passes_per_layer(const ViewLayer *view_layer)
 {
   const int num_cryptomatte_levels = view_layer->cryptomatte_levels;
diff --git a/source/blender/draw/engines/eevee/eevee_private.h b/source/blender/draw/engines/eevee/eevee_private.h
index ee336326166..3a86640134c 100644
--- a/source/blender/draw/engines/eevee/eevee_private.h
+++ b/source/blender/draw/engines/eevee/eevee_private.h
@@ -301,7 +301,7 @@ typedef struct EEVEE_PassList {
   struct DRWPass *maxz_copydepth_ps;
   struct DRWPass *maxz_copydepth_layer_ps;
 
-  /* Renderpass Accumulation. */
+  /* Render-pass Accumulation. */
   struct DRWPass *material_accum_ps;
   struct DRWPass *background_accum_ps;
   struct DRWPass *cryptomatte_ps;
@@ -1067,7 +1067,7 @@ typedef struct EEVEE_PrivateData {
   GPUTexture *renderpass_col_input;
   GPUTexture *renderpass_light_input;
   GPUTexture *renderpass_transmittance_input;
-  /* Renderpass ubo reference used by material pass. */
+  /* Render-pass UBO reference used by material pass. */
   struct GPUUniformBuf *renderpass_ubo;
   /** For rendering shadows. */
   struct DRWView *cube_views[6];
diff --git a/source/blender/draw/engines/eevee_next/eevee_defines.hh b/source/blender/draw/engines/eevee_next/eevee_defines.hh
index 35eb33671db..7141928a20d 100644
--- a/source/blender/draw/engines/eevee_next/eevee_defines.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_defines.hh
@@ -11,9 +11,11 @@
 
 #pragma once
 
-/* Number of items in a culling batch. Needs to be Power of 2. Must be <= to 65536. */
-/* Current limiting factor is the sorting phase which is single pass and only sort within a
- * threadgroup which maximum size is 1024. */
+/**
+   Number of items in a culling batch. Needs to be Power of 2. Must be <= to 65536.
+ * Current limiting factor is the sorting phase which is single pass and only sort within a
+ * thread-group which maximum size is 1024.
+ */
 #define CULLING_BATCH_SIZE 1024
 
 /**
diff --git a/source/blender/draw/engines/eevee_next/eevee_instance.cc b/source/blender/draw/engines/eevee_next/eevee_instance.cc
index f03bd9d0692..b369e536454 100644
--- a/source/blender/draw/engines/eevee_next/eevee_instance.cc
+++ b/source/blender/draw/engines/eevee_next/eevee_instance.cc
@@ -21,9 +21,9 @@
 namespace blender::eevee {
 
 /* -------------------------------------------------------------------- */
-/** \name Init
+/** \name Initialization
  *
- * Init funcions need to be called once at the start of a frame.
+ * Initialization functions need to be called once at the start of a frame.
  * Active camera, render extent and enabled render passes are immutable until next init.
  * This takes care of resizing output buffers and view in case a parameter changed.
  * IMPORTANT: xxx.init() functions are NOT meant to acquire and allocate DRW resources.
diff --git a/source/blender/draw/engines/eevee_next/eevee_material.hh b/source/blender/draw/engines/eevee_next/eevee_material.hh
index 0c454128aba..5c8188c7cf0 100644
--- a/source/blender/draw/engines/eevee_next/eevee_material.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_material.hh
@@ -104,7 +104,7 @@ static inline eMaterialGeometry to_material_geometry(const Object *ob)
   }
 }
 
-/** Unique key to identify each material in the hashmap. */
+/** Unique key to identify each material in the hash-map. */
 struct MaterialKey {
   Material *mat;
   uint64_t options;
@@ -169,7 +169,7 @@ struct ShaderKey {
 /** \} */
 
 /* -------------------------------------------------------------------- */
-/** \name Default Material Nodetree
+/** \name Default Material Node-Tree
  *
  * In order to support materials without nodetree we reuse and configure a standalone nodetree that
  * we pass for shader generation. The GPUMaterial is still stored inside the Material even if
@@ -254,4 +254,4 @@ class MaterialModule {
 
 /** \} */
 
-}  // namespace blender::eevee
\ No newline at end of file
+}  // namespace blender::eevee
diff --git a/source/blender/draw/engines/eevee_next/eevee_shader.cc b/source/blender/draw/engines/eevee_next/eevee_shader.cc
index 086c5f9f358..39c5cf6a536 100644
--- a/source/blender/draw/engines/eevee_next/eevee_shader.cc
+++ b/source/blender/draw/engines/eevee_next/eevee_shader.cc
@@ -25,7 +25,7 @@ ShaderModule *ShaderModule::g_shader_module = nullptr;
 ShaderModule *ShaderModule::module_get()
 {
   if (g_shader_module == nullptr) {
-    /* TODO(fclem) threadsafety. */
+    /* TODO(@fclem) thread-safety. */
     g_shader_module = new ShaderModule();
   }
   return g_shader_module;
@@ -34,7 +34,7 @@ ShaderModule *ShaderModule::module_get()
 void ShaderModule::module_free()
 {
   if (g_shader_module != nullptr) {
-    /* TODO(fclem) threadsafety. */
+    /* TODO(@fclem) thread-safety. */
     delete g_shader_module;
     g_shader_module = nullptr;
   }
@@ -148,7 +148,7 @@ void ShaderModule::material_create_info_ammend(GPUMaterial *gpumat, GPUCodegenOu
       /** Noop. */
       break;
     case MAT_GEOM_CURVES:
-      /** Hair attributes comme from sampler buffer. Transfer attributes to sampler. */
+      /** Hair attributes come from sampler buffer. Transfer attributes to sampler. */
       for (auto &input : info.vertex_inputs_) {
         if (input.name == "orco") {
           /** NOTE: Orco is generated from strand position for now. */
@@ -163,14 +163,14 @@ void ShaderModule::material_create_info_ammend(GPUMaterial *gpumat, GPUCodegenOu
     case MAT_GEOM_WORLD:
       /**
        * Only orco layer is supported by world and it is procedurally generated. These are here to
-       * make the attribs_load function calls valids.
+       * make the attribs_load function calls valid.
        */
       ATTR_FALLTHROUGH;
     case MAT_GEOM_GPENCIL:
       /**
        * Only one uv and one color attribute layer are supported by gpencil objects and they are
        * already declared in another createInfo. These are here to make the attribs_load
-       * function calls valids.
+       * function calls valid.
        */
       for (auto &input : info.vertex_inputs_) {
         global_vars << input.type << " " << input.name << ";\n";
diff --git a/source/blender/draw/engines/eevee_next/eevee_shader.hh b/source/blender/draw/engines/eevee_next/eevee_shader.hh
index ba7c97b3b6a..29fcbafb167 100644
--- a/source/blender/draw/engines/eevee_next/eevee_shader.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_shader.hh
@@ -36,7 +36,7 @@ class ShaderModule {
  private:
   std::array<GPUShader *, MAX_SHADER_TYPE> shaders_;
 
-  /** Shared shader module accross all engine instances. */
+  /** Shared shader module across all engine instances. */
   static ShaderModule *g_shader_module;
 
  public:
diff --git a/source/blender/draw/engines/eevee_next/eevee_shader_shared.hh b/source/blender/draw/engines/eevee_next/eevee_shader_shared.hh
index 2c539339952..3c890de09a0 100644
--- a/source/blender/draw/engines/eevee_next/eevee_shader_shared.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_shader_shared.hh
@@ -26,7 +26,7 @@ using draw::TextureFromPool;
 #define UBO_MIN_MAX_SUPPORTED_SIZE 1 << 14
 
 /* -------------------------------------------------------------------- */
-/** \name Raytracing
+/** \name Ray-Tracing
  * \{ */
 
 enum eClosureBits : uint32_t {
diff --git a/source/blender/draw/engines/eevee_next/eevee_sync.hh b/source/blender/draw/engines/eevee_next/eevee_sync.hh
index 6ad9347abbc..3f58ca14778 100644
--- a/source/blender/draw/engines/eevee_next/eevee_sync.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_sync.hh
@@ -27,7 +27,7 @@ class Instance;
 /* -------------------------------------------------------------------- */
 /** \name ObjectKey
  *
- * Unique key to identify each object in the hashmap.
+ * Unique key to identify each object in the hash-map.
  * \{ */
 
 struct ObjectKey {
diff --git a/source/blender/draw/engines/eevee_next/eevee_view.cc b/source/blender/draw/engines/eevee_next/eevee_view.cc
index 5125d51c9dc..074bc8b02aa 100644
--- a/source/blender/draw/engines/eevee_next/eevee_view.cc
+++ b/source/blender/draw/engines/eevee_next/eevee_view.cc
@@ -9,7 +9,7 @@
  * - The entire main view.
  * - A fragment of the main view (for panoramic projections).
  * - A shadow map view.
- * - A lightprobe view (either planar, cubemap, irradiance grid).
+ * - A light-probe view (either planar, cube-map, irradiance grid).
  *
  * A pass is a container for scene data. It is view agnostic but has specific logic depending on
  * its type. Passes are shared between views.
@@ -40,7 +40,7 @@ void ShadingView::sync(int2 render_extent_)
     int64_t render_pixel_count = render_extent_.x * (int64_t)render_extent_.y;
     /* Divide pixel count between the 6 views. Rendering to a square target. */
     extent_[0] = extent_[1] = ceilf(sqrtf(1 + (render_pixel_count / 6)));
-    /* TODO(fclem) Clip unused views heres. */
+    /* TODO(@fclem): Clip unused views here. */
     is_enabled_ = true;
   }
   else {
@@ -60,8 +60,8 @@ void ShadingView::sync(int2 render_extent_)
   const float(*viewmat_p)[4] = viewmat.ptr(), (*winmat_p)[4] = winmat.ptr();
 #if 0
   if (false /* inst_.camera.is_panoramic() */) {
-    /* TODO(fclem) Overscans. */
-    /* For now a mandatory 5% overscan for DoF. */
+    /* TODO(@fclem) Over-scans. */
+    /* For now a mandatory 5% over-scan for DoF. */
     float side = data.clip_near * 1.05f;
     float near = data.clip_near;
     float far = data.clip_far;
@@ -204,4 +204,4 @@ void ShadingView::update_view(void)
 
 /** \} */
 
-}  // namespace blender::eevee
\ No newline at end of file
+}  // namespace blender::eevee
diff --git a/source/blender/draw/engines/eevee_next/eevee_view.hh b/source/blender/draw/engines/eevee_next/eevee_view.hh
index 16c2184784c..e0ba4485365 100644
--- a/source/blender/draw/engines/eevee_next/eevee_view.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_view.hh
@@ -8,7 +8,7 @@
  * A view is either:
  * - The entire main view.
  * - A portion of the main view (for panoramic projections).
- * - A lightprobe view (either planar, cubemap, irradiance grid).
+ * - A light-probe view (either planar, cube-map, irradiance grid).
  *
  * A pass is a container for scene data. It is view agnostic but has specific logic depending on
  * its type. Passes are shared between views.
@@ -154,4 +154,4 @@ class MainView {
 
 /** \} */
 
-}  // namespace blender::eevee
\ No newline at end of file
+}  // namespace blender::eevee
diff --git a/source/blender/draw/engines/eevee_next/eevee_world.hh b/source/blender/draw/engines/eevee_next/eevee_world.hh
index a7b77ef2e62..ff5be774b90 100644
--- a/source/blender/draw/engines/eevee_next/eevee_world.hh
+++ b/source/blender/draw/engines/eevee_next/eevee_world.hh
@@ -18,7 +18,7 @@ namespace blender::eevee {
 class Instance;
 
 /* -------------------------------------------------------------------- */
-/** \name Default World Nodetree
+/** \name Default World Node-Tree
  *
  * In order to support worlds without nodetree we reuse and configure a standalone nodetree that
  * we pass for shader generation. The GPUMaterial is still stored inside the World even if
diff --git a/source/blender/draw/engines/eevee_next/shaders/infos/eevee_material_info.hh b/source/blender/draw/engines/eevee_next/shaders/infos/eevee_material_info.hh
index 13269d833e8..9ee51262a0c 100644
--- a/source/blender/draw/engines/eevee_next/shaders/infos/eevee_material_info.hh
+++ b/source/blender/draw/engines/eevee_next/shaders/infos/eevee_material_info.hh
@@ -93,7 +93,7 @@ GPU_SHADER_CREATE_INFO(eevee_surf_forward)
     .fragment_source("eevee_surf_forward_frag.glsl")
     // .additional_info("eevee_sampling_data",
     //  "eevee_lightprobe_data",
-    /* Optionnally added depending on the material. */
+    /* Optionally added depending on the material. */
     // "eevee_raytrace_data",
     // "eevee_transmittance_data",
     //  "eevee_utility_texture",
diff --git a/source/blender/draw/engines/overlay/shaders/infos/extra_info.hh b/source/blender/draw/engines/overlay/shaders/infos/extra_info.hh
index a765d881682..b9b1b73dbd4 100644
--- a/source/blender/draw/engines/overlay/shaders/infos/extra_info.hh
+++ b/source/blender/draw/engines/overlay/shaders/infos/extra_info.hh
@@ -284,7 +284,7 @@ GPU_SHADER_INTERFACE_INFO(overlay_particle_iface, "").flat(Type::VEC4, "finalCol
 
 GPU_SHADER_CREATE_INFO(overlay_particle)
     .sampler(0, ImageType::FLOAT_1D, "weightTex")
-    .push_constant(Type::VEC4, "color") /* Drawsize packed in alpha */
+    .push_constant(Type::VEC4, "color") /* Draw-size packed in alpha. */
     .vertex_in(0, Type::VEC3, "part_pos")
     .vertex_in(1, Type::VEC4, "part_rot")
     .vertex_in(2, Type::FLOAT, "part_val")
diff --git a/source/blender/draw/engines/overlay/shaders/infos/volume_info.hh b/source/blender/draw/engines/overlay/shaders/infos/volume_info.hh
index 713c8c2dc4b..5853e974eeb 100644
--- a/source/blender/draw/engines/overlay/shaders/infos/volume_info.hh
+++ b/source/blender/draw/engines/overlay/shaders/infos/volume_info.hh
@@ -48,7 +48,7 @@ GPU_SHADER_CREATE_INFO(overlay_volume_velocity_needle)
 /** \} */
 
 /* -------------------------------------------------------------------- */
-/** \name Volume Gridlines
+/** \name Volume Grid-Lines
  * \{ */
 
 GPU_SHADER_INTERFACE_INFO(overlay_volume_gridlines_iface, "").flat(Type::VEC4, "finalColor");
diff --git a/source/blender/draw/engines/overlay/shaders/infos/wireframe_info.hh b/source/blender/draw/engines/overlay/shaders/infos/wireframe_info.hh
index 43367121d6a..16b59f6bb7d 100644
--- a/source/blender/draw/engines/overlay/shaders/infos/wireframe_info.hh
+++ b/source/blender/draw/engines/overlay/shaders/infos/wireframe_info.hh
@@ -21,7 +21,7 @@ GPU_SHADER_CREATE_INFO(overlay_wireframe)
     .sampler(0, ImageType::DEPTH_2D, "depthTex")
     .vertex_in(0, Type::VEC3, "pos")
     .vertex_in(1, Type::VEC3, "nor")
-    .vertex_in(2, Type::FLOAT, "wd") /* wiredata */
+    .vertex_in(2, Type::FLOAT, "wd") /* wire-data. */
     .vertex_out(overlay_wireframe_iface)
     .vertex_source("wireframe_vert.glsl")
     .fragment_source("wireframe_frag.glsl")
diff --git a/source/blender/draw/engines/select/shaders/infos/select_id_info.hh b/source/blender/draw/engines/select/shaders/infos/select_id_info.hh
index ad0de61ffc3..e3166582197 100644
--- a/source/blender/draw/engines/select/shaders/infos/select_id_info.hh
+++ b/source/blender/draw/engines/select/shaders/infos/select_id_info.hh
@@ -3,7 +3,7 @@
 #include "gpu_shader_create_info.hh"
 
 /* -------------------------------------------------------------------- */
-/** \name Select ID fo Edit Mesh selection
+/** \name Select ID for Edit Mesh Selection
  * \{ */
 
 GPU_SHADER_INTERFACE_INFO(select_id_iface, "").flat(Type::INT, "id");
diff --git a/source/blender/editors/gpencil/gpencil_sculpt_paint.c b/source/blender/editors/gpencil/gpencil_sculpt_paint.c
index ae40c76916b..01ac02a9a1d 100644
--- a/source/blender/editors/gpencil/gpencil_sculpt_paint.c
+++ b/source/blender/editors/gpencil/gpencil_sculpt_paint.c
@@ -146,7 +146,7 @@ typedef struct tGP_BrushEditData {
   float inv_mat[4][4];
 
   RNG *rng;
-  /* Automasking strokes. */
+  /* Auto-masking strokes. */
   struct GHash *automasking_strokes;
   bool automasking_ready;
 
diff --git a/source/blender/editors/sculpt_paint/paint_vertex.cc b/source/blender/editors/sculpt_paint/paint_vertex.cc
index 747295f3de0..a1dac4e6ce5 100644
--- a/source/blender/editors/sculpt_paint/paint_vertex.cc
+++ b/source/blender/editors/sculpt_paint/paint_vertex.cc
@@ -4145,7 +4145,7 @@ static bool vertex_color_set(Object *ob, ColorPaint4f paintcol_in, Color *color_
 }
 
 /**
- * Fills the object's active color atribute layer with the fill color.
+ * Fills the object's active color attribute layer with the fill color.
  *
  * \param[in] ob: The object.
  * \param[in] fill_color: The fill color.
diff --git a/source/blender/gpu/metal/mtl_texture.hh b/source/blender/gpu/metal/mtl_texture.hh
index 94892544f96..43287bc92f4 100644
--- a/source/blender/gpu/metal/mtl_texture.hh
+++ b/source/blender/gpu/metal/mtl_texture.hh
@@ -240,7 +240,7 @@ class MTLTexture : public Texture {
   id<MTLBuffer> vert_buffer_mtl_;
   int vert_buffer_offset_;
 
-  /* Core parameters and subresources. */
+  /* Core parameters and sub-resources. */
   eGPUTextureUsage gpu_image_usage_flags_;
 
   /* Whether the texture's properties or state has changed (e.g. mipmap range), and re-baking of
diff --git a/source/blender/gpu/metal/mtl_texture.mm b/source/blender/gpu/metal/mtl_texture.mm
index aedccc60920..b201999c7b7 100644
--- a/source/blender/gpu/metal/mtl_texture.mm
+++ b/source/blender/gpu/metal/mtl_texture.mm
@@ -1767,8 +1767,8 @@ void gpu::MTLTexture::ensure_baked()
       /* CUBE TEXTURES */
       case GPU_TEXTURE_CUBE:
       case GPU_TEXTURE_CUBE_ARRAY: {
-        /* Note: For a cubemap 'Texture::d_' refers to total number of faces, not just array slices
-         */
+        /* NOTE: For a cube-map 'Texture::d_' refers to total number of faces,
+         * not just array slices. */
         BLI_assert(this->w_ > 0 && this->h_ > 0);
         this->texture_descriptor_ = [[MTLTextureDescriptor alloc] init];
         this->texture_descriptor_.pixelFormat = mtl_format;
diff --git a/source/blender/gpu/shaders/infos/gpu_shader_3D_uniform_color_info.hh b/source/blender/gpu/shaders/infos/gpu_shader_3D_uniform_color_info.hh
index 369fe3ac293..ae7edeb16e2 100644
--- a/source/blender/gpu/shaders/infos/gpu_shader_3D_uniform_color_info.hh
+++ b/source/blender/gpu/shaders/infos/gpu_shader_3D_uniform_color_info.hh
@@ -28,7 +28,7 @@ GPU_SHADER_CREATE_INFO(gpu_shader_3D_clipped_uniform_color)
     .fragment_out(0, Type::VEC4, "fragColor")
     .push_constant(Type::MAT4, "ModelViewProjectionMatrix")
     .push_constant(Type::VEC4, "color")
-    /* TODO(fclem): Put thoses two to one UBO. */
+    /* TODO(@fclem): Put those two to one UBO. */
     .push_constant(Type::MAT4, "ModelMatrix")
     .push_constant(Type::VEC4, "ClipPlane")
     .vertex_source("gpu_shader_3D_clipped_uniform_color_vert.glsl")
diff --git a/source/blender/io/wavefront_obj/importer/obj_import_file_reader.cc b/source/blender/io/wavefront_obj/importer/obj_import_file_reader.cc
index 56806449733..de96dacce0d 100644
--- a/source/blender/io/wavefront_obj/importer/obj_import_file_reader.cc
+++ b/source/blender/io/wavefront_obj/importer/obj_import_file_reader.cc
@@ -320,8 +320,8 @@ static bool parse_keyword(StringRef &line, StringRef keyword)
   if (!line.startswith(keyword)) {
     return false;
   }
-  /* Treat any ASCII control character as whitespace; don't use isspace() for performance reasons.
-   */
+  /* Treat any ASCII control character as white-space;
+   * don't use `isspace()` for performance reasons. */
   if (line[keyword_len] > ' ') {
     return false;
   }
diff --git a/source/blender/makesdna/DNA_layer_types.h b/source/blender/makesdna/DNA_layer_types.h
index d5f7e25bb80..4ee5f34fcde 100644
--- a/source/blender/makesdna/DNA_layer_types.h
+++ b/source/blender/makesdna/DNA_layer_types.h
@@ -125,7 +125,7 @@ typedef struct ViewLayerAOV {
   int type;
 } ViewLayerAOV;
 
-/* Lightgroup Renderpass definition. */
+/** Light-group Render-pass definition. */
 typedef struct ViewLayerLightgroup {
   struct ViewLayerLightgroup *next, *prev;
 
diff --git a/source/blender/windowmanager/WM_types.h b/source/blender/windowmanager/WM_types.h
index a9b8d91ca03..3ee5c85c031 100644
--- a/source/blender/windowmanager/WM_types.h
+++ b/source/blender/windowmanager/WM_types.h
@@ -1193,8 +1193,9 @@ typedef struct wmDropBox {
                        struct wmDrag *drag,
                        const int xy[2]);
 
-  /** Called with the draw buffer (#GPUViewport) set up for drawing into the region's view.
-   * \note Only setups the drawing buffer for drawing in view, not the GPU transform matricies.
+  /**
+   * Called with the draw buffer (#GPUViewport) set up for drawing into the region's view.
+   * \note Only setups the drawing buffer for drawing in view, not the GPU transform matrices.
    * The callback has to do that itself, with for example #UI_view2d_view_ortho.
    * \param xy: Cursor location in window coordinates (#wmEvent.xy compatible).
    */
-- 
cgit v1.2.3