Cleanup: update comments

source/blender/editors/manipulator_library/manipulator_types/button2d_manipulator.c

@@ -23,11 +23,12 @@
  *
  * \name Button Manipulator
  *
- * 3D Manipulator, also works in 2D views.
+ * 2D Manipulator, also works in 3D views.
  *
  * \brief Single click button action for use in manipulator groups.
  *
- * Note: currently only very basic icon buttons supported.
+ * \note Currently only basic icon & vector-shape buttons are supported.
+ *
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/space_view3d/view3d_manipulator_navigate.c

@@ -73,6 +73,7 @@ enum {
 	MPR_TOTAL = 6,
 };
 
+/* Vector icons compatible with 'GPU_batch_from_poly_2d_encoded' */
 static const uchar shape_camera[] = {
 	0xa3, 0x19, 0x78, 0x55, 0x4d, 0x19, 0x4f, 0x0a, 0x7f, 0x00, 0xb0, 0x0a, 0xa9, 0x19,
 	0xa9, 0x19, 0x25, 0xda, 0x0a, 0xb0, 0x00, 0x7f, 0x0a, 0x4f, 0x25, 0x25, 0x4f, 0x0a,

source/blender/gpu/intern/gpu_batch.c

@@ -57,6 +57,11 @@ void GWN_batch_program_set_builtin(Gwn_Batch *batch, GPUBuiltinShader shader_id)
 /** \name Batch Creation
  * \{ */
 
+/**
+ * Creates triangles from a byte-array of polygons.
+ *
+ * See 'make_shape_2d_from_blend.py' utility to create data to pass to this function.
+ */
 Gwn_Batch *GPU_batch_from_poly_2d_encoded(
         const uchar *polys_flat, uint polys_flat_len, float min, float max)
 {