Cleanup: comment blocks, trailing space in comments

8 files changed, 23 insertions, 18 deletions

diff --git a/source/blender/imbuf/IMB_imbuf.h b/source/blender/imbuf/IMB_imbuf.h
index 69a80d6e0d3..2cfce7b1ba0 100644
--- a/source/blender/imbuf/IMB_imbuf.h
+++ b/source/blender/imbuf/IMB_imbuf.h
@@ -299,17 +299,22 @@ void IMB_rectblend_threaded(struct ImBuf *dbuf,
 typedef enum IMB_Timecode_Type {
   /** Don't use time-code files at all. */
   IMB_TC_NONE = 0,
-  /** use images in the order as they are recorded
+  /**
+   * Use images in the order as they are recorded
    * (currently, this is the only one implemented
-   * and is a sane default) */
+   * and is a sane default).
+   */
   IMB_TC_RECORD_RUN = 1,
-  /** Use global timestamp written by recording
-   * device (prosumer camcorders e.g. can do that). */
+  /**
+   * Use global timestamp written by recording
+   * device (prosumer camcorders e.g. can do that).
+   */
   IMB_TC_FREE_RUN = 2,
-  /** Interpolate a global timestamp using the
+  /**
+   * Interpolate a global timestamp using the
    * record date and time written by recording
-   * device (*every* consumer camcorder can do
-   * that :) )*/
+   * device (*every* consumer camcorder can do that).
+   */
   IMB_TC_INTERPOLATED_REC_DATE_FREE_RUN = 4,
   IMB_TC_RECORD_RUN_NO_GAPS = 8,
   IMB_TC_MAX_SLOT = 4,
diff --git a/source/blender/imbuf/intern/cineon/logImageCore.c b/source/blender/imbuf/intern/cineon/logImageCore.c
index 2d42609fdf5..73bcb8d7ebc 100644
--- a/source/blender/imbuf/intern/cineon/logImageCore.c
+++ b/source/blender/imbuf/intern/cineon/logImageCore.c
@@ -486,7 +486,7 @@ int logImageGetDataRGBA(LogImageFile *logImage, float *data, int dataIsLinearRGB
     }
   }
 
-  /* only one element, easy case, no need to do anything  */
+  /* Only one element, easy case, no need to do anything. */
   if (logImage->numElements == 1) {
     returnValue = convertLogElementToRGBA(
         elementData[0], data, logImage, logImage->element[0], dataIsLinearRGB);
diff --git a/source/blender/imbuf/intern/divers.c b/source/blender/imbuf/intern/divers.c
index 47712456014..e6f42da1597 100644
--- a/source/blender/imbuf/intern/divers.c
+++ b/source/blender/imbuf/intern/divers.c
@@ -366,7 +366,7 @@ void IMB_buffer_byte_from_float_mask(uchar *rect_to,
   }
 }
 
-/* byte to float pixels, input and output 4-channel RGBA  */
+/* Byte to float pixels, input and output 4-channel RGBA. */
 void IMB_buffer_float_from_byte(float *rect_to,
                                 const uchar *rect_from,
                                 int profile_to,
diff --git a/source/blender/imbuf/intern/imageprocess.c b/source/blender/imbuf/intern/imageprocess.c
index e2d469ab5a3..804c9c3eb89 100644
--- a/source/blender/imbuf/intern/imageprocess.c
+++ b/source/blender/imbuf/intern/imageprocess.c
@@ -181,7 +181,7 @@ void bilinear_interpolation_color_wrap(
     return;
   }
 
-  /* wrap interpolation pixels - main difference from bilinear_interpolation_color  */
+  /* Wrap interpolation pixels - main difference from #bilinear_interpolation_color. */
   if (x1 < 0) {
     x1 = in->x + x1;
   }
@@ -324,7 +324,7 @@ void nearest_interpolation_color_wrap(
   x = x % in->x;
   y = y % in->y;
 
-  /* wrap interpolation pixels - main difference from nearest_interpolation_color  */
+  /* Wrap interpolation pixels - main difference from #nearest_interpolation_color. */
   if (x < 0) {
     x += in->x;
   }
diff --git a/source/blender/imbuf/intern/iris.c b/source/blender/imbuf/intern/iris.c
index 547af472d73..e62473fb8c7 100644
--- a/source/blender/imbuf/intern/iris.c
+++ b/source/blender/imbuf/intern/iris.c
@@ -237,10 +237,10 @@ static void test_endian_zbuf(struct ImBuf *ibuf)
   }
 }
 
-/* from misc_util: flip the bytes from x  */
+/* From misc_util: flip the bytes from x. */
 #define GS(x) (((uchar *)(x))[0] << 8 | ((uchar *)(x))[1])
 
-/* this one is only def-ed once, strangely... */
+/* This one is only def-ed once, strangely... */
 #define GSS(x) (((uchar *)(x))[1] << 8 | ((uchar *)(x))[0])
 
 bool imb_is_a_iris(const uchar *mem, size_t size)
diff --git a/source/blender/imbuf/intern/openexr/openexr_api.cpp b/source/blender/imbuf/intern/openexr/openexr_api.cpp
index 382d86f2645..ab578e25b94 100644
--- a/source/blender/imbuf/intern/openexr/openexr_api.cpp
+++ b/source/blender/imbuf/intern/openexr/openexr_api.cpp
@@ -930,7 +930,7 @@ void IMB_exrtile_begin_write(
   exr_printf("%s %-6s %-22s \"%s\"\n", "p", "view", "name", "internal_name");
   exr_printf("---------------------------------------------------------------\n");
 
-  /* assign channels  */
+  /* Assign channels. */
   for (echan = (ExrChannel *)data->channels.first; echan; echan = echan->next) {
     /* Tiles are expected to be saved with full float currently. */
     BLI_assert(echan->use_half_float == 0);
diff --git a/source/blender/imbuf/intern/targa.c b/source/blender/imbuf/intern/targa.c
index d7cefbbd077..1fde173b4cf 100644
--- a/source/blender/imbuf/intern/targa.c
+++ b/source/blender/imbuf/intern/targa.c
@@ -427,7 +427,7 @@ static void complete_partial_load(struct ImBuf *ibuf, unsigned int *rect)
     printf("decodetarga: incomplete file, %.1f%% missing\n",
            100 * ((float)size / (ibuf->x * ibuf->y)));
 
-    /* not essential but makes displaying partially rendered TGA's less ugly  */
+    /* Not essential but makes displaying partially rendered TGA's less ugly. */
     memset(rect, 0, size);
   }
   else {
@@ -701,7 +701,7 @@ ImBuf *imb_loadtarga(const unsigned char *mem,
     }
     ibuf->planes = size;
 
-    if (tga.mapbits != 32) { /* set alpha bits  */
+    if (tga.mapbits != 32) { /* Set alpha bits. */
       cmap[0] &= BIG_LONG(0x00ffffffl);
     }
   }
diff --git a/source/blender/imbuf/intern/thumbs.c b/source/blender/imbuf/intern/thumbs.c
index 7b4bf704096..d38c300a4c4 100644
--- a/source/blender/imbuf/intern/thumbs.c
+++ b/source/blender/imbuf/intern/thumbs.c
@@ -144,8 +144,8 @@ static bool get_thumb_dir(char *dir, ThumbSize size)
  * \{ */
 
 typedef enum {
-  UNSAFE_ALL = 0x1,        /* Escape all unsafe characters   */
-  UNSAFE_ALLOW_PLUS = 0x2, /* Allows '+'  */
+  UNSAFE_ALL = 0x1,        /* Escape all unsafe characters. */
+  UNSAFE_ALLOW_PLUS = 0x2, /* Allows '+' */
   UNSAFE_PATH = 0x8,       /* Allows '/', '&', '=', ':', '@', '+', '$' and ',' */
   UNSAFE_HOST = 0x10,      /* Allows '/' and ':' and '@' */
   UNSAFE_SLASHES = 0x20,   /* Allows all characters except for '/' and '%' */