Add missing comments to headers and sources

Author: 8dcc

src/include/main.h

@@ -2,12 +2,20 @@
 #ifndef MAIN_H_
 #define MAIN_H_ 1
 
+/*
+ * Compile-time configuration.
+ */
 #define BOARD       "g"
 #define THREADS_URL "https://a.4cdn.org/" BOARD "/threads.json"
 
-/* Maximum number of threads to parse and print */
+/*
+ * Maximum number of threads (not posts) to parse and print.
+ */
 #define MAX_THREADS 255
 
+/*
+ * Entry point of the program.
+ */
 int main(void);
 
 #endif /* MAIN_H_ */

src/include/util.h

@@ -17,8 +17,14 @@
  */
 #define STRLEN(STR) (ARRLEN(STR) - 1)
 
+/*
+ * Move a string to a destination address, allowing buffer overlapping.
+ */
 #define STRMOVE(DST, STR) memmove(DST, STR, strlen(STR) + 1)
 
+/*
+ * Print an error and a newline.
+ */
 #define ERR(...)                                                               \
     do {                                                                       \
         fprintf(stderr, COL_ERROR "4cli: " COL_WARN);                          \

src/request.c

@@ -10,6 +10,9 @@
 #include "include/util.h"
 #include "include/main.h"
 
+/*
+ * Structure representing a buffer of arbitrary size.
+ */
 typedef struct {
     char* data;
     size_t sz;