chore: update comment

radio/src/lua/api_general.cpp

@@ -1632,18 +1632,21 @@ static int luaPlayTone(lua_State * L)
 }
 
 /*luadoc
-@function screenshot()
+@name screenshot
 
-Takes a screenshot
+@description Takes a screenshot, which is saved to the SCREENSHOTS folder on the radio SD card.
 
-@retval none 
+@syntax screenshot()
 
-@status current Introduced in 2.11
+@return none
 
-// targets: BW, COLOR
-//
-// EXAMPLES:
-// screenshot()
+@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]
+
+@status current Introduced in 2.11
 */
 static int luaScreenshot(lua_State * L)
 {