diff --git a/include/rngxx.h b/include/rngxx.h
index 9037f0a..dbff170 100644
--- a/include/rngxx.h
+++ b/include/rngxx.h
@@ -1,3 +1,4 @@
+// C api for rngxx
 #ifndef _RNGXX_H
 #define _RNGXX_H
 
@@ -16,15 +17,19 @@
 extern "C" {
 #endif
 
+// -- C API types -- (C++ compat)
 typedef struct Random rng_t;
 
 enum rng_kind {
 	RNG_KIND_CRAND,
 };
 
+// -- // --
 #ifndef _RNGXX_IMPL_ONLY_TYPES
+// -- C API functions -- (C++ NO compat)
 rng_t* rng_new(enum rng_kind kind, u64 seed[static restrict 1]);
 
+// -- // --
 #endif
 #ifdef __cplusplus
 }