Merge 433ffa5068 into a0513c0a05

cmd/docgen/docgen.lua

@@ -1,72 +0,0 @@
-local fs = require 'fs'
-local emmyPattern = '^%-%-%- (.+)'
-local modpattern = '^%-+ @module (%w+)'
-local pieces = {}
-
-local files = fs.readdir 'nature'
-for _, fname in ipairs(files) do
-	local isScript = fname:match'%.lua$'
-	if not isScript then goto continue end
-
-	local f = io.open(string.format('nature/%s', fname))
-	local header = f:read '*l'
-	local mod = header:match(modpattern)
-	if not mod then goto continue end
-
-	print(fname, mod)
-	pieces[mod] = {}
-
-	local docPiece = {}
-	for line in f:lines() do
-		if line == header then goto continue2 end
-		if not line:match(emmyPattern) then
-			if line:match '^function' then
-				local pattern = (string.format('^function %s%%.', mod) .. '(%w+)')
-				local funcName = line:match(pattern)
-				if not funcName then goto continue2 end
-				print(line)
-				print(pattern)
-				print(funcName)
-				pieces[iface][funcName] = docPiece
-			end
-			docPiece = {}
-			goto continue2
-		end
-
-		table.insert(docPiece, line)
-		::continue2::
-	end
-	::continue::
-end
-
-for iface, dps in pairs(pieces) do
-	local mod = iface:match '(%w+)%.' or 'nature'
-	local path = string.format('luadocs/api/%s/%s.md', mod, iface)
-	local f <close> = io.open(path, 'a+')
-	print(f)
-
-	print(mod, path)
-	fs.mkdir(fs.dir(path), true)
-
-	for func, docs in pairs(dps) do
-		local params = table.filter(docs, function(t)
-			return t:match '^%-%-%- @param'
-		end)
-		f:write(string.format('## %s(', func))
-		for i, str in ipairs(params) do
-			if i ~= 1 then
-				f:write ', '
-			end
-			f:write(str:match '^%-%-%- @param ([%w]+) ')
-		end
-		f:write(')\n')
-
-		for _, str in ipairs(docs) do
-			if not str:match '^%-%-%- @' then
-				f:write(str:match '^%-%-%- (.+)' .. '\n')
-			end	
-		end
-		f:write('\n')
-	end
-	f:flush()
-end

nature/dirs.lua

@@ -1,4 +1,3 @@
--- @module dirs
 local fs = require 'fs'
 
 local dirs = {}
@@ -12,8 +11,8 @@ dirs.recentDirs = {}
 dirs.recentSize = 10
 
 --- Get (and remove) a `num` of entries from recent directories.
--- @param num number
+--- @param num number
--- @param remove boolean Whether to remove items
+--- @param remove boolean Whether to remove items
 function dirRecents(num, remove)
 	num = num or 1
 	local entries = {}
@@ -35,7 +34,7 @@ function dirRecents(num, remove)
 end
 
 --- Look at `num` amount of recent directories, starting from the latest.
--- @param num? number
+--- @param num? number
 function dirs.peak(num)
 	return dirRecents(num)
 end
@@ -52,19 +51,19 @@ function dirs.push(d)
 end
 
 --- Remove `num` amount of dirs from the recent directories.
--- @param num number
+--- @param num number
 function dirs.pop(num)
 	return dirRecents(num, true)
 end
 
 --- Get entry from recent directories.
--- @param idx number
+--- @param idx number
 function dirs.recent(idx)
 	return dirs.recentDirs[idx]
 end
 
 --- Sets the old directory.
--- @param d string
+--- @param d string
 function dirs.setOld(d)
 	ok, d = pcall(fs.abs, d)
 	assert(ok, 'could not turn "' .. d .. '"into an absolute path')