Cleanup: spelling in comments

17 files changed, 34 insertions, 32 deletions

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");