thodg/libgit2

diff --git a/include/git2/submodule.h b/include/git2/submodule.h
index 96187b0..bc94eac 100644
--- a/include/git2/submodule.h
+++ b/include/git2/submodule.h
@@ -110,11 +110,10 @@ typedef enum {
 /**
  * Function pointer to receive each submodule
  *
- * `sm` is the `git_submodule` currently being visited.
- *
- * `name` is the name of the submodule.
- *
- * `payload` is the value you passed to the foreach function as payload.
+ * @param sm git_submodule currently being visited
+ * @param name name of the submodule
+ * @param payload value you passed to the foreach function as payload
+ * @return 0 on success or error code
  */
 typedef int (*git_submodule_cb)(
 	git_submodule *sm, const char *name, void *payload);