diff --git a/src/libostree/ostree-core.h b/src/libostree/ostree-core.h
index 0e06048f..539909a8 100644
--- a/src/libostree/ostree-core.h
+++ b/src/libostree/ostree-core.h
@@ -229,7 +229,7 @@ gboolean ostree_checksum_file_async_finish (GFile          *f,
 GVariant *ostree_create_directory_metadata (GFileInfo *dir_info,
                                             GVariant  *xattrs);
 
-/** VALIDATION **/
+/* VALIDATION */
 
 gboolean ostree_validate_structureof_objtype (guchar    objtype,
                                               GError   **error);
diff --git a/src/libostree/ostree-repo-commit.c b/src/libostree/ostree-repo-commit.c
index 5251840f..9c399387 100644
--- a/src/libostree/ostree-repo-commit.c
+++ b/src/libostree/ostree-repo-commit.c
@@ -221,9 +221,9 @@ compare_ascii_checksums_for_sorting (gconstpointer  a_pp,
   return strcmp (a, b);
 }
 
-/**
+/*
  * Create sizes metadata GVariant and add it to the metadata variant given.
-*/
+ */
 static gboolean
 add_size_index_to_metadata (OstreeRepo        *self,
                             GVariant          *original_metadata,