deliberately order TOC of generated documentation

create_makefile.sh

@@ -23,7 +23,7 @@ done
 FIND_OPTS+=( -print )
 
 # Compile all relevant *.v files
-coq_makefile -f _CoqProject $(find "${FIND_OPTS[@]}" ) -o Makefile
+coq_makefile -f _CoqProject $(find "${FIND_OPTS[@]}" | scripts/module-toc-order.py ) -o Makefile
 
 # Patch HTML target to switch out color, and 
 # so that it parses comments and has links to ssreflect.

scripts/module-toc-order.py

+#!/usr/bin/env python3
+
+import os
+import sys
+
+MODULE_ORDER = [
+    'behavior.time',
+    'behavior.job',
+    'behavior.schedule',
+    'behavior.service',
+    'behavior.arrival_sequence',
+    'behavior.ready',
+    'behavior',
+    'model.processor',
+    'model.readiness',
+    'model.preemption',
+    'model.task',
+    'model.priority',
+    'model.schedule',
+    'model',
+    'results',
+    'analysis',
+    'classic',
+    'util',
+]
+
+def modorder(fname):
+    modname = fname.replace('./', '').replace('.v', '').replace('/', '.')
+    for i, prefix in enumerate(MODULE_ORDER):
+        if modname.startswith(prefix):
+            return (i, modname)
+    return (len(MODULE_ORDER), modname)
+
+def main():
+    lines = sys.stdin.readlines()
+    for l in sorted(lines, key=modorder):
+        print(l, end='')
+
+if __name__ == '__main__':
+    main()
+