code cleanup and work on #78 linking for annunciator

coordinator/ui/components/boiler.lua

@@ -14,11 +14,11 @@ local cpair = core.graphics.cpair
 local border = core.graphics.border
 
 -- new boiler view
----@param root graphics_element
----@param x integer
----@param y integer
----@param id integer
----@param ps psil
+---@param root graphics_element parent
+---@param x integer top left x
+---@param y integer top left y
+---@param id integer device index
+---@param ps psil ps interface
 local function new_view(root, x, y, id, ps)
     local tag = id .. "_"
 

coordinator/ui/components/reactor.lua

@@ -15,11 +15,12 @@ local TEXT_ALIGN = core.graphics.TEXT_ALIGN
 local cpair = core.graphics.cpair
 local border = core.graphics.border
 
----@param root graphics_element
----@param x integer
----@param y integer
----@param data reactor_db
----@param ps psil
+-- create new reactor view
+---@param root graphics_element parent
+---@param x integer top left x
+---@param y integer top left y
+---@param data reactor_db reactor data
+---@param ps psil ps interface
 local function new_view(root, x, y, data, ps)
     local reactor = Rectangle{parent=root,border=border(1, colors.gray, true),width=30,height=7,x=x,y=y}
 

coordinator/ui/components/turbine.lua

@@ -14,11 +14,11 @@ local cpair = core.graphics.cpair
 local border = core.graphics.border
 
 -- new turbine view
----@param root graphics_element
----@param x integer
----@param y integer
----@param id integer
----@param ps psil
+---@param root graphics_element parent
+---@param x integer top left x
+---@param y integer top left y
+---@param id integer device index
+---@param ps psil ps interface
 local function new_view(root, x, y, id, ps)
     local tag = id .. "_"
 

coordinator/ui/components/unit_overview.lua

@@ -20,10 +20,11 @@ local cpair = core.graphics.cpair
 local border = core.graphics.border
 local pipe = core.graphics.pipe
 
----@param parent graphics_element
----@param x integer
----@param y integer
----@param unit coord_db_entry
+-- make a new unit overview window
+---@param parent graphics_element parent
+---@param x integer top left x
+---@param y integer top left y
+---@param unit ioctl_entry unit database entry
 local function make(parent, x, y, unit)
     local height = 0
     local num_boilers = #unit.boiler_data_tbl