diff --git a/include/git2/cherrypick.h b/include/git2/cherrypick.h
index 191170a58..edec96a94 100644
--- a/include/git2/cherrypick.h
+++ b/include/git2/cherrypick.h
@@ -29,8 +29,8 @@ typedef struct {
 	/** For merge commits, the "mainline" is treated as the parent. */
 	unsigned int mainline;
 
-	git_merge_options merge_opts; /* Options for the merging */
-	git_checkout_options checkout_opts; /* Options for the checkout */
+	git_merge_options merge_opts; /**< Options for the merging */
+	git_checkout_options checkout_opts; /**< Options for the checkout */
 } git_cherrypick_options;
 
 #define GIT_CHERRYPICK_OPTIONS_VERSION 1
diff --git a/include/git2/config.h b/include/git2/config.h
index 46b285cbc..70c8beade 100644
--- a/include/git2/config.h
+++ b/include/git2/config.h
@@ -59,9 +59,9 @@ typedef enum {
  * An entry in a configuration file
  */
 typedef struct {
-	const char *name; /* Name of the entry (normalised) */
-	const char *value; /* String value of the entry */
-	git_config_level_t level; /* Which config file this was found in */
+	const char *name; /**< Name of the entry (normalised) */
+	const char *value; /**< String value of the entry */
+	git_config_level_t level; /**< Which config file this was found in */
 } git_config_entry;
 
 typedef int  (*git_config_foreach_cb)(const git_config_entry *, void *);
diff --git a/include/git2/revert.h b/include/git2/revert.h
index eb069ae12..2de194219 100644
--- a/include/git2/revert.h
+++ b/include/git2/revert.h
@@ -29,8 +29,8 @@ typedef struct {
 	/** For merge commits, the "mainline" is treated as the parent. */
 	unsigned int mainline;
 
-	git_merge_options merge_opts; /* Options for the merging */
-	git_checkout_options checkout_opts; /* Options for the checkout */
+	git_merge_options merge_opts; /**< Options for the merging */
+	git_checkout_options checkout_opts; /**< Options for the checkout */
 } git_revert_options;
 
 #define GIT_REVERT_OPTIONS_VERSION 1