Set up documentation generation

std/assembly/allocator/arena.ts

@@ -1,9 +1,11 @@
 /**
- * @file Arena Memory Allocator
+ * Arena Memory Allocator
  *
  * Provides a `reset_memory` function to reset the heap to its initial state. A user has to make
  * sure that there are no more references to cleared memory afterwards. Always aligns to 8 bytes.
- */
+ *
+ * @module std/assembly/allocator/arena
+ *//***/
 
 import { MASK as AL_MASK } from "./common/alignment";
 

std/assembly/allocator/buddy.ts

@@ -1,6 +1,7 @@
 /**
- * @file Buddy Memory Allocator
- */
+ * Buddy Memory Allocator.
+ * @module stdd/assembly/allocator/buddy
+ *//***/
 
 /*
   Copyright 2018 Evan Wallace

std/assembly/allocator/common/alignment.ts

@@ -1,3 +1,8 @@
+/**
+ * Shared alignment constants.
+ * @module std/assembly/allocator/common/alignment
+ *//***/
+
 /** Number of alignment bits. */
 export const BITS: u32 = 3;
 

std/assembly/allocator/emscripten.ts

@@ -1,10 +1,12 @@
 /**
- * @file Emscripten Memory Allocator
+ * Emscripten Memory Allocator.
  *
  * Uses Emscripten's exported _malloc and _free implementations, i.e., when linking with
  * Emscripten-compiled programs that already provide these. Differs from 'system' in that their
  * names are prefixed with an underscore.
- */
+ *
+ * @module std/assembly/allocator/emscripten
+ *//***/
 
 declare function _malloc(size: usize): usize;
 declare function _free(ptr: usize): void;

std/assembly/allocator/system.ts

@@ -1,9 +1,11 @@
 /**
- * @file System Memory Allocator
+ * System Memory Allocator.
  *
  * Uses the environment's malloc and free implementations, i.e., when linking with other C-like
  * programs that already provide these.
- */
+ *
+ * @module std/assembly/allocator/system
+ *//***/
 
 declare function malloc(size: usize): usize;
 declare function free(ptr: usize): void;

std/assembly/allocator/tlsf.ts

@@ -1,9 +1,11 @@
 /**
- * @file Two-Level Segregate Fit Memory Allocator
+ * Two-Level Segregate Fit Memory Allocator.
  *
  * A general purpose dynamic memory allocator specifically designed to meet real-time requirements.
  * Always aligns to 8 bytes.
- */
+ *
+ * @module std/assembly/allocator/tlsf
+ *//***/
 
 // ╒══════════════ Block size interpretation (32-bit) ═════════════╕
 //    3                   2                   1