From ced94bc11c84f3c997949c2a0ec2449054a8e417 Mon Sep 17 00:00:00 2001
From: Campbell Barton <ideasman42@gmail.com>
Date: Fri, 23 Jul 2021 16:56:00 +1000
Subject: Cleanup: code comments punctuation / spacing

---
 source/blender/blenkernel/BKE_customdata.h         |  2 +-
 source/blender/blenkernel/intern/boids.c           |  2 +-
 source/blender/blenkernel/intern/editmesh.c        |  2 +-
 source/blender/blenkernel/intern/icons.cc          |  2 +-
 source/blender/blenkernel/intern/layer.c           |  2 +-
 source/blender/blenkernel/intern/paint.c           |  2 +-
 source/blender/blenkernel/intern/subsurf_ccg.c     |  2 +-
 source/blender/blenkernel/intern/writeffmpeg.c     |  7 ++++---
 source/blender/blenlib/intern/BLI_kdopbvh.c        |  2 +-
 source/blender/blenlib/intern/math_interp.c        |  2 +-
 source/blender/blenlib/intern/math_matrix.c        |  6 +++---
 source/blender/blenlib/intern/string_utils.c       |  6 +++---
 .../blenlib/tests/BLI_mesh_intersect_test.cc       | 10 +++++-----
 source/blender/blenloader/intern/readfile.c        |  2 +-
 source/blender/bmesh/bmesh_class.h                 |  2 +-
 source/blender/bmesh/intern/bmesh_query.h          |  2 +-
 source/blender/bmesh/tools/bmesh_region_match.c    |  2 +-
 .../operations/COM_DoubleEdgeMaskOperation.cc      | 16 ++++++++--------
 .../intern/eval/deg_eval_copy_on_write.cc          |  2 +-
 .../gpencil/shaders/gpencil_common_lib.glsl        |  2 +-
 source/blender/draw/intern/DRW_render.h            |  2 +-
 source/blender/draw/intern/draw_instance_data.c    |  2 +-
 source/blender/editors/armature/pose_lib_2.c       |  2 +-
 .../blender/editors/interface/interface_handlers.c |  6 +++---
 source/blender/editors/render/render_update.c      |  2 +-
 .../editors/sculpt_paint/sculpt_filter_color.c     |  2 +-
 .../editors/sculpt_paint/sculpt_paint_color.c      |  2 +-
 source/blender/editors/space_graph/graph_edit.c    |  8 ++++----
 source/blender/editors/space_graph/graph_view.c    |  2 +-
 source/blender/editors/space_image/image_buttons.c |  2 +-
 .../editors/space_node/node_relationships.cc       |  2 +-
 source/blender/editors/space_node/node_select.cc   |  2 +-
 .../editors/space_outliner/outliner_select.c       | 11 ++++++++---
 .../editors/transform/transform_convert_mesh.c     |  2 +-
 .../blender/editors/transform/transform_generics.c |  4 ++--
 .../editors/transform/transform_orientations.c     |  4 ++--
 source/blender/editors/uvedit/uvedit_select.c      |  2 +-
 .../freestyle/intern/view_map/Interface0D.h        |  4 ++--
 .../blender/freestyle/intern/view_map/Silhouette.h |  6 +++---
 source/blender/freestyle/intern/view_map/ViewMap.h | 12 ++++++++----
 .../intern/MOD_gpencil_ui_common.c                 |  2 +-
 .../gpencil_modifiers/intern/lineart/lineart_cpu.c |  4 ++--
 source/blender/gpu/intern/gpu_framebuffer.cc       |  2 +-
 source/blender/imbuf/intern/iris.c                 |  2 +-
 .../blender/imbuf/intern/openexr/openexr_api.cpp   |  2 +-
 source/blender/imbuf/intern/scaling.c              |  2 +-
 source/blender/io/collada/ControllerExporter.cpp   |  2 +-
 source/blender/io/collada/DocumentExporter.cpp     |  2 +-
 source/blender/io/collada/MeshImporter.cpp         |  2 +-
 source/blender/makesdna/DNA_action_types.h         |  4 ++--
 source/blender/makesdna/DNA_anim_types.h           | 22 +++++++++++-----------
 source/blender/makesdna/DNA_constraint_types.h     |  8 ++++----
 source/blender/makesdna/DNA_ipo_types.h            |  8 ++++----
 source/blender/makesdna/DNA_light_types.h          |  2 +-
 source/blender/makesdna/DNA_mask_types.h           |  4 ++--
 source/blender/makesdna/DNA_object_types.h         |  2 +-
 source/blender/makesdna/DNA_rigidbody_types.h      |  4 ++--
 source/blender/makesdna/DNA_scene_types.h          |  2 +-
 source/blender/makesdna/DNA_screen_types.h         |  2 +-
 source/blender/makesdna/DNA_userdef_types.h        |  6 +++---
 source/blender/makesdna/DNA_view2d_types.h         |  2 +-
 source/blender/makesdna/DNA_windowmanager_types.h  |  2 +-
 source/blender/makesrna/RNA_types.h                |  2 +-
 source/blender/makesrna/intern/rna_access.c        |  2 +-
 source/blender/makesrna/intern/rna_rna.c           |  4 ++--
 source/blender/modifiers/intern/MOD_array.c        |  4 ++--
 source/blender/modifiers/intern/MOD_nodes.cc       |  2 +-
 source/blender/modifiers/intern/MOD_ui_common.c    |  2 +-
 .../blender/modifiers/intern/MOD_weighted_normal.c |  2 +-
 .../blender/modifiers/intern/MOD_weightvg_util.c   |  6 +++---
 .../blender/nodes/composite/node_composite_tree.c  |  9 +++++----
 source/blender/python/BPY_extern.h                 |  2 +-
 source/blender/python/intern/bpy_operator.c        |  2 +-
 source/blender/python/intern/bpy_rna_anim.c        |  2 +-
 source/blender/python/mathutils/mathutils_noise.c  |  3 +--
 source/blender/render/intern/texture_image.c       |  4 ++--
 source/blender/sequencer/intern/effects.c          | 12 +++++-------
 source/blender/sequencer/intern/strip_edit.c       |  4 ++--
 source/blender/sequencer/intern/strip_time.c       |  4 ++--
 source/blender/shader_fx/intern/FX_ui_common.c     |  2 +-
 .../blender/simulation/intern/implicit_blender.c   | 22 +++++++++++-----------
 .../blender/simulation/intern/implicit_eigen.cpp   |  4 ++--
 .../blender/windowmanager/intern/wm_keymap_utils.c |  2 +-
 source/blender/windowmanager/wm_surface.h          |  4 ++--
 84 files changed, 175 insertions(+), 167 deletions(-)

(limited to 'source/blender')

diff --git a/source/blender/blenkernel/BKE_customdata.h b/source/blender/blenkernel/BKE_customdata.h
index c4db8ee925e..7a44553c565 100644
--- a/source/blender/blenkernel/BKE_customdata.h
+++ b/source/blender/blenkernel/BKE_customdata.h
@@ -501,7 +501,7 @@ enum {
   CD_FAKE = 1 << 8,
 
   /* Vertices. */
-  CD_FAKE_MDEFORMVERT = CD_FAKE | CD_MDEFORMVERT, /* *sigh* due to how vgroups are stored :( . */
+  CD_FAKE_MDEFORMVERT = CD_FAKE | CD_MDEFORMVERT, /* *sigh* due to how vgroups are stored :(. */
   CD_FAKE_SHAPEKEY = CD_FAKE |
                      CD_SHAPEKEY, /* Not available as real CD layer in non-bmesh context. */
 
diff --git a/source/blender/blenkernel/intern/boids.c b/source/blender/blenkernel/intern/boids.c
index efd0fc71b20..9caf416cd0c 100644
--- a/source/blender/blenkernel/intern/boids.c
+++ b/source/blender/blenkernel/intern/boids.c
@@ -1072,7 +1072,7 @@ static BoidState *get_boid_state(BoidSettings *boids, ParticleData *pa)
   return state;
 }
 
-#if 0 /* TODO  */
+#if 0 /* TODO */
 static int boid_condition_is_true(BoidCondition *cond)
 {
  return 0;
diff --git a/source/blender/blenkernel/intern/editmesh.c b/source/blender/blenkernel/intern/editmesh.c
index 9cae74e4e9a..83e03ef44f5 100644
--- a/source/blender/blenkernel/intern/editmesh.c
+++ b/source/blender/blenkernel/intern/editmesh.c
@@ -306,7 +306,7 @@ const float (*BKE_editmesh_vert_coords_when_deformed(struct Depsgraph *depsgraph
   }
   else if ((em->mesh_eval_final != NULL) &&
            (em->mesh_eval_final->runtime.wrapper_type == ME_WRAPPER_TYPE_BMESH)) {
-    /* If this is an edit-mesh type, leave NULL as we can use the vertex coords. . */
+    /* If this is an edit-mesh type, leave NULL as we can use the vertex coords. */
   }
   else {
     /* Constructive modifiers have been used, we need to allocate coordinates. */
diff --git a/source/blender/blenkernel/intern/icons.cc b/source/blender/blenkernel/intern/icons.cc
index 7e9f81f9c83..12a0a1e3ae7 100644
--- a/source/blender/blenkernel/intern/icons.cc
+++ b/source/blender/blenkernel/intern/icons.cc
@@ -667,7 +667,7 @@ void BKE_previewimg_blend_read(BlendDataReader *reader, PreviewImage *prv)
       BKE_previewimg_finish(prv, i);
     }
     else {
-      /* Only for old files that didn't write the flag . */
+      /* Only for old files that didn't write the flag. */
       prv->flag[i] |= PRV_UNFINISHED;
     }
   }
diff --git a/source/blender/blenkernel/intern/layer.c b/source/blender/blenkernel/intern/layer.c
index 730c989abc9..28282aaa823 100644
--- a/source/blender/blenkernel/intern/layer.c
+++ b/source/blender/blenkernel/intern/layer.c
@@ -1237,7 +1237,7 @@ void BKE_layer_collection_isolate_global(Scene *scene,
   bool hide_it = extend && (lc->runtime_flag & LAYER_COLLECTION_VISIBLE_VIEW_LAYER);
 
   if (!extend) {
-    /* Hide all collections . */
+    /* Hide all collections. */
     LISTBASE_FOREACH (LayerCollection *, lc_iter, &lc_master->layer_collections) {
       layer_collection_flag_set_recursive(lc_iter, LAYER_COLLECTION_HIDE);
     }
diff --git a/source/blender/blenkernel/intern/paint.c b/source/blender/blenkernel/intern/paint.c
index 1af66fa090b..a1fa6aae1ce 100644
--- a/source/blender/blenkernel/intern/paint.c
+++ b/source/blender/blenkernel/intern/paint.c
@@ -880,7 +880,7 @@ static int palettecolor_compare_luminance(const void *a1, const void *a2)
 
 void BKE_palette_sort_hsv(tPaletteColorHSV *color_array, const int totcol)
 {
-  /* Sort by Hue , Saturation and Value. */
+  /* Sort by Hue, Saturation and Value. */
   qsort(color_array, totcol, sizeof(tPaletteColorHSV), palettecolor_compare_hsv);
 }
 
diff --git a/source/blender/blenkernel/intern/subsurf_ccg.c b/source/blender/blenkernel/intern/subsurf_ccg.c
index cff2c5cc562..a1b45c2ac7d 100644
--- a/source/blender/blenkernel/intern/subsurf_ccg.c
+++ b/source/blender/blenkernel/intern/subsurf_ccg.c
@@ -423,7 +423,7 @@ static void set_subsurf_legacy_uv(CCGSubSurf *ss, DerivedMesh *dm, DerivedMesh *
 
   /* get some info from CCGSubSurf */
   totface = ccgSubSurf_getNumFaces(uvss);
-  /* edgeSize = ccgSubSurf_getEdgeSize(uvss); */ /*UNUSED*/
+  // edgeSize = ccgSubSurf_getEdgeSize(uvss); /* UNUSED */
   gridSize = ccgSubSurf_getGridSize(uvss);
   gridFaces = gridSize - 1;
 
diff --git a/source/blender/blenkernel/intern/writeffmpeg.c b/source/blender/blenkernel/intern/writeffmpeg.c
index 560ae30967f..9b3103a638b 100644
--- a/source/blender/blenkernel/intern/writeffmpeg.c
+++ b/source/blender/blenkernel/intern/writeffmpeg.c
@@ -1747,9 +1747,10 @@ void BKE_ffmpeg_preset_set(RenderData *rd, int preset)
       rd->ffcodecdata.type = FFMPEG_MPEG2;
       rd->ffcodecdata.video_bitrate = 6000;
 
-      /* Don't set resolution, see T21351.
-       * rd->xsch = 720;
-       * rd->ysch = isntsc ? 480 : 576; */
+#  if 0 /* Don't set resolution, see T21351. */
+      rd->xsch = 720;
+      rd->ysch = isntsc ? 480 : 576;
+#  endif
 
       rd->ffcodecdata.gop_size = isntsc ? 18 : 15;
       rd->ffcodecdata.rc_max_rate = 9000;
diff --git a/source/blender/blenlib/intern/BLI_kdopbvh.c b/source/blender/blenlib/intern/BLI_kdopbvh.c
index 3af942cd6d0..674654c99a8 100644
--- a/source/blender/blenlib/intern/BLI_kdopbvh.c
+++ b/source/blender/blenlib/intern/BLI_kdopbvh.c
@@ -22,7 +22,7 @@
  * \brief BVH-tree implementation.
  *
  * k-DOP BVH (Discrete Oriented Polytope, Bounding Volume Hierarchy).
- * A k-DOP is represented as k/2 pairs of min , max values for k/2 directions (intervals, "slabs").
+ * A k-DOP is represented as k/2 pairs of min, max values for k/2 directions (intervals, "slabs").
  *
  * See: http://www.gris.uni-tuebingen.de/people/staff/jmezger/papers/bvh.pdf
  *
diff --git a/source/blender/blenlib/intern/math_interp.c b/source/blender/blenlib/intern/math_interp.c
index 04fae6a0e68..bd48edf70c0 100644
--- a/source/blender/blenlib/intern/math_interp.c
+++ b/source/blender/blenlib/intern/math_interp.c
@@ -625,7 +625,7 @@ void BLI_ewa_filter(const int width,
    * Use a different radius based on interpolation switch,
    * just enough to anti-alias when interpolation is off,
    * and slightly larger to make result a bit smoother than bilinear interpolation when
-   * interpolation is on (minimum values: const float rmin = intpol ? 1.0f : 0.5f;) */
+   * interpolation is on (minimum values: `const float rmin = intpol ? 1.0f : 0.5f;`) */
   const float rmin = (intpol ? 1.5625f : 0.765625f) / ff2;
   BLI_ewa_imp2radangle(A, B, C, F, &a, &b, &th, &ecc);
   if ((b2 = b * b) < rmin) {
diff --git a/source/blender/blenlib/intern/math_matrix.c b/source/blender/blenlib/intern/math_matrix.c
index 5920788821c..b605c3eeead 100644
--- a/source/blender/blenlib/intern/math_matrix.c
+++ b/source/blender/blenlib/intern/math_matrix.c
@@ -276,7 +276,7 @@ void mul_m4_m4m4_uniq(float R[4][4], const float A[4][4], const float B[4][4])
 {
   BLI_assert(!ELEM(R, A, B));
 
-  /* matrix product: R[j][k] = A[j][i] . B[i][k] */
+  /* Matrix product: `R[j][k] = A[j][i] . B[i][k]`. */
 #ifdef BLI_HAVE_SSE2
   __m128 A0 = _mm_loadu_ps(A[0]);
   __m128 A1 = _mm_loadu_ps(A[1]);
@@ -321,7 +321,7 @@ void mul_m4_m4m4_db_uniq(double R[4][4], const double A[4][4], const double B[4]
 {
   BLI_assert(!ELEM(R, A, B));
 
-  /* matrix product: R[j][k] = A[j][i] . B[i][k] */
+  /* Matrix product: `R[j][k] = A[j][i] . B[i][k]`. */
 
   R[0][0] = B[0][0] * A[0][0] + B[0][1] * A[1][0] + B[0][2] * A[2][0] + B[0][3] * A[3][0];
   R[0][1] = B[0][0] * A[0][1] + B[0][1] * A[1][1] + B[0][2] * A[2][1] + B[0][3] * A[3][1];
@@ -349,7 +349,7 @@ void mul_m4db_m4db_m4fl_uniq(double R[4][4], const double A[4][4], const float B
   /* Remove second check since types don't match. */
   BLI_assert(!ELEM(R, A /*, B */));
 
-  /* matrix product: R[j][k] = A[j][i] . B[i][k] */
+  /* Matrix product: `R[j][k] = A[j][i] . B[i][k]`. */
 
   R[0][0] = B[0][0] * A[0][0] + B[0][1] * A[1][0] + B[0][2] * A[2][0] + B[0][3] * A[3][0];
   R[0][1] = B[0][0] * A[0][1] + B[0][1] * A[1][1] + B[0][2] * A[2][1] + B[0][3] * A[3][1];
diff --git a/source/blender/blenlib/intern/string_utils.c b/source/blender/blenlib/intern/string_utils.c
index 6a2ed8fac2c..d2666c6fe63 100644
--- a/source/blender/blenlib/intern/string_utils.c
+++ b/source/blender/blenlib/intern/string_utils.c
@@ -182,8 +182,8 @@ void BLI_string_flip_side_name(char *r_name,
 
   /* We first check the case with a .### extension, let's find the last period */
   if (isdigit(r_name[len - 1])) {
-    index = strrchr(r_name, '.');     /* last occurrence. */
-    if (index && isdigit(index[1])) { /* doesn't handle case bone.1abc2 correct..., whatever! */
+    index = strrchr(r_name, '.');     /* Last occurrence. */
+    if (index && isdigit(index[1])) { /* Doesn't handle case `bone.1abc2` correct..., whatever! */
       if (strip_number == false) {
         BLI_strncpy(number, index, name_len);
       }
@@ -194,7 +194,7 @@ void BLI_string_flip_side_name(char *r_name,
 
   BLI_strncpy(prefix, r_name, name_len);
 
-  /* first case; separator . - _ with extensions r R l L. */
+  /* First case; separator (`.` or `_`) with extensions in `r R l L`. */
   if ((len > 1) && is_char_sep(r_name[len - 2])) {
     is_set = true;
     switch (r_name[len - 1]) {
diff --git a/source/blender/blenlib/tests/BLI_mesh_intersect_test.cc b/source/blender/blenlib/tests/BLI_mesh_intersect_test.cc
index 24fa7f1a476..0329fc156c0 100644
--- a/source/blender/blenlib/tests/BLI_mesh_intersect_test.cc
+++ b/source/blender/blenlib/tests/BLI_mesh_intersect_test.cc
@@ -866,11 +866,11 @@ static void fill_sphere_data(int nrings,
   };
   Array<int> eid = {0, 0, 0, 0}; /* Don't care about edge ids. */
   /*
-   * (x, y , z) is given from inclination theta and azimuth phi,
-   * where 0 <= theta <= pi;  0 <= phi <= 2pi.
-   * x = radius * sin(theta) cos(phi)
-   * y = radius * sin(theta) sin(phi)
-   * z = radius * cos(theta)
+   * (x, y, z) is given from inclination theta and azimuth phi,
+   * where: `0 <= theta <= pi;  0 <= phi <= 2pi`.
+   * `x = radius * sin(theta) cos(phi)`
+   * `y = radius * sin(theta) sin(phi)`
+   * `z = radius * cos(theta)`
    */
   for (int s = 0; s < nsegs; ++s) {
     double phi = s * delta_phi;
diff --git a/source/blender/blenloader/intern/readfile.c b/source/blender/blenloader/intern/readfile.c
index 03fb4149d7b..11986f11fea 100644
--- a/source/blender/blenloader/intern/readfile.c
+++ b/source/blender/blenloader/intern/readfile.c
@@ -2444,7 +2444,7 @@ static void direct_link_id_common(
     BlendDataReader *reader, Library *current_library, ID *id, ID *id_old, const int tag)
 {
   if (!BLO_read_data_is_undo(reader)) {
-    /* When actually reading a file , we do want to reset/re-generate session uuids.
+    /* When actually reading a file, we do want to reset/re-generate session uuids.
      * In undo case, we want to re-use existing ones. */
     id->session_uuid = MAIN_ID_SESSION_UUID_UNSET;
   }
diff --git a/source/blender/bmesh/bmesh_class.h b/source/blender/bmesh/bmesh_class.h
index 423d64ba62c..82c76c8ae4f 100644
--- a/source/blender/bmesh/bmesh_class.h
+++ b/source/blender/bmesh/bmesh_class.h
@@ -185,7 +185,7 @@ typedef struct BMLoop {
   struct BMFace *f;
 
   /**
-   * Other loops connected to this edge,.
+   * Other loops connected to this edge.
    *
    * This is typically use for accessing an edges faces,
    * however this is done by stepping over it's loops.
diff --git a/source/blender/bmesh/intern/bmesh_query.h b/source/blender/bmesh/intern/bmesh_query.h
index 5627f3820c2..021358f81ad 100644
--- a/source/blender/bmesh/intern/bmesh_query.h
+++ b/source/blender/bmesh/intern/bmesh_query.h
@@ -272,7 +272,7 @@ int BM_mesh_calc_edge_groups_as_arrays(BMesh *bm,
                                        int (**r_groups)[3]) ATTR_WARN_UNUSED_RESULT
     ATTR_NONNULL(1, 2, 3, 4, 5);
 
-/* not really any good place  to put this */
+/* Not really any good place to put this. */
 float bmesh_subd_falloff_calc(const int falloff, float val) ATTR_WARN_UNUSED_RESULT;
 
 #include "bmesh_query_inline.h"
diff --git a/source/blender/bmesh/tools/bmesh_region_match.c b/source/blender/bmesh/tools/bmesh_region_match.c
index 4ae5bfb7fb2..924538490ad 100644
--- a/source/blender/bmesh/tools/bmesh_region_match.c
+++ b/source/blender/bmesh/tools/bmesh_region_match.c
@@ -1336,7 +1336,7 @@ static void bm_vert_fasthash_destroy(UUIDFashMatch *fm)
  * Take a face-region and return a list of matching face-regions.
  *
  * \param faces_region: A single, contiguous face-region.
- * \return  A list of matching null-terminated face-region arrays.
+ * \return A list of matching null-terminated face-region arrays.
  */
 int BM_mesh_region_match(BMesh *bm,
                          BMFace **faces_region,
diff --git a/source/blender/compositor/operations/COM_DoubleEdgeMaskOperation.cc b/source/blender/compositor/operations/COM_DoubleEdgeMaskOperation.cc
index 13993c06d51..55ae19ad194 100644
--- a/source/blender/compositor/operations/COM_DoubleEdgeMaskOperation.cc
+++ b/source/blender/compositor/operations/COM_DoubleEdgeMaskOperation.cc
@@ -988,11 +988,11 @@ static void do_createEdgeLocationBuffer(unsigned int t,
    *
    * Example:  9 by 9 pixel block
    *
-   * . = pixel non-white in both outer and inner mask
-   * o = pixel white in outer, but not inner mask, adjacent to "." pixel
-   * g = pixel white in outer, but not inner mask, not adjacent to "." pixel
-   * i = pixel white in inner mask, adjacent to "g" or "." pixel
-   * F = pixel white in inner mask, only adjacent to other pixels white in the inner mask
+   * `.` = Pixel non-white in both outer and inner mask.
+   * `o` = Pixel white in outer, but not inner mask, adjacent to "." pixel.
+   * `g` = Pixel white in outer, but not inner mask, not adjacent to "." pixel.
+   * `i` = Pixel white in inner mask, adjacent to "g" or "." pixel.
+   * `F` = Pixel white in inner mask, only adjacent to other pixels white in the inner mask.
    *
    *
    * .........   <----- pixel #80
@@ -1108,9 +1108,9 @@ static void do_fillGradientBuffer(unsigned int rw,
    * outside edge.
    *
    * In an image where:
-   * . = blank (black) pixels, not covered by inner mask or outer mask
-   * + = desired gradient pixels, covered only by outer mask
-   * * = white full mask pixels, covered by at least inner mask
+   * `.` = Blank (black) pixels, not covered by inner mask or outer mask.
+   * `+` = Desired gradient pixels, covered only by outer mask.
+   * `*` = White full mask pixels, covered by at least inner mask.
    *
    * ...............................
    * ...............+++++++++++.....
diff --git a/source/blender/depsgraph/intern/eval/deg_eval_copy_on_write.cc b/source/blender/depsgraph/intern/eval/deg_eval_copy_on_write.cc
index 346eba5bbc2..a844d23b558 100644
--- a/source/blender/depsgraph/intern/eval/deg_eval_copy_on_write.cc
+++ b/source/blender/depsgraph/intern/eval/deg_eval_copy_on_write.cc
@@ -348,7 +348,7 @@ bool scene_copy_inplace_no_main(const Scene *scene, Scene *new_scene)
 
 /* For the given scene get view layer which corresponds to an original for the
  * scene's evaluated one. This depends on how the scene is pulled into the
- * dependency  graph. */
+ * dependency graph. */
 ViewLayer *get_original_view_layer(const Depsgraph *depsgraph, const IDNode *id_node)
 {
   if (id_node->linked_state == DEG_ID_LINKED_DIRECTLY) {
diff --git a/source/blender/draw/engines/gpencil/shaders/gpencil_common_lib.glsl b/source/blender/draw/engines/gpencil/shaders/gpencil_common_lib.glsl
index b1368f90846..36a52e05a4a 100644
--- a/source/blender/draw/engines/gpencil/shaders/gpencil_common_lib.glsl
+++ b/source/blender/draw/engines/gpencil/shaders/gpencil_common_lib.glsl
@@ -327,7 +327,7 @@ vec2 safe_normalize_len(vec2 v, out float len)
 
 float stroke_thickness_modulate(float thickness)
 {
-  /* Modify stroke thickness by object and layer factors.-*/
+  /* Modify stroke thickness by object and layer factors. */
   thickness *= thicknessScale;
   thickness += thicknessOffset;
   thickness = max(1.0, thickness);
diff --git a/source/blender/draw/intern/DRW_render.h b/source/blender/draw/intern/DRW_render.h
index f5b95ac97ff..cd8b6531037 100644
--- a/source/blender/draw/intern/DRW_render.h
+++ b/source/blender/draw/intern/DRW_render.h
@@ -327,7 +327,7 @@ typedef enum {
   /** Culling test */
   DRW_STATE_CULL_BACK = (1 << 7),
   DRW_STATE_CULL_FRONT = (1 << 8),
-  /** Stencil test . These options are mutually exclusive and packed into 2 bits. */
+  /** Stencil test. These options are mutually exclusive and packed into 2 bits. */
   DRW_STATE_STENCIL_ALWAYS = (1 << 9),
   DRW_STATE_STENCIL_EQUAL = (2 << 9),
   DRW_STATE_STENCIL_NEQUAL = (3 << 9),
diff --git a/source/blender/draw/intern/draw_instance_data.c b/source/blender/draw/intern/draw_instance_data.c
index 449f2cd9606..e055192eb21 100644
--- a/source/blender/draw/intern/draw_instance_data.c
+++ b/source/blender/draw/intern/draw_instance_data.c
@@ -80,7 +80,7 @@ typedef struct DRWTempInstancingHandle {
   GPUBatch *batch;
   /** Batch containing instancing attributes. */
   GPUBatch *instancer;
-  /** Callbuffer to be used instead of instancer . */
+  /** Callbuffer to be used instead of instancer. */
   GPUVertBuf *buf;
   /** Original non-instanced batch pointer. */
   GPUBatch *geom;
diff --git a/source/blender/editors/armature/pose_lib_2.c b/source/blender/editors/armature/pose_lib_2.c
index e146799a23c..32440f941ba 100644
--- a/source/blender/editors/armature/pose_lib_2.c
+++ b/source/blender/editors/armature/pose_lib_2.c
@@ -130,7 +130,7 @@ static void poselib_keytag_pose(bContext *C, Scene *scene, PoseBlendData *pbd)
   /* start tagging/keying */
   const bArmature *armature = pbd->ob->data;
   LISTBASE_FOREACH (bActionGroup *, agrp, &act->groups) {
-    /* only for selected bones unless there aren't any selected, in which case all are included  */
+    /* Only for selected bones unless there aren't any selected, in which case all are included. */
     bPoseChannel *pchan = BKE_pose_channel_find_name(pose, agrp->name);
     if (pchan == NULL) {
       continue;
diff --git a/source/blender/editors/interface/interface_handlers.c b/source/blender/editors/interface/interface_handlers.c
index b41db7818da..bfc03a95949 100644
--- a/source/blender/editors/interface/interface_handlers.c
+++ b/source/blender/editors/interface/interface_handlers.c
@@ -3929,7 +3929,7 @@ static void ui_do_but_textedit(
 
       /* exception that's useful for number buttons, some keyboard
        * numpads have a comma instead of a period */
-      if (ELEM(but->type, UI_BTYPE_NUM, UI_BTYPE_NUM_SLIDER)) { /* could use data->min*/
+      if (ELEM(but->type, UI_BTYPE_NUM, UI_BTYPE_NUM_SLIDER)) { /* Could use `data->min`. */
         if (event->type == EVT_PADPERIOD && ascii == ',') {
           ascii = '.';
           utf8_buf = NULL; /* force ascii fallback */
@@ -9486,7 +9486,7 @@ static void ui_list_activate_row_from_index(
     /* A bit ugly, set the active index in RNA directly. That's because a button that's
      * scrolled away in the list box isn't created at all.
      * The custom activate operator (#uiList.custom_activate_opname) is not called in this case
-     * (which may need the row button context).*/
+     * (which may need the row button context). */
     RNA_property_int_set(&listbox->rnapoin, listbox->rnaprop, index);
     RNA_property_update(C, &listbox->rnapoin, listbox->rnaprop);
     ui_apply_but_undo(listbox);
@@ -9505,7 +9505,7 @@ static int ui_list_get_increment(const uiList *ui_list, const int type, const in
     increment = (type == EVT_UPARROWKEY) ? -columns : columns;
   }
   else {
-    /* Left or right in grid layouts or any direction in single column layouts increments by 1.  */
+    /* Left or right in grid layouts or any direction in single column layouts increments by 1. */
     increment = ELEM(type, EVT_UPARROWKEY, EVT_LEFTARROWKEY, WHEELUPMOUSE) ? -1 : 1;
   }
 
diff --git a/source/blender/editors/render/render_update.c b/source/blender/editors/render/render_update.c
index 80b5623b9c3..fb9d11feb63 100644
--- a/source/blender/editors/render/render_update.c
+++ b/source/blender/editors/render/render_update.c
@@ -65,7 +65,7 @@
 
 /***************************** Render Engines ********************************/
 
-/* Update 3D viewport render or draw engine on changes to the scene or view settings . */
+/* Update 3D viewport render or draw engine on changes to the scene or view settings. */
 void ED_render_view3d_update(Depsgraph *depsgraph,
                              wmWindow *window,
                              ScrArea *area,
diff --git a/source/blender/editors/sculpt_paint/sculpt_filter_color.c b/source/blender/editors/sculpt_paint/sculpt_filter_color.c
index de9511bab6f..4b49bf2cefb 100644
--- a/source/blender/editors/sculpt_paint/sculpt_filter_color.c
+++ b/source/blender/editors/sculpt_paint/sculpt_filter_color.c
@@ -10,7 +10,7 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software  Foundation,
+ * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
  * The Original Code is Copyright (C) 2020 Blender Foundation.
diff --git a/source/blender/editors/sculpt_paint/sculpt_paint_color.c b/source/blender/editors/sculpt_paint/sculpt_paint_color.c
index c3977b28178..936ebb7e8f7 100644
--- a/source/blender/editors/sculpt_paint/sculpt_paint_color.c
+++ b/source/blender/editors/sculpt_paint/sculpt_paint_color.c
@@ -10,7 +10,7 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software  Foundation,
+ * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
  * The Original Code is Copyright (C) 2020 Blender Foundation.
diff --git a/source/blender/editors/space_graph/graph_edit.c b/source/blender/editors/space_graph/graph_edit.c
index 6f1b0bb0d7d..9f9869a854c 100644
--- a/source/blender/editors/space_graph/graph_edit.c
+++ b/source/blender/editors/space_graph/graph_edit.c
@@ -261,7 +261,7 @@ static int graphkeys_insertkey_exec(bContext *C, wmOperator *op)
     return OPERATOR_CANCELLED;
   }
 
-  /* Which channels to affect?. */
+  /* Which channels to affect? */
   mode = RNA_enum_get(op->ptr, "type");
 
   /* Insert keyframes. */
@@ -2814,7 +2814,7 @@ static int graph_fmodifier_paste_exec(bContext *C, wmOperator *op)
   }
   ANIM_animdata_freelist(&anim_data);
 
-  /* Successful or not?. */
+  /* Successful or not? */
   if (ok) {
     /* Set notifier that keyframes have changed. */
     WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_EDITED, NULL);
@@ -2873,7 +2873,7 @@ static int graph_driver_vars_copy_exec(bContext *C, wmOperator *op)
     ok = ANIM_driver_vars_copy(op->reports, fcu);
   }
 
-  /* Successful or not?. */
+  /* Successful or not? */
   if (ok) {
     return OPERATOR_FINISHED;
   }
@@ -2915,7 +2915,7 @@ static int graph_driver_vars_paste_exec(bContext *C, wmOperator *op)
     ok = ANIM_driver_vars_paste(op->reports, fcu, replace);
   }
 
-  /* Successful or not?. */
+  /* Successful or not? */
   if (ok) {
     /* Rebuild depsgraph, now that there are extra deps here. */
     DEG_relations_tag_update(CTX_data_main(C));
diff --git a/source/blender/editors/space_graph/graph_view.c b/source/blender/editors/space_graph/graph_view.c
index 31c53cde62c..036fd354c18 100644
--- a/source/blender/editors/space_graph/graph_view.c
+++ b/source/blender/editors/space_graph/graph_view.c
@@ -398,7 +398,7 @@ static void create_ghost_curves(bAnimContext *ac, int start, int end)
             ANIMFILTER_NODUPLIS);
   ANIM_animdata_filter(ac, &anim_data, filter, ac->data, ac->datatype);
 
-  /* Loop through filtered data and add keys between selected keyframes on every frame . */
+  /* Loop through filtered data and add keys between selected keyframes on every frame. */
   for (ale = anim_data.first; ale; ale = ale->next) {
     FCurve *fcu = (FCurve *)ale->key_data;
     FCurve *gcu = BKE_fcurve_create();
diff --git a/source/blender/editors/space_image/image_buttons.c b/source/blender/editors/space_image/image_buttons.c
index 4779a82948d..86349a64681 100644
--- a/source/blender/editors/space_image/image_buttons.c
+++ b/source/blender/editors/space_image/image_buttons.c
@@ -1189,7 +1189,7 @@ void uiTemplateImageLayers(uiLayout *layout, bContext *C, Image *ima, ImageUser
     const int menus_width = 160 * dpi_fac;
     const bool is_render_result = (ima->type == IMA_TYPE_R_RESULT);
 
-    /* use BKE_image_acquire_renderresult  so we get the correct slot in the menu */
+    /* Use BKE_image_acquire_renderresult so we get the correct slot in the menu. */
     rr = BKE_image_acquire_renderresult(scene, ima);
     uiblock_layer_pass_buttons(
         layout, ima, rr, iuser, menus_width, is_render_result ? &ima->render_slot : NULL);
diff --git a/source/blender/editors/space_node/node_relationships.cc b/source/blender/editors/space_node/node_relationships.cc
index 725c872e98f..61a874b2b2d 100644
--- a/source/blender/editors/space_node/node_relationships.cc
+++ b/source/blender/editors/space_node/node_relationships.cc
@@ -299,7 +299,7 @@ static void pick_input_link_by_link_intersect(const bContext *C,
 
   /* If no linked was picked in this call, try using the one picked in the previous call.
    * Not essential for the basic behavior, but can make interaction feel a bit better if
-   * the  mouse moves to the right and loses the "selection." */
+   * the mouse moves to the right and loses the "selection." */
   if (!link_to_pick) {
     bNodeLink *last_picked_link = nldrag->last_picked_multi_input_socket_link;
     if (last_picked_link) {
diff --git a/source/blender/editors/space_node/node_select.cc b/source/blender/editors/space_node/node_select.cc
index a081cc83481..6c07c41f451 100644
--- a/source/blender/editors/space_node/node_select.cc
+++ b/source/blender/editors/space_node/node_select.cc
@@ -1196,7 +1196,7 @@ static void node_find_create_label(const bNode *node, char *str, int maxlen)
   }
 }
 
-/* generic  search invoke */
+/* Generic search invoke. */
 static void node_find_update_fn(const struct bContext *C,
                                 void *UNUSED(arg),
                                 const char *str,
diff --git a/source/blender/editors/space_outliner/outliner_select.c b/source/blender/editors/space_outliner/outliner_select.c
index 35015356f0b..aaa52f6b649 100644
--- a/source/blender/editors/space_outliner/outliner_select.c
+++ b/source/blender/editors/space_outliner/outliner_select.c
@@ -697,7 +697,9 @@ static void tree_element_sequence_dup_activate(Scene *scene, TreeElement *UNUSED
 {
   Editing *ed = SEQ_editing_get(scene, false);
 
-  /* XXX  select_single_seq(seq, 1); */
+#if 0
+  select_single_seq(seq, 1);
+#endif
   Sequence *p = ed->seqbasep->first;
   while (p) {
     if ((!p->strip) || (!p->strip->stripdata) || (p->strip->stripdata->name[0] == '\0')) {
@@ -705,8 +707,11 @@ static void tree_element_sequence_dup_activate(Scene *scene, TreeElement *UNUSED
       continue;
     }
 
-    /* XXX: if (STREQ(p->strip->stripdata->name, seq->strip->stripdata->name)) select_single_seq(p,
-     * 0); */
+#if 0
+    if (STREQ(p->strip->stripdata->name, seq->strip->stripdata->name)) {
+      select_single_seq(p, 0);
+    }
+#endif
     p = p->next;
   }
 }
diff --git a/source/blender/editors/transform/transform_convert_mesh.c b/source/blender/editors/transform/transform_convert_mesh.c
index c1ee6edfef6..7377e47da3d 100644
--- a/source/blender/editors/transform/transform_convert_mesh.c
+++ b/source/blender/editors/transform/transform_convert_mesh.c
@@ -1981,7 +1981,7 @@ static void tc_mesh_partial_update(TransInfo *t,
 
   /* Promote the partial update types based on the previous state
    * so the values that no longer modified are reset before being left as-is.
-   * Needed for translation which can toggle snap-to-normal during transform.  */
+   * Needed for translation which can toggle snap-to-normal during transform. */
   const enum ePartialType partial_for_looptri = MAX2(partial_state->for_looptri,
                                                      partial_state_prev->for_looptri);
   const enum ePartialType partial_for_normals = MAX2(partial_state->for_normals,
diff --git a/source/blender/editors/transform/transform_generics.c b/source/blender/editors/transform/transform_generics.c
index aaac8e21cb9..e89ab6729d2 100644
--- a/source/blender/editors/transform/transform_generics.c
+++ b/source/blender/editors/transform/transform_generics.c
@@ -343,9 +343,9 @@ void initTransInfo(bContext *C, TransInfo *t, wmOperator *op, const wmEvent *eve
   }
   else {
     if (region) {
-      /* XXX for now, get View2D  from the active region */
+      /* XXX: For now, get View2D from the active region. */
       t->view = &region->v2d;
-      /* XXX for now, the center point is the midpoint of the data */
+      /* XXX: For now, the center point is the midpoint of the data. */
     }
     else {
       t->view = NULL;
diff --git a/source/blender/editors/transform/transform_orientations.c b/source/blender/editors/transform/transform_orientations.c
index 155250261de..33f4b06eb0e 100644
--- a/source/blender/editors/transform/transform_orientations.c
+++ b/source/blender/editors/transform/transform_orientations.c
@@ -537,10 +537,10 @@ short ED_transform_calc_orientation_from_type_ex(const bContext *C,
     case V3D_ORIENT_LOCAL: {
       if (ob) {
         if (ob->mode & OB_MODE_POSE) {
-          /* each bone moves on its own local axis, but  to avoid confusion,
+          /* Each bone moves on its own local axis, but to avoid confusion,
            * use the active pones axis for display T33575, this works as expected on a single
            * bone and users who select many bones will understand what's going on and what local
-           * means when they start transforming */
+           * means when they start transforming. */
           ED_getTransformOrientationMatrix(C, ob, obedit, pivot_point, r_mat);
         }
         else {
diff --git a/source/blender/editors/uvedit/uvedit_select.c b/source/blender/editors/uvedit/uvedit_select.c
index 7709b76290f..20aadb84b7b 100644
--- a/source/blender/editors/uvedit/uvedit_select.c
+++ b/source/blender/editors/uvedit/uvedit_select.c
@@ -1126,7 +1126,7 @@ static void uv_select_edgeloop_single_side_tag(const Scene *scene,
     while (l_step != NULL) {
 
       if (!uvedit_face_visible_test(scene, l_step->f) ||
-          /* Check the boundary is still a  boundary. */
+          /* Check the boundary is still a boundary. */
           (uvedit_loop_find_other_radial_loop_with_visible_face(
                scene, l_step, cd_loop_uv_offset) != NULL)) {
         break;
diff --git a/source/blender/freestyle/intern/view_map/Interface0D.h b/source/blender/freestyle/intern/view_map/Interface0D.h
index 065319578e5..d7b213706b5 100644
--- a/source/blender/freestyle/intern/view_map/Interface0D.h
+++ b/source/blender/freestyle/intern/view_map/Interface0D.h
@@ -311,13 +311,13 @@ class Interface0DIterator : public Iterator {
     return result;
   }
 
-  /** operator == . */
+  /** operator `==`. */
   bool operator==(const Interface0DIterator &it) const
   {
     return _iterator->operator==(*(it._iterator));
   }
 
-  /** operator != . */
+  /** operator `!=`. */
   bool operator!=(const Interface0DIterator &it) const
   {
     return !(*this == it);
diff --git a/source/blender/freestyle/intern/view_map/Silhouette.h b/source/blender/freestyle/intern/view_map/Silhouette.h
index 3709b0ae11a..479dbaeedc1 100644
--- a/source/blender/freestyle/intern/view_map/Silhouette.h
+++ b/source/blender/freestyle/intern/view_map/Silhouette.h
@@ -745,7 +745,7 @@ class FEdge : public Interface1D {
     _VertexB = vB;
   }
 
-  /** Sets the FEdge Id . */
+  /** Sets the FEdge Id. */
   inline void setId(const Id &id)
   {
     _Id = id;
@@ -1153,7 +1153,7 @@ class FEdgeSharp : public FEdge {
   bool _bFaceMark;
 
  public:
-  /** Returns the string "FEdgeSharp" . */
+  /** Returns the string "FEdgeSharp". */
   virtual string getExactTypeName() const
   {
     return "FEdgeSharp";
@@ -1305,7 +1305,7 @@ class FEdgeSmooth : public FEdge {
   bool _FaceMark;
 
  public:
-  /** Returns the string "FEdgeSmooth" . */
+  /** Returns the string "FEdgeSmooth". */
   virtual string getExactTypeName() const
   {
     return "FEdgeSmooth";
diff --git a/source/blender/freestyle/intern/view_map/ViewMap.h b/source/blender/freestyle/intern/view_map/ViewMap.h
index bd7edad7642..e7d57c9dfb4 100644
--- a/source/blender/freestyle/intern/view_map/ViewMap.h
+++ b/source/blender/freestyle/intern/view_map/ViewMap.h
@@ -477,10 +477,14 @@ class TVertex : public ViewVertex {
   directedViewEdge _FrontEdgeB;
   directedViewEdge _BackEdgeA;
   directedViewEdge _BackEdgeB;
-  Id _Id;  // id to identify t vertices . these id will be negative in order not to be mixed with
-           // NonTVertex ids.
-  edge_pointers_container
-      _sortedEdges;  // the list of the four ViewEdges, ordered in CCW order (in the image plan)
+
+  /**
+   * ID to identify t vertices.
+   * these id will be negative in order not to be mixed with NonTVertex ids.
+   */
+  Id _Id;
+  /** The list of the four ViewEdges, ordered in CCW order (in the image plan). */
+  edge_pointers_container _sortedEdges;
 
  public:
   /** Default constructor. */
diff --git a/source/blender/gpencil_modifiers/intern/MOD_gpencil_ui_common.c b/source/blender/gpencil_modifiers/intern/MOD_gpencil_ui_common.c
index a156fca5b7b..a79e212b9db 100644
--- a/source/blender/gpencil_modifiers/intern/MOD_gpencil_ui_common.c
+++ b/source/blender/gpencil_modifiers/intern/MOD_gpencil_ui_common.c
@@ -9,7 +9,7 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software  Foundation,
+ * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
diff --git a/source/blender/gpencil_modifiers/intern/lineart/lineart_cpu.c b/source/blender/gpencil_modifiers/intern/lineart/lineart_cpu.c
index f5f71278d43..83abac201d0 100644
--- a/source/blender/gpencil_modifiers/intern/lineart/lineart_cpu.c
+++ b/source/blender/gpencil_modifiers/intern/lineart/lineart_cpu.c
@@ -2122,7 +2122,7 @@ static void lineart_main_load_geometries(
 
     Object *use_ob = DEG_get_evaluated_object(depsgraph, ob);
     /* Prepare the matrix used for transforming this specific object (instance). This has to be
-     * done before mesh boundbox check because the function needs that.  */
+     * done before mesh boundbox check because the function needs that. */
     mul_m4db_m4db_m4fl_uniq(obi->model_view_proj, rb->view_projection, ob->obmat);
     mul_m4db_m4db_m4fl_uniq(obi->model_view, rb->view, ob->obmat);
 
@@ -2153,7 +2153,7 @@ static void lineart_main_load_geometries(
       obi->free_use_mesh = true;
     }
 
-    /* Make normal matrix.  */
+    /* Make normal matrix. */
     float imat[4][4];
     invert_m4_m4(imat, ob->obmat);
     transpose_m4(imat);
diff --git a/source/blender/gpu/intern/gpu_framebuffer.cc b/source/blender/gpu/intern/gpu_framebuffer.cc
index 4bb13d01c2d..a6f7d43e563 100644
--- a/source/blender/gpu/intern/gpu_framebuffer.cc
+++ b/source/blender/gpu/intern/gpu_framebuffer.cc
@@ -495,7 +495,7 @@ void GPU_framebuffer_py_reference_set(GPUFrameBuffer *gpu_fb, void **py_ref)
 /** \} */
 
 /* -------------------------------------------------------------------- */
-/** \name  Frame-Buffer Stack
+/** \name Frame-Buffer Stack
  *
  * Keeps track of frame-buffer binding operation to restore previously bound frame-buffers.
  * \{ */
diff --git a/source/blender/imbuf/intern/iris.c b/source/blender/imbuf/intern/iris.c
index e62473fb8c7..59a17fcc600 100644
--- a/source/blender/imbuf/intern/iris.c
+++ b/source/blender/imbuf/intern/iris.c
@@ -39,7 +39,7 @@
 #define IMAGIC 0732
 
 typedef struct {
-  ushort imagic; /* stuff saved on disk . . */
+  ushort imagic; /* Stuff saved on disk. */
   ushort type;
   ushort dim;
   ushort xsize;
diff --git a/source/blender/imbuf/intern/openexr/openexr_api.cpp b/source/blender/imbuf/intern/openexr/openexr_api.cpp
index ab578e25b94..d1fa26e1a3e 100644
--- a/source/blender/imbuf/intern/openexr/openexr_api.cpp
+++ b/source/blender/imbuf/intern/openexr/openexr_api.cpp
@@ -1705,7 +1705,7 @@ static void exr_print_filecontents(MultiPartInputFile &file)
   }
 }
 
-/* for non-multilayer, map  R G B A channel names to something that's in this file */
+/* For non-multi-layer, map R G B A channel names to something that's in this file. */
 static const char *exr_rgba_channelname(MultiPartInputFile &file, const char *chan)
 {
   const ChannelList &channels = file.header(0).channels();
diff --git a/source/blender/imbuf/intern/scaling.c b/source/blender/imbuf/intern/scaling.c
index 79c2583f983..1c4b7af6ef1 100644
--- a/source/blender/imbuf/intern/scaling.c
+++ b/source/blender/imbuf/intern/scaling.c
@@ -867,7 +867,7 @@ static void q_scale_float(
  *
  * only handles common cases when we either
  *
- * scale  both, x and y or
+ * scale both, x and y or
  * shrink both, x and y
  *
  * but that is pretty fast:
diff --git a/source/blender/io/collada/ControllerExporter.cpp b/source/blender/io/collada/ControllerExporter.cpp
index e61ed47adee..d768d2e44e8 100644
--- a/source/blender/io/collada/ControllerExporter.cpp
+++ b/source/blender/io/collada/ControllerExporter.cpp
@@ -231,7 +231,7 @@ void ControllerExporter::export_skin_controller(Object *ob, Object *ob_arm)
         uint idx = vert->dw[j].def_nr;
         if (idx >= joint_index_by_def_index.size()) {
           /* XXX: Maybe better find out where and
-           *      why the Out Of Bound indexes get created ? */
+           *      why the Out Of Bound indexes get created? */
           oob_counter += 1;
         }
         else {
diff --git a/source/blender/io/collada/DocumentExporter.cpp b/source/blender/io/collada/DocumentExporter.cpp
index 46dfdda4ede..3c64591366c 100644
--- a/source/blender/io/collada/DocumentExporter.cpp
+++ b/source/blender/io/collada/DocumentExporter.cpp
@@ -180,7 +180,7 @@ int DocumentExporter::exportCurrentScene()
   bContext *C = blender_context.get_context();
 
   PointerRNA sceneptr, unit_settings;
-  PropertyRNA *system; /* unused , *scale; */
+  PropertyRNA *system; /* unused, *scale; */
 
   clear_global_id_map();
 
diff --git a/source/blender/io/collada/MeshImporter.cpp b/source/blender/io/collada/MeshImporter.cpp
index 5aa57159328..ef486375ce3 100644
--- a/source/blender/io/collada/MeshImporter.cpp
+++ b/source/blender/io/collada/MeshImporter.cpp
@@ -708,7 +708,7 @@ void MeshImporter::read_polys(COLLADAFW::Mesh *collada_mesh, Mesh *me)
           prim.totpoly++;
         }
 
-        /* Moving cursor  to the next triangle fan. */
+        /* Moving cursor to the next triangle fan. */
         if (mp_has_normals) {
           normal_indices += 2;
         }
diff --git a/source/blender/makesdna/DNA_action_types.h b/source/blender/makesdna/DNA_action_types.h
index aba6ccfd3ba..baed2aa2866 100644
--- a/source/blender/makesdna/DNA_action_types.h
+++ b/source/blender/makesdna/DNA_action_types.h
@@ -830,7 +830,7 @@ typedef struct SpaceAction {
   /** The currently active context (when not showing action). */
   bDopeSheet ads;
 
-  /** For Time-Slide transform mode drawing - current frame?. */
+  /** For Time-Slide transform mode drawing - current frame? */
   float timeslide;
 
   short flag;
@@ -838,7 +838,7 @@ typedef struct SpaceAction {
   char mode;
   /* Storage for sub-space types. */
   char mode_prev;
-  /** Automatic keyframe snapping mode  . */
+  /** Automatic keyframe snapping mode. */
   char autosnap;
   /** (eTimeline_Cache_Flag). */
   char cache_display;
diff --git a/source/blender/makesdna/DNA_anim_types.h b/source/blender/makesdna/DNA_anim_types.h
index 837dadaa719..a49a76c3f26 100644
--- a/source/blender/makesdna/DNA_anim_types.h
+++ b/source/blender/makesdna/DNA_anim_types.h
@@ -51,7 +51,7 @@ typedef struct FModifier {
   /** Pointer to modifier data. */
   void *data;
 
-  /** User-defined description for the modifier - MAX_ID_NAME-2. */
+  /** User-defined description for the modifier - `MAX_ID_NAME - 2`. */
   char name[64];
   /** Type of f-curve modifier. */
   short type;
@@ -185,7 +185,7 @@ typedef enum eFMod_Generator_Functions {
 
 /* envelope modifier - envelope data */
 typedef struct FCM_EnvelopeData {
-  /** Min/max values for envelope at this point (absolute values) . */
+  /** Min/max values for envelope at this point (absolute values). */
   float min, max;
   /** Time for that this sample-point occurs. */
   float time;
@@ -198,7 +198,7 @@ typedef struct FCM_EnvelopeData {
 
 /* envelope-like adjustment to values (for fade in/out) */
 typedef struct FMod_Envelope {
-  /** Data-points defining envelope to apply (array) . */
+  /** Data-points defining envelope to apply (array). */
   FCM_EnvelopeData *data;
   /** Number of envelope points. */
   int totvert;
@@ -321,7 +321,7 @@ typedef struct DriverTarget {
 
   /**
    * Name of the posebone to use
-   * (for vars where DTAR_FLAG_STRUCT_REF is used) - MAX_ID_NAME-2.
+   * (for vars where DTAR_FLAG_STRUCT_REF is used) - `MAX_ID_NAME - 2`.
    */
   char pchan_name[64];
   /** Transform channel index (for #DVAR_TYPE_TRANSFORM_CHAN). */
@@ -418,7 +418,7 @@ typedef struct DriverVar {
 
   /**
    * Name of the variable to use in py-expression
-   * (must be valid python identifier) - MAX_ID_NAME-2.
+   * (must be valid python identifier) - `MAX_ID_NAME - 2`.
    */
   char name[64];
 
@@ -734,7 +734,7 @@ typedef struct NlaStrip {
   /** F-Curve modifiers to be applied to the entire strip's referenced F-Curves. */
   ListBase modifiers;
 
-  /** User-Visible Identifier for Strip - MAX_ID_NAME-2. */
+  /** User-Visible Identifier for Strip - `MAX_ID_NAME - 2`. */
   char name[64];
 
   /** Influence of strip. */
@@ -873,7 +873,7 @@ typedef struct NlaTrack {
    * \note not really useful, but we need a '_pad' var anyways! */
   int index;
 
-  /** Short user-description of this track - MAX_ID_NAME-2. */
+  /** Short user-description of this track - `MAX_ID_NAME - 2`. */
   char name[64];
 } NlaTrack;
 
@@ -917,7 +917,7 @@ typedef struct KS_Path {
 
   /** ID block that keyframes are for. */
   ID *id;
-  /** Name of the group to add to - MAX_ID_NAME-2. */
+  /** Name of the group to add to - `MAX_ID_NAME - 2`. */
   char group[64];
 
   /** ID-type that path can be used on. */
@@ -977,13 +977,13 @@ typedef struct KeyingSet {
   /** (KS_Path) paths to keyframe to. */
   ListBase paths;
 
-  /** Unique name (for search, etc.) - MAX_ID_NAME-2 . */
+  /** Unique name (for search, etc.) - `MAX_ID_NAME - 2`. */
   char idname[64];
-  /** User-viewable name for KeyingSet (for menus, etc.) - MAX_ID_NAME-2. */
+  /** User-viewable name for KeyingSet (for menus, etc.) - `MAX_ID_NAME - 2`. */
   char name[64];
   /** (RNA_DYN_DESCR_MAX) short help text. */
   char description[240];
-  /** Name of the typeinfo data used for the relative paths - MAX_ID_NAME-2. */
+  /** Name of the typeinfo data used for the relative paths - `MAX_ID_NAME - 2`. */
   char typeinfo[64];
 
   /** Index of the active path. */
diff --git a/source/blender/makesdna/DNA_constraint_types.h b/source/blender/makesdna/DNA_constraint_types.h
index 63bf587d7fb..a77fbc9e45e 100644
--- a/source/blender/makesdna/DNA_constraint_types.h
+++ b/source/blender/makesdna/DNA_constraint_types.h
@@ -425,7 +425,7 @@ typedef struct bRigidBodyJointConstraint {
 typedef struct bClampToConstraint {
   /** 'target' must be a curve. */
   struct Object *tar;
-  /** Which axis/plane to compare owner's location on . */
+  /** Which axis/plane to compare owner's location on. */
   int flag;
   /** For legacy reasons, this is flag2. used for any extra settings. */
   int flag2;
@@ -474,7 +474,7 @@ typedef struct bTransformConstraint {
   float from_min[3];
   /** To map on to to_min/max range. */
   float from_max[3];
-  /** Range of motion on owner caused by target . */
+  /** Range of motion on owner caused by target. */
   float to_min[3];
   float to_max[3];
 
@@ -482,7 +482,7 @@ typedef struct bTransformConstraint {
   float from_min_rot[3];
   /** To map on to to_min/max range. */
   float from_max_rot[3];
-  /** Range of motion on owner caused by target . */
+  /** Range of motion on owner caused by target. */
   float to_min_rot[3];
   float to_max_rot[3];
 
@@ -490,7 +490,7 @@ typedef struct bTransformConstraint {
   float from_min_scale[3];
   /** To map on to to_min/max range. */
   float from_max_scale[3];
-  /** Range of motion on owner caused by target . */
+  /** Range of motion on owner caused by target. */
   float to_min_scale[3];
   float to_max_scale[3];
 } bTransformConstraint;
diff --git a/source/blender/makesdna/DNA_ipo_types.h b/source/blender/makesdna/DNA_ipo_types.h
index 0552c449819..4f71a257877 100644
--- a/source/blender/makesdna/DNA_ipo_types.h
+++ b/source/blender/makesdna/DNA_ipo_types.h
@@ -63,9 +63,9 @@ typedef struct IpoDriver {
 typedef struct IpoCurve {
   struct IpoCurve *next, *prev;
 
-  /** Array of BPoints (sizeof(BPoint) * totvert) - i.e. baked/imported data. */
+  /** Array of #BPoints `(sizeof(BPoint) * totvert)` - i.e. baked/imported data. */
   struct BPoint *bp;
-  /** Array of BezTriples (sizeof(BezTriple) * totvert)  - i.e. user-editable keyframes . */
+  /** Array of #BezTriples `(sizeof(BezTriple) * totvert)` - i.e. user-editable keyframes. */
   struct BezTriple *bezt;
 
   /** Bounding boxes. */
@@ -75,7 +75,7 @@ typedef struct IpoCurve {
   short blocktype, adrcode, vartype;
   /** Total number of BezTriples (i.e. keyframes) on curve. */
   short totvert;
-  /** Interpolation and extrapolation modes . */
+  /** Interpolation and extrapolation modes. */
   short ipo, extrap;
   /** Flag= settings. */
   short flag;
@@ -102,7 +102,7 @@ typedef struct Ipo {
 
   /** A list of IpoCurve structs in a linked list. */
   ListBase curve;
-  /** Rect defining extents of keyframes?. */
+  /** Rect defining extents of keyframes? */
   rctf cur;
 
   /** Blocktype: self-explanatory; showkey: either 0 or 1
diff --git a/source/blender/makesdna/DNA_light_types.h b/source/blender/makesdna/DNA_light_types.h
index 82ff3c95834..5ec82a68a2d 100644
--- a/source/blender/makesdna/DNA_light_types.h
+++ b/source/blender/makesdna/DNA_light_types.h
@@ -134,7 +134,7 @@ typedef struct Light {
 /* #define LA_NO_DIFF       (1 << 11) */ /* not used anywhere */
 /* #define LA_NO_SPEC       (1 << 12) */ /* not used anywhere */
 /* #define LA_SHAD_RAY      (1 << 13) */ /* not used anywhere - cleaned */
-/* yafray: light  shadowbuffer flag, softlight */
+/* yafray: light shadowbuffer flag, softlight */
 /* Since it is used with LOCAL light, can't use LA_SHAD */
 /* #define LA_YF_SOFT       (1 << 14) */ /* not used anymore */
 /* #define LA_LAYER_SHADOW  (1 << 15) */ /* not used anymore */
diff --git a/source/blender/makesdna/DNA_mask_types.h b/source/blender/makesdna/DNA_mask_types.h
index 8868ac1ea12..e6a7c004078 100644
--- a/source/blender/makesdna/DNA_mask_types.h
+++ b/source/blender/makesdna/DNA_mask_types.h
@@ -93,7 +93,7 @@ typedef struct MaskSplinePointUW {
 } MaskSplinePointUW;
 
 typedef struct MaskSplinePoint {
-  /** Actual point coordinates and its handles . */
+  /** Actual point coordinates and its handles. */
   BezTriple bezt;
   char _pad[4];
   /** Number of uv feather values. */
@@ -173,7 +173,7 @@ typedef struct MaskLayer {
 
   /** For animation. */
   char flag;
-  /** Matching 'Object' flag of the same name - eventually use in the outliner . */
+  /** Matching 'Object' flag of the same name - eventually use in the outliner. */
   char restrictflag;
 } MaskLayer;
 
diff --git a/source/blender/makesdna/DNA_object_types.h b/source/blender/makesdna/DNA_object_types.h
index dd31e85647d..60a34fef899 100644
--- a/source/blender/makesdna/DNA_object_types.h
+++ b/source/blender/makesdna/DNA_object_types.h
@@ -336,7 +336,7 @@ typedef struct Object {
   /** Deprecated, use 'matbits'. */
   short colbits DNA_DEPRECATED;
 
-  /** Transformation settings and transform locks . */
+  /** Transformation settings and transform locks. */
   short transflag, protectflag;
   short trackflag, upflag;
   /** Used for DopeSheet filtering settings (expanded/collapsed). */
diff --git a/source/blender/makesdna/DNA_rigidbody_types.h b/source/blender/makesdna/DNA_rigidbody_types.h
index 1d5e5eeed31..aa11e74e89d 100644
--- a/source/blender/makesdna/DNA_rigidbody_types.h
+++ b/source/blender/makesdna/DNA_rigidbody_types.h
@@ -125,7 +125,7 @@ typedef struct RigidBodyOb_Shared {
  */
 typedef struct RigidBodyOb {
   /* General Settings for this RigidBodyOb */
-  /** (eRigidBodyOb_Type) role of RigidBody in sim . */
+  /** (eRigidBodyOb_Type) role of RigidBody in sim. */
   short type;
   /** (eRigidBody_Shape) collision shape to use. */
   short shape;
@@ -243,7 +243,7 @@ typedef struct RigidBodyCon {
   struct Object *ob2;
 
   /* General Settings for this RigidBodyCon */
-  /** (eRigidBodyCon_Type) role of RigidBody in sim . */
+  /** (eRigidBodyCon_Type) role of RigidBody in sim. */
   short type;
   /** Number of constraint solver iterations made per simulation step. */
   short num_solver_iterations;
diff --git a/source/blender/makesdna/DNA_scene_types.h b/source/blender/makesdna/DNA_scene_types.h
index cd752b220a3..31352b2c8f4 100644
--- a/source/blender/makesdna/DNA_scene_types.h
+++ b/source/blender/makesdna/DNA_scene_types.h
@@ -1750,7 +1750,7 @@ typedef struct Scene {
   /** (runtime) info/cache used for presenting playback framerate info to the user. */
   void *fps_info;
 
-  /* none of the dependency graph  vars is mean to be saved */
+  /* None of the dependency graph vars is mean to be saved. */
   struct GHash *depsgraph_hash;
   char _pad7[4];
 
diff --git a/source/blender/makesdna/DNA_screen_types.h b/source/blender/makesdna/DNA_screen_types.h
index 5bd9cc7a999..d5b7458ae7b 100644
--- a/source/blender/makesdna/DNA_screen_types.h
+++ b/source/blender/makesdna/DNA_screen_types.h
@@ -522,7 +522,7 @@ typedef struct ARegion {
 
   /** Use this string to draw info. */
   char *headerstr;
-  /** XXX 2.50, need spacedata equivalent?. */
+  /** XXX 2.50, need spacedata equivalent? */
   void *regiondata;
 
   ARegion_Runtime runtime;
diff --git a/source/blender/makesdna/DNA_userdef_types.h b/source/blender/makesdna/DNA_userdef_types.h
index 629aa191890..5f8a8c6230a 100644
--- a/source/blender/makesdna/DNA_userdef_types.h
+++ b/source/blender/makesdna/DNA_userdef_types.h
@@ -513,7 +513,7 @@ typedef struct bTheme {
 typedef struct bAddon {
   struct bAddon *next, *prev;
   char module[64];
-  /** User-Defined Properties on this  Addon (for storing preferences). */
+  /** User-Defined Properties on this add-on (for storing preferences). */
   IDProperty *prop;
 } bAddon;
 
@@ -800,7 +800,7 @@ typedef struct UserDef {
   short rvisize;
   /** Rotating view icon brightness. */
   short rvibright;
-  /** Maximum number of recently used files to remember . */
+  /** Maximum number of recently used files to remember. */
   short recent_files;
   /** Milliseconds to spend spinning the view. */
   short smooth_viewtx;
@@ -1291,7 +1291,7 @@ typedef enum eTimecodeStyles {
   USER_TIMECODE_SECONDS_ONLY = 4,
   /**
    * Private (not exposed as generic choices) options.
-   * milliseconds for sub-frames , SubRip format- HH:MM:SS,sss.
+   * milliseconds for sub-frames, SubRip format- HH:MM:SS,sss.
    */
   USER_TIMECODE_SUBRIP = 100,
 } eTimecodeStyles;
diff --git a/source/blender/makesdna/DNA_view2d_types.h b/source/blender/makesdna/DNA_view2d_types.h
index 131772d49b4..c385ac04bd3 100644
--- a/source/blender/makesdna/DNA_view2d_types.h
+++ b/source/blender/makesdna/DNA_view2d_types.h
@@ -50,7 +50,7 @@ typedef struct View2D {
   /** Scroll_ui - temp settings used for UI drawing of scrollers. */
   short scroll_ui;
 
-  /** Keeptot - 'cur' rect cannot move outside the 'tot' rect?. */
+  /** Keeptot - 'cur' rect cannot move outside the 'tot' rect? */
   short keeptot;
   /** Keepzoom - axes that zooming cannot occur on, and also clamp within zoom-limits. */
   short keepzoom;
diff --git a/source/blender/makesdna/DNA_windowmanager_types.h b/source/blender/makesdna/DNA_windowmanager_types.h
index 94e89944f08..a9016dd4edd 100644
--- a/source/blender/makesdna/DNA_windowmanager_types.h
+++ b/source/blender/makesdna/DNA_windowmanager_types.h
@@ -94,7 +94,7 @@ typedef struct Report {
   /** ReportType. */
   short type;
   short flag;
-  /** `strlen(message)`, saves some time calculating the word wrap . */
+  /** `strlen(message)`, saves some time calculating the word wrap. */
   int len;
   const char *typestr;
   const char *message;
diff --git a/source/blender/makesrna/RNA_types.h b/source/blender/makesrna/RNA_types.h
index c2335b82fca..d880c892aa9 100644
--- a/source/blender/makesrna/RNA_types.h
+++ b/source/blender/makesrna/RNA_types.h
@@ -226,7 +226,7 @@ typedef enum PropertyFlag {
   PROP_ICONS_CONSECUTIVE = (1 << 12),
   PROP_ICONS_REVERSE = (1 << 8),
 
-  /** Hidden in  the user interface. */
+  /** Hidden in the user interface. */
   PROP_HIDDEN = (1 << 19),
   /** Do not write in presets. */
   PROP_SKIP_SAVE = (1 << 28),
diff --git a/source/blender/makesrna/intern/rna_access.c b/source/blender/makesrna/intern/rna_access.c
index 1159d6f7a68..feacd47c98c 100644
--- a/source/blender/makesrna/intern/rna_access.c
+++ b/source/blender/makesrna/intern/rna_access.c
@@ -5031,7 +5031,7 @@ static char *rna_path_token(const char **path, char *fixedbuf, int fixedlen, int
     }
   }
   else {
-    /* get data until . or [ */
+    /* Get data until `.` or `[`. */
     p = *path;
 
     while (*p && *p != '.' && *p != '[') {
diff --git a/source/blender/makesrna/intern/rna_rna.c b/source/blender/makesrna/intern/rna_rna.c
index 42bdc7442f4..b080e572fa2 100644
--- a/source/blender/makesrna/intern/rna_rna.c
+++ b/source/blender/makesrna/intern/rna_rna.c
@@ -2123,7 +2123,7 @@ bool rna_property_override_store_default(Main *UNUSED(bmain),
                 for (int j = len_local; j--;) {
                   array_b[j] = j >= i ? -array_b[j] : fac * (array_a[j] - array_b[j]);
                   if (array_b[j] < prop_min || array_b[j] > prop_max) {
-                    /* We failed to  find a suitable diff op,
+                    /* We failed to find a suitable diff op,
                      * fall back to plain REPLACE one. */
                     opop->operation = IDOVERRIDE_LIBRARY_OP_REPLACE;
                     do_set = false;
@@ -2213,7 +2213,7 @@ bool rna_property_override_store_default(Main *UNUSED(bmain),
                 for (int j = len_local; j--;) {
                   array_b[j] = j >= i ? -array_b[j] : fac * (array_a[j] - array_b[j]);
                   if (array_b[j] < prop_min || array_b[j] > prop_max) {
-                    /* We failed to  find a suitable diff op,
+                    /* We failed to find a suitable diff op,
                      * fall back to plain REPLACE one. */
                     opop->operation = IDOVERRIDE_LIBRARY_OP_REPLACE;
                     do_set = false;
diff --git a/source/blender/modifiers/intern/MOD_array.c b/source/blender/modifiers/intern/MOD_array.c
index 722614c4831..6a9c9715994 100644
--- a/source/blender/modifiers/intern/MOD_array.c
+++ b/source/blender/modifiers/intern/MOD_array.c
@@ -194,8 +194,8 @@ static void dm_mvert_map_doubles(int *doubles_map,
   i_target_low_bound = 0;
   target_scan_completed = false;
 
-  /* Scan source vertices, in SortVertsElem sorted array, */
-  /* all the while maintaining the lower bound of possible doubles in target vertices */
+  /* Scan source vertices, in #SortVertsElem sorted array,
+   * all the while maintaining the lower bound of possible doubles in target vertices. */
   for (i_source = 0, sve_source = sorted_verts_source; i_source < source_num_verts;
        i_source++, sve_source++) {
     int best_target_vertex = -1;
diff --git a/source/blender/modifiers/intern/MOD_nodes.cc b/source/blender/modifiers/intern/MOD_nodes.cc
index d46ac4c0a8b..5fa11ffdd10 100644
--- a/source/blender/modifiers/intern/MOD_nodes.cc
+++ b/source/blender/modifiers/intern/MOD_nodes.cc
@@ -10,7 +10,7 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software  Foundation,
+ * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
  * The Original Code is Copyright (C) 2005 by the Blender Foundation.
diff --git a/source/blender/modifiers/intern/MOD_ui_common.c b/source/blender/modifiers/intern/MOD_ui_common.c
index 9245afdb096..6239ee45e59 100644
--- a/source/blender/modifiers/intern/MOD_ui_common.c
+++ b/source/blender/modifiers/intern/MOD_ui_common.c
@@ -9,7 +9,7 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software  Foundation,
+ * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
diff --git a/source/blender/modifiers/intern/MOD_weighted_normal.c b/source/blender/modifiers/intern/MOD_weighted_normal.c
index bbdd7d0e647..3b147c69716 100644
--- a/source/blender/modifiers/intern/MOD_weighted_normal.c
+++ b/source/blender/modifiers/intern/MOD_weighted_normal.c
@@ -623,7 +623,7 @@ static Mesh *modifyMesh(ModifierData *md, const ModifierEvalContext *ctx, Mesh *
   CustomData *ldata = &result->ldata;
   clnors = CustomData_get_layer(ldata, CD_CUSTOMLOOPNORMAL);
 
-  /* Keep info  whether we had clnors,
+  /* Keep info whether we had clnors,
    * it helps when generating clnor spaces and default normals. */
   const bool has_clnors = clnors != NULL;
   if (!clnors) {
diff --git a/source/blender/modifiers/intern/MOD_weightvg_util.c b/source/blender/modifiers/intern/MOD_weightvg_util.c
index 696c4c855c7..e403051d1be 100644
--- a/source/blender/modifiers/intern/MOD_weightvg_util.c
+++ b/source/blender/modifiers/intern/MOD_weightvg_util.c
@@ -167,9 +167,9 @@ void weightvg_do_mask(const ModifierEvalContext *ctx,
     const int numVerts = mesh->totvert;
 
     /* Use new generic get_texture_coords, but do not modify our DNA struct for it...
-     * XXX Why use a ModifierData stuff here ? Why not a simple, generic struct for parameters ?
-     *     What e.g. if a modifier wants to use several textures ?
-     *     Why use only v_co, and not MVert (or both) ?
+     * XXX Why use a ModifierData stuff here ? Why not a simple, generic struct for parameters?
+     *     What e.g. if a modifier wants to use several textures?
+     *     Why use only v_co, and not MVert (or both)?
      */
     t_map.texture = texture;
     t_map.map_object = tex_map_object;
diff --git a/source/blender/nodes/composite/node_composite_tree.c b/source/blender/nodes/composite/node_composite_tree.c
index 013d196e1c8..d21e0938356 100644
--- a/source/blender/nodes/composite/node_composite_tree.c
+++ b/source/blender/nodes/composite/node_composite_tree.c
@@ -264,14 +264,15 @@ void ntreeCompositExecTree(Scene *scene,
 
 /* *********************************************** */
 
-/* Update the outputs of the render layer nodes.
+/**
+ * Update the outputs of the render layer nodes.
  * Since the outputs depend on the render engine, this part is a bit complex:
- * - ntreeCompositUpdateRLayers is called and loops over all render layer nodes.
+ * - #ntreeCompositUpdateRLayers is called and loops over all render layer nodes.
  * - Each render layer node calls the update function of the
  *   render engine that's used for its scene.
  * - The render engine calls RE_engine_register_pass for each pass.
- * - RE_engine_register_pass calls ntreeCompositRegisterPass,.
- *   which calls node_cmp_rlayers_register_pass for every render layer node.
+ * - #RE_engine_register_pass calls #ntreeCompositRegisterPass,
+ *   which calls #node_cmp_rlayers_register_pass for every render layer node.
  */
 void ntreeCompositUpdateRLayers(bNodeTree *ntree)
 {
diff --git a/source/blender/python/BPY_extern.h b/source/blender/python/BPY_extern.h
index 84d804f8bdf..43a73363c98 100644
--- a/source/blender/python/BPY_extern.h
+++ b/source/blender/python/BPY_extern.h
@@ -30,7 +30,7 @@ struct PathResolvedRNA;
 struct Text;              /* defined in DNA_text_types.h */
 struct bConstraint;       /* DNA_constraint_types.h */
 struct bConstraintOb;     /* DNA_constraint_types.h */
-struct bConstraintTarget; /* DNA_constraint_types.h*/
+struct bConstraintTarget; /* DNA_constraint_types.h */
 struct bContext;
 struct bContextDataResult;
 struct bPythonConstraint; /* DNA_constraint_types.h */
diff --git a/source/blender/python/intern/bpy_operator.c b/source/blender/python/intern/bpy_operator.c
index 9ee9f2e477f..d5afb2334f0 100644
--- a/source/blender/python/intern/bpy_operator.c
+++ b/source/blender/python/intern/bpy_operator.c
@@ -339,7 +339,7 @@ static PyObject *pyop_call(PyObject *UNUSED(self), PyObject *args)
     return NULL;
   }
 
-  /* When calling  bpy.ops.wm.read_factory_settings() bpy.data's main pointer
+  /* When calling `bpy.ops.wm.read_factory_settings()` `bpy.data's` main pointer
    * is freed by clear_globals(), further access will crash blender.
    * Setting context is not needed in this case, only calling because this
    * function corrects bpy.data (internal Main pointer) */
diff --git a/source/blender/python/intern/bpy_rna_anim.c b/source/blender/python/intern/bpy_rna_anim.c
index 9745f39b6b8..a716f4ab9e5 100644
--- a/source/blender/python/intern/bpy_rna_anim.c
+++ b/source/blender/python/intern/bpy_rna_anim.c
@@ -605,7 +605,7 @@ PyObject *pyrna_struct_driver_add(BPy_StructRNA *self, PyObject *args)
     DEG_relations_tag_update(CTX_data_main(context));
   }
   else {
-    /* XXX, should be handled by reports, */
+    /* XXX: should be handled by reports. */
     PyErr_SetString(PyExc_TypeError,
                     "bpy_struct.driver_add(): failed because of an internal error");
     return NULL;
diff --git a/source/blender/python/mathutils/mathutils_noise.c b/source/blender/python/mathutils/mathutils_noise.c
index 707fd40e9d0..69d37b345c6 100644
--- a/source/blender/python/mathutils/mathutils_noise.c
+++ b/source/blender/python/mathutils/mathutils_noise.c
@@ -131,8 +131,7 @@ static void next_state(void)
   ulong *p = state;
   int j;
 
-  /* if init_genrand() has not been called, */
-  /* a default initial seed is used         */
+  /* If init_genrand() has not been called, a default initial seed is used. */
   if (initf == 0) {
     init_genrand(5489UL);
   }
diff --git a/source/blender/render/intern/texture_image.c b/source/blender/render/intern/texture_image.c
index c4ee16a0ecc..62aee564626 100644
--- a/source/blender/render/intern/texture_image.c
+++ b/source/blender/render/intern/texture_image.c
@@ -932,8 +932,8 @@ static void feline_eval(TexResult *texr, ImBuf *ibuf, float fx, float fy, afdata
 #endif
     /* `const int out =` */ ibuf_get_color_clip_bilerp(
         tc, ibuf, ibuf->x * u, ibuf->y * v, AFD->intpol, AFD->extflag);
-    /* TXF alpha: clip |= out;
-     * TXF alpha: cw += out ? 0.0f : wt; */
+    /* TXF alpha: `clip |= out;`
+     * TXF alpha: `cw += out ? 0.0f : wt;` */
     texr->tr += tc[0] * wt;
     texr->tg += tc[1] * wt;
     texr->tb += tc[2] * wt;
diff --git a/source/blender/sequencer/intern/effects.c b/source/blender/sequencer/intern/effects.c
index 9ccd55e3fbc..7757271a2e5 100644
--- a/source/blender/sequencer/intern/effects.c
+++ b/source/blender/sequencer/intern/effects.c
@@ -1428,10 +1428,9 @@ static void do_mul_effect_byte(float facf0,
   fac1 = (int)(256.0f * facf0);
   fac3 = (int)(256.0f * facf1);
 
-  /* formula:
-   * fac * (a * b) + (1 - fac) * a  => fac * a * (b - 1) + axaux = c * px + py * s; //+centx
-   * yaux = -s * px + c * py; //+centy
-   */
+  /* Formula:
+   * `fac * (a * b) + (1 - fac) * a => fac * a * (b - 1) + axaux = c * px + py * s;` // + centx
+   * `yaux = -s * px + c * py;` // + centy */
 
   while (y--) {
 
@@ -1483,9 +1482,8 @@ static void do_mul_effect_float(
   fac1 = facf0;
   fac3 = facf1;
 
-  /* formula:
-   * fac * (a * b) + (1 - fac) * a  =>  fac * a * (b - 1) + a
-   */
+  /* Formula:
+   * `fac * (a * b) + (1 - fac) * a => fac * a * (b - 1) + a`. */
 
   while (y--) {
     x = xo;
diff --git a/source/blender/sequencer/intern/strip_edit.c b/source/blender/sequencer/intern/strip_edit.c
index 0dc8dfa10d7..e92afee08cd 100644
--- a/source/blender/sequencer/intern/strip_edit.c
+++ b/source/blender/sequencer/intern/strip_edit.c
@@ -112,8 +112,8 @@ static void seq_update_muting_recursive(ListBase *seqbasep, Sequence *metaseq, i
   Sequence *seq;
   int seqmute;
 
-  /* for sound we go over full meta tree to update muted state,
-   * since sound is played outside of evaluating the imbufs, */
+  /* For sound we go over full meta tree to update muted state,
+   * since sound is played outside of evaluating the imbufs. */
   for (seq = seqbasep->first; seq; seq = seq->next) {
     seqmute = (mute || (seq->flag & SEQ_MUTE));
 
diff --git a/source/blender/sequencer/intern/strip_time.c b/source/blender/sequencer/intern/strip_time.c
index 20e2421ea88..68128690773 100644
--- a/source/blender/sequencer/intern/strip_time.c
+++ b/source/blender/sequencer/intern/strip_time.c
@@ -111,8 +111,8 @@ static void seq_update_sound_bounds_recursive_impl(Scene *scene,
 {
   Sequence *seq;
 
-  /* for sound we go over full meta tree to update bounds of the sound strips,
-   * since sound is played outside of evaluating the imbufs, */
+  /* For sound we go over full meta tree to update bounds of the sound strips,
+   * since sound is played outside of evaluating the imbufs. */
   for (seq = metaseq->seqbase.first; seq; seq = seq->next) {
     if (seq->type == SEQ_TYPE_META) {
       seq_update_sound_bounds_recursive_impl(
diff --git a/source/blender/shader_fx/intern/FX_ui_common.c b/source/blender/shader_fx/intern/FX_ui_common.c
index 8a259c6aaff..8cb1ea6b66c 100644
--- a/source/blender/shader_fx/intern/FX_ui_common.c
+++ b/source/blender/shader_fx/intern/FX_ui_common.c
@@ -9,7 +9,7 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software  Foundation,
+ * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
diff --git a/source/blender/simulation/intern/implicit_blender.c b/source/blender/simulation/intern/implicit_blender.c
index 64ee8d7d389..10a5f153662 100644
--- a/source/blender/simulation/intern/implicit_blender.c
+++ b/source/blender/simulation/intern/implicit_blender.c
@@ -180,8 +180,8 @@ DO_INLINE void mul_lfvectorS(float (*to)[3],
     mul_fvector_S(to[i], fLongVector[i], scalar);
   }
 }
-/* Multiply long vector with scalar. */
-/* A -= B * float */
+/* Multiply long vector with scalar.
+ * `A -= B * float` */
 DO_INLINE void submul_lfvectorS(float (*to)[3],
                                 float (*fLongVector)[3],
                                 float scalar,
@@ -209,7 +209,7 @@ DO_INLINE float dot_lfvector(float (*fLongVectorA)[3],
   }
   return temp;
 }
-/* A = B + C  --> for big vector */
+/* `A = B + C` -> for big vector. */
 DO_INLINE void add_lfvector_lfvector(float (*to)[3],
                                      float (*fLongVectorA)[3],
                                      float (*fLongVectorB)[3],
@@ -221,7 +221,7 @@ DO_INLINE void add_lfvector_lfvector(float (*to)[3],
     add_v3_v3v3(to[i], fLongVectorA[i], fLongVectorB[i]);
   }
 }
-/* A = B + C * float --> for big vector */
+/* `A = B + C * float` -> for big vector. */
 DO_INLINE void add_lfvector_lfvectorS(float (*to)[3],
                                       float (*fLongVectorA)[3],
                                       float (*fLongVectorB)[3],
@@ -234,7 +234,7 @@ DO_INLINE void add_lfvector_lfvectorS(float (*to)[3],
     VECADDS(to[i], fLongVectorA[i], fLongVectorB[i], bS);
   }
 }
-/* A = B * float + C * float --> for big vector */
+/* `A = B * float + C * float` -> for big vector */
 DO_INLINE void add_lfvectorS_lfvectorS(float (*to)[3],
                                        float (*fLongVectorA)[3],
                                        float aS,
@@ -248,7 +248,7 @@ DO_INLINE void add_lfvectorS_lfvectorS(float (*to)[3],
     VECADDSS(to[i], fLongVectorA[i], aS, fLongVectorB[i], bS);
   }
 }
-/* A = B - C * float --> for big vector */
+/* `A = B - C * float` -> for big vector. */
 DO_INLINE void sub_lfvector_lfvectorS(float (*to)[3],
                                       float (*fLongVectorA)[3],
                                       float (*fLongVectorB)[3],
@@ -260,7 +260,7 @@ DO_INLINE void sub_lfvector_lfvectorS(float (*to)[3],
     VECSUBS(to[i], fLongVectorA[i], fLongVectorB[i], bS);
   }
 }
-/* A = B - C --> for big vector */
+/* `A = B - C` -> for big vector. */
 DO_INLINE void sub_lfvector_lfvector(float (*to)[3],
                                      float (*fLongVectorA)[3],
                                      float (*fLongVectorB)[3],
@@ -455,7 +455,7 @@ DO_INLINE void add_fmatrix_fmatrix(float to[3][3],
   add_v3_v3v3(to[1], matrixA[1], matrixB[1]);
   add_v3_v3v3(to[2], matrixA[2], matrixB[2]);
 }
-/* A -= B*x + C*y (3x3 matrix sub-addition with 3x3 matrix) */
+/* `A -= B*x + (C * y)` (3x3 matrix sub-addition with 3x3 matrix). */
 DO_INLINE void subadd_fmatrixS_fmatrixS(
     float to[3][3], const float matrixA[3][3], float aS, const float matrixB[3][3], float bS)
 {
@@ -463,7 +463,7 @@ DO_INLINE void subadd_fmatrixS_fmatrixS(
   VECSUBADDSS(to[1], matrixA[1], aS, matrixB[1], bS);
   VECSUBADDSS(to[2], matrixA[2], aS, matrixB[2], bS);
 }
-/* A = B - C (3x3 matrix subtraction with 3x3 matrix) */
+/* `A = B - C` (3x3 matrix subtraction with 3x3 matrix). */
 DO_INLINE void sub_fmatrix_fmatrix(float to[3][3],
                                    const float matrixA[3][3],
                                    const float matrixB[3][3])
@@ -1683,8 +1683,8 @@ BLI_INLINE void dfdx_damp(float to[3][3],
                           float rest,
                           float damping)
 {
-  /* inner spring damping   vel is the relative velocity  of the endpoints. */
-  //  return (I-outerprod(dir, dir)) * (-damping * -(dot(dir, vel)/Max(length, rest)));
+  /* Inner spring damping `vel` is the relative velocity of the endpoints. */
+  // return (I - outerprod(dir, dir)) * (-damping * -(dot(dir, vel) / Max(length, rest)));
   mul_fvectorT_fvector(to, dir, dir);
   sub_fmatrix_fmatrix(to, I, to);
   mul_fmatrix_S(to, (-damping * -(dot_v3v3(dir, vel) / MAX2(length, rest))));
diff --git a/source/blender/simulation/intern/implicit_eigen.cpp b/source/blender/simulation/intern/implicit_eigen.cpp
index e34d51fb227..d509b3db873 100644
--- a/source/blender/simulation/intern/implicit_eigen.cpp
+++ b/source/blender/simulation/intern/implicit_eigen.cpp
@@ -894,8 +894,8 @@ BLI_INLINE void dfdx_damp(float to[3][3],
                           float rest,
                           float damping)
 {
-  /* inner spring damping   vel is the relative velocity  of the endpoints. */
-  //  return (I-outerprod(dir, dir)) * (-damping * -(dot(dir, vel)/Max(length, rest)));
+  /* Inner spring damping vel is the relative velocity of the endpoints. */
+  // return (I - outerprod(dir, dir)) * (-damping * -(dot(dir, vel) / Max(length, rest)));
   mul_fvectorT_fvector(to, dir, dir);
   sub_fmatrix_fmatrix(to, I, to);
   mul_fmatrix_S(to, (-damping * -(dot_v3v3(dir, vel) / MAX2(length, rest))));
diff --git a/source/blender/windowmanager/intern/wm_keymap_utils.c b/source/blender/windowmanager/intern/wm_keymap_utils.c
index b0b4f0f5904..795f78e215f 100644
--- a/source/blender/windowmanager/intern/wm_keymap_utils.c
+++ b/source/blender/windowmanager/intern/wm_keymap_utils.c
@@ -207,7 +207,7 @@ wmKeyMap *WM_keymap_guess_from_context(const bContext *C)
 /* Needs to be kept up to date with Keymap and Operator naming */
 wmKeyMap *WM_keymap_guess_opname(const bContext *C, const char *opname)
 {
-  /* Op types purposely skipped  for now:
+  /* Op types purposely skipped for now:
    *     BRUSH_OT
    *     BOID_OT
    *     BUTTONS_OT
diff --git a/source/blender/windowmanager/wm_surface.h b/source/blender/windowmanager/wm_surface.h
index 06c29231361..36d74f612fc 100644
--- a/source/blender/windowmanager/wm_surface.h
+++ b/source/blender/windowmanager/wm_surface.h
@@ -42,9 +42,9 @@ typedef struct wmSurface {
   /** Free customdata, not the surface itself (done by wm_surface API) */
   void (*free_data)(struct wmSurface *);
 
-  /** Called  when surface is activated for drawing (made drawable). */
+  /** Called when surface is activated for drawing (made drawable). */
   void (*activate)(void);
-  /** Called  when surface is deactivated for drawing (current drawable cleared). */
+  /** Called when surface is deactivated for drawing (current drawable cleared). */
   void (*deactivate)(void);
 } wmSurface;
 
-- 
cgit v1.2.3