Add TODO

Author: lucic71

rules/sys_types/src.c

@@ -6,6 +6,19 @@
 typedef uid_t t1;
 typedef off_t t2;
 
+// glibc declares some APIs with private typedefs, e.g. `__off_t lseek(...)`,
+// where Darwin uses `off_t`. Give them the public typedef's translation so
+// both platforms produce the same output.
+//
+// TODO:
+//
+//   Rules are written in terms of standard names `off_t lseek(...)`, however
+//   libraries choose to implement them using library specific names `__off_t
+//   lseek(...)`.
+//
+//   Fix this in converter by using the names in the rules, not the
+//   library-specific names.
+
 #ifdef __GLIBC__
 typedef __uid_t t3;
 typedef __off_t t4;

rules/time/src.c

@@ -9,6 +9,18 @@ typedef struct timeval t2;
 typedef struct timespec t3;
 typedef time_t t4;
 
+// struct timespec::tv_sec is `__time_t` on glibc and `__darwin_time_t` on
+// Darwin. Give both time_t's translation.
+//
+// TODO:
+//
+//   Rules are written in terms of standard names `time_t tv_sec`, however
+//   libraries choose to implement them using library specific names `__time_t
+//   tv_sec`.
+//
+//   Fix this in converter by using the names in the rules, not the
+//   library-specific names.
+
 #if defined(__GLIBC__)
 typedef __time_t t5;
 #elif defined(__APPLE__)