summaryrefslogtreecommitdiff
path: root/luals-stubs/backstack.lua
diff options
context:
space:
mode:
authorjacqueline <me@jacqueline.id.au>2024-03-13 19:47:18 +1100
committerjacqueline <me@jacqueline.id.au>2024-03-13 19:47:18 +1100
commitc5c6506ebcdde78e0a79dfae9585325766291097 (patch)
treedebe9eaadfa32abe20fe04b595a3697dc2f31772 /luals-stubs/backstack.lua
parent2eb3fd53d7bf32cffb1569d6b2b0c1fbc5b9ed2c (diff)
parent686ada3d4663d40f30d40368f0b9520e011ccd2d (diff)
downloadtangara-fw-c5c6506ebcdde78e0a79dfae9585325766291097.tar.gz
Merge branch 'main' of codeberg.org:cool-tech-zone/tangara-fw
Diffstat (limited to 'luals-stubs/backstack.lua')
-rw-r--r--luals-stubs/backstack.lua13
1 files changed, 11 insertions, 2 deletions
diff --git a/luals-stubs/backstack.lua b/luals-stubs/backstack.lua
index 2e4eccb3..b39fcbf2 100644
--- a/luals-stubs/backstack.lua
+++ b/luals-stubs/backstack.lua
@@ -1,11 +1,20 @@
--- @meta
+--- The `backstack` module contains functions that can be used to implement a
+--- basic stack-based navigation hierarchy. See also the `screen` module, which
+--- provides a class prototype meant for use with this module.
--- @class backstack
local backstack = {}
---- @param constructor function
-function backstack.push(constructor) end
+--- Displays the given screen to the user. If there was already a screen being
+--- displayed, then the current screen is removed from the display, and added
+--- to the backstack.
+--- @param screen screen The screen to display.
+function backstack.push(screen) end
+--- Removes the current screen from the display, then replaces it with the
+--- screen that is at the top of the backstack. This function does nothing if
+--- there are no other screens in the stack.
function backstack.pop() end
return backstack