Cleanup: spelling in comments

6 files changed, 16 insertions, 16 deletions

diff --git a/source/blender/io/alembic/intern/abc_reader_curves.h b/source/blender/io/alembic/intern/abc_reader_curves.h
index 6bc0691a870..4cfb50ac59e 100644
--- a/source/blender/io/alembic/intern/abc_reader_curves.h
+++ b/source/blender/io/alembic/intern/abc_reader_curves.h
@@ -45,8 +45,8 @@ class AbcCurveReader final : public AbcObjectReader {
   void readObjectData(Main *bmain, const Alembic::Abc::ISampleSelector &sample_sel) override;
   /**
    * \note Alembic only stores data about control points, but the Mesh
-   * passed from the cache modifier contains the displist, which has more data
-   * than the control points, so to avoid corrupting the displist we modify the
+   * passed from the cache modifier contains the #DispList, which has more data
+   * than the control points, so to avoid corrupting the #DispList we modify the
    * object directly and create a new Mesh from that. Also we might need to
    * create new or delete existing NURBS in the curve.
    */
diff --git a/source/blender/io/wavefront_obj/exporter/obj_export_file_writer.cc b/source/blender/io/wavefront_obj/exporter/obj_export_file_writer.cc
index d92d1c5ad48..8c4ae7e111e 100644
--- a/source/blender/io/wavefront_obj/exporter/obj_export_file_writer.cc
+++ b/source/blender/io/wavefront_obj/exporter/obj_export_file_writer.cc
@@ -189,7 +189,7 @@ void OBJWriter::write_vertex_coords(const OBJMesh &obj_mesh_data) const
 }
 
 /**
- * Write UV vertex coordinates for all vertices as "vt u v".
+ * Write UV vertex coordinates for all vertices as `vt u v`.
  * \note UV indices are stored here, but written later.
  */
 void OBJWriter::write_uv_coords(OBJMesh &r_obj_mesh_data) const
@@ -430,7 +430,7 @@ void OBJWriter::write_nurbs_curve(const OBJCurve &obj_nurbs_data) const
     file_handler_->write<eOBJSyntaxElement::curve_element_end>();
 
     /**
-     * In "parm u 0 0.1 .." line:, (total control points + 2) equidistant numbers in the
+     * In `parm u 0 0.1 ..` line:, (total control points + 2) equidistant numbers in the
      * parameter range are inserted.
      */
     file_handler_->write<eOBJSyntaxElement::nurbs_parameter_begin>();
@@ -584,9 +584,9 @@ void MTLWriter::write_materials()
 }
 
 /**
- * Add the materials of the given object to MTLWriter, deduping
+ * Add the materials of the given object to #MTLWriter, de-duplicating
  * against ones that are already there.
- * Return a Vector of indices into mtlmaterials_ that hold the MTLMaterial
+ * Return a Vector of indices into mtlmaterials_ that hold the #MTLMaterial
  * that corresponds to each material slot, in order, of the given Object.
  * Indexes are returned rather than pointers to the MTLMaterials themselves
  * because the mtlmaterials_ Vector may move around when resized.
diff --git a/source/blender/io/wavefront_obj/exporter/obj_export_io.hh b/source/blender/io/wavefront_obj/exporter/obj_export_io.hh
index 83571d8aa46..6d0ff1aa6a5 100644
--- a/source/blender/io/wavefront_obj/exporter/obj_export_io.hh
+++ b/source/blender/io/wavefront_obj/exporter/obj_export_io.hh
@@ -301,7 +301,7 @@ template<eFileType filetype> class FileHandler : NonCopyable, NonMovable {
   template<typename T> using remove_cvref_t = std::remove_cv_t<std::remove_reference_t<T>>;
 
   /**
-   * Make #std::string etc., usable for fprintf-family.
+   * Make #std::string etc., usable for `fprintf` family.
    * \return: `const char *` or the original argument if the argument is
    * not related to #std::string.
    */
diff --git a/source/blender/io/wavefront_obj/exporter/obj_export_mesh.hh b/source/blender/io/wavefront_obj/exporter/obj_export_mesh.hh
index d72dd76d447..92fea78732a 100644
--- a/source/blender/io/wavefront_obj/exporter/obj_export_mesh.hh
+++ b/source/blender/io/wavefront_obj/exporter/obj_export_mesh.hh
@@ -36,13 +36,13 @@
 #include "IO_wavefront_obj.h"
 
 namespace blender::io::obj {
-/* Denote absence for usually non-negative numbers. */
+/** Denote absence for usually non-negative numbers. */
 const int NOT_FOUND = -1;
-/* Any negative number other than `NOT_FOUND` to initialise usually non-negative numbers. */
+/** Any negative number other than `NOT_FOUND` to initialize usually non-negative numbers. */
 const int NEGATIVE_INIT = -10;
 
 /**
- * #std::unique_ptr deleter for BMesh.
+ * #std::unique_ptr than handles freeing #BMesh.
  */
 struct CustomBMeshDeleter {
   void operator()(BMesh *bmesh)
diff --git a/source/blender/io/wavefront_obj/exporter/obj_export_mtl.cc b/source/blender/io/wavefront_obj/exporter/obj_export_mtl.cc
index b60f8976177..b99d41e0c72 100644
--- a/source/blender/io/wavefront_obj/exporter/obj_export_mtl.cc
+++ b/source/blender/io/wavefront_obj/exporter/obj_export_mtl.cc
@@ -192,7 +192,7 @@ static void store_bsdf_properties(const nodes::NodeRef *bsdf_node,
   if (bnode) {
     copy_property_from_node(SOCK_FLOAT, bnode, "Roughness", {&roughness, 1});
   }
-  /* Emperical approximation. Importer should use the inverse of this method. */
+  /* Empirical approximation. Importer should use the inverse of this method. */
   float spec_exponent = (1.0f - roughness) * 30;
   spec_exponent *= spec_exponent;
 
@@ -230,7 +230,7 @@ static void store_bsdf_properties(const nodes::NodeRef *bsdf_node,
   }
   mul_v3_fl(emission_col, emission_strength);
 
-  /* See https://wikipedia.org/wiki/Wavefront_.obj_file for all possible values of illum. */
+  /* See https://wikipedia.org/wiki/Wavefront_.obj_file for all possible values of `illum`. */
   /* Highlight on. */
   int illum = 2;
   if (specular == 0.0f) {
@@ -268,7 +268,7 @@ static void store_bsdf_properties(const nodes::NodeRef *bsdf_node,
 }
 
 /**
- * Store image texture options and filepaths in r_mtl_mat.
+ * Store image texture options and file-paths in `r_mtl_mat`.
  */
 static void store_image_textures(const nodes::NodeRef *bsdf_node,
                                  const nodes::NodeTreeRef *node_tree,
@@ -292,7 +292,7 @@ static void store_image_textures(const nodes::NodeRef *bsdf_node,
     const bNode *normal_map_node{nullptr};
 
     if (texture_map.key == eMTLSyntaxElement::map_Bump) {
-      /* Find sockets linked to destination "Normal" socket in p-bsdf node. */
+      /* Find sockets linked to destination "Normal" socket in P-BSDF node. */
       linked_sockets_to_dest_id(bnode, *node_tree, "Normal", linked_sockets);
       /* Among the linked sockets, find Normal Map shader node. */
       normal_map_node = get_node_of_type(linked_sockets, SH_NODE_NORMAL_MAP);
@@ -308,7 +308,7 @@ static void store_image_textures(const nodes::NodeRef *bsdf_node,
       }
     }
     else {
-      /* Find sockets linked to the destination socket of interest, in p-bsdf node. */
+      /* Find sockets linked to the destination socket of interest, in P-BSDF node. */
       linked_sockets_to_dest_id(
           bnode, *node_tree, texture_map.value.dest_socket_id, linked_sockets);
     }
diff --git a/source/blender/io/wavefront_obj/tests/obj_exporter_tests.hh b/source/blender/io/wavefront_obj/tests/obj_exporter_tests.hh
index def70eff0ee..4baf1df51f5 100644
--- a/source/blender/io/wavefront_obj/tests/obj_exporter_tests.hh
+++ b/source/blender/io/wavefront_obj/tests/obj_exporter_tests.hh
@@ -20,7 +20,7 @@ using array_float_3 = std::array<float, 3>;
 
 /**
  * This matches #OBJCurve's member functions, except that all the numbers and names are known
- * constants. Used to store expected values of NURBS Curve sobjects.
+ * constants. Used to store expected values of NURBS curves objects.
  */
 class NurbsObject {
  private: