Cleanup: consistent use of tags: NOTE/TODO/FIXME/XXX

Also use doxy style function reference `#` prefix chars when
referencing identifiers.

5 files changed, 12 insertions, 12 deletions

diff --git a/intern/cycles/kernel/kernel_bake.h b/intern/cycles/kernel/kernel_bake.h
index bdedf0c20a8..d1f33a4d0f0 100644
--- a/intern/cycles/kernel/kernel_bake.h
+++ b/intern/cycles/kernel/kernel_bake.h
@@ -40,7 +40,7 @@ ccl_device_noinline void compute_light_pass(
   /* Evaluate surface shader. */
   shader_eval_surface(kg, sd, &state, NULL, state.flag);
 
-  /* TODO, disable more closures we don't need besides transparent */
+  /* TODO: disable more closures we don't need besides transparent. */
   shader_bsdf_disable_transparency(kg, sd);
 
   /* Init ray. */
diff --git a/intern/ghost/intern/GHOST_SystemSDL.cpp b/intern/ghost/intern/GHOST_SystemSDL.cpp
index eccef18bee2..7fea0ce8a02 100644
--- a/intern/ghost/intern/GHOST_SystemSDL.cpp
+++ b/intern/ghost/intern/GHOST_SystemSDL.cpp
@@ -121,7 +121,7 @@ GHOST_TSuccess GHOST_SystemSDL::init()
 void GHOST_SystemSDL::getAllDisplayDimensions(GHOST_TUns32 &width, GHOST_TUns32 &height) const
 {
   SDL_DisplayMode mode;
-  SDL_GetDesktopDisplayMode(0, &mode); /* note, always 0 display */
+  SDL_GetDesktopDisplayMode(0, &mode); /* NOTE: always 0 display. */
   width = mode.w;
   height = mode.h;
 }
@@ -129,7 +129,7 @@ void GHOST_SystemSDL::getAllDisplayDimensions(GHOST_TUns32 &width, GHOST_TUns32
 void GHOST_SystemSDL::getMainDisplayDimensions(GHOST_TUns32 &width, GHOST_TUns32 &height) const
 {
   SDL_DisplayMode mode;
-  SDL_GetCurrentDisplayMode(0, &mode); /* note, always 0 display */
+  SDL_GetCurrentDisplayMode(0, &mode); /* NOTE: always 0 display. */
   width = mode.w;
   height = mode.h;
 }
@@ -468,8 +468,8 @@ void GHOST_SystemSDL::processEvent(SDL_Event *sdl_event)
       assert(window != NULL);
 
       GHOST_TKey gkey = convertSDLKey(sdl_sub_evt.keysym.scancode);
-      /* note, the sdl_sub_evt.keysym.sym is truncated,
-       * for unicode support ghost has to be modified */
+      /* NOTE: the `sdl_sub_evt.keysym.sym` is truncated,
+       * for unicode support ghost has to be modified. */
       /* printf("%d\n", sym); */
       if (sym > 127) {
         switch (sym) {
@@ -755,5 +755,5 @@ void GHOST_SystemSDL::putClipboard(GHOST_TInt8 *buffer, bool selection) const
 
 GHOST_TUns64 GHOST_SystemSDL::getMilliSeconds()
 {
-  return GHOST_TUns64(SDL_GetTicks()); /* note, 32 -> 64bits */
+  return GHOST_TUns64(SDL_GetTicks()); /* NOTE: 32 -> 64bits. */
 }
diff --git a/intern/ghost/intern/GHOST_SystemWin32.cpp b/intern/ghost/intern/GHOST_SystemWin32.cpp
index a7cb4aee837..0282340c071 100644
--- a/intern/ghost/intern/GHOST_SystemWin32.cpp
+++ b/intern/ghost/intern/GHOST_SystemWin32.cpp
@@ -1197,8 +1197,8 @@ GHOST_EventKey *GHOST_SystemWin32::processKeyEvent(GHOST_WindowWin32 *window, RA
     // Don't call ToUnicodeEx on dead keys as it clears the buffer and so won't allow diacritical
     // composition.
     else if (MapVirtualKeyW(vk, 2) != 0) {
-      // todo: ToUnicodeEx can respond with up to 4 utf16 chars (only 2 here).
-      // Could be up to 24 utf8 bytes.
+      /* TODO: #ToUnicodeEx can respond with up to 4 utf16 chars (only 2 here).
+       * Could be up to 24 utf8 bytes. */
       if ((r = ToUnicodeEx(
                vk, raw.data.keyboard.MakeCode, state, utf16, 2, 0, system->m_keylayout))) {
         if ((r > 0 && r < 3)) {
diff --git a/intern/ghost/intern/GHOST_SystemX11.cpp b/intern/ghost/intern/GHOST_SystemX11.cpp
index c5564e9880e..b8e221f5d0c 100644
--- a/intern/ghost/intern/GHOST_SystemX11.cpp
+++ b/intern/ghost/intern/GHOST_SystemX11.cpp
@@ -302,9 +302,9 @@ GHOST_TUns8 GHOST_SystemX11::getNumDisplays() const
 void GHOST_SystemX11::getMainDisplayDimensions(GHOST_TUns32 &width, GHOST_TUns32 &height) const
 {
   if (m_display) {
-    /* note, for this to work as documented,
+    /* NOTE(campbell): for this to work as documented,
      * we would need to use Xinerama check r54370 for code that did this,
-     * we've since removed since its not worth the extra dep - campbell */
+     * we've since removed since its not worth the extra dependency. */
     getAllDisplayDimensions(width, height);
   }
 }
diff --git a/intern/ghost/intern/GHOST_WindowSDL.cpp b/intern/ghost/intern/GHOST_WindowSDL.cpp
index ff0c506feb7..56ae0deb341 100644
--- a/intern/ghost/intern/GHOST_WindowSDL.cpp
+++ b/intern/ghost/intern/GHOST_WindowSDL.cpp
@@ -556,7 +556,7 @@ static SDL_Cursor *sdl_ghost_CreateCursor(
   return cursor;
 }
 
-/* TODO, this is currently never freed but it won't leak either. */
+/* TODO: this is currently never freed but it won't leak either. */
 static SDL_Cursor *getStandardCursorShape(GHOST_TStandardCursor shape)
 {
   if (sdl_std_cursor_array[0] == NULL) {
@@ -576,7 +576,7 @@ static SDL_Cursor *getStandardCursorShape(GHOST_TStandardCursor shape)
     DEF_CURSOR(left_ptr, GHOST_kStandardCursorDefault);
     DEF_CURSOR(right_ptr, GHOST_kStandardCursorRightArrow);
     DEF_CURSOR(left_ptr, GHOST_kStandardCursorLeftArrow);
-    DEF_CURSOR(umbrella, GHOST_kStandardCursorInfo);  // TODO, replace this one.
+    DEF_CURSOR(umbrella, GHOST_kStandardCursorInfo); /* TODO: replace this one. */
     DEF_CURSOR(pirate, GHOST_kStandardCursorDestroy);
     DEF_CURSOR(question_arrow, GHOST_kStandardCursorHelp);
     DEF_CURSOR(watch, GHOST_kStandardCursorWait);