docs: add hilbish.timers interface docs

docs/api/hilbish/hilbish.jobs.md

@@ -5,7 +5,8 @@ layout: apidoc
 ---
 
 ## Introduction
- Manage interactive jobs in Hilbish via Lua.
+
+Manage interactive jobs in Hilbish via Lua.
 
 Jobs are the name of background tasks/commands. A job can be started via
 interactive usage or with the functions defined below for use in external runners.

docs/api/hilbish/hilbish.timers.md

@@ -9,7 +9,22 @@ The timers interface si one to easily set timeouts and intervals
 to run functions after a certain time or repeatedly without using
 odd tricks.
 
+## Object properties
+- `type`: What type of timer it is
+- `running`: If the timer is running
+- `duration`: The duration in milliseconds that the timer will run
+
 ## Functions
+### start()
+Starts a timer.
+
 ### stop()
 Stops a timer.
 
+### create(type, time, callback)
+Creates a timer that runs based on the specified `time` in milliseconds.
+The `type` can either be interval (value of 0) or timeout (value of 1).
+
+### get(id)
+Retrieves a timer via its ID.
+

emmyLuaDocs/hilbish.lua

@@ -155,6 +155,9 @@ function hilbish.jobs.stop() end
 --- This is the equivalent of using `source`.
 function hilbish.runner.sh(cmd) end
 
+--- Starts a timer.
+function hilbish.timers:start() end
+
 --- Stops a timer.
 function hilbish.timers:stop() end
 
@@ -199,4 +202,11 @@ function hilbish.history.get(idx) end
 --- @returns number
 function hilbish.history.size() end
 
+--- Creates a timer that runs based on the specified `time` in milliseconds.
+--- The `type` can either be interval (value of 0) or timeout (value of 1).
+function hilbish.timers.create(type, time, callback) end
+
+--- Retrieves a timer via its ID.
+function hilbish.timers.get(id) end
+
 return hilbish

nature/runner.lua

@@ -1,3 +1,4 @@
+--- hilbish.runner
 local currentRunner = 'hybrid'
 local runners = {}
 

timer.go

@@ -73,6 +73,10 @@ func (t *timer) stop() error {
 	return nil
 }
 
+// #interface timers
+// #member
+// start()
+// Starts a timer.
 func timerStart(thr *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 	if err := c.Check1Arg(); err != nil {
 		return nil, err

timerhandler.go

@@ -61,6 +61,10 @@ func (th *timersModule) get(id int) *timer {
 	return th.timers[id]
 }
 
+// #interface timers
+// create(type, time, callback)
+// Creates a timer that runs based on the specified `time` in milliseconds.
+// The `type` can either be interval (value of 0) or timeout (value of 1).
 func (th *timersModule) luaCreate(t *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 	if err := c.CheckNArgs(3); err != nil {
 		return nil, err
@@ -83,6 +87,9 @@ func (th *timersModule) luaCreate(t *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 	return c.PushingNext1(t.Runtime, rt.UserDataValue(tmr.ud)), nil
 }
 
+// #interface timers
+// get(id)
+// Retrieves a timer via its ID.
 func (th *timersModule) luaGet(thr *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 	if err := c.Check1Arg(); err != nil {
 		return nil, err
@@ -101,6 +108,9 @@ func (th *timersModule) luaGet(thr *rt.Thread, c *rt.GoCont) (rt.Cont, error) {
 }
 
 // #interface timers
+// #property type What type of timer it is
+// #property running If the timer is running
+// #property duration The duration in milliseconds that the timer will run
 // timeout and interval API
 // The timers interface si one to easily set timeouts and intervals
 // to run functions after a certain time or repeatedly without using