diff --git a/src/jtag/interfaces.c b/src/jtag/interfaces.c
index 1d8cb7566e63f329c489cc1ccbba56208db96c1c..778c4e3f27a3f4c46bc0a0ff826bb8d165b3df2a 100644
--- a/src/jtag/interfaces.c
+++ b/src/jtag/interfaces.c
@@ -33,12 +33,12 @@
 
 #include "interfaces.h"
 
-/**
- * @file This file includes declarations for all built-in jtag interfaces,
- *  which are then listed in the jtag_interfaces array.
+/** @file
+ * This file includes declarations for all built-in jtag interfaces,
+ * which are then listed in the jtag_interfaces array.
  *
- *  Dynamic loading can be implemented be searching for shared libraries
- *  that contain a jtag_interface structure that can added to this list.
+ * Dynamic loading can be implemented be searching for shared libraries
+ * that contain a jtag_interface structure that can added to this list.
  */
 
 #if BUILD_ZY1000 == 1
diff --git a/src/jtag/interfaces.h b/src/jtag/interfaces.h
index a6d94405994b59818eea89a8741b2a167c72dfd6..a32d3f918223ccb81a90a5170a2178004c27bccf 100644
--- a/src/jtag/interfaces.h
+++ b/src/jtag/interfaces.h
@@ -30,8 +30,8 @@
 #ifndef OPENOCD_JTAG_INTERFACES_H
 #define OPENOCD_JTAG_INTERFACES_H
 
-/**
- * @file Exports the list of JTAG interface drivers, along with routines
+/** @file
+ * Exports the list of JTAG interface drivers, along with routines
  * for loading and unloading them dynamically from shared libraries.
  */