diff --git a/src/include/console/post_codes.h b/src/include/console/post_codes.h
index 9f9b7886a6..b2db2da7d5 100644
--- a/src/include/console/post_codes.h
+++ b/src/include/console/post_codes.h
@@ -20,7 +20,9 @@
 
 /**
  * @file post_codes.h
- *
+ */
+
+/*
  * This aims to be a central point for POST codes used throughout coreboot.
  * All POST codes should be declared here as macros, and post_code() should
  * be used with the macros instead of hardcoded values. This allows us to
@@ -40,6 +42,7 @@
  * without any explanation or effort on part of the maintainers.
  *
  */
+
 #ifndef POST_CODES_H
 #define POST_CODES_H
 
diff --git a/src/include/device/early_smbus.h b/src/include/device/early_smbus.h
index 5e15bb1e00..437a569256 100644
--- a/src/include/device/early_smbus.h
+++ b/src/include/device/early_smbus.h
@@ -18,7 +18,7 @@
  */
 
 /**
- * @file early_smbus.h
+ * @file device/early_smbus.h
  *
  * This file defines a common API for accessing the SMBus during early
  * initialization. It defines the prototypes for common SMBus functions. The