diff --git a/tools/lint/common.h b/tools/lint/common.h
index c37021b..0684daa 100644
--- a/tools/lint/common.h
+++ b/tools/lint/common.h
@@ -85,7 +85,7 @@
 /**
  * @brief Parse features being specified for the specific YANG module.
  *
- * Format of the input @p fstring is as follows: <module_name>:[<feature>,]*
+ * Format of the input @p fstring is as follows: "<module_name>:[<feature>,]*"
  *
  * @param[in] fstring Input string to be parsed.
  * @param[in, out] fset Features information set (of struct schema_features *). The set is being filled.
@@ -140,7 +140,7 @@
  * @param[in] path Schema module file path to be parsed.
  * @param[out] dir Pointer to the directory path where the file resides. Caller is expected to free the returned string.
  * @param[out] module Pointer to the name of the module (without file suffixes or revision information) specified by the
- * @path. Caller is expected to free the returned string.
+ * @p path. Caller is expected to free the returned string.
  * @return 0 on success
  * @return -1 on error
  */
@@ -184,7 +184,7 @@
  *
  * Either the @p schema or @p data parameter is set.
  *
- * @param[in] filename Name of the file to examine.
+ * @param[in] filepath Name of the file to examine.
  * @param[out] schema_form Pointer to a variable to store the input schema format.
  * @param[out] data_form Pointer to a variable to store the expected input data format.
  * @return zero in case a format was successfully detected.
diff --git a/tools/lint/completion.c b/tools/lint/completion.c
index 16d2fdb..f0dd041 100644
--- a/tools/lint/completion.c
+++ b/tools/lint/completion.c
@@ -137,8 +137,8 @@
  * @brief Add all child nodes of a single node to the completion hint.
  *
  * @param[in] last_node Node of which children will be added to the hint.
- * @param matches[out] Matches provided to the user as a completion hint.
- * @param match_count[out] Number of matches.
+ * @param[out] matches Matches provided to the user as a completion hint.
+ * @param[out] match_count Number of matches.
  */
 static void
 single_hint_add_children(const struct lysc_node *last_node, char ***matches, unsigned int *match_count)
diff --git a/tools/lint/main_ni.c b/tools/lint/main_ni.c
index 3b6c71a..b7d821f 100644
--- a/tools/lint/main_ni.c
+++ b/tools/lint/main_ni.c
@@ -384,7 +384,7 @@
 /**
  * @brief Enable specific debugging messages.
  *
- * @param[in] groups String in the form <group>[,group>]*.
+ * @param[in] groups String in the form "<group>[,group>]*".
  * @param[in,out] yo Options for yanglint.
  * return 0 on success.
  */