From 6438d0ad1f6a8999a975216967abd1430126fa72 Mon Sep 17 00:00:00 2001
From: Hans Goudey <hans@blender.org>
Date: Thu, 11 Jan 2024 11:01:44 -0500
Subject: [PATCH] Cleanup: Grammar in comments

---
 intern/ghost/intern/GHOST_SystemWayland.cc           |  2 +-
 scripts/templates_py/gizmo_simple.py                 |  4 ++--
 source/blender/blenkernel/BKE_object_types.hh        |  8 ++++----
 source/blender/blenkernel/BKE_subdiv.hh              |  2 +-
 source/blender/editors/animation/anim_filter.cc      |  2 +-
 .../blender/editors/curves/intern/curves_extrude.cc  |  2 +-
 source/blender/editors/include/ED_object.hh          |  2 +-
 source/blender/editors/include/ED_view3d.hh          |  4 ++--
 source/blender/gpu/GPU_state.h                       |  2 +-
 .../shaders/common/gpu_shader_math_vector_lib.glsl   | 12 ++++++------
 source/blender/makesdna/DNA_anim_types.h             |  2 +-
 source/blender/makesdna/DNA_node_types.h             |  4 ++--
 source/blender/makesrna/RNA_types.hh                 |  2 +-
 source/blender/windowmanager/intern/wm_playanim.cc   |  2 +-
 14 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/intern/ghost/intern/GHOST_SystemWayland.cc b/intern/ghost/intern/GHOST_SystemWayland.cc
index 8d2fa14e29e..7037889e90b 100644
--- a/intern/ghost/intern/GHOST_SystemWayland.cc
+++ b/intern/ghost/intern/GHOST_SystemWayland.cc
@@ -1327,7 +1327,7 @@ struct GWL_Display {
 };
 
 /**
- * Free the #GWL_Display and it's related members.
+ * Free the #GWL_Display and its related members.
  *
  * \note This may run on a partially initialized struct,
  * so it can't be assumed all members are set.
diff --git a/scripts/templates_py/gizmo_simple.py b/scripts/templates_py/gizmo_simple.py
index 65d125adecc..d222e8b49d7 100644
--- a/scripts/templates_py/gizmo_simple.py
+++ b/scripts/templates_py/gizmo_simple.py
@@ -1,8 +1,8 @@
 # Example of a group that edits a single property
 # using the predefined gizmo arrow.
 #
-# Usage: Select a light in the 3D view and drag the arrow at it's rear
-# to change it's energy value.
+# Usage: Select a light in the 3D view and drag the arrow at its rear
+# to change its energy value.
 #
 import bpy
 from bpy.types import (
diff --git a/source/blender/blenkernel/BKE_object_types.hh b/source/blender/blenkernel/BKE_object_types.hh
index c0c3f072ab8..fcfbedb4284 100644
--- a/source/blender/blenkernel/BKE_object_types.hh
+++ b/source/blender/blenkernel/BKE_object_types.hh
@@ -90,10 +90,10 @@ struct ObjectRuntime {
   /**
    * Evaluated mesh cage in edit mode.
    *
-   * \note When it's `runtime->deformed_only` is true, the meshes vertex positions
-   * and other geometry arrays will be aligned the edit-mesh.
-   * Otherwise the #CD_ORIGINDEX custom-data should be used to map the cage geometry
-   * back to the original indices, see #eModifierTypeFlag_SupportsMapping.
+   * \note When the mesh's `runtime->deformed_only` is true, the meshes vertex positions
+   * and other geometry arrays will be aligned the edit-mesh. Otherwise the #CD_ORIGINDEX
+   * custom-data should be used to map the cage geometry back to the original indices, see
+   * #eModifierTypeFlag_SupportsMapping.
    */
   Mesh *editmesh_eval_cage = nullptr;
 
diff --git a/source/blender/blenkernel/BKE_subdiv.hh b/source/blender/blenkernel/BKE_subdiv.hh
index 31c082b0434..887acf036fc 100644
--- a/source/blender/blenkernel/BKE_subdiv.hh
+++ b/source/blender/blenkernel/BKE_subdiv.hh
@@ -37,7 +37,7 @@ enum eSubdivFVarLinearInterpolation {
 };
 
 struct SubdivSettings {
-  /* Simple subdivision corresponds to "Simple" option in the interface. When it's enabled the
+  /* Simple subdivision corresponds to "Simple" option in the interface. When it's enabled, the
    * subdivided mesh is not "smoothed": new vertices are added uniformly on the existing surface.
    *
    * On an OpenSubdiv implementation level this translates to a subdivision scheme:
diff --git a/source/blender/editors/animation/anim_filter.cc b/source/blender/editors/animation/anim_filter.cc
index c7811d5ebb4..5e93a8e7d58 100644
--- a/source/blender/editors/animation/anim_filter.cc
+++ b/source/blender/editors/animation/anim_filter.cc
@@ -1108,7 +1108,7 @@ static bool skip_fcurve_selected_data(bDopeSheet *ads, FCurve *fcu, ID *owner_id
          * since data-paths that point to missing strips are not shown.
          * If this is an important difference, the nullptr case could perform a global lookup,
          * only returning `true` if the sequence strip exists elsewhere
-         * (ignoring it's selection state). */
+         * (ignoring its selection state). */
         if (seq == nullptr) {
           return true;
         }
diff --git a/source/blender/editors/curves/intern/curves_extrude.cc b/source/blender/editors/curves/intern/curves_extrude.cc
index 5829ffe5cff..b36a8b05300 100644
--- a/source/blender/editors/curves/intern/curves_extrude.cc
+++ b/source/blender/editors/curves/intern/curves_extrude.cc
@@ -75,7 +75,7 @@ static bool handle_range(const int curve_index,
 }
 
 /**
- * Calculates number of points in resulting curve denoted by #curve_index and sets it's
+ * Calculates number of points in resulting curve denoted by #curve_index and sets its
  * #curve_offsets value.
  */
 static void calc_curve_offset(const int curve_index,
diff --git a/source/blender/editors/include/ED_object.hh b/source/blender/editors/include/ED_object.hh
index 0c7327e8225..3b0820df312 100644
--- a/source/blender/editors/include/ED_object.hh
+++ b/source/blender/editors/include/ED_object.hh
@@ -453,7 +453,7 @@ void ED_object_posemode_set_for_weight_paint(bContext *C,
  * Return the index of an object in a mode (typically edit/pose mode).
  *
  * Useful for operators with multi-mode editing to be able to redo an action on an object
- * by it's index which (unlike pointers) the operator can store for redo.
+ * by its index which (unlike pointers) the operator can store for redo.
  *
  * The indices aren't intended to be useful from Python scripts,
  * although they are not prevented from passing them in, this is mainly to enable redo.
diff --git a/source/blender/editors/include/ED_view3d.hh b/source/blender/editors/include/ED_view3d.hh
index e0fee701e3a..449262d8ed9 100644
--- a/source/blender/editors/include/ED_view3d.hh
+++ b/source/blender/editors/include/ED_view3d.hh
@@ -652,7 +652,7 @@ bool ED_view3d_win_to_3d_on_plane_int(
  * \param region: The region (used for the window width and height).
  * \param xy_delta: 2D difference (in pixels) such as `event->mval[0] - other_x`.
  * \param zfac: The depth result typically calculated by #ED_view3d_calc_zfac
- * (see it's doc-string for details).
+ * (see its doc-string for details).
  * \param r_out: The resulting world-space delta.
  */
 void ED_view3d_win_to_delta(const ARegion *region,
@@ -936,7 +936,7 @@ ViewContext ED_view3d_viewcontext_init(bContext *C, Depsgraph *depsgraph);
  * Re-initialize `vc` with `obact` as if it's active object (with some differences).
  *
  * This is often used when operating on multiple objects in modes (edit, pose mode etc)
- * where the `vc` is passed in as an argument which then references it's object data.
+ * where the `vc` is passed in as an argument which then references its object data.
  *
  * \note members #ViewContext.obedit & #ViewContext.em are only initialized if they're already set,
  * by #ED_view3d_viewcontext_init in most cases.
diff --git a/source/blender/gpu/GPU_state.h b/source/blender/gpu/GPU_state.h
index edf5678ef55..63c22540610 100644
--- a/source/blender/gpu/GPU_state.h
+++ b/source/blender/gpu/GPU_state.h
@@ -156,7 +156,7 @@ void GPU_line_smooth(bool enable);
 /**
  * \note By convention, this is set as needed and not reset back to 1.0.
  * This means code that draws lines must always set the line width beforehand,
- * but is not expected to restore it's previous value.
+ * but is not expected to restore its previous value.
  */
 void GPU_line_width(float width);
 void GPU_logic_op_xor_set(bool enable);
diff --git a/source/blender/gpu/shaders/common/gpu_shader_math_vector_lib.glsl b/source/blender/gpu/shaders/common/gpu_shader_math_vector_lib.glsl
index 4181503d25a..f538de374b8 100644
--- a/source/blender/gpu/shaders/common/gpu_shader_math_vector_lib.glsl
+++ b/source/blender/gpu/shaders/common/gpu_shader_math_vector_lib.glsl
@@ -469,7 +469,7 @@ vec2 normalize_and_get_length(vec2 vector, out float out_length)
     out_length = sqrt(out_length);
     return vector / out_length;
   }
-  /* Either the vector is small or one of it's values contained `nan`. */
+  /* Either the vector is small or one of its values contained `nan`. */
   out_length = 0.0;
   return vec2(0.0);
 }
@@ -481,7 +481,7 @@ vec3 normalize_and_get_length(vec3 vector, out float out_length)
     out_length = sqrt(out_length);
     return vector / out_length;
   }
-  /* Either the vector is small or one of it's values contained `nan`. */
+  /* Either the vector is small or one of its values contained `nan`. */
   out_length = 0.0;
   return vec3(0.0);
 }
@@ -493,7 +493,7 @@ vec4 normalize_and_get_length(vec4 vector, out float out_length)
     out_length = sqrt(out_length);
     return vector / out_length;
   }
-  /* Either the vector is small or one of it's values contained `nan`. */
+  /* Either the vector is small or one of its values contained `nan`. */
   out_length = 0.0;
   return vec4(0.0);
 }
@@ -506,7 +506,7 @@ vec2 safe_normalize_and_get_length(vec2 vector, out float out_length)
     out_length = sqrt(out_length);
     return vector / out_length;
   }
-  /* Either the vector is small or one of it's values contained `nan`. */
+  /* Either the vector is small or one of its values contained `nan`. */
   out_length = 0.0;
   return vec2(1.0, 0.0);
 }
@@ -518,7 +518,7 @@ vec3 safe_normalize_and_get_length(vec3 vector, out float out_length)
     out_length = sqrt(out_length);
     return vector / out_length;
   }
-  /* Either the vector is small or one of it's values contained `nan`. */
+  /* Either the vector is small or one of its values contained `nan`. */
   out_length = 0.0;
   return vec3(1.0, 0.0, 0.0);
 }
@@ -530,7 +530,7 @@ vec4 safe_normalize_and_get_length(vec4 vector, out float out_length)
     out_length = sqrt(out_length);
     return vector / out_length;
   }
-  /* Either the vector is small or one of it's values contained `nan`. */
+  /* Either the vector is small or one of its values contained `nan`. */
   out_length = 0.0;
   return vec4(1.0, 0.0, 0.0, 0.0);
 }
diff --git a/source/blender/makesdna/DNA_anim_types.h b/source/blender/makesdna/DNA_anim_types.h
index 0f45ff46eab..0aa6271ad00 100644
--- a/source/blender/makesdna/DNA_anim_types.h
+++ b/source/blender/makesdna/DNA_anim_types.h
@@ -1206,7 +1206,7 @@ typedef struct IdAdtTemplate {
   AnimData *adt;
 } IdAdtTemplate;
 
-/* From: `DNA_object_types.h`, see it's doc-string there. */
+/* From: `DNA_object_types.h`, see its doc-string there. */
 #define SELECT 1
 
 /* ************************************************ */
diff --git a/source/blender/makesdna/DNA_node_types.h b/source/blender/makesdna/DNA_node_types.h
index 383ba5a2c3c..f14b5d9f7c3 100644
--- a/source/blender/makesdna/DNA_node_types.h
+++ b/source/blender/makesdna/DNA_node_types.h
@@ -731,7 +731,7 @@ typedef struct bNodeTree {
   const bNode *find_nested_node(int32_t nested_node_id) const;
 
   /**
-   * Update a run-time cache for the node tree based on it's current state. This makes many methods
+   * Update a run-time cache for the node tree based on its current state. This makes many methods
    * available which allow efficient lookup for topology information (like neighboring sockets).
    */
   void ensure_topology_cache() const;
@@ -786,7 +786,7 @@ typedef struct bNodeTree {
   const blender::bke::bNodeTreeZones *zones() const;
 
   /**
-   * Update a run-time cache for the node tree interface based on it's current state.
+   * Update a run-time cache for the node tree interface based on its current state.
    * This should be done before accessing interface item spans below.
    */
   void ensure_interface_cache() const;
diff --git a/source/blender/makesrna/RNA_types.hh b/source/blender/makesrna/RNA_types.hh
index 98f190280d0..a88400a0ef8 100644
--- a/source/blender/makesrna/RNA_types.hh
+++ b/source/blender/makesrna/RNA_types.hh
@@ -560,7 +560,7 @@ typedef void (*StringPropertySearchVisitFunc)(void *visit_user_data,
 /**
  * \param C: context, may be NULL (in this case all available items should be shown).
  * \param ptr: RNA pointer.
- * \param prop: RNA property. This must have it's #StringPropertyRNA.search callback set,
+ * \param prop: RNA property. This must have its #StringPropertyRNA.search callback set,
  * to check this use `RNA_property_string_search_flag(prop) & PROP_STRING_SEARCH_SUPPORTED`.
  * \param edit_text: Optionally use the string being edited by the user as a basis
  * for the search results (auto-complete Python attributes for e.g.).
diff --git a/source/blender/windowmanager/intern/wm_playanim.cc b/source/blender/windowmanager/intern/wm_playanim.cc
index b95693811cd..29eb433ea99 100644
--- a/source/blender/windowmanager/intern/wm_playanim.cc
+++ b/source/blender/windowmanager/intern/wm_playanim.cc
@@ -351,7 +351,7 @@ struct PlayAnimPict {
 /**
  * Various globals relating to playback.
  * \note Avoid adding members here where possible,
- * prefer #PlayState or one of it's members where possible.
+ * prefer #PlayState or one of its members where possible.
  */
 static struct {
   bool from_disk;