Cleanup: spelling in comments, unused arg warning

2 files changed, 7 insertions, 6 deletions

diff --git a/source/blender/blenkernel/BKE_mesh_types.h b/source/blender/blenkernel/BKE_mesh_types.h
index dacc2188abb..80f61086052 100644
--- a/source/blender/blenkernel/BKE_mesh_types.h
+++ b/source/blender/blenkernel/BKE_mesh_types.h
@@ -99,7 +99,7 @@ struct MeshRuntime {
   /** Cache for BVH trees generated for the mesh. Defined in 'BKE_bvhutil.c' */
   BVHCache *bvh_cache = nullptr;
 
-  /** Cache of non-manifold boundary data for Shrinkwrap Target Project. */
+  /** Cache of non-manifold boundary data for Shrink-wrap Target Project. */
   ShrinkwrapBoundaryData *shrinkwrap_data = nullptr;
 
   /** Needed in case we need to lazily initialize the mesh. */
@@ -136,8 +136,8 @@ struct MeshRuntime {
 
   /**
    * Caches for lazily computed vertex and polygon normals. These are stored here rather than in
-   * #CustomData because they can be calculated on a const mesh, and adding custom data layers on a
-   * const mesh is not thread-safe.
+   * #CustomData because they can be calculated on a `const` mesh, and adding custom data layers on
+   * a `const` mesh is not thread-safe.
    */
   bool vert_normals_dirty = false;
   bool poly_normals_dirty = false;
diff --git a/source/blender/blenkernel/BKE_paint.h b/source/blender/blenkernel/BKE_paint.h
index 557edddac2a..437a22e4782 100644
--- a/source/blender/blenkernel/BKE_paint.h
+++ b/source/blender/blenkernel/BKE_paint.h
@@ -861,12 +861,13 @@ int *BKE_sculpt_face_sets_ensure(struct Mesh *mesh);
  */
 bool *BKE_sculpt_hide_poly_ensure(struct Mesh *mesh);
 
-/* Ensures a mask layer exists. If depsgraph and bmain are non-null,
- * a mask doesn't exist and the object has a multiresolution modifier
+/**
+ * Ensures a mask layer exists. If depsgraph and bmain are non-null,
+ * a mask doesn't exist and the object has a multi-resolution modifier
  * then the scene depsgraph will be evaluated to update the runtime
  * subdivision data.
  *
- * Note: always call *before* BKE_sculpt_update_object_for_edit.
+ * \note always call *before* #BKE_sculpt_update_object_for_edit.
  */
 int BKE_sculpt_mask_layers_ensure(struct Depsgraph *depsgraph,
                                   struct Main *bmain,