diff --git a/cmd/docgen/docgen.lua b/cmd/docgen/docgen.lua index 5c7d155..62c4619 100644 --- a/cmd/docgen/docgen.lua +++ b/cmd/docgen/docgen.lua @@ -49,10 +49,14 @@ for _, fname in ipairs(files) do if emmy then if emmy == 'param' then + print('bruh', emmythings[1], emmythings[2]) table.insert(dps.params, 1, { name = emmythings[1], - type = emmythings[2] + type = emmythings[2], + -- the +1 accounts for space. + description = table.concat(emmythings, ' '):sub(emmythings[1]:len() + 1 + emmythings[2]:len() + 1) }) + print(table.concat(emmythings, '/')) end else table.insert(dps.description, 1, docline) @@ -160,7 +164,8 @@ for iface, dps in pairs(pieces) do f:write 'This function has no parameters. \n' end for _, param in ipairs(docs.params) do - f:write(string.format('`%s` **`%s`**\n', param.name:gsub('%?$', ''), param.type)) + f:write(string.format('`%s` **`%s`** \n', param.name:gsub('%?$', ''), param.type)) + f:write(string.format('%s\n\n', param.description)) end --[[ local params = table.filter(docs, function(t) diff --git a/docs/api/hilbish/hilbish.messages.md b/docs/api/hilbish/hilbish.messages.md index 1e37205..4c72d3a 100644 --- a/docs/api/hilbish/hilbish.messages.md +++ b/docs/api/hilbish/hilbish.messages.md @@ -105,3 +105,1214 @@ hilbish.messages.unreadCount() This function has no parameters. +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +r + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +e + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +r + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +e + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +r + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +e + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +r + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +e + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +r + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +e + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** +r + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** +e + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** + + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** + + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete(idx) + + + +

+ +Deletes the message at `idx`. +#### Parameters +`idx` **`number`** + + +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** + + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.all() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.clear() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.delete() + + + +

+ +Deletes the message at `idx`. +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.read() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.send(message) + + + +

+ +Sends a message. +#### Parameters +`message` **`hilbish.message`** + + +
+ +
+
+

+hilbish.messages.readAll() + + + +

+ + +#### Parameters +This function has no parameters. +
+ +
+
+

+hilbish.messages.unreadCount() + + + +

+ + +#### Parameters +This function has no parameters. +
+ diff --git a/docs/api/hilbish/hilbish.runner.md b/docs/api/hilbish/hilbish.runner.md index a88985f..8666c16 100644 --- a/docs/api/hilbish/hilbish.runner.md +++ b/docs/api/hilbish/hilbish.runner.md @@ -145,7 +145,9 @@ hilbish.runner.setCurrent(name) Sets the current interactive/command line runner mode. #### Parameters -`name` **`string`** +`name` **`string`** + +
@@ -160,8 +162,12 @@ hilbish.runner.add(name, runner) Adds a runner to the table of available runners. If runner is a table, it must have the run function in it. #### Parameters -`name` **`string`** -`runner` **`function`** +`name` **`string`** + + +`runner` **`function|table`** + +
@@ -175,7 +181,9 @@ hilbish.runner.get(name) Get a runner by name. #### Parameters -`name` **`string`** +`name` **`string`** + +
@@ -189,8 +197,12 @@ hilbish.runner.set(name, runner) Sets a runner by name. The runner table must have the run function in it. #### Parameters -`name` **`string`** -`runner` **`table`** +`name` **`string`** + + +`runner` **`table`** + +
@@ -205,7 +217,11 @@ hilbish.runner.exec(cmd, runnerName) Executes cmd with a runner. If runnerName isn't passed, it uses the user's current runner. #### Parameters -`cmd` **`string`** -`runnerName` **`string?`** +`cmd` **`string`** + + +`runnerName` **`string?`** + + diff --git a/docs/nature/dirs.md b/docs/nature/dirs.md index 2a0e966..b658c98 100644 --- a/docs/nature/dirs.md +++ b/docs/nature/dirs.md @@ -18,7 +18,9 @@ dirs.setOld(d) Sets the old directory string. #### Parameters -`d` **`string`** +`d` **`string`** + +
@@ -46,7 +48,9 @@ dirs.peak(num) Look at `num` amount of recent directories, starting from the latest. #### Parameters -`num` **`number`** +`num` **`number`** + +
@@ -60,7 +64,9 @@ dirs.pop(num) Remove the specified amount of dirs from the recent directories list. #### Parameters -`num` **`number`** +`num` **`number`** + +
@@ -74,6 +80,8 @@ dirs.recent(idx) Get entry from recent directories list based on index. #### Parameters -`idx` **`number`** +`idx` **`number`** + + diff --git a/nature/hummingbird.lua b/nature/hummingbird.lua index 271c3cf..058353d 100644 --- a/nature/hummingbird.lua +++ b/nature/hummingbird.lua @@ -53,7 +53,7 @@ function hilbish.messages.read(idx) end end -function hilbish.messages.readAll(idx) +function hilbish.messages.readAll() for _, msg in ipairs(hilbish.messages.all()) do hilbish.messages.read(msg.index) end @@ -63,6 +63,7 @@ function hilbish.messages.unreadCount() return unread end +--- Deletes the message at `idx`. function hilbish.messages.delete(idx) local msg = M._messages[idx] if not msg then diff --git a/nature/runner.lua b/nature/runner.lua index 0725810..8e3dfb8 100644 --- a/nature/runner.lua +++ b/nature/runner.lua @@ -21,7 +21,7 @@ end --- Adds a runner to the table of available runners. If runner is a table, --- it must have the run function in it. --- @param name string ---- @param runner function | table +--- @param runner function|table function hilbish.runner.add(name, runner) if type(name) ~= 'string' then error 'expected runner name to be a table'