feat: generate toc for lua modules

cmd/docgen/docgen.lua

@@ -116,12 +116,14 @@ for iface, dps in pairs(pieces) do
 	local newOrNotNature = exists and mod ~= 'nature'
 
 	local f <close> = io.open(path, newOrNotNature and 'r+' or 'w+')
+	local tocPos
 	if not newOrNotNature then
 		f:write(string.format(header, 'Module', iface, (descriptions[iface] and #descriptions[iface] > 0) and descriptions[iface][1] or 'No description.', docParent))
 		if descriptions[iface] and #descriptions[iface] > 0 then
 			table.remove(descriptions[iface], 1)
 			f:write(string.format('\n## Introduction\n%s\n\n', table.concat(descriptions[iface], '\n')))
 			f:write('## Functions\n')
+			tocPos = f:seek()
 		end
 	end
 	print(f)
@@ -129,7 +131,6 @@ for iface, dps in pairs(pieces) do
 	print('mod and path:', mod, path)
 
 	local tocSearch = false
-	local tocPos
 	for line in f:lines() do
 		if line:match '^## Functions' then
 			tocSearch = true

docs/api/hilbish/hilbish.messages.md

@@ -20,6 +20,14 @@ The `hilbish.message` type is a table with the following keys:
 `read` (boolean): Whether the full message has been read or not.
 
 ## Functions
+|<a href="#unreadCount">unreadCount()</a>|Returns the amount of unread messages.|
+|<a href="#readAll">readAll()</a>|Marks all messages as read.|
+|<a href="#send">send(message)</a>|Sends a message.|
+|<a href="#read">read(idx)</a>|Marks a message at `idx` as read.|
+|<a href="#delete">delete(idx)</a>|Deletes the message at `idx`.|
+|<a href="#clear">clear()</a>|Deletes all messages.|
+|<a href="#all">all()</a>|Returns all messages.|
+
 <hr>
 <div id='all'>
 <h4 class='heading'>
@@ -34,6 +42,7 @@ Returns all messages.
 This function has no parameters.  
 </div>
 
+
 <hr>
 <div id='clear'>
 <h4 class='heading'>
@@ -48,6 +57,7 @@ Deletes all messages.
 This function has no parameters.  
 </div>
 
+
 <hr>
 <div id='delete'>
 <h4 class='heading'>
@@ -64,6 +74,7 @@ Deletes the message at `idx`.
 
 </div>
 
+
 <hr>
 <div id='read'>
 <h4 class='heading'>
@@ -80,6 +91,7 @@ Marks a message at `idx` as read.
 
 </div>
 
+
 <hr>
 <div id='send'>
 <h4 class='heading'>
@@ -96,6 +108,7 @@ Sends a message.
 
 </div>
 
+
 <hr>
 <div id='readAll'>
 <h4 class='heading'>
@@ -110,6 +123,7 @@ Marks all messages as read.
 This function has no parameters.  
 </div>
 
+
 <hr>
 <div id='unreadCount'>
 <h4 class='heading'>

docs/api/hilbish/hilbish.runner.md

@@ -120,6 +120,7 @@ This is the equivalent of using `source`.
 
 </div>
 
+
 <hr>
 <div id='getCurrent'>
 <h4 class='heading'>
@@ -134,6 +135,7 @@ Returns the current runner by name.
 This function has no parameters.  
 </div>
 
+
 <hr>
 <div id='setCurrent'>
 <h4 class='heading'>
@@ -150,6 +152,7 @@ Sets Hilbish's runner mode by name.
 
 </div>
 
+
 <hr>
 <div id='add'>
 <h4 class='heading'>
@@ -170,6 +173,7 @@ If runner is a table, it must have the run function in it.
 
 </div>
 
+
 <hr>
 <div id='get'>
 <h4 class='heading'>
@@ -186,6 +190,7 @@ Get a runner by name.
 
 </div>
 
+
 <hr>
 <div id='set'>
 <h4 class='heading'>
@@ -207,6 +212,7 @@ The runner table must have the run function in it.
 
 </div>
 
+
 <hr>
 <div id='exec'>
 <h4 class='heading'>

docs/nature/dirs.md

@@ -13,6 +13,12 @@ The dirs module defines a small set of functions to store and manage
 directories.
 
 ## Functions
+|<a href="#recent">recent(idx)</a>|Get entry from recent directories list based on index.|
+|<a href="#pop">pop(num)</a>|Remove the specified amount of dirs from the recent directories list.|
+|<a href="#peak">peak(num)</a>|Look at `num` amount of recent directories, starting from the latest.|
+|<a href="#push">push(dir)</a>|Add `dir` to the recent directories list.|
+|<a href="#setOld">setOld(d)</a>|Sets the old directory string.|
+
 <hr>
 <div id='setOld'>
 <h4 class='heading'>
@@ -29,6 +35,7 @@ Sets the old directory string.
 
 </div>
 
+
 <hr>
 <div id='push'>
 <h4 class='heading'>
@@ -45,6 +52,7 @@ Add `dir` to the recent directories list.
 
 </div>
 
+
 <hr>
 <div id='peak'>
 <h4 class='heading'>
@@ -62,6 +70,7 @@ This returns  a table of recent directories, up to the `num` amount.
 
 </div>
 
+
 <hr>
 <div id='pop'>
 <h4 class='heading'>
@@ -78,6 +87,7 @@ Remove the specified amount of dirs from the recent directories list.
 
 </div>
 
+
 <hr>
 <div id='recent'>
 <h4 class='heading'>

docs/nature/doc.md

@@ -15,6 +15,10 @@ This is only documented for the sake of it. It's only intended use
 is by the Greenhouse pager.
 
 ## Functions
+|<a href="#renderCodeBlock">renderCodeBlock(text)</a>|Assembles and renders a code block. This returns|
+|<a href="#highlight">highlight(text)</a>|Performs basic Lua code highlighting.|
+|<a href="#renderInfoBlock">renderInfoBlock(type, text)</a>|Renders an info block. An info block is a block of text with|
+
 <hr>
 <div id='renderInfoBlock'>
 <h4 class='heading'>
@@ -35,6 +39,7 @@ an icon and styled text block.
 
 </div>
 
+
 <hr>
 <div id='highlight'>
 <h4 class='heading'>
@@ -51,6 +56,7 @@ Performs basic Lua code highlighting.
 
 </div>
 
+
 <hr>
 <div id='renderCodeBlock'>
 <h4 class='heading'>