Cleanup: move doc-strings into headers

- The comment for create_normals was moved into an inline note
  as it's not related to the public API.
- Use a colon after parameters.

Ref T92709

1 files changed, 21 insertions, 0 deletions

diff --git a/source/blender/io/wavefront_obj/importer/obj_import_mesh.hh b/source/blender/io/wavefront_obj/importer/obj_import_mesh.hh
index 86132b94a31..e2cdb4c0721 100644
--- a/source/blender/io/wavefront_obj/importer/obj_import_mesh.hh
+++ b/source/blender/io/wavefront_obj/importer/obj_import_mesh.hh
@@ -37,11 +37,32 @@ class MeshFromGeometry : NonMovable, NonCopyable {
                       const OBJImportParams &import_params);
 
  private:
+  /**
+   * OBJ files coming from the wild might have faces that are invalid in Blender
+   * (mostly with duplicate vertex indices, used by some software to indicate
+   * polygons with holes). This method tries to fix them up.
+   */
   void fixup_invalid_faces();
   void create_vertices(Mesh *mesh);
+  /**
+   * Create polygons for the Mesh, set smooth shading flag, deform group name,
+   * assigned material also.
+   *
+   * It must receive all polygons to be added to the mesh.
+   * Remove holes from polygons before * calling this.
+   */
   void create_polys_loops(Object *obj, Mesh *mesh);
+  /**
+   * Add explicitly imported OBJ edges to the mesh.
+   */
   void create_edges(Mesh *mesh);
+  /**
+   * Add UV layer and vertices to the Mesh.
+   */
   void create_uv_verts(Mesh *mesh);
+  /**
+   * Add materials and the nodetree to the Mesh Object.
+   */
   void create_materials(Main *bmain,
                         const Map<std::string, std::unique_ptr<MTLMaterial>> &materials,
                         Map<std::string, Material *> &created_materials,