[Bf-blender-cvs] [b331acf4771] master: Cleanup: comment spelling & punctuation

YimingWu noreply at git.blender.org
Tue Jul 27 10:15:07 CEST 2021


Commit: b331acf477125121b109e743c00fd214f7aaf6a1
Author: YimingWu
Date:   Tue Jul 27 14:02:22 2021 +0800
Branches: master
https://developer.blender.org/rBb331acf477125121b109e743c00fd214f7aaf6a1

Cleanup: comment spelling & punctuation

===================================================================

M	source/blender/blenfont/intern/blf_font.c
M	source/blender/blenkernel/intern/layer.c
M	source/blender/compositor/intern/COM_ExecutionSystem.h
M	source/blender/editors/animation/anim_channels_edit.c
M	source/blender/editors/armature/armature_utils.c
M	source/blender/editors/gpencil/gpencil_armature.c
M	source/blender/editors/include/ED_anim_api.h
M	source/blender/editors/space_node/drawnode.cc
M	source/blender/makesdna/DNA_armature_types.h
M	source/blender/makesdna/DNA_freestyle_types.h
M	source/blender/makesdna/DNA_ipo_types.h
M	source/blender/makesdna/DNA_linestyle_types.h
M	source/blender/makesdna/DNA_mesh_types.h
M	source/blender/makesdna/DNA_modifier_types.h
M	source/blender/makesdna/DNA_scene_types.h
M	source/blender/makesrna/intern/rna_asset.c
M	source/blender/makesrna/intern/rna_wm.c
M	source/blender/windowmanager/gizmo/WM_gizmo_types.h

===================================================================

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_curv

@@ Diff output truncated at 10240 characters. @@



More information about the Bf-blender-cvs mailing list