Cleanup: Grammar in comments

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.

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
+# Usage: Select a light in the 3D view and drag the arrow at its rear
-# to change it's energy value.
+# to change its energy value.
 #
 import bpy
 from bpy.types import (

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
+   * \note When the mesh's `runtime->deformed_only` is true, the meshes vertex positions
-   * and other geometry arrays will be aligned the edit-mesh.
+   * and other geometry arrays will be aligned the edit-mesh. Otherwise the #CD_ORIGINDEX
-   * Otherwise the #CD_ORIGINDEX custom-data should be used to map the cage geometry
+   * custom-data should be used to map the cage geometry back to the original indices, see
-   * back to the original indices, see #eModifierTypeFlag_SupportsMapping.
+   * #eModifierTypeFlag_SupportsMapping.
    */
   Mesh *editmesh_eval_cage = nullptr;
 

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:

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;
         }

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,

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.

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.

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

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

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
 
 /* ************************************************ */

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;

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.).

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;