Cleanup: spelling
authorCampbell Barton <ideasman42@gmail.com>
Fri, 16 Aug 2019 14:54:22 +0000 (00:54 +1000)
committerCampbell Barton <ideasman42@gmail.com>
Fri, 16 Aug 2019 14:57:05 +0000 (00:57 +1000)
72 files changed:
intern/cycles/bvh/bvh4.cpp
intern/cycles/kernel/filter/filter_transform.h
intern/cycles/kernel/kernel_shader.h
intern/cycles/render/stats.h
intern/cycles/util/util_vector.h
release/scripts/modules/bl_i18n_utils/utils.py
release/scripts/modules/bpy_extras/mesh_utils.py
release/scripts/startup/bl_operators/anim.py
source/blender/blenkernel/intern/armature_update.c
source/blender/blenkernel/intern/customdata.c
source/blender/blenkernel/intern/editmesh.c
source/blender/blenkernel/intern/library.c
source/blender/blenkernel/intern/mask.c
source/blender/blenkernel/intern/mball.c
source/blender/blenkernel/intern/mesh_evaluate.c
source/blender/blenkernel/intern/object_update.c
source/blender/blenkernel/intern/ocean.c
source/blender/blenkernel/intern/softbody.c
source/blender/blenlib/intern/BLI_ghash.c
source/blender/blenlib/intern/boxpack_2d.c
source/blender/blenlib/intern/math_geom.c
source/blender/blenloader/BLO_blend_defs.h
source/blender/blenloader/intern/readfile.c
source/blender/blenloader/intern/versioning_280.c
source/blender/blenloader/intern/writefile.c
source/blender/bmesh/intern/bmesh_mesh_conv.c
source/blender/bmesh/intern/bmesh_polygon.c
source/blender/bmesh/tools/bmesh_decimate_collapse.c
source/blender/bmesh/tools/bmesh_decimate_unsubdivide.c
source/blender/bmesh/tools/bmesh_region_match.c
source/blender/compositor/intern/COM_MemoryBuffer.h
source/blender/compositor/nodes/COM_ImageNode.cpp
source/blender/compositor/operations/COM_ColorBalanceLGGOperation.cpp
source/blender/compositor/operations/COM_MaskOperation.cpp
source/blender/depsgraph/intern/depsgraph_tag.cc
source/blender/draw/intern/draw_cache.c
source/blender/draw/intern/draw_cache_extract_mesh.c
source/blender/editors/animation/anim_motion_paths.c
source/blender/editors/animation/keyingsets.c
source/blender/editors/armature/armature_add.c
source/blender/editors/curve/editcurve_paint.c
source/blender/editors/gizmo_library/gizmo_types/arrow3d_gizmo.c
source/blender/editors/gizmo_library/gizmo_types/cage3d_gizmo.c
source/blender/editors/gpencil/gpencil_edit.c
source/blender/editors/interface/view2d_ops.c
source/blender/editors/mesh/editmesh_knife.c
source/blender/editors/screen/screen_edit.c
source/blender/editors/screen/screen_ops.c
source/blender/editors/sculpt_paint/paint_image_proj.c
source/blender/editors/space_view3d/view3d_edit.c
source/blender/editors/space_view3d/view3d_utils.c
source/blender/editors/transform/transform.c
source/blender/editors/transform/transform_input.c
source/blender/freestyle/intern/scene_graph/IndexedFaceSet.h
source/blender/gpu/intern/gpu_vertex_format.c
source/blender/imbuf/IMB_imbuf.h
source/blender/imbuf/intern/scaling.c
source/blender/makesdna/DNA_meshdata_types.h
source/blender/makesdna/intern/dna_genfile.c
source/blender/makesrna/intern/rna_object.c
source/blender/makesrna/intern/rna_object_force.c
source/blender/makesrna/intern/rna_scene.c
source/blender/modifiers/intern/MOD_mask.c
source/blender/python/bmesh/bmesh_py_types_meshdata.c
source/blender/python/intern/bpy_app_translations.c
source/blender/python/mathutils/mathutils_Quaternion.c
source/blender/python/mathutils/mathutils_Vector.c
source/blender/python/mathutils/mathutils_geometry.c
source/blender/render/intern/source/pipeline.c
source/blender/windowmanager/intern/wm_files.c
source/blender/windowmanager/intern/wm_window.c
source/creator/creator.c

index 850bdf5b8b4921ef55131b7fdb79135de372c63a..b6df9024ffadb575dcc4e93dfd9e5cee2d86a84c 100644 (file)
@@ -43,8 +43,7 @@ BVHNode *bvh_node_merge_children_recursively(const BVHNode *node)
   if (node->is_leaf()) {
     return new LeafNode(*reinterpret_cast<const LeafNode *>(node));
   }
-  /* Collect nodes of one layer deeper, allowing us to have more childrem in
-   * an inner layer. */
+  /* Collect nodes of one layer deeper, allowing us to have more children in an inner layer. */
   assert(node->num_children() <= 2);
   const BVHNode *children[4];
   const BVHNode *child0 = node->get_child(0);
index 585c4b337873f98e5f18a76ff7253b7b53db0370..880a661214e64caad87962a2eaf8742c4e46a252 100644 (file)
@@ -70,9 +70,9 @@ ccl_device void kernel_filter_construct_transform(const float *ccl_restrict buff
   filter_calculate_scale(feature_scale, use_time);
 
   /* === Generate the feature transformation. ===
-   * This transformation maps the num_features-dimentional feature space to a reduced feature
-   * (r-feature) space which generally has fewer dimensions. This mainly helps to prevent
-   * overfitting. */
+   * This transformation maps the num_features-dimensional feature space to a reduced feature
+   * (r-feature) space which generally has fewer dimensions.
+   * This mainly helps to prevent over-fitting. */
   float feature_matrix[DENOISE_FEATURES * DENOISE_FEATURES];
   math_matrix_zero(feature_matrix, num_features);
   FOR_PIXEL_WINDOW
@@ -85,7 +85,7 @@ ccl_device void kernel_filter_construct_transform(const float *ccl_restrict buff
 
   math_matrix_jacobi_eigendecomposition(feature_matrix, transform, num_features, 1);
   *rank = 0;
-  /* Prevent overfitting when a small window is used. */
+  /* Prevent over-fitting when a small window is used. */
   int max_rank = min(num_features, num_pixels / 3);
   if (pca_threshold < 0.0f) {
     float threshold_energy = 0.0f;
index 4963e012e150cc106966f5a33a702c57669b6e0f..ed1a60a664f32222f2a4998c34e447aec3863e17 100644 (file)
@@ -686,8 +686,7 @@ ccl_device_inline const ShaderClosure *shader_bsdf_pick(ShaderData *sd, float *r
         if (r < next_sum) {
           sampled = i;
 
-          /* Rescale to reuse for direction sample, to better
-           * preserve stratification. */
+          /* Rescale to reuse for direction sample, to better preserve stratification. */
           *randu = (r - partial_sum) / sc->sample_weight;
           break;
         }
@@ -743,8 +742,7 @@ ccl_device_inline const ShaderClosure *shader_bssrdf_pick(ShaderData *sd,
             *throughput *= (sum_bsdf + sum_bssrdf) / sum_bssrdf;
             sampled = i;
 
-            /* Rescale to reuse for direction sample, to better
-             * preserve stratifaction. */
+            /* Rescale to reuse for direction sample, to better preserve stratification. */
             *randu = (r - partial_sum) / sc->sample_weight;
             break;
           }
index f1bf1903483e3a20715eb14fbf9939f48e1e901e..e45403a3754563fe3c10cb73d018a166547c90c4 100644 (file)
@@ -29,7 +29,7 @@ CCL_NAMESPACE_BEGIN
  * semantic around the units of size, it just should be the same for all
  * entries.
  *
- * This is a generic entry foi all size-related statistics, which helps
+ * This is a generic entry for all size-related statistics, which helps
  * avoiding duplicating code for things like sorting.
  */
 class NamedSizeEntry {
index 437478d64d3268ee0726935d73b9c6a9ad90973f..04fb33368d931f2f71642ad0081b900e3648cd19 100644 (file)
@@ -27,7 +27,7 @@
 
 CCL_NAMESPACE_BEGIN
 
-/* Own subclass-ed vestion of std::vector. Subclass is needed because:
+/* Own subclass-ed version of std::vector. Subclass is needed because:
  *
  * - Use own allocator which keeps track of used/peak memory.
  * - Have method to ensure capacity is re-set to 0.
index bbc0c5c84052af287c25ff5cd7f2c26b18d8cfb0..2cca41711936c060ba19d69a90980d845b9a8c8c 100644 (file)
@@ -834,7 +834,7 @@ class I18nMessages:
     def parse_messages_from_po(self, src, key=None):
         """
         Parse a po file.
-        Note: This function will silently "arrange" mis-formated entries, thus using afterward write_messages() should
+        Note: This function will silently "arrange" mis-formatted entries, thus using afterward write_messages() should
               always produce a po-valid file, though not correct!
         """
         reading_msgid = False
index 41727565cfa69d4769a220edce13dd34466d46ac..1576947b8b40e75386135c0ff1821774987f9646 100644 (file)
@@ -241,9 +241,9 @@ def edge_loops_from_edges(mesh, edges=None):
 
 def ngon_tessellate(from_data, indices, fix_loops=True, debug_print=True):
     """
-    Takes a polyline of indices (fgon) and returns a list of face
+    Takes a polyline of indices (ngon) and returns a list of face
     index lists. Designed to be used for importers that need indices for an
-    fgon to create from existing verts.
+    ngon to create from existing verts.
 
     :arg from_data: either a mesh, or a list/tuple of vectors.
     :type from_data: list or :class:`bpy.types.Mesh`
index 1470aed4d55ffc5f9c83584af2650824fd9212fe..d55644f19c71b0d1aa1af79fbda32ecc05af12a1 100644 (file)
@@ -105,7 +105,7 @@ class ANIM_OT_keying_set_export(Operator):
             # - idtype_list is used to get the list of id-datablocks from
             #   bpy.data.* since this info isn't available elsewhere
             # - id.bl_rna.name gives a name suitable for UI,
-            #   with a capitalised first letter, but we need
+            #   with a capitalized first letter, but we need
             #   the plural form that's all lower case
             # - special handling is needed for "nested" ID-blocks
             #   (e.g. nodetree in Material)
index bf7d81e5d63d31242ab975b5b71d5cffdea77fe4..cd1cdce91e0320c0eecd55b9c76c9a6edbdebf49 100644 (file)
@@ -889,7 +889,7 @@ void BKE_pose_eval_proxy_copy_bone(struct Depsgraph *depsgraph, Object *object,
   bPoseChannel *pchan = pose_pchan_get_indexed(object, pchan_index);
   DEG_debug_print_eval_subdata(
       depsgraph, __func__, object->id.name, object, "pchan", pchan->name, pchan);
-  /* TODO(sergey): Use indexec lookup, once it's guaranteed to be kept
+  /* TODO(sergey): Use indexed lookup, once it's guaranteed to be kept
    * around for the time while proxies are evaluating.
    */
 #if 0
index 3c7ac5d8d2ecdb64b77771542cef3d407e783467..db0ed0dc0fb7cf14909b5d85cf66fca75b71a754 100644 (file)
@@ -294,7 +294,7 @@ static void layerInterp_mdeformvert(const void **sources,
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
 
   /* now we know how many unique deform weights there are, so realloc */
   if (dvert->dw && (dvert->totweight == totweight)) {
@@ -441,7 +441,7 @@ static void layerInterp_tface(
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   *tf = *(MTFace *)(*sources);
   memcpy(tf->uv, uv, sizeof(tf->uv));
 }
@@ -548,7 +548,7 @@ static void layerInterp_origspace_face(
     }
   }
 
-  /* delay writing to the destination in case dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   memcpy(osf->uv, uv, sizeof(osf->uv));
 }
 
@@ -908,7 +908,7 @@ static void layerInterp_mloopcol(
   /* Subdivide smooth or fractal can cause problems without clamping
    * although weights should also not cause this situation */
 
-  /* also delay writing to the destination incase dest is in sources */
+  /* Also delay writing to the destination in case dest is in sources. */
   mc->r = round_fl_to_uchar_clamp(col.r);
   mc->g = round_fl_to_uchar_clamp(col.g);
   mc->b = round_fl_to_uchar_clamp(col.b);
@@ -1008,7 +1008,7 @@ static void layerInterp_mloopuv(
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   copy_v2_v2(((MLoopUV *)dest)->uv, uv);
   ((MLoopUV *)dest)->flag = flag;
 }
@@ -1104,7 +1104,7 @@ static void layerInterp_mloop_origspace(
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   copy_v2_v2(((OrigSpaceLoop *)dest)->uv, uv);
 }
 /* --- end copy */
@@ -1152,7 +1152,7 @@ static void layerInterp_mcol(
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   for (j = 0; j < 4; ++j) {
 
     /* Subdivide smooth or fractal can cause problems without clamping
@@ -1220,7 +1220,7 @@ static void layerInterp_bweight(const void **sources,
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   *((float *)dest) = f;
 }
 
@@ -1251,7 +1251,7 @@ static void layerInterp_shapekey(const void **sources,
     }
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   copy_v3_v3((float *)dest, co);
 }
 
@@ -1289,7 +1289,7 @@ static void layerInterp_mvert_skin(const void **sources,
     madd_v3_v3fl(radius, vs_src->radius, w);
   }
 
-  /* delay writing to the destination incase dest is in sources */
+  /* Delay writing to the destination in case dest is in sources. */
   vs_dst = dest;
   copy_v3_v3(vs_dst->radius, radius);
   vs_dst->flag &= ~MVERT_SKIN_ROOT;
@@ -2828,9 +2828,7 @@ void CustomData_interp(const CustomData *source,
   const void *source_buf[SOURCE_BUF_SIZE];
   const void **sources = source_buf;
 
-  /* slow fallback in case we're interpolating a ridiculous number of
-   * elements
-   */
+  /* Slow fallback in case we're interpolating a ridiculous number of elements. */
   if (count > SOURCE_BUF_SIZE) {
     sources = MEM_malloc_arrayN(count, sizeof(*sources), __func__);
   }
@@ -3828,9 +3826,7 @@ void CustomData_bmesh_interp(CustomData *data,
   void *source_buf[SOURCE_BUF_SIZE];
   const void **sources = (const void **)source_buf;
 
-  /* slow fallback in case we're interpolating a ridiculous number of
-   * elements
-   */
+  /* Slow fallback in case we're interpolating a ridiculous number of elements. */
   if (count > SOURCE_BUF_SIZE) {
     sources = MEM_malloc_arrayN(count, sizeof(*sources), __func__);
   }
index b8234ccc5bb46aaa3b4c29a2b8ee4f5abb97e5c7..1c3f6a56629260109ad9d473fe983d6ad9b5c210 100644 (file)
@@ -61,11 +61,10 @@ BMEditMesh *BKE_editmesh_copy(BMEditMesh *em)
 
   /* The tessellation is NOT calculated on the copy here,
    * because currently all the callers of this function use
-   * it to make a backup copy of the BMEditMesh to restore
-   * it in the case of errors in an operation. For perf
-   * reasons, in that case it makes more sense to do the
-   * tessellation only when/if that copy ends up getting
-   * used.*/
+   * it to make a backup copy of the #BMEditMesh to restore
+   * it in the case of errors in an operation. For performance reasons,
+   * in that case it makes more sense to do the
+   * tessellation only when/if that copy ends up getting used. */
   em_copy->looptris = NULL;
 
   return em_copy;
@@ -97,8 +96,8 @@ static void editmesh_tessface_calc_intern(BMEditMesh *em)
 
   BMesh *bm = em->bm;
 
-  /* this assumes all faces can be scan-filled, which isn't always true,
-   * worst case we over alloc a little which is acceptable */
+  /* This assumes all faces can be scan-filled, which isn't always true,
+   * worst case we over allocate a little which is acceptable. */
   const int looptris_tot = poly_to_tri_count(bm->totface, bm->totloop);
   const int looptris_tot_prev_alloc = em->looptris ?
                                           (MEM_allocN_len(em->looptris) / sizeof(*em->looptris)) :
@@ -109,7 +108,7 @@ static void editmesh_tessface_calc_intern(BMEditMesh *em)
   /* this means no reallocs for quad dominant models, for */
   if ((em->looptris != NULL) &&
       /* (*em->tottri >= looptris_tot)) */
-      /* check against alloc'd size incase we over alloc'd a little */
+      /* Check against allocated size in case we over allocated a little. */
       ((looptris_tot_prev_alloc >= looptris_tot) &&
        (looptris_tot_prev_alloc <= looptris_tot * 2))) {
     looptris = em->looptris;
index de6f5142a19e9b63cc7f206a894a3242c38528f0..2dbca3b4db10bfc25f93a836b7a5a5b0948759b0 100644 (file)
@@ -1727,8 +1727,8 @@ bool BKE_id_new_name_validate(ListBase *lb, ID *id, const char *tname)
 
   /* This was in 2.43 and previous releases
    * however all data in blender should be sorted, not just duplicate names
-   * sorting should not hurt, but noting just incase it alters the way other
-   * functions work, so sort every time */
+   * sorting should not hurt, but noting just in case it alters the way other
+   * functions work, so sort every time. */
 #if 0
   if (result) {
     id_sort_by_name(lb, id);
index b6d61563fe84a2284b942804f1c83a0e850c5985..fc087ff91b23a5aa9167ce65ce406408db24ac63 100644 (file)
@@ -1628,7 +1628,9 @@ MaskLayerShape *BKE_mask_layer_shape_find_frame(MaskLayer *masklay, const int fr
   return NULL;
 }
 
-/* when returning 2 - the frame isnt found but before/after frames are */
+/**
+ * When returning 2 - the frame isn't found but before/after frames are.
+ */
 int BKE_mask_layer_shape_find_frame_range(MaskLayer *masklay,
                                           const float frame,
                                           MaskLayerShape **r_masklay_shape_a,
index d6fa071009ea1b05c5a30c7324bd852bc96dec89..0820f0ebbb139b696fd9c899520ea08a08a13ae9 100644 (file)
@@ -364,12 +364,13 @@ bool BKE_mball_is_any_unselected(const MetaBall *mb)
   return false;
 }
 
-/* \brief copy some properties from object to other metaball object with same base name
+/**
+ * \brief copy some properties from object to other metaball object with same base name
  *
  * When some properties (wiresize, threshold, update flags) of metaball are changed, then this
  * properties are copied to all metaballs in same "group" (metaballs with same base name: MBall,
  * MBall.001, MBall.002, etc). The most important is to copy properties to the base metaball,
- * because this metaball influence polygonisation of metaballs. */
+ * because this metaball influence polygonization of metaballs. */
 void BKE_mball_properties_copy(Scene *scene, Object *active_object)
 {
   Scene *sce_iter = scene;
index 2ea275cdfb0a80f6339ee1117e77315d130a2281..ad06f4b7da1a5a3f933e3e4690a4043df32c6279 100644 (file)
@@ -1320,7 +1320,7 @@ static void split_loop_nor_fan_do(LoopSplitTaskDataCommon *common_data, LoopSpli
           }
           // print_v2("new clnors", clnors_avg);
         }
-        /* Extra bonus: since smallstack is local to this func,
+        /* Extra bonus: since small-stack is local to this function,
          * no more need to empty it at all cost! */
 
         BKE_lnor_space_custom_data_to_normal(lnor_space, *clnor_ref, lnor);
@@ -1336,7 +1336,7 @@ static void split_loop_nor_fan_do(LoopSplitTaskDataCommon *common_data, LoopSpli
         copy_v3_v3(nor, lnor);
       }
     }
-    /* Extra bonus: since smallstack is local to this func,
+    /* Extra bonus: since small-stack is local to this funcion,
      * no more need to empty it at all cost! */
   }
 }
index 202eadaa35afabf472a1256132aefcbdc755a05a..49f5aa35f939f3f69c9776962727d0ef988a79da 100644 (file)
@@ -432,7 +432,7 @@ void BKE_object_eval_eval_base_flags(Depsgraph *depsgraph,
   BKE_base_eval_flags(base);
 
   /* For render, compute base visibility again since BKE_base_eval_flags
-   * assumed viewport visibility. Selectability does not matter here. */
+   * assumed viewport visibility. Select-ability does not matter here. */
   if (DEG_get_mode(depsgraph) == DAG_EVAL_RENDER) {
     if (base->flag & BASE_ENABLED_RENDER) {
       base->flag |= BASE_VISIBLE;
index 39fb668c8730e77742ad83f40f87eb2bfc999b04..fcceebc3913cad59ef76bf33bac89b499005901a 100644 (file)
@@ -519,7 +519,7 @@ static void ocean_compute_htilda(void *__restrict userdata,
 
   int j;
 
-  /* note the <= _N/2 here, see the fftw doco
+  /* Note the <= _N/2 here, see the FFTW documentation
    * about the mechanics of the complex->real fft storage. */
   for (j = 0; j <= o->_N / 2; ++j) {
     fftw_complex exp_param1;
index 20736e28a5366ccf7def9cb6296791a3cbfaa6fa..d3b72fb295d71f3d555a3209ea9d3e8921af5156 100644 (file)
@@ -2705,7 +2705,7 @@ static void mesh_to_softbody(Scene *scene, Object *ob)
 
   for (a = 0; a < me->totvert; a++, bp++) {
     /* get scalar values needed  *per vertex* from vertex group functions,
-     * so we can *paint* them nicly ..
+     * so we can *paint* them nicely ..
      * they are normalized [0.0..1.0] so may be we need amplitude for scale
      * which can be done by caller but still .. i'd like it to go this way
      */
index 769bb02e2b96b9bf03d217e013bcc10c6c48e707..05ffb02597d8b3e2e73438d741b3d16909044b03 100644 (file)
@@ -886,7 +886,7 @@ bool BLI_ghash_ensure_p_ex(GHash *gh, const void *key, void ***r_key, void ***r_
   const bool haskey = (e != NULL);
 
   if (!haskey) {
-    /* pass 'key' incase we resize */
+    /* Pass 'key' in case we resize. */
     e = BLI_mempool_alloc(gh->entrypool);
     ghash_insert_ex_keyonly_entry(gh, (void *)key, bucket_index, (Entry *)e);
     e->e.key = NULL; /* caller must re-assign */
@@ -1189,7 +1189,7 @@ bool BLI_gset_ensure_p_ex(GSet *gs, const void *key, void ***r_key)
   const bool haskey = (e != NULL);
 
   if (!haskey) {
-    /* pass 'key' incase we resize */
+    /* Pass 'key' in case we resize */
     e = BLI_mempool_alloc(((GHash *)gs)->entrypool);
     ghash_insert_ex_keyonly_entry((GHash *)gs, (void *)key, bucket_index, (Entry *)e);
     e->key = NULL; /* caller must re-assign */
index 196d45967bec4cc64098890a7f67e5f6f45f2140..ddc7f9ee4c7844aa43a3a2968bfee5b0e711d2fd 100644 (file)
@@ -273,12 +273,12 @@ static int vertex_sort(const void *p1, const void *p2, void *vs_ctx_p)
 /** \} */
 
 /**
- * Main boxpacking function accessed from other functions
+ * Main box-packing function accessed from other functions
  * This sets boxes x,y to positive values, sorting from 0,0 outwards.
  * There is no limit to the space boxes may take, only that they will be packed
  * tightly into the lower left hand corner (0,0)
  *
- * \param boxarray: a pre allocated array of boxes.
+ * \param boxarray: a pre-allocated array of boxes.
  *      only the 'box->x' and 'box->y' are set, 'box->w' and 'box->h' are used,
  *      'box->index' is not used at all, the only reason its there
  *          is that the box array is sorted by area and programs need to be able
index 06fd5c7077209eeebb4ee2e21035a101a7533f3e..c4bdc73e0e31c689313291172770c87d00a8cddb 100644 (file)
@@ -3452,7 +3452,7 @@ bool clip_segment_v3_plane(
     }
   }
 
-  /* incase input/output values match (above also) */
+  /* In case input/output values match (above also). */
   const float p1_copy[3] = {UNPACK3(p1)};
   copy_v3_v3(r_p2, p2);
   copy_v3_v3(r_p1, p1_copy);
@@ -3511,7 +3511,7 @@ bool clip_segment_v3_plane_n(const float p1[3],
     }
   }
 
-  /* incase input/output values match */
+  /* In case input/output values match. */
   const float p1_copy[3] = {UNPACK3(p1)};
 
   madd_v3_v3v3fl(r_p1, p1_copy, dp, p1_fac);
index 0787d054141b49a3a75a8a90be43152d5c47b866..fec61605dcac735c5b835090cb953d6adcdb3025 100644 (file)
@@ -18,7 +18,7 @@
 
 /** \file
  * \ingroup blenloader
- * \brief defines for blendfile codes
+ * \brief defines for blend-file codes.
  */
 
 /* INTEGER CODES */
index 23807de2537b55040a3a9943f37e86a9f9b0007b..1e3342cef0429db89ee89fd7223d92d25d1e6952 100644 (file)
  * which keeps large arrays in memory from data-blocks we may not even use.
  *
  * \note This is disabled when using compression,
- * while zlib supports seek ist's unusably slow, see: T61880.
+ * while zlib supports seek it's unusably slow, see: T61880.
  */
 #define USE_BHEAD_READ_ON_DEMAND
 
@@ -271,13 +271,13 @@ typedef struct BHeadN {
  * because ID names are used in lookup tables. */
 #define BHEAD_USE_READ_ON_DEMAND(bhead) ((bhead)->code == DATA)
 
-/* this function ensures that reports are printed,
- * in the case of libraray linking errors this is important!
+/**
+ * This function ensures that reports are printed,
+ * in the case of library linking errors this is important!
  *
  * bit kludge but better then doubling up on prints,
  * we could alternatively have a versions of a report function which forces printing - campbell
  */
-
 void blo_reportf_wrap(ReportList *reports, ReportType type, const char *format, ...)
 {
   char fixed_buf[1024]; /* should be long enough */
@@ -533,7 +533,7 @@ static void split_libdata(ListBase *lb_src, Main **lib_main_array, const uint li
 
     if (id->lib) {
       if (((uint)id->lib->temp_index < lib_main_array_len) &&
-          /* this check should never fail, just incase 'id->lib' is a dangling pointer. */
+          /* this check should never fail, just in case 'id->lib' is a dangling pointer. */
           (lib_main_array[id->lib->temp_index]->curlib == id->lib)) {
         Main *mainvar = lib_main_array[id->lib->temp_index];
         ListBase *lb_dst = which_libbase(mainvar, GS(id->name));
@@ -2498,16 +2498,13 @@ static void IDP_DirectLinkProperty(IDProperty *prop, int switch_endian, FileData
       IDP_DirectLinkIDPArray(prop, switch_endian, fd);
       break;
     case IDP_DOUBLE:
-      /* erg, stupid doubles.  since I'm storing them
-       * in the same field as int val; val2 in the
-       * IDPropertyData struct, they have to deal with
-       * endianness specifically
+      /* Workaround for doubles.
+       * They are stored in the same field as `int val, val2` in the IDPropertyData struct,
+       * they have to deal with endianness specifically.
        *
-       * in theory, val and val2 would've already been swapped
+       * In theory, val and val2 would've already been swapped
        * if switch_endian is true, so we have to first unswap
-       * them then reswap them as a single 64-bit entity.
-       */
-
+       * them then re-swap them as a single 64-bit entity. */
       if (switch_endian) {
         BLI_endian_switch_int32(&prop->data.val);
         BLI_endian_switch_int32(&prop->data.val2);
@@ -7686,8 +7683,8 @@ static void direct_link_windowmanager(FileData *fd, wmWindowManager *wm)
     win->addmousemove = true;
     win->stereo3d_format = newdataadr(fd, win->stereo3d_format);
 
-    /* multiview always fallback to anaglyph at file opening
-     * otherwise quadbuffer saved files can break Blender */
+    /* Multi-view always fallback to anaglyph at file opening
+     * otherwise quad-buffer saved files can break Blender. */
     if (win->stereo3d_format) {
       win->stereo3d_format->display_mode = S3D_DISPLAY_ANAGLYPH;
     }
@@ -9192,7 +9189,7 @@ static BHead *read_libblock(FileData *fd, Main *main, BHead *bhead, const int ta
    * flags dependency graph does not do animation update to avoid loss of unkeyed changes.,
    * which conflicts with undo/redo of changes to animation data itself.
    *
-   * But for regular file load we clear the flag, since the flags might have been changed sinde
+   * But for regular file load we clear the flag, since the flags might have been changed since
    * the version the file has been saved with. */
   if (!fd->memfile) {
     id->recalc = 0;
@@ -11265,7 +11262,7 @@ static void add_collections_to_scene(Main *mainvar,
     }
     /* We do not want to force instantiation of indirectly linked collections,
      * not even when appending. Users can now easily instantiate collections (and their objects)
-     * as needed by themsleves. See T67032. */
+     * as needed by themselves. See T67032. */
     else if ((collection->id.tag & LIB_TAG_INDIRECT) == 0) {
       bool do_add_collection = (collection->id.tag & LIB_TAG_DOIT) != 0;
       if (!do_add_collection) {
index 078fbb2c5f6547a13ace30e48bbdf0089c401497..c3706f375fe915943650d3e5cea5b3d169048b80 100644 (file)
@@ -125,8 +125,8 @@ static void do_version_workspaces_create_from_screens(Main *bmain)
     }
 
     if (screen_parent) {
-      /* fullscreen with "Back to Previous" option, don't create
-       * a new workspace, add layout workspace containing parent */
+      /* Full-screen with "Back to Previous" option, don't create
+       * a new workspace, add layout workspace containing parent. */
       workspace = BLI_findstring(
           &bmain->workspaces, screen_parent->id.name + 2, offsetof(ID, name) + 2);
     }
index 5954ba9cf8e9df3f24a2e7dbb559f27e4a6f64e1..0ff7ba0034f523c09a767997c2456f73fa39ed7a 100644 (file)
@@ -1142,9 +1142,12 @@ typedef struct RenderInfo {
   char scene_name[MAX_ID_NAME - 2];
 } RenderInfo;
 
-/* was for historic render-deamon feature,
- * now write because it can be easily extracted without
- * reading the whole blend file */
+/**
+ * This was originally added for the historic render-daemon feature,
+ * now write because it can be easily extracted without reading the whole blend file.
+ *
+ * See: `release/scripts/modules/blend_render_info.py`
+ */
 static void write_renderinfo(WriteData *wd, Main *mainvar)
 {
   bScreen *curscreen;
index 2000689b496ae5e026214d0bdbd5c7571c68d577..9bab959f0a2e78a02e46244920c5ea210a0342cd 100644 (file)
@@ -422,7 +422,7 @@ void BM_mesh_bm_from_me(BMesh *bm, const Mesh *me, const struct BMeshFromMeshPar
       /* don't use 'j' since we may have skipped some faces, hence some loops. */
       BM_elem_index_set(l_iter, totloops++); /* set_ok */
 
-      /* Save index of correspsonding MLoop */
+      /* Save index of corresponding #MLoop. */
       CustomData_to_bmesh_block(&me->ldata, &bm->ldata, j++, &l_iter->head.data, true);
     } while ((l_iter = l_iter->next) != l_first);
 
index dc839054987f7b7c5def82ad5796dc40716dbb25..915ad6bf5c45fd75209627d1fc1a8a3f729ee04b 100644 (file)
@@ -483,7 +483,7 @@ void BM_face_calc_tangent_edge_diagonal(const BMFace *f, float r_tangent[3])
 
   l_iter = l_first = BM_FACE_FIRST_LOOP(f);
 
-  /* incase of degenerate faces */
+  /* In case of degenerate faces. */
   zero_v3(r_tangent);
 
   /* warning: O(n^2) loop here, take care! */
@@ -520,7 +520,7 @@ void BM_face_calc_tangent_vert_diagonal(const BMFace *f, float r_tangent[3])
 
   l_iter = l_first = BM_FACE_FIRST_LOOP(f);
 
-  /* incase of degenerate faces */
+  /* In case of degenerate faces. */
   zero_v3(r_tangent);
 
   /* warning: O(n^2) loop here, take care! */
index e32a9334343c39dea60c46769fd84a412fa59532..198b4c8e76b9951949c0673e55ba1aaf93567b21 100644 (file)
@@ -363,7 +363,7 @@ static void bm_decim_build_edge_cost(BMesh *bm,
 struct KD_Symmetry_Data {
   /* pre-flipped coords */
   float e_v1_co[3], e_v2_co[3];
-  /* Use to compare the correct endpoints incase v1/v2 are swapped */
+  /* Use to compare the correct endpoints in case v1/v2 are swapped. */
   float e_dir[3];
 
   int e_found_index;
@@ -1371,8 +1371,8 @@ void BM_mesh_decimate_collapse(BMesh *bm,
       /* handy to detect corruptions elsewhere */
       BLI_assert(BM_elem_index_get(e) < tot_edge_orig);
 
-      /* under normal conditions wont be accessed again,
-       * but NULL just incase so we don't use freed node */
+      /* Under normal conditions wont be accessed again,
+       * but NULL just in case so we don't use freed node. */
       eheap_table[BM_elem_index_get(e)] = NULL;
 
       bm_decim_edge_collapse(bm,
index 27b4fa15f261968c922b6afebeecf840921b8b81..2cc86a7c93fbd746e5291a46bc797a36800c9868 100644 (file)
@@ -231,7 +231,7 @@ void BM_mesh_decimate_unsubdivide_ex(BMesh *bm, const int iterations, const bool
           if (BMO_vert_flag_test(bm, v, ELE_VERT_TAG))
 #endif
           {
-            /* check again incase the topology changed */
+            /* Check again in case the topology changed. */
             if (bm_vert_dissolve_fan_test(v)) {
               v_first = v;
             }
index 943f7532960c8d68b516689181e8a85b4d45c02e..c30992fa2964279b11c99b09b5f662960549b90e 100644 (file)
@@ -1099,7 +1099,7 @@ static BMEdge *bm_face_region_pivot_edge_find(BMFace **faces_region,
         }
       }
       else {
-        /* use incase (depth == 0), no interior verts */
+        /* Use in case (depth == 0), no interior verts. */
         e_pivot_fallback = e;
       }
     } while ((l_iter = l_iter->next) != l_first);
index df936818f338a9d10c8cd42b5225494560a45b00..7e5b0264aa3d111024c66b4a5567488531fa2d98 100644 (file)
@@ -73,7 +73,7 @@ class MemoryBuffer {
   rcti m_rect;
 
   /**
-   * brief refers to the chunknumber within the executiongroup where related to the MemoryProxy
+   * brief refers to the chunk-number within the execution-group where related to the MemoryProxy
    * \see memoryProxy
    */
   unsigned int m_chunkNumber;
index dc3f65deb1f9abc560037d5c3dcd3cfb9fea37ce..6bce56ffd52c69924c46e9572273c2979989ec97 100644 (file)
@@ -195,7 +195,7 @@ void ImageNode::convertToOperations(NodeConverter &converter,
             }
           }
 
-          /* incase we can't load the layer */
+          /* In case we can't load the layer. */
           if (operation == NULL) {
             converter.setInvalidOutput(getOutputSocket(index));
           }
index 68b5af3089af8dae5074d3059c6709d417e52868..1578a805d1e5604944f4c3b868cce16b8af66d64 100644 (file)
@@ -22,7 +22,7 @@
 inline float colorbalance_lgg(float in, float lift_lgg, float gamma_inv, float gain)
 {
   /* 1:1 match with the sequencer with linear/srgb conversions, the conversion isnt pretty
-   * but best keep it this way, sice testing for durian shows a similar calculation
+   * but best keep it this way, since testing for durian shows a similar calculation
    * without lin/srgb conversions gives bad results (over-saturated shadows) with colors
    * slightly below 1.0. some correction can be done but it ends up looking bad for shadows or
    * lighter tones - campbell */
index 0c9208fb6bbac2001f56677c08b7f319e9fce2c6..88a3a5c535c4452ed8e16eec15d165ad5ccd0c67 100644 (file)
@@ -148,7 +148,7 @@ void MaskOperation::executePixelSampled(float output[4],
     }
   }
   else {
-    /* incase loop below fails */
+    /* In case loop below fails. */
     output[0] = 0.0f;
 
     for (unsigned int i = 0; i < this->m_rasterMaskHandleTot; i++) {
index 392514990e3b3154400a4058a54d1b8277169dd2..b73a3c08e10ddd31c7a417d4d980d3ecb4de13db 100644 (file)
@@ -638,7 +638,7 @@ void graph_id_tag_update(
    * This way IDs in the undo steps will have this flag preserved, making it possible to restore
    * all needed tags when new dependency graph is created on redo.
    * This is the only way to ensure modifications to animation data (such as keyframes i.e.)
-   * properly triggers animation update for the newely constructed dependency graph on redo (while
+   * properly triggers animation update for the newly constructed dependency graph on redo (while
    * usually newly created dependency graph skips animation update to avoid loss of unkeyed
    * changes). */
   if (update_source == DEG_UPDATE_SOURCE_USER_EDIT) {
index bad4b55eb1aeb3e3e7185ba7c822eb12b0e79c5e..520932bc429d96fecfe542261aadecd5df574bef 100644 (file)
@@ -4001,7 +4001,7 @@ GPUBatch *DRW_cache_cursor_get(bool crosshair_lines)
 /** \} */
 
 /* -------------------------------------------------------------------- */
-/** \name Batch Cache Impl. common
+/** \name Batch Cache Implementation (common)
  * \{ */
 
 void drw_batch_cache_validate(Object *ob)
index e735554b1f29c7a119e5d9360e7ca87d52c9a16b..098ce8642b89670c638d4aaeaf13e64639b5a354 100644 (file)
@@ -919,7 +919,7 @@ static void *extract_lines_adjacency_init(const MeshRenderData *mr, void *UNUSED
 {
   /* Similar to poly_to_tri_count().
    * There is always loop + tri - 1 edges inside a polygon.
-   * Cummulate for all polys and you get : */
+   * Accumulate for all polys and you get : */
   uint tess_edge_len = mr->loop_len + mr->tri_len - mr->poly_len;
 
   size_t vert_to_loop_size = sizeof(uint) * mr->vert_len;
@@ -1859,8 +1859,8 @@ static void *extract_orco_init(const MeshRenderData *mr, void *buf)
   static GPUVertFormat format = {0};
   if (format.attr_len == 0) {
     /* FIXME(fclem): We use the last component as a way to differentiate from generic vertex
-     * attribs. This is a substential waste of Vram and should be done another way.
-     * Unfortunately, at the time of writting, I did not found any other "non disruptive"
+     * attribs. This is a substantial waste of Vram and should be done another way.
+     * Unfortunately, at the time of writing, I did not found any other "non disruptive"
      * alternative. */
     GPU_vertformat_attr_add(&format, "orco", GPU_COMP_F32, 4, GPU_FETCH_FLOAT);
   }
index 7a5b57b1ce6d1bf415c58b00aedceb61a6f3a73c..bd4886817cd364bb099fc8ce4e4d252cd193e1b9 100644 (file)
@@ -60,9 +60,8 @@ typedef struct MPathTarget {
   Object *ob;          /* source object */
   bPoseChannel *pchan; /* source posechannel (if applicable) */
 
-  /* "Evaluated" Copies (these come from the background COW copie
-   * that provide all the coordinates we want to save off)
-   */
+  /* "Evaluated" Copies (these come from the background COW copy
+   * that provide all the coordinates we want to save off). */
   Object *ob_eval; /* evaluated object */
 } MPathTarget;
 
index ccd0fc546111785961c0366303c7a09a701bce82..7d31c6d3e3a5e4392416e5afb7885bc23e643c35 100644 (file)
@@ -712,9 +712,9 @@ int ANIM_scene_get_keyingset_index(Scene *scene, KeyingSet *ks)
     }
   }
 
-  /* still here, so try builtins list too
-   * - builtins are from (<= -1)
-   * - none/invalid is (= 0)
+  /* Still here, so try built-ins list too:
+   * - Built-ins are from (<= -1).
+   * - None/Invalid is (= 0).
    */
   index = BLI_findindex(&builtin_keyingsets, ks);
   if (index != -1) {
index d2fa77f90befd96fdd2373b4ed30fd48c676cdd9..1073034383d00b865c80a433097ca7d0809e7b24 100644 (file)
@@ -769,7 +769,7 @@ static int armature_symmetrize_exec(bContext *C, wmOperator *op)
 
         EditBone *ebone = ebone_iter->temp.ebone;
 
-        /* copy flags incase bone is pre-existing data */
+        /* Copy flags in case bone is pre-existing data. */
         ebone->flag = (ebone->flag & ~flag_copy) | (ebone_iter->flag & flag_copy);
 
         if (ebone_iter->parent == NULL) {
index 5e0053782d4d53a5318b8155018c7a4783d2d9d8..c7c19aa2d025125e6e1842df305ea8a52c29b8ee 100644 (file)
@@ -120,7 +120,7 @@ struct CurveDrawData {
 
   struct {
     float mouse[2];
-    /* used incase we can't calculate the depth */
+    /* Used in case we can't calculate the depth. */
     float location_world[3];
 
     float location_world_valid[3];
@@ -1053,7 +1053,7 @@ static int curve_draw_invoke(bContext *C, wmOperator *op, const wmEvent *event)
 
   const bool is_modal = RNA_boolean_get(op->ptr, "wait_for_input");
 
-  /* fallback (incase we can't find the depth on first test) */
+  /* Fallback (in case we can't find the depth on first test). */
   {
     const float mval_fl[2] = {UNPACK2(event->mval)};
     float center[3];
index d23965269abd57e7cb16b57014da0133cf780bdc..fa9c0f1fbb22b4f8f50abd18ca6b546238654267 100644 (file)
@@ -363,8 +363,8 @@ static void gizmo_arrow_exit(bContext *C, wmGizmo *gz, const bool cancel)
   const bool is_prop_valid = WM_gizmo_target_property_is_valid(gz_prop);
 
   if (!cancel) {
-    /* Assign incase applying the operation needs an updated offset
-     * editmesh bisect needs this. */
+    /* Assign in case applying the operation needs an updated offset
+     * edit-mesh bisect needs this. */
     if (is_prop_valid) {
       const int transform_flag = RNA_enum_get(arrow->gizmo.ptr, "transform");
       const bool constrained = (transform_flag & ED_GIZMO_ARROW_XFORM_FLAG_CONSTRAINED) != 0;
index e2a86469da17793be4214297c0b916957090559d..406f76bc65ea26890e59fe7b503f0d6b91c15097 100644 (file)
@@ -358,7 +358,7 @@ static void gizmo_cage3d_draw_intern(
       bool show = false;
       if (gz->highlight_part == ED_GIZMO_CAGE3D_PART_TRANSLATE) {
         /* Only show if we're drawing the center handle
-         * otherwise the entire rectangle is the hotspot. */
+         * otherwise the entire rectangle is the hot-spot. */
         if (draw_options & ED_GIZMO_CAGE2D_DRAW_FLAG_XFORM_CENTER_HANDLE) {
           show = true;
         }
index 575e45565ffd289a8fe964addc0329fb207b0f31..f509be9312a176286a052a2dccd0092998baa7f8 100644 (file)
@@ -3331,7 +3331,7 @@ typedef enum eGP_ReprojectModes {
   GP_REPROJECT_FRONT = 0,
   GP_REPROJECT_SIDE,
   GP_REPROJECT_TOP,
-  /* On same plane, parallel to viewplane */
+  /* On same plane, parallel to view-plane. */
   GP_REPROJECT_VIEW,
   /* Reprojected on to the scene geometry */
   GP_REPROJECT_SURFACE,
@@ -3374,11 +3374,10 @@ static int gp_strokes_reproject_exec(bContext *C, wmOperator *op)
       for (i = 0, pt = gps->points; i < gps->totpoints; i++, pt++) {
         float xy[2];
 
-        /* 3D to Screenspace */
-        /* Note: We can't use gp_point_to_xy() here because that uses ints for the screenspace
-         *       coordinates, resulting in lost precision, which in turn causes stairstepping
-         *       artifacts in the final points.
-         */
+        /* 3D to Screen-space */
+        /* Note: We can't use gp_point_to_xy() here because that uses ints for the screen-space
+         * coordinates, resulting in lost precision, which in turn causes stair-stepping
+         * artifacts in the final points. */
         bGPDspoint pt2;
         gp_point_to_parent_space(pt, gpstroke_iter.diff_mat, &pt2);
         gp_point_to_xy_fl(&gsc, gps, &pt2, &xy[0], &xy[1]);
@@ -3427,16 +3426,15 @@ static int gp_strokes_reproject_exec(bContext *C, wmOperator *op)
           /* apply parent again */
           gp_apply_parent_point(depsgraph, ob, gpd, gpl, pt);
         }
-        /* Project screenspace back to 3D space (from current perspective)
-         * so that all points have been treated the same way
-         */
+        /* Project screen-space back to 3D space (from current perspective)
+         * so that all points have been treated the same way. */
         else if (mode == GP_REPROJECT_VIEW) {
-          /* Planar - All on same plane parallel to the viewplane */
+          /* Planar - All on same plane parallel to the view-plane. */
           gp_point_xy_to_3d(&gsc, scene, xy, &pt->x);
         }
         else {
           /* Geometry - Snap to surfaces of visible geometry */
-          /* XXX: There will be precision loss (possible stairstep artifacts)
+          /* XXX: There will be precision loss (possible stair-step artifacts)
            * from this conversion to satisfy the API's */
           const int screen_co[2] = {(int)xy[0], (int)xy[1]};
 
@@ -4440,7 +4438,7 @@ static int gpencil_cutter_lasso_select(bContext *C,
       if ((pt->flag & GP_SPOINT_SELECT) || (pt->flag & GP_SPOINT_TAG)) {
         continue;
       }
-      /* convert point coords to screenspace */
+      /* convert point coords to screen-space */
       const bool is_inside = is_inside_fn(gps, pt, &gsc, gpstroke_iter.diff_mat, user_data);
       if (is_inside) {
         tot_inside++;
index f32fcffabd447864353b81541ef8c96726f82c57..032fb7e4cc22cab86c07f733f71c245e5202a5a1 100644 (file)
@@ -1844,7 +1844,7 @@ static void scroller_activate_init(bContext *C,
    */
   scrollers = UI_view2d_scrollers_calc(v2d, NULL);
 
-  /* use a union of 'cur' & 'tot' incase the current view is far outside 'tot'. In this cases
+  /* Use a union of 'cur' & 'tot' in case the current view is far outside 'tot'. In this cases
    * moving the scroll bars has far too little effect and the view can get stuck T31476. */
   tot_cur_union = v2d->tot;
   BLI_rctf_union(&tot_cur_union, &v2d->cur);
index bb58409458009eb4d08f6c4d8f42a64a649af1d2..ab1595997e59b51349c2feae5c3f0cbbf43037b1 100644 (file)
@@ -2949,7 +2949,7 @@ static int knifetool_modal(bContext *C, wmOperator *op, const wmEvent *event)
       case KNF_MODAL_ADD_CUT_CLOSED:
         if (kcd->mode == MODE_DRAGGING) {
 
-          /* shouldn't be possible with default key-layout, just incase... */
+          /* Shouldn't be possible with default key-layout, just in case. */
           if (kcd->is_drag_hold) {
             kcd->is_drag_hold = false;
             knifetool_update_mval(kcd, kcd->curr.mval);
index dddc33e3ad0351018fdac800733ddd1db70a7284..326bbbd87709ce049368080b5367c76e2225338c 100644 (file)
@@ -1116,7 +1116,7 @@ void ED_screen_full_prevspace(bContext *C, ScrArea *sa)
 
 void ED_screen_restore_temp_type(bContext *C, ScrArea *sa)
 {
-  /* incase nether functions below run */
+  /* In case nether functions below run. */
   ED_area_tag_redraw(sa);
 
   if (sa->flag & AREA_FLAG_TEMP_TYPE) {
index 42f502f651186938b7688b0d0514b9853437a2e8..885cd1ee77ddc88cf0f75894c71d3d80c9058aba 100644 (file)
@@ -3742,7 +3742,7 @@ static int region_quadview_exec(bContext *C, wmOperator *op)
       rv3d->viewlock = 0;
       rv3d->rflag &= ~RV3D_CLIPPING;
 
-      /* accumulate locks, incase they're mixed */
+      /* Accumulate locks, in case they're mixed. */
       for (ar_iter = sa->regionbase.first; ar_iter; ar_iter = ar_iter->next) {
         if (ar_iter->regiontype == RGN_TYPE_WINDOW) {
           RegionView3D *rv3d_iter = ar_iter->regiondata;
index 342d0b6e820763cbb2aaf14ffad625886f56c92a..397b2981ace8e4d263ff8d62eaf12f834dd6af39 100644 (file)
@@ -1719,9 +1719,9 @@ static float project_paint_uvpixel_mask(const ProjPaintState *ps,
       normalize_v3(no);
     }
     else {
-      /* incase the */
 #if 1
-      /* normalizing per pixel isn't optimal, we could cache or check ps->*/
+      /* In case the normalizing per pixel isn't optimal,
+       * we could cache or access from evaluated mesh. */
       normal_tri_v3(no,
                     ps->mvert_eval[lt_vtri[0]].co,
                     ps->mvert_eval[lt_vtri[1]].co,
index 9a9fe81a13e72dc4658125ec83713b20458dfe82..b9adde6f60e804f81e3144f68d4e2736405f5cc8 100644 (file)
@@ -404,9 +404,7 @@ static void viewops_data_create(bContext *C,
   if (viewops_flag & VIEWOPS_FLAG_PERSP_ENSURE) {
     if (ED_view3d_persp_ensure(depsgraph, vod->v3d, vod->ar)) {
       /* If we're switching from camera view to the perspective one,
-       * need to tag viewport update, so camera vuew and borders
-       * are properly updated.
-       */
+       * need to tag viewport update, so camera view and borders are properly updated. */
       ED_region_tag_redraw(vod->ar);
     }
   }
index 7f930f1d8769d25a6238fb95eee344c41ad33299..1af94e3ade52bb839a63397cc54a4625ee10ced7 100644 (file)
@@ -622,8 +622,8 @@ bool ED_view3d_camera_autokey(
 /**
  * Call after modifying a locked view.
  *
- * \note Not every view edit currently auto-keys (numpad for eg),
- * this is complicated because of smoothview.
+ * \note Not every view edit currently auto-keys (num-pad for eg),
+ * this is complicated because of smooth-view.
  */
 bool ED_view3d_camera_lock_autokey(View3D *v3d,
                                    RegionView3D *rv3d,
index 14995144c5c5c30559ba314d050272f864560053..6478928a6b606c30d16b6b441c06ca66e16c2047 100644 (file)
@@ -6601,7 +6601,7 @@ static void slide_origdata_interp_data_vert(SlideOrigData *sod,
      * and we do not want to mess up other shape keys */
     BM_loop_interp_from_face(bm, l, f_copy, false, false);
 
-    /* make sure face-attributes are correct (e.g. MTexPoly) */
+    /* make sure face-attributes are correct (e.g. #MLoopUV, #MLoopCol) */
     BM_elem_attrs_copy_ex(sod->bm_origfaces, bm, f_copy, l->f, 0x0, CD_MASK_NORMAL);
 
     /* weight the loop */
index 6ebed88878ffcea06c1720ad2fd3193ce9b718f7..e771fe43bd8674e39be248da6318e842d21e8c5c 100644 (file)
@@ -299,7 +299,7 @@ static void calcSpringFactor(MouseInput *mi)
 
 void initMouseInputMode(TransInfo *t, MouseInput *mi, MouseInputMode mode)
 {
-  /* incase we allocate a new value */
+  /* In case we allocate a new value. */
   void *mi_data_prev = mi->data;
 
   mi->use_virtual_mval = true;
index d70794d9b78a1159c24fed7b5e910025488a3091..f8dd25913c1752389ef1c535adc069402607cf62 100644 (file)
@@ -19,7 +19,7 @@
 
 /** \file
  * \ingroup freestyle
- * \brief A Set of indexed faces to represent a surfacic object
+ * \brief A Set of indexed faces to represent a surface object
  */
 
 #include <memory.h>
index 11df86c0b3ad89006e66cc2ac753618aa7e63160..66e5e254734fc5491011b1af0efafd62748775aa 100644 (file)
@@ -253,7 +253,7 @@ void GPU_vertformat_safe_attrib_name(const char *attrib_name,
     *(uint *)&data[4] = BLI_ghashutil_strhash_p_murmur(attrib_name + 4);
   }
   else {
-    /* Copy the whole name. Collision is barelly possible
+    /* Copy the whole name. Collision is barely possible
      * (hash would have to be equal to the last 4 bytes). */
     for (int i = 0; i < 8 && attrib_name[i] != '\0'; i++) {
       data[i] = attrib_name[i];
index 791e939db7f31ad18726673a061131a9d06833ae..571cac4139927c1bcca7c63c211ade5080d1e9e1 100644 (file)
@@ -46,8 +46,7 @@
  *
  * IMB needs:
  * - \ref DNA module
- *     The listbase types are used for handling the memory
- *     management.
+ *     The #ListBase types are used for handling the memory management.
  * - \ref blenlib module
  *     blenlib handles guarded memory management in blender-style.
  *     BLI_winstuff.h makes a few windows specific behaviors
index 28557277d72c8b209da471d4566a5af2e7e16253..46ddee25b0fd1714dd11cb95fc9504858386d10a 100644 (file)
@@ -1629,8 +1629,8 @@ bool IMB_scaleImBuf(struct ImBuf *ibuf, unsigned int newx, unsigned int newy)
     return false;
   }
 
-  /* scaleup / scaledown functions below change ibuf->x and ibuf->y
-   * so we first scale the Z-buffer (if any) */
+  /* Scale-up / scale-down functions below change ibuf->x and ibuf->y
+   * so we first scale the Z-buffer (if any). */
   scalefast_Z_ImBuf(ibuf, newx, newy);
 
   /* try to scale common cases in a fast way */
index 88eef05f8be3b146ba14271f0fa949f2c797690f..af350cfee48d11071fa9ea5679ef6fc4ad2907ad 100644 (file)
@@ -188,10 +188,6 @@ typedef struct MVertTri {
   unsigned int tri[3];
 } MVertTri;
 
-// typedef struct MTexPoly {
-//  void *_pad;
-//} MTexPoly;
-
 typedef struct MLoopUV {
   float uv[2];
   int flag;
index 5252c8f3350347c2c206c28de9f4e44a450e2ba9..86ba306fc6a84cdd7f731767e7dfd52d9408ac51 100644 (file)
@@ -339,7 +339,7 @@ static bool init_structDNA(SDNA *sdna, bool do_endian_swap, const char **r_error
 
   data = (int *)sdna->data;
 
-  /* clear pointers incase of error */
+  /* Clear pointers in case of error. */
   sdna->names = NULL;
   sdna->types = NULL;
   sdna->structs = NULL;
index d546c8d71479d23df831dfbedea75f8feb2478d2..bc433691cb42f4e2d42b5f382b7e1bc1328c11fe 100644 (file)
@@ -1432,8 +1432,8 @@ bool rna_Object_constraints_override_apply(Main *UNUSED(bmain),
   Object *ob_src = (Object *)ptr_src->id.data;
 
   /* Remember that insertion operations are defined and stored in correct order, which means that
-   * even if we insert several items in a row, we alays insert first one, then second one, etc.
-   * So we should always find 'anchor' constraint in both _src *and* _dst> */
+   * even if we insert several items in a row, we always insert first one, then second one, etc.
+   * So we should always find 'anchor' constraint in both _src *and* _dst. */
   bConstraint *con_anchor = NULL;
   if (opop->subitem_local_name && opop->subitem_local_name[0]) {
     con_anchor = BLI_findstring(
@@ -1520,8 +1520,8 @@ bool rna_Object_modifiers_override_apply(Main *UNUSED(bmain),
   Object *ob_src = (Object *)ptr_src->id.data;
 
   /* Remember that insertion operations are defined and stored in correct order, which means that
-   * even if we insert several items in a row, we alays insert first one, then second one, etc.
-   * So we should always find 'anchor' constraint in both _src *and* _dst> */
+   * even if we insert several items in a row, we always insert first one, then second one, etc.
+   * So we should always find 'anchor' constraint in both _src *and* _dst. */
   ModifierData *mod_anchor = NULL;
   if (opop->subitem_local_name && opop->subitem_local_name[0]) {
     mod_anchor = BLI_findstring(
index 066e350ab3e0f45cc836f935603ff05393d38502..4dd46281a423cdd0c9cc715895a4b9ef7ef83a22 100644 (file)
@@ -888,7 +888,7 @@ static void rna_def_pointcache_common(StructRNA *srna)
   prop = RNA_def_property(srna, "info", PROP_STRING, PROP_NONE);
   RNA_def_property_string_sdna(prop, NULL, "info");
   RNA_def_property_clear_flag(prop, PROP_EDITABLE);
-  /* Note that we do not actually need a getter here, `rna_Cache_info_length` will upate the info
+  /* Note that we do not actually need a getter here, `rna_Cache_info_length` will update the info
    * string just as well. */
   RNA_def_property_string_funcs(prop, NULL, "rna_Cache_info_length", NULL);
   RNA_def_property_string_maxlength(
index 4da67f837c12f62b45a12d2c829f89e719d5eb7c..ed6cba4f4b12aa9843de19cc83b8e18d14767f74 100644 (file)
@@ -821,8 +821,8 @@ static void rna_Scene_fps_update(Main *bmain, Scene *scene, PointerRNA *UNUSED(p
 {
   DEG_id_tag_update(&scene->id, ID_RECALC_AUDIO_FPS | ID_RECALC_SEQUENCER_STRIPS);
   /* NOTE: Tag via dependency graph will take care of all the updates ion the evaluated domain,
-   * however, changes in FPS actually modifies an original stip length, so this we take care about
-   * here. */
+   * however, changes in FPS actually modifies an original skip length,
+   * so this we take care about here. */
   BKE_sequencer_refresh_sound_length(bmain, scene);
 }
 
index 3417aaeeb5ce42787d37d694188922a12687ea30..f2f2b13b0df75a57f994a66e72c4d6cae2dba475 100644 (file)
@@ -138,10 +138,10 @@ static Mesh *applyModifier(ModifierData *md, const ModifierEvalContext *ctx, Mes
       return mesh;
     }
 
-    /* Determine whether each vertexgroup is associated with a selected bone or not:
-     * - Each cell is a boolean saying whether bone corresponding to the ith group is selected.
+    /* Determine whether each vertex-group is associated with a selected bone or not:
+     * - Each cell is a boolean saying whether bone corresponding to the i'th group selected.
      * - Groups that don't match a bone are treated as not existing
-     *   (along with the corresponding ungrouped verts).
+     *   (along with the corresponding un-grouped verts).
      */
     bone_select_array = MEM_malloc_arrayN((size_t)defbase_tot, sizeof(char), "mask array");
 
index 0aa01ddb59415d3b0a8671e7330e1f90fcdd456a..2e15c1d9ce0339158a7fe469af48550234c5270e 100644 (file)
@@ -20,8 +20,8 @@
 /** \file
  * \ingroup pybmesh
  *
- * This file defines customdata types which can't be accessed as primitive
- * python types such as MDeformVert, MLoopUV, MTexPoly
+ * This file defines custom-data types which can't be accessed as primitive
+ * python types such as #MDeformVert, #MLoopUV.
  */
 
 #include <Python.h>
@@ -515,8 +515,8 @@ static PySequenceMethods bpy_bmdeformvert_as_sequence = {
     NULL,                          /* sq_concat */
     NULL,                          /* sq_repeat */
 
-    /* note: if this is set PySequence_Check() returns True,
-     * but in this case we dont want to be treated as a seq */
+    /* Note: if this is set #PySequence_Check() returns True,
+     * but in this case we don't want to be treated as a seq. */
     NULL, /* sq_item */
 
     NULL,                                  /* sq_slice */
index a48cd742448101b19c3255373a42c0bba7171d37..3c1dbfba72e41715fbda2679f0f72f0d0cf6eccb 100644 (file)
@@ -890,7 +890,7 @@ PyObject *BPY_app_translations_struct(void)
 
 void BPY_app_translations_end(void)
 {
-  /* Incase the object remains in a module's namespace, see T44127. */
+  /* In case the object remains in a module's name-space, see T44127. */
 #ifdef WITH_INTERNATIONAL
   _clear_translations_cache();
 #endif
index 23fd65319a6bb9cbddb6dd5728f5c2125b7a3c4f..267971408bfcdd9d76d1f2968bb1eac8083c3351 100644 (file)
@@ -1015,7 +1015,7 @@ static PyObject *Quaternion_matmul(PyObject *q1, PyObject *q2)
   return NULL;
 }
 /*------------------------obj @= obj------------------------------
- * inplace quaternion multiplication */
+ * in-place quaternion multiplication */
 static PyObject *Quaternion_imatmul(PyObject *q1, PyObject *q2)
 {
   float quat[QUAT_SIZE];
index 490a1d9dd76d5ad6fde055da7e5606123127e5ed..aa7cbadde14c945ace9e23273eaccec8f51ede8b 100644 (file)
@@ -786,10 +786,8 @@ static PyObject *Vector_to_track_quat(VectorObject *self, PyObject *args)
     return NULL;
   }
 
-  /*
-   * flip vector around, since vectoquat expect a vector from target to tracking object
-   * and the python function expects the inverse (a vector to the target).
-   */
+  /* Flip vector around, since #vec_to_quat expect a vector from target to tracking object
+   * and the python function expects the inverse (a vector to the target). */
   negate_v3_v3(vec, self->vec);
 
   vec_to_quat(quat, vec, track, up);
index a6dded4ee8bbe5cd94668481df93bfe5ff22fd7e..f7eed390ca269331864bd7e5ec3369f3806a8595 100644 (file)
@@ -1213,7 +1213,7 @@ static PyObject *M_Geometry_tessellate_polygon(PyObject *UNUSED(self), PyObject
   PyObject *polyLine, *polyVec;
   int i, len_polylines, len_polypoints, ls_error = 0;
 
-  /* display listbase */
+  /* Display #ListBase. */
   ListBase dispbase = {NULL, NULL};
   DispList *dl;
   float *fp; /*pointer to the array of malloced dl->verts to set the points from the vectors */
@@ -1299,7 +1299,7 @@ static PyObject *M_Geometry_tessellate_polygon(PyObject *UNUSED(self), PyObject
     BKE_displist_fill(&dispbase, &dispbase, NULL, false);
 
     /* The faces are stored in a new DisplayList
-     * that's added to the head of the listbase */
+     * that's added to the head of the #ListBase. */
     dl = dispbase.first;
 
     tri_list = PyList_New(dl->parts);
index 6284fa2d1195b94f3470115c7c7abbe19b12e055..b4d0c2147f2d7a1237410f8f3108ab221d1e67f6 100644 (file)
@@ -1992,8 +1992,8 @@ static int render_initialize_from_main(Render *re,
   winx = (rd->size * rd->xsch) / 100;
   winy = (rd->size * rd->ysch) / 100;
 
-  /* We always render smaller part, inserting it in larger image is compositor bizz,
-   * it uses disprect for it. */
+  /* We always render smaller part, inserting it in larger image is compositor business,
+   * it uses 'disprect' for it. */
   if (scene->r.mode & R_BORDER) {
     disprect.xmin = rd->border.xmin * winx;
     disprect.xmax = rd->border.xmax * winx;
index 189c4f18613263f6f0238da642d794d1a6ea67cb..d9f43b51f4d08f4cb79b02a27c4a650758bf020e 100644 (file)
@@ -1351,7 +1351,7 @@ static bool wm_file_write(bContext *C, const char *filepath, int fileflags, Repo
     }
   }
 
-  /* Call pre-save callbacks befores writing preview,
+  /* Call pre-save callbacks before writing preview,
    * that way you can generate custom file thumbnail. */
   BLI_callback_exec(bmain, NULL, BLI_CB_EVT_SAVE_PRE);
 
index dc9a7b29bb2489411dac90c0f14ed3d0a513a5a9..9443dddb59a5b2d728d86bada50201a7229128a3 100644 (file)
@@ -482,8 +482,8 @@ void wm_window_title(wmWindowManager *wm, wmWindow *win)
     }
 
     /* Informs GHOST of unsaved changes, to set window modified visual indicator (macOS)
-     * and to give hint of unsaved changes for a user warning mechanism in case of OS
-     * application terminate request (e.g. OS Shortcut Alt+F4, Cmd+Q, (...), or session end). */
+     * and to give hint of unsaved changes for a user warning mechanism in case of OS application
+     * terminate request (e.g. OS Shortcut Alt+F4, Command+Q, (...), or session end). */
     GHOST_SetWindowModifiedState(win->ghostwin, (GHOST_TUns8)!wm->file_saved);
   }
 }
index 9eb1578001ca5b5019f047288f788bd461a208b4..6fd472d24c5e80a43529f657b298172ef004a67f 100644 (file)
@@ -400,8 +400,8 @@ int main(int argc,
   /* background render uses this font too */
   BKE_vfont_builtin_register(datatoc_bfont_pfb, datatoc_bfont_pfb_size);
 
-  /* Initialize ffmpeg if built in, also needed for bmode if videos are
-   * rendered via ffmpeg */
+  /* Initialize ffmpeg if built in, also needed for background-mode if videos are
+   * rendered via ffmpeg. */
   BKE_sound_init_once();
 
   init_def_material();