[Bf-blender-cvs] [36feade] temp_custom_loop_normals: comments

[Campbell Barton]

Commit: 36feadeb5b3aa53391e7a8f69faac270107a9f07
Author: Campbell Barton
Date:   Thu Feb 5 02:31:22 2015 +1100
Branches: temp_custom_loop_normals
https://developer.blender.org/rB36feadeb5b3aa53391e7a8f69faac270107a9f07

comments

===================================================================

M	source/blender/blenkernel/BKE_mesh.h

===================================================================

diff --git a/source/blender/blenkernel/BKE_mesh.h b/source/blender/blenkernel/BKE_mesh.h
index c7b4365..969cb6f 100644
--- a/source/blender/blenkernel/BKE_mesh.h
+++ b/source/blender/blenkernel/BKE_mesh.h
@@ -184,6 +184,9 @@ void BKE_mesh_loop_tangents_ex(
 void BKE_mesh_loop_tangents(
         struct Mesh *mesh, const char *uvmap, float (*r_looptangents)[4], struct ReportList *reports);
 
+/**
+ * References a contiguous loop-fan with normal offset vars.
+ */
 typedef struct MLoopNorSpace {
 	float vec_lnor[3];      /* Automatically computed loop normal. */
 	float vec_ref[3];       /* Reference vector, orthogonal to vec_lnor. */
@@ -192,8 +195,11 @@ typedef struct MLoopNorSpace {
 	float ref_beta;         /* Reference angle, around vec_lnor, in ]0, 2pi] range (0.0 marks that space as invalid). */
 	struct LinkNode *loops; /* All indices (uint_in_ptr) of loops using this lnor space (i.e. smooth fan of loops). */
 } MLoopNorSpace;
+/**
+ * Collection of #MLoopNorSpace basic storage & pre-allocation.
+ */
 typedef struct MLoopNorSpaceset {
-	MLoopNorSpace **lspaceset;
+	MLoopNorSpace **lspaceset;    /* MLoop aligned array */
 	struct LinkNode *loops_pool;  /* Allocated once, avoids to call BLI_linklist_prepend_arena() for each loop! */
 	struct MemArena *mem;
 } MLoopNorSpaceset;