lua: fix regression with display module

doc: add note about double buffering to Lua intro

docs/manual/keira/lua/intro.rst

@@ -86,6 +86,7 @@ Keira має вбудовану віртуальну машину мови пр
     local ball_x
     local ball_y
 
+    -- Завантажуємо зображення м'яча, яке знаходиться в корені SD-картки:
     local ball = resources.load_image("ball.bmp", display.color565(255, 255, 255))
 
     function lilka.init()
@@ -139,6 +140,17 @@ Keira має вбудовану віртуальну машину мови пр
 
 Завдяки аргументу ``delta`` м'яч завжди рухатиметься з однаковою швидкістю незалежно від того, як швидко виконується програма - чи це 30 кадрів на секунду, чи 10, чи 1000.
 
+.. warning::
+
+    Ваш код всередині функції ``lilka.draw()`` не повинен робити жодних припущень щодо того, що вже було намальовано раніше. Кожен кадр гри потрібно малювати повністю.
+
+    Це потрібно тому, що Keira використовує
+    `подвійну буферизацію <https://uk.wikipedia.org/wiki/%D0%91%D0%B0%D0%B3%D0%B0%D1%82%D0%BE%D0%BA%D1%80%D0%B0%D1%82%D0%BD%D0%B0_%D0%B1%D1%83%D1%84%D0%B5%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D1%96%D1%8F#%D0%9F%D0%BE%D0%B4%D0%B2%D1%96%D0%B9%D0%BD%D0%B0_%D0%B1%D1%83%D1%84%D0%B5%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D1%96%D1%8F_%D1%83_%D0%BA%D0%BE%D0%BC%D0%BF'%D1%8E%D1%82%D0%B5%D1%80%D0%BD%D1%96%D0%B9_%D0%B3%D1%80%D0%B0%D1%84%D1%96%D1%86%D1%96>`_
+    екрану, тобто ваша гра малює на **передньому буфері**, а в цей час Keira відображає **задній буфер** на екрані.
+
+    Тому радимо починати кожен кадр гри з виклику ``display.fill_screen(display.color565(0, 0, 0))``, щоб очистити передній буфер перед малюванням нового кадру,
+    оскільки він може бути забруднений попереднім кадром.
+
 .. _lua-fast-testing:
 
 Швидке тестування програм

firmware/keira/src/apps/lua/lualilka_display.cpp

@@ -300,5 +300,6 @@ int lualilka_display_register(lua_State* L) {
     lua_setfield(L, -2, "width");
     lua_pushinteger(L, app->canvas->height());
     lua_setfield(L, -2, "height");
+    lua_setglobal(L, "display");
     return 0;
 }