formatting

src/platform/platform_core.h

@@ -6,15 +6,7 @@ Struct(P_Window);
 Struct(P_Sock);
 
 ////////////////////////////////
-//~ Wait
+//~ Job queue types
-
- /* Futex-like wait & wake */
-
-void P_Wait(volatile void *addr, void *cmp, u32 size, i64 timeout_ns);
-void P_Wake(void *addr, i32 count);
-
-////////////////////////////////
-//~ Job
 
 /* Work pools contain their own worker threads with their own thread priority/affinity based on the intended context of the pool. */
 typedef i32 P_Pool; enum
@@ -54,7 +46,7 @@ Struct(P_JobData)
 typedef P_JobDef(P_JobFunc, job_data);
 
 ////////////////////////////////
-//~ Time
+//~ Time types
 
 Struct(P_DateTime)
 {
@@ -69,7 +61,7 @@ Struct(P_DateTime)
 };
 
 ////////////////////////////////
-//~ File
+//~ File system types
 
 Struct(P_File)
 {
@@ -92,7 +84,7 @@ Struct(P_FileMap)
 };
 
 ////////////////////////////////
-//~ Watch
+//~ Watch types
 
 typedef i32 P_WatchInfoKind; enum
 {
@@ -120,8 +112,9 @@ Struct(P_WatchInfoList)
 };
 
 ////////////////////////////////
-//~ Window events
+//~ Window event types
 
+//- Button
 typedef i32 P_Btn; enum
 {
     P_Btn_None,
@@ -227,6 +220,7 @@ typedef i32 P_Btn; enum
     P_Btn_Count
 };
 
+//- Window event
 typedef i32 P_WindowEventKind; enum
 {
     P_WindowEventKind_None,
@@ -267,7 +261,7 @@ Struct(P_WindowEventArray)
 };
 
 ////////////////////////////////
-//~ Window settings
+//~ Window setting types
 
 /* NOTE:
  * A window object can only be interacted with by the thread that created it.
@@ -309,7 +303,7 @@ Struct(P_WindowSettings)
 };
 
 ////////////////////////////////
-//~ Address
+//~ Address types
 
 typedef i32 P_AddressFamily; enum
 {
@@ -327,7 +321,7 @@ Struct(P_Address)
 };
 
 ////////////////////////////////
-//~ Sock
+//~ Sock types
 
 Struct(P_SockReadResult)
 {
@@ -337,7 +331,7 @@ Struct(P_SockReadResult)
 };
 
 ////////////////////////////////
-//~ Message box
+//~ Message box types
 
 typedef i32 P_MessageBoxKind; enum
 {
@@ -348,11 +342,18 @@ typedef i32 P_MessageBoxKind; enum
 };
 
 ////////////////////////////////
-//~ Exit callback function
+//~ Exit callback types
 
 #define P_ExitFuncDef(name) void name(void)
 typedef P_ExitFuncDef(P_ExitFunc);
 
+////////////////////////////////
+//~ Wait
+
+ /* Futex-like wait & wake */
+void P_Wait(volatile void *addr, void *cmp, u32 size, i64 timeout_ns);
+void P_Wake(void *addr, i32 count);
+
 ////////////////////////////////
 //~ Job helpers