docs(lua): normalize luadoc annotation style for screenshot/GlobalVariableDetails (#7769)

Co-authored-by: Peter Feerick <5500713+pfeerick@users.noreply.github.com>
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Peter Feerick
2026-09-07 14:23:38 +10:00
committed by GitHub
co-authored by Peter Feerick Claude Sonnet 5
parent 11ccd67a0c
commit 227aef6783
2 changed files with 27 additions and 26 deletions
+6 -10
View File
@@ -1634,21 +1634,17 @@ static int luaPlayTone(lua_State * L)
}
/*luadoc
@name screenshot
@function screenshot()
@description Takes a screenshot, which is saved to the SCREENSHOTS folder on the radio SD card.
Takes a screenshot, which is saved to the SCREENSHOTS folder on the radio SD card.
@syntax screenshot()
@retval none
@return none
@notes This command is currently not rate limited, so repeated frequent calls will slow down the UI and can even freeze the entire radio, so should be used with care.
@target [BW]
@target [GS]
@target [COLOR]
@notice This command is currently not rate limited, so repeated frequent calls will slow down the UI and can even freeze the entire radio, so should be used with care.
@status current Introduced in 2.11
// targets: BW, GS, COLOR
*/
static int luaScreenshot(lua_State * L)
{
+21 -16
View File
@@ -1736,16 +1736,21 @@ static int luaModelSetGlobalVariable(lua_State *L)
}
/*luadoc
@name model.getGlobalVariableDetails(index)
@function model.getGlobalVariableDetails(index)
@description Returns details about a Global Variable, but not values
Returns details about a Global Variable, but not values
@syntax val = model.getGlobalVariableDetails(index)
@arg index required integer
@argdesc zero based global variable index, use 0 for GV1, 8 for GV9
@return table
@returndesc table with keys - name (string), min (int), max, prec, unit and popup (bool) - if exists
@apistat 2.11.0 introduced
@param index (number) zero based global variable index, use 0 for GV1, 8 for GV9
@retval table details of the global variable:
* `name` (string) global variable name
* `min` (number) minimum value
* `max` (number) maximum value
* `prec` (number) precision
* `unit` (number) unit
* `popup` (boolean) show popup - if exists
@status current Introduced in 2.11.0
*/
static int luaModelGetGlobalVariableDetails(lua_State *L)
{
@@ -1765,17 +1770,17 @@ static int luaModelGetGlobalVariableDetails(lua_State *L)
}
/*luadoc
@name model.setGlobalVariableDetails(index, params)
@function model.setGlobalVariableDetails(index, params)
@description Sets details about a Global Variable, but not values
Sets details about a Global Variable, but not values
@arg index required integer
@argdesc zero based global variable index, use 0 for GV1, 8 for GV9
@arg table params
@argdesc see model.getGlobalVariableDetails(index) return format for table format.
@return none
@apistat 2.11.0 introduced
@param index (number) zero based global variable index, use 0 for GV1, 8 for GV9
@param params (table) see model.getGlobalVariableDetails(index) return format for table format
@retval none
@status current Introduced in 2.11.0
*/
static int luaModelSetGlobalVariableDetails(lua_State *L)
{