diff --git a/graphics/elements/indicators/data.lua b/graphics/elements/indicators/data.lua
index 64e2a23..c566791 100644
--- a/graphics/elements/indicators/data.lua
+++ b/graphics/elements/indicators/data.lua
@@ -92,6 +92,8 @@ local function data(args)
         end
     end
 
+    -- set the value
+    ---@param val any new value
     function e.set_value(val) e.on_update(val) end
 
     -- initial value draw
diff --git a/graphics/elements/indicators/hbar.lua b/graphics/elements/indicators/hbar.lua
index 4a291ff..9794736 100644
--- a/graphics/elements/indicators/hbar.lua
+++ b/graphics/elements/indicators/hbar.lua
@@ -41,6 +41,7 @@ local function hbar(args)
     end
 
     -- handle data changes
+    ---@param fraction number 0.0 to 1.0
     function e.on_update(fraction)
         e.value = fraction
 
@@ -109,6 +110,8 @@ local function hbar(args)
         e.on_update(e.value)
     end
 
+    -- set the percentage value
+    ---@param val number 0.0 to 1.0
     function e.set_value(val) e.on_update(val) end
 
     -- initialize to 0
diff --git a/graphics/elements/indicators/icon.lua b/graphics/elements/indicators/icon.lua
index 728bfea..0c71d29 100644
--- a/graphics/elements/indicators/icon.lua
+++ b/graphics/elements/indicators/icon.lua
@@ -60,6 +60,8 @@ local function icon(args)
         e.window.blit(blit_cmd.text, blit_cmd.fgd, blit_cmd.bkg)
     end
 
+    -- set indicator state
+    ---@param val integer indicator state
     function e.set_value(val) e.on_update(val) end
 
     -- initial icon draw
diff --git a/graphics/elements/indicators/light.lua b/graphics/elements/indicators/light.lua
index a1cc85b..5d38a7c 100644
--- a/graphics/elements/indicators/light.lua
+++ b/graphics/elements/indicators/light.lua
@@ -40,6 +40,8 @@ local function indicator_light(args)
         end
     end
 
+    -- set indicator state
+    ---@param val boolean indicator state
     function e.set_value(val) e.on_update(val) end
 
     -- write label and initial indicator light
diff --git a/graphics/elements/indicators/state.lua b/graphics/elements/indicators/state.lua
index 4631a40..386910c 100644
--- a/graphics/elements/indicators/state.lua
+++ b/graphics/elements/indicators/state.lua
@@ -66,6 +66,8 @@ local function state_indicator(args)
         e.window.blit(blit_cmd.text, blit_cmd.fgd, blit_cmd.bkg)
     end
 
+    -- set indicator state
+    ---@param val integer indicator state
     function e.set_value(val) e.on_update(val) end
 
     -- initial draw
diff --git a/graphics/elements/indicators/trilight.lua b/graphics/elements/indicators/trilight.lua
index 435af84..83aef37 100644
--- a/graphics/elements/indicators/trilight.lua
+++ b/graphics/elements/indicators/trilight.lua
@@ -51,6 +51,8 @@ local function tristate_indicator_light(args)
         end
     end
 
+    -- set indicator state
+    ---@param val integer indicator state
     function e.set_value(val) e.on_update(val) end
 
     -- write label and initial indicator light
diff --git a/graphics/elements/indicators/vbar.lua b/graphics/elements/indicators/vbar.lua
index 38eb023..f56c60c 100644
--- a/graphics/elements/indicators/vbar.lua
+++ b/graphics/elements/indicators/vbar.lua
@@ -32,6 +32,7 @@ local function vbar(args)
     local two_thirds = util.strrep("\x83", e.frame.w)
 
     -- handle data changes
+    ---@param fraction number 0.0 to 1.0
     function e.on_update(fraction)
         e.value = fraction
 
@@ -91,6 +92,8 @@ local function vbar(args)
         e.on_update(e.value)
     end
 
+    -- set the percentage value
+    ---@param val number 0.0 to 1.0
     function e.set_value(val) e.on_update(val) end
 
     return e.get()