Cleanup: spelling in comments, use doxygen comments

intern/ghost/intern/GHOST_XrGraphicsBindingVulkan.cc

@@ -677,7 +677,7 @@ void GHOST_XrGraphicsBindingVulkan::submitToSwapchainImageGpu(
                        2,
                        vk_image_memory_barrier);
 
-  /* Copy image to swapchain */
+  /* Copy image to swap-chain. */
   VkImageCopy vk_image_copy = {{VK_IMAGE_ASPECT_COLOR_BIT, 0, 0, 1},
                                {0, 0, 0},
                                {VK_IMAGE_ASPECT_COLOR_BIT, 0, 0, 1},
@@ -691,7 +691,7 @@ void GHOST_XrGraphicsBindingVulkan::submitToSwapchainImageGpu(
                  1,
                  &vk_image_copy);
 
-  /* Swapchain needs to be in an VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL compatible layout. */
+  /* Swap-chain needs to be in an VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL compatible layout. */
   VkImageMemoryBarrier vk_image_memory_barrier2 = {VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER,
                                                    nullptr,
                                                    VK_ACCESS_TRANSFER_WRITE_BIT,

source/blender/blenkernel/BKE_mesh.h

@@ -280,11 +280,14 @@ enum {
  * Collection of #MLoopNorSpace basic storage & pre-allocation.
  */
 struct MLoopNorSpaceArray {
-  MLoopNorSpace **lspacearr; /* Face corner aligned array */
-  struct LinkNode
-      *loops_pool; /* Allocated once, avoids to call BLI_linklist_prepend_arena() for each loop! */
-  char data_type;  /* Whether we store loop indices, or pointers to BMLoop. */
-  int spaces_num;  /* Number of clnors spaces defined in this array. */
+  /** Face corner aligned array. */
+  MLoopNorSpace **lspacearr;
+  /** Allocated once, avoids to call #BLI_linklist_prepend_arena() for each loop! */
+  struct LinkNode *loops_pool;
+  /** Whether we store loop indices, or pointers to #BMLoop. */
+  char data_type;
+  /** Number of `clnors` spaces defined in this array. */
+  int spaces_num;
   struct MemArena *mem;
 };
 /**

source/blender/draw/intern/draw_debug.cc

@@ -255,7 +255,7 @@ void DebugDraw::display_lines(View &view)
 
   {
     gpu::DebugScope debug_scope("CPU");
-    /* We might have race condition here (a writer thread might still be outputing vertices).
+    /* We might have race condition here (a writer thread might still be outputting vertices).
      * But that is ok. At worse, we will be missing some vertex data and show 1 corrupted line. */
     cpu_draw_buf_.current()->command.vertex_len = vertex_len_.load();
     cpu_draw_buf_.current()->push_update();
@@ -280,7 +280,7 @@ void DebugDraw::display_lines(View &view)
 
 void DebugDraw::display_to_view(View &view)
 {
-  /* Display only on the main thread. Avoid concurent usage of the resource. */
+  /* Display only on the main thread. Avoid concurrent usage of the resource. */
   BLI_assert(BLI_thread_is_main());
 
   GPU_debug_group_begin("DebugDraw");

source/blender/draw/intern/draw_pass.hh

@@ -135,9 +135,9 @@ class PassBase {
   Vector<command::Header, 0> headers_;
   /** Commands referenced by headers (which contains their types). */
   Vector<command::Undetermined, 0> commands_;
-  /* Reference to draw commands buffer. Either own or from parent pass. */
+  /** Reference to draw commands buffer. Either own or from parent pass. */
   DrawCommandBufType &draw_commands_buf_;
-  /* Reference to sub-pass commands buffer. Either own or from parent pass. */
+  /** Reference to sub-pass commands buffer. Either own or from parent pass. */
   SubPassVector<PassBase<DrawCommandBufType>> &sub_passes_;
   /** Currently bound shader. Used for interface queries. */
   GPUShader *shader_;
@@ -170,7 +170,7 @@ class PassBase {
   void init();
 
   /**
-   * Returns true if the pass and its subpasses don't contain any draw or dispatch command.
+   * Returns true if the pass and its sub-passes don't contain any draw or dispatch command.
    */
   bool is_empty() const;
 

source/blender/editors/interface/interface_handlers.cc

@@ -12080,7 +12080,7 @@ static bool ui_can_activate_other_menu(uiBut *but, uiBut *but_other, const wmEve
     right = but->rect.xmax;
     left = but_other->rect.xmax;
     if (ELEM(but_other->type, UI_BTYPE_POPOVER, UI_BTYPE_MENU)) {
-      /* Skip the dropdown arrow on the right of it. */
+      /* Skip the drop-down arrow on the right of it. */
       safety += 8.0f * UI_SCALE_FAC;
     }
     left -= safety;

source/blender/imbuf/intern/format_iris.cc

@@ -561,7 +561,7 @@ ImBuf *imb_loadiris(const uchar *mem, size_t size, int flags, ImFileColorSpace &
   return ibuf;
 }
 
-/* static utility functions for longimagedata */
+/* Static utility functions for loading image data. */
 
 static void interleaverow(uchar *lptr, const uchar *cptr, int z, int n)
 {