Cleanup: comment spelling & punctuation

18 files changed, 32 insertions, 27 deletions

diff --git a/source/blender/blenfont/intern/blf_font.c b/source/blender/blenfont/intern/blf_font.c
index 2c7ffbe8e42..74c4c684d6b 100644
--- a/source/blender/blenfont/intern/blf_font.c
+++ b/source/blender/blenfont/intern/blf_font.c
@@ -66,7 +66,7 @@
 /* Batching buffer for drawing. */
 BatchBLF g_batch;
 
-/* freetype2 handle ONLY for this file!. */
+/* freetype2 handle ONLY for this file! */
 static FT_Library ft_lib;
 static SpinLock ft_lib_mutex;
 static SpinLock blf_glyph_cache_mutex;
diff --git a/source/blender/blenkernel/intern/layer.c b/source/blender/blenkernel/intern/layer.c
index 0a0705649bc..61b031396dd 100644
--- a/source/blender/blenkernel/intern/layer.c
+++ b/source/blender/blenkernel/intern/layer.c
@@ -743,7 +743,7 @@ int BKE_layer_collection_findindex(ViewLayer *view_layer, const LayerCollection
  * called a lot (e.g. during massive remappings of IDs).
  *
  * Usage of these should be done very carefully though. In particular, calling
- * code must ensures it resync LayerCollections before any UI/Eevnt loop
+ * code must ensures it resync LayerCollections before any UI/Event loop
  * handling can happen.
  *
  * WARNING: This is not threadsafe at all, only use from main thread.
diff --git a/source/blender/compositor/intern/COM_ExecutionSystem.h b/source/blender/compositor/intern/COM_ExecutionSystem.h
index ad6f9fd4bdb..bce96db52c7 100644
--- a/source/blender/compositor/intern/COM_ExecutionSystem.h
+++ b/source/blender/compositor/intern/COM_ExecutionSystem.h
@@ -208,8 +208,8 @@ class ExecutionSystem {
   void execute_work(const rcti &work_rect, std::function<void(const rcti &split_rect)> work_func);
 
   /**
-   * Multi-threadedly execute given work function passing work_rect splits as argument. On
-   * finished, caller thread will call reduce_func for each thread result.
+   * Multi-threaded execution of given work function passing work_rect splits as argument.
+   * Once finished, caller thread will call reduce_func for each thread result.
    */
   template<typename TResult>
   void execute_work(const rcti &work_rect,
diff --git a/source/blender/editors/animation/anim_channels_edit.c b/source/blender/editors/animation/anim_channels_edit.c
index 8f8c1c067d4..c6c7cc4adb0 100644
--- a/source/blender/editors/animation/anim_channels_edit.c
+++ b/source/blender/editors/animation/anim_channels_edit.c
@@ -2026,7 +2026,7 @@ static const EnumPropertyItem prop_animchannel_settings_types[] = {
  * \param mode: eAnimChannels_SetFlag.
  * \param onlysel: only selected channels get the flag set.
  *
- * TODO: enable a setting which turns flushing on/off?.
+ * TODO: enable a setting which turns flushing on/off?
  */
 static void setflag_anim_channels(bAnimContext *ac,
                                   eAnimChannel_Settings setting,
diff --git a/source/blender/editors/armature/armature_utils.c b/source/blender/editors/armature/armature_utils.c
index 874f1b49451..4fe4422e4e0 100644
--- a/source/blender/editors/armature/armature_utils.c
+++ b/source/blender/editors/armature/armature_utils.c
@@ -107,7 +107,7 @@ int bone_looper(Object *ob, Bone *bone, void *data, int (*bone_func)(Object *, B
 {
   /* We want to apply the function bone_func to every bone
    * in an armature -- feed bone_looper the first bone and
-   * a pointer to the bone_func and watch it go!. The int count
+   * a pointer to the bone_func and watch it go! The int count
    * can be useful for counting bones with a certain property
    * (e.g. skinnable)
    */
diff --git a/source/blender/editors/gpencil/gpencil_armature.c b/source/blender/editors/gpencil/gpencil_armature.c
index c800851bb08..86ec6c53fe6 100644
--- a/source/blender/editors/gpencil/gpencil_armature.c
+++ b/source/blender/editors/gpencil/gpencil_armature.c
@@ -80,7 +80,7 @@ static int gpencil_bone_looper(Object *ob,
 {
   /* We want to apply the function bone_func to every bone
    * in an armature -- feed bone_looper the first bone and
-   * a pointer to the bone_func and watch it go!. The int count
+   * a pointer to the bone_func and watch it go! The int count
    * can be useful for counting bones with a certain property
    * (e.g. skinnable)
    */
diff --git a/source/blender/editors/include/ED_anim_api.h b/source/blender/editors/include/ED_anim_api.h
index 50e53acb376..75c02082bd3 100644
--- a/source/blender/editors/include/ED_anim_api.h
+++ b/source/blender/editors/include/ED_anim_api.h
@@ -290,7 +290,7 @@ typedef enum eAnimFilter_Flags {
    * (i.e. scene visibility criteria).
    *
    * XXX: it's hard to think of any examples where this *ISN'T* the case...
-   * perhaps becomes implicit?.
+   * perhaps becomes implicit?
    */
   ANIMFILTER_DATA_VISIBLE = (1 << 0),
   /** channel is visible within the channel-list hierarchy
diff --git a/source/blender/editors/space_node/drawnode.cc b/source/blender/editors/space_node/drawnode.cc
index df3afb42ab2..95eb1ccc025 100644
--- a/source/blender/editors/space_node/drawnode.cc
+++ b/source/blender/editors/space_node/drawnode.cc
@@ -165,7 +165,7 @@ static void node_buts_curvevec(uiLayout *layout, bContext *UNUSED(C), PointerRNA
 }
 
 #define SAMPLE_FLT_ISNONE FLT_MAX
-/* bad bad, 2.5 will do better?... no it won't... */
+/* Bad bad, 2.5 will do better? ... no it won't! */
 static float _sample_col[4] = {SAMPLE_FLT_ISNONE};
 void ED_node_sample_set(const float col[4])
 {
diff --git a/source/blender/makesdna/DNA_armature_types.h b/source/blender/makesdna/DNA_armature_types.h
index f397b7f27b4..454d843112a 100644
--- a/source/blender/makesdna/DNA_armature_types.h
+++ b/source/blender/makesdna/DNA_armature_types.h
@@ -76,7 +76,12 @@ typedef struct Bone {
 
   /** dist, weight: for non-deformgroup deforms. */
   float dist, weight;
-  /** width: for block bones. keep in this order, transform!. */
+  /**
+   * The width for block bones.
+   *
+   * \note keep in this order for transform code which stores a pointer to `xwidth`,
+   * accessing length and `zwidth` as offsets.
+   */
   float xwidth, length, zwidth;
   /**
    * Radius for head/tail sphere, defining deform as well,
diff --git a/source/blender/makesdna/DNA_freestyle_types.h b/source/blender/makesdna/DNA_freestyle_types.h
index 884e11f3a8e..4d4fbaed29a 100644
--- a/source/blender/makesdna/DNA_freestyle_types.h
+++ b/source/blender/makesdna/DNA_freestyle_types.h
@@ -145,7 +145,7 @@ typedef struct FreestyleConfig {
   int flags;
   float sphere_radius;
   float dkr_epsilon;
-  /** In radians!. */
+  /** In radians. */
   float crease_angle;
 
   ListBase linesets;
diff --git a/source/blender/makesdna/DNA_ipo_types.h b/source/blender/makesdna/DNA_ipo_types.h
index 4f71a257877..e2fdd19232c 100644
--- a/source/blender/makesdna/DNA_ipo_types.h
+++ b/source/blender/makesdna/DNA_ipo_types.h
@@ -82,7 +82,7 @@ typedef struct IpoCurve {
   char _pad0[2];
   /** Minimum/maximum y-extents for curve. */
   float ymin, ymax;
-  /** ???. */
+  /** Unused since the first available revision. */
   unsigned int bitmask;
 
   /** Minimum/maximum values for sliders (in action editor). */
diff --git a/source/blender/makesdna/DNA_linestyle_types.h b/source/blender/makesdna/DNA_linestyle_types.h
index b154de4507e..d83e24c5117 100644
--- a/source/blender/makesdna/DNA_linestyle_types.h
+++ b/source/blender/makesdna/DNA_linestyle_types.h
@@ -382,7 +382,7 @@ typedef struct LineStyleGeometryModifier_PerlinNoise1D {
   struct LineStyleModifier modifier;
 
   float frequency, amplitude;
-  /** In radians!. */
+  /** In radians. */
   float angle;
   unsigned int octaves;
   int seed;
@@ -393,7 +393,7 @@ typedef struct LineStyleGeometryModifier_PerlinNoise2D {
   struct LineStyleModifier modifier;
 
   float frequency, amplitude;
-  /** In radians!. */
+  /** In radians. */
   float angle;
   unsigned int octaves;
   int seed;
@@ -463,7 +463,7 @@ typedef struct LineStyleGeometryModifier_2DTransform {
 
   int pivot;
   float scale_x, scale_y;
-  /** In radians!. */
+  /** In radians. */
   float angle;
   float pivot_u;
   float pivot_x, pivot_y;
@@ -483,7 +483,7 @@ typedef struct LineStyleThicknessModifier_Calligraphy {
   struct LineStyleModifier modifier;
 
   float min_thickness, max_thickness;
-  /** In radians!. */
+  /** In radians. */
   float orientation;
   char _pad[4];
 } LineStyleThicknessModifier_Calligraphy;
diff --git a/source/blender/makesdna/DNA_mesh_types.h b/source/blender/makesdna/DNA_mesh_types.h
index c54c086affd..b59ea838719 100644
--- a/source/blender/makesdna/DNA_mesh_types.h
+++ b/source/blender/makesdna/DNA_mesh_types.h
@@ -175,7 +175,7 @@ typedef struct Mesh {
   struct Mesh *texcomesh;
 
   /* When the object is available, the preferred access method is: BKE_editmesh_from_object(ob) */
-  /** Not saved in file!. */
+  /** Not saved in file. */
   struct BMEditMesh *edit_mesh;
 
   struct CustomData vdata, edata, fdata;
diff --git a/source/blender/makesdna/DNA_modifier_types.h b/source/blender/makesdna/DNA_modifier_types.h
index 99c346bf589..f66de378c35 100644
--- a/source/blender/makesdna/DNA_modifier_types.h
+++ b/source/blender/makesdna/DNA_modifier_types.h
@@ -952,7 +952,7 @@ typedef struct MeshDeformModifierData {
   MDefCell *dyngrid;
   /** Dynamic binding vertex influences. */
   MDefInfluence *dyninfluences;
-  /** Is this vertex bound or not?. */
+  /** Is this vertex bound or not? */
   int *dynverts;
   /** Size of the dynamic bind grid. */
   int dyngridsize;
@@ -1469,7 +1469,7 @@ typedef struct WeightVGEditModifierData {
   float default_weight;
 
   /* Mapping stuff. */
-  /** The custom mapping curve!. */
+  /** The custom mapping curve. */
   struct CurveMapping *cmap_curve;
 
   /* The add/remove vertices weight thresholds. */
@@ -1543,7 +1543,7 @@ typedef struct WeightVGMixModifierData {
   struct Object *mask_tex_map_obj;
   /** Name of the map bone. */
   char mask_tex_map_bone[64];
-  /** How to map the texture!. */
+  /** How to map the texture. */
   int mask_tex_mapping;
   /** Name of the UV map. MAX_CUSTOMDATA_LAYER_NAME. */
   char mask_tex_uvlayer_name[64];
@@ -1601,7 +1601,7 @@ typedef struct WeightVGProximityModifierData {
   char defgrp_name[64];
 
   /* Mapping stuff. */
-  /** The custom mapping curve!. */
+  /** The custom mapping curve. */
   struct CurveMapping *cmap_curve;
 
   /* Proximity modes. */
@@ -1626,7 +1626,7 @@ typedef struct WeightVGProximityModifierData {
   struct Object *mask_tex_map_obj;
   /** Name of the map bone. */
   char mask_tex_map_bone[64];
-  /** How to map the texture!. */
+  /** How to map the texture. */
   int mask_tex_mapping;
   /** Name of the UV Map. MAX_CUSTOMDATA_LAYER_NAME. */
   char mask_tex_uvlayer_name[64];
diff --git a/source/blender/makesdna/DNA_scene_types.h b/source/blender/makesdna/DNA_scene_types.h
index 000db5bf5b1..05bd88acab0 100644
--- a/source/blender/makesdna/DNA_scene_types.h
+++ b/source/blender/makesdna/DNA_scene_types.h
@@ -734,7 +734,7 @@ typedef struct RenderData {
 
   /* sequencer options */
   char seq_prev_type;
-  /** UNUSED!. */
+  /** UNUSED. */
   char seq_rend_type;
   /** Flag use for sequence render/draw. */
   char seq_flag;
@@ -1535,7 +1535,7 @@ typedef struct ToolSettings {
 
 typedef struct UnitSettings {
   /* Display/Editing unit options for each scene */
-  /** Maybe have other unit conversions?. */
+  /** Maybe have other unit conversions? */
   float scale_length;
   /** Imperial, metric etc. */
   char system;
diff --git a/source/blender/makesrna/intern/rna_asset.c b/source/blender/makesrna/intern/rna_asset.c
index 484b7593812..80b2594d0c9 100644
--- a/source/blender/makesrna/intern/rna_asset.c
+++ b/source/blender/makesrna/intern/rna_asset.c
@@ -233,7 +233,7 @@ static void rna_def_asset_data(BlenderRNA *brna)
 
   srna = RNA_def_struct(brna, "AssetMetaData", NULL);
   RNA_def_struct_ui_text(srna, "Asset Data", "Additional data stored for an asset data-block");
-  //  RNA_def_struct_ui_icon(srna, ICON_ASSET); /* TODO: Icon doesn't exist!. */
+  //  RNA_def_struct_ui_icon(srna, ICON_ASSET); /* TODO: Icon doesn't exist! */
   /* The struct has custom properties, but no pointer properties to other IDs! */
   RNA_def_struct_idprops_func(srna, "rna_AssetMetaData_idprops");
   RNA_def_struct_flag(srna, STRUCT_NO_DATABLOCK_IDPROPERTIES); /* Mandatory! */
diff --git a/source/blender/makesrna/intern/rna_wm.c b/source/blender/makesrna/intern/rna_wm.c
index 9b4089b272c..667f3822935 100644
--- a/source/blender/makesrna/intern/rna_wm.c
+++ b/source/blender/makesrna/intern/rna_wm.c
@@ -1912,7 +1912,7 @@ static void rna_def_operator(BlenderRNA *brna)
   /* Registration */
   prop = RNA_def_property(srna, "bl_idname", PROP_STRING, PROP_NONE);
   RNA_def_property_string_sdna(prop, NULL, "type->idname");
-  /* else it uses the pointer size!. -3 because '.' -> '_OT_' */
+  /* Without setting the length the pointer size would be used. -3 because `.` -> `_OT_`. */
   RNA_def_property_string_maxlength(prop, OP_MAX_TYPENAME - 3);
   RNA_def_property_string_funcs(prop, NULL, NULL, "rna_Operator_bl_idname_set");
   /* RNA_def_property_clear_flag(prop, PROP_EDITABLE); */
diff --git a/source/blender/windowmanager/gizmo/WM_gizmo_types.h b/source/blender/windowmanager/gizmo/WM_gizmo_types.h
index 1fbbec7f949..eab62ffce4c 100644
--- a/source/blender/windowmanager/gizmo/WM_gizmo_types.h
+++ b/source/blender/windowmanager/gizmo/WM_gizmo_types.h
@@ -186,7 +186,7 @@ typedef enum eWM_GizmoFlagMapTypeUpdateFlag {
  * \brief Gizmo tweak flag.
  * Bitflag passed to gizmo while tweaking.
  *
- * \note Gizmos are responsible for handling this #wmGizmo.modal callback!.
+ * \note Gizmos are responsible for handling this #wmGizmo.modal callback.
  */
 typedef enum {
   /* Drag with extra precision (Shift). */