Cleanup: use C comments for descriptive text

Follow our code style guide by using C-comments for text descriptions.

3 files changed, 29 insertions, 29 deletions

diff --git a/source/blender/editors/include/ED_anim_api.h b/source/blender/editors/include/ED_anim_api.h
index 36990414e6d..04f6932d671 100644
--- a/source/blender/editors/include/ED_anim_api.h
+++ b/source/blender/editors/include/ED_anim_api.h
@@ -332,7 +332,7 @@ typedef enum eAnimFilter_Flags {
 } eAnimFilter_Flags;
 
 /* ---------- Flag Checking Macros ------------ */
-// xxx check on all of these flags again...
+/* XXX check on all of these flags again. */
 
 /* Dopesheet only */
 /* 'Scene' channels */
@@ -507,7 +507,7 @@ typedef enum eAnimChannels_SetFlag {
   ACHANNEL_SETFLAG_ADD = 1,
   /** on->off, off->on */
   ACHANNEL_SETFLAG_INVERT = 2,
-  /** some on -> all off // all on */
+  /** some on -> all off / all on */
   ACHANNEL_SETFLAG_TOGGLE = 3,
 } eAnimChannels_SetFlag;
 
@@ -730,7 +730,7 @@ void ANIM_nla_mapping_apply_fcurve(struct AnimData *adt,
 /* ..... */
 
 /* Perform auto-blending/extend refreshes after some operations */
-// NOTE: defined in space_nla/nla_edit.c, not in animation/
+/* NOTE: defined in space_nla/nla_edit.c, not in animation/ */
 void ED_nla_postop_refresh(bAnimContext *ac);
 
 /* ------------- Unit Conversion Mappings ------------- */
diff --git a/source/blender/editors/include/UI_icons.h b/source/blender/editors/include/UI_icons.h
index 09ab72efaaf..d99ecf2fd56 100644
--- a/source/blender/editors/include/UI_icons.h
+++ b/source/blender/editors/include/UI_icons.h
@@ -160,7 +160,7 @@ DEF_ICON_BLANK(157)
 DEF_ICON_BLANK(158)
 DEF_ICON_BLANK(159)
 DEF_ICON_BLANK(160)
-DEF_ICON(BLANK1)  // Not actually blank - this is used all over the place
+DEF_ICON(BLANK1) /* Not actually blank - this is used all over the place */
 DEF_ICON(FAKE_USER_OFF)
 DEF_ICON(FAKE_USER_ON)
 /* EDITORS */
@@ -192,7 +192,7 @@ DEF_ICON(UV)
 DEF_ICON_BLANK(190)
 
 /* MODES */
-DEF_ICON(OBJECT_DATAMODE)  // XXX fix this up
+DEF_ICON(OBJECT_DATAMODE) /* XXX fix this up */
 DEF_ICON(EDITMODE_HLT)
 DEF_ICON(UV_DATA)
 DEF_ICON(VPAINT_HLT)
@@ -873,7 +873,7 @@ DEF_ICON(SEQ_SPLITVIEW)
 DEF_ICON(SEQ_STRIP_META)
 DEF_ICON(SEQ_STRIP_DUPLICATE)
 DEF_ICON_BLANK(872)
-DEF_ICON(IMAGE_RGB)  // XXX CHANGE TO STRAIGHT ALPHA, Z ETC
+DEF_ICON(IMAGE_RGB) /* XXX CHANGE TO STRAIGHT ALPHA, Z ETC */
 DEF_ICON(IMAGE_RGB_ALPHA)
 DEF_ICON(IMAGE_ALPHA)
 DEF_ICON(IMAGE_ZDEPTH)
diff --git a/source/blender/editors/include/UI_resources.h b/source/blender/editors/include/UI_resources.h
index a7b87d38472..f597bb307db 100644
--- a/source/blender/editors/include/UI_resources.h
+++ b/source/blender/editors/include/UI_resources.h
@@ -50,7 +50,7 @@ typedef enum ThemeColorID {
   TH_REDALERT,
 
   TH_THEMEUI,
-  // common colors among spaces
+  /* Common colors among spaces. */
 
   TH_BACK,
   /** Use when 'TH_SHOW_BACK_GRAD' is set (the lower, darker color). */
@@ -358,92 +358,92 @@ struct bThemeState {
   int spacetype, regionid;
 };
 
-// THE CODERS API FOR THEMES:
+/* THE CODERS API FOR THEMES: */
 
-// returns one value, not scaled
+/* returns one value, not scaled */
 float UI_GetThemeValuef(int colorid);
 int UI_GetThemeValue(int colorid);
 
 float UI_GetThemeValueTypef(int colorid, int spacetype);
 int UI_GetThemeValueType(int colorid, int spacetype);
 
-// get three color values, scaled to 0.0-1.0 range
+/* get three color values, scaled to 0.0-1.0 range */
 void UI_GetThemeColor3fv(int colorid, float col[3]);
 void UI_GetThemeColorBlend3ubv(int colorid1, int colorid2, float fac, unsigned char col[3]);
 void UI_GetThemeColorBlend3f(int colorid1, int colorid2, float fac, float r_col[3]);
 void UI_GetThemeColorBlend4f(int colorid1, int colorid2, float fac, float r_col[4]);
-// get the color, range 0.0-1.0, complete with shading offset
+/* get the color, range 0.0-1.0, complete with shading offset */
 void UI_GetThemeColorShade3fv(int colorid, int offset, float col[3]);
 void UI_GetThemeColorShade3ubv(int colorid, int offset, unsigned char col[3]);
 void UI_GetThemeColorShade4ubv(int colorid, int offset, unsigned char col[4]);
 
-// get three color values, range 0-255,
-// complete with shading offset for the RGB components and blending.
+/* get three color values, range 0-255,
+ * complete with shading offset for the RGB components and blending. */
 void UI_GetThemeColorBlendShade3ubv(
     int colorid1, int colorid2, float fac, int offset, unsigned char col[3]);
 
-// get four color values, scaled to 0.0-1.0 range
+/* get four color values, scaled to 0.0-1.0 range */
 void UI_GetThemeColor4fv(int colorid, float col[4]);
 
 /* get four color values from specified space type, scaled to 0.0-1.0 range */
 void UI_GetThemeColorType4fv(int colorid, int spacetype, float col[4]);
 
-// get four color values, range 0.0-1.0, complete with shading offset for the RGB components
+/* get four color values, range 0.0-1.0, complete with shading offset for the RGB components */
 void UI_GetThemeColorShade4fv(int colorid, int offset, float col[4]);
 void UI_GetThemeColorShadeAlpha4fv(int colorid, int coloffset, int alphaoffset, float col[4]);
 
-// get four color values ranged between 0 and 255; includes the alpha channel
+/* get four color values ranged between 0 and 255; includes the alpha channel */
 void UI_GetThemeColorShadeAlpha4ubv(int colorid,
                                     int coloffset,
                                     int alphaoffset,
                                     unsigned char col[4]);
 
-// get four color values, range 0.0-1.0,
-// complete with shading offset for the RGB components and blending.
+/* get four color values, range 0.0-1.0,
+ * complete with shading offset for the RGB components and blending. */
 void UI_GetThemeColorBlendShade3fv(
     int colorid1, int colorid2, float fac, int offset, float col[3]);
 void UI_GetThemeColorBlendShade4fv(
     int colorid1, int colorid2, float fac, int offset, float col[4]);
 
-// get the 3 or 4 byte values
+/* get the 3 or 4 byte values */
 void UI_GetThemeColor3ubv(int colorid, unsigned char col[3]);
 void UI_GetThemeColor4ubv(int colorid, unsigned char col[4]);
 
-// get a theme color from specified space type
+/* get a theme color from specified space type */
 void UI_GetThemeColorType3fv(int colorid, int spacetype, float col[3]);
 void UI_GetThemeColorType3ubv(int colorid, int spacetype, unsigned char col[3]);
 void UI_GetThemeColorType4ubv(int colorid, int spacetype, unsigned char col[4]);
 
-// get theme color for coloring monochrome icons
+/* get theme color for coloring monochrome icons */
 bool UI_GetIconThemeColor4ubv(int colorid, unsigned char col[4]);
 
-// shade a 3 byte color (same as UI_GetColorPtrBlendShade3ubv with 0.0 factor)
+/* shade a 3 byte color (same as UI_GetColorPtrBlendShade3ubv with 0.0 factor) */
 void UI_GetColorPtrShade3ubv(const unsigned char cp1[3], unsigned char col[3], int offset);
 
-// get a 3 byte color, blended and shaded between two other char color pointers
+/* get a 3 byte color, blended and shaded between two other char color pointers */
 void UI_GetColorPtrBlendShade3ubv(const unsigned char cp1[3],
                                   const unsigned char cp2[3],
                                   unsigned char col[3],
                                   float fac,
                                   int offset);
 
-// sets the font color
-// (for anything fancy use UI_GetThemeColor[Fancy] then BLF_color)
+/* sets the font color
+ * (for anything fancy use UI_GetThemeColor[Fancy] then BLF_color) */
 void UI_FontThemeColor(int fontid, int colorid);
 
-// clear the framebuffer using the input colorid
+/* clear the framebuffer using the input colorid */
 void UI_ThemeClearColor(int colorid);
 
-// internal (blender) usage only, for init and set active
+/* internal (blender) usage only, for init and set active */
 void UI_SetTheme(int spacetype, int regionid);
 
-// get current theme
+/* get current theme */
 struct bTheme *UI_GetTheme(void);
 
 void UI_Theme_Store(struct bThemeState *theme_state);
 void UI_Theme_Restore(struct bThemeState *theme_state);
 
-// return shadow width outside menus and popups */
+/* return shadow width outside menus and popups */
 int UI_ThemeMenuShadowWidth(void);
 
 /* only for buttons in theme editor! */