diff --git a/include/git2/reflog.h b/include/git2/reflog.h
index 8a2edca4d..7f2781fc3 100644
--- a/include/git2/reflog.h
+++ b/include/git2/reflog.h
@@ -81,7 +81,7 @@ GIT_EXTERN(unsigned int) git_reflog_entrycount(git_reflog *reflog);
  *
  * @param reflog a previously loaded reflog
  * @param idx the position to lookup
- * @param the entry; NULL if not found
+ * @return the entry; NULL if not found
  */
 GIT_EXTERN(const git_reflog_entry *) git_reflog_entry_byindex(git_reflog *reflog, unsigned int idx);
 
diff --git a/include/git2/refspec.h b/include/git2/refspec.h
index 0cbe42ff7..e6b83c353 100644
--- a/include/git2/refspec.h
+++ b/include/git2/refspec.h
@@ -33,10 +33,10 @@ int git_refspec_src_match(const git_refspec *refspec, const char *refname);
  * Transform a reference to its target following the refspec's rules
  *
  * @param out where to store the target name
- * @param in the source reference
+ * @param outlen the size ouf the `out` buffer
  * @param spec the refspec
- * @param len the length of the out buffer
+ * @param name the name of the reference to transform
  * @preturn GIT_SUCCESS, GIT_ESHORTBUFFER or another error
  */
-int git_refspec_transform(char *out, size_t outlen, const git_refspec *spec,  const char *name);
+int git_refspec_transform(char *out, size_t outlen, const git_refspec *spec, const char *name);
 #endif