Declare why certain headers are included

include/haggis.h

@@ -34,8 +34,8 @@
 #define HAGGIS_H
 
 #include "linklist.h"
-#include <stdint.h>
-#include <stdio.h>
+#include <stdint.h>        // uint<x>_t
+#include <stdio.h>         // FILE
 
 typedef uint8_t u8;
 

include/jobq.h

@@ -34,8 +34,6 @@
 #define JOBQ_H
 
 #include <pthread.h>
-#include <stddef.h>
-#include <stdlib.h>
 
 #include "haggis.h"
 

src/haggis.c

@@ -30,10 +30,9 @@
  *      other than his own.
  */
 
-#include <fcntl.h>
-#include <limits.h>
+#include <limits.h>          // PATH_MAX
 #include <md5.h>
-#include <stdint.h>
+#include <stdint.h>          // uint<x>_t
 
 #if defined(__FreeBSD__) || defined(__DragonFly__)
 #include <sha.h>
@@ -48,13 +47,12 @@
 #include <sha2.h>
 #endif /* if defined (__FreeBSD__) */
 
-#include <stddef.h>
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <unistd.h>
-#include <sys/stat.h>
-#include <sys/sysmacros.h>
+#include <stdio.h>           // fopen, fread, fwrite, FILE
+#include <stdlib.h>          // free, malloc
+#include <string.h>          // memcpy, strlen
+#include <unistd.h>          // readlink
+#include <sys/stat.h>        // stat
+#include <sys/sysmacros.h>   // major, minor, dev_t
 
 #include "bytes.h"
 #include "haggis.h"

src/jobq.c

@@ -29,6 +29,7 @@
  *      as such so that the author does not get blamed for bugs
  *      other than his own.
 */
+#include <stdlib.h>    // free, malloc
 
 #include "jobq.h"