Dev docs: some widgets

frontend/ui/widget/container/alphacontainer.lua

@@ -1,10 +1,25 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-local BlitBuffer = require("ffi/blitbuffer")
-
---[[
+--[[--
 AlphaContainer will paint its content (1 widget) onto lower levels using
 a transparency (0..1)
+
+Example:
+
+    local alpha
+    alpha = AlphaContainer:new{
+        alpha = 0.7,
+
+        FrameContainer:new{
+            background = Blitbuffer.COLOR_WHITE,
+            bordersize = 1,
+            margin = 0,
+            padding = 1
+        }
+    }
 --]]
+
+local BlitBuffer = require("ffi/blitbuffer")
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local AlphaContainer = WidgetContainer:new{
     alpha = 1,
     -- we cache a blitbuffer object for re-use here:

frontend/ui/widget/container/bottomcontainer.lua

@@ -1,10 +1,11 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-local Geom = require("ui/geometry")
-
---[[
+--[[--
 BottomContainer contains its content (1 widget) at the bottom of its own
 dimensions
 --]]
+
+local Geom = require("ui/geometry")
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local BottomContainer = WidgetContainer:new()
 
 function BottomContainer:paintTo(bb, x, y)

frontend/ui/widget/container/centercontainer.lua

@@ -1,8 +1,9 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-
---[[
+--[[--
 CenterContainer centers its content (1 widget) within its own dimensions
 --]]
+
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local CenterContainer = WidgetContainer:new()
 
 function CenterContainer:paintTo(bb, x, y)

frontend/ui/widget/container/framecontainer.lua

@@ -1,11 +1,27 @@
+--[[--
+A FrameContainer is some graphics content (1 widget) that is surrounded by a
+frame
+
+Example:
+
+    local frame
+    frame = FrameContainer:new{
+        radius = 8,
+        bordersize = 3,
+        padding = 0,
+        margin = 0,
+        background = Blitbuffer.COLOR_WHITE,
+        VerticalGroup:new{
+            -- etc
+        }
+    }
+
+--]]
+
 local WidgetContainer = require("ui/widget/container/widgetcontainer")
 local Geom = require("ui/geometry")
 local Blitbuffer = require("ffi/blitbuffer")
 
---[[
-A FrameContainer is some graphics content (1 widget) that is surrounded by a
-frame
---]]
 local FrameContainer = WidgetContainer:new{
     background = nil,
     color = Blitbuffer.COLOR_BLACK,

frontend/ui/widget/container/leftcontainer.lua

@@ -1,8 +1,9 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-
---[[
+--[[--
 LeftContainer aligns its content (1 widget) at the left of its own dimensions
 --]]
+
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local LeftContainer = WidgetContainer:new()
 
 function LeftContainer:paintTo(bb, x, y)

frontend/ui/widget/container/rightcontainer.lua

@@ -1,8 +1,9 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-
---[[
+--[[--
 RightContainer aligns its content (1 widget) at the right of its own dimensions
 --]]
+
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local RightContainer = WidgetContainer:new()
 
 function RightContainer:paintTo(bb, x, y)

frontend/ui/widget/container/topcontainer.lua

@@ -1,8 +1,9 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-
---[[
+--[[--
 TopContainer contains its content (1 widget) at the top of its own dimensions
 --]]
+
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local TopContainer = WidgetContainer:new()
 
 return TopContainer

frontend/ui/widget/container/underlinecontainer.lua

@@ -1,12 +1,13 @@
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-local Geom = require("ui/geometry")
-local Blitbuffer = require("ffi/blitbuffer")
-
---[[
-an UnderlineContainer is a WidgetContainer that is able to paint
-a line under its child node
+--[[--
+An UnderlineContainer is a WidgetContainer that is able to paint
+a line under its child node.
 --]]
 
+
+local Blitbuffer = require("ffi/blitbuffer")
+local Geom = require("ui/geometry")
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+
 local UnderlineContainer = WidgetContainer:new{
     linesize = 2,
     padding = 1,

frontend/ui/widget/iconbutton.lua

@@ -1,11 +1,12 @@
+--[[--
+Button with a big icon image! Designed for touch devices.
+--]]
+
 local InputContainer = require("ui/widget/container/inputcontainer")
 local ImageWidget = require("ui/widget/imagewidget")
 local GestureRange = require("ui/gesturerange")
 local UIManager = require("ui/uimanager")
 
---[[
-Button with a big icon image! Designed for touch device
---]]
 local IconButton = InputContainer:new{
     icon_file = "resources/info-confirm.png",
     dimen = nil,

frontend/ui/widget/imageviewer.lua

@@ -1,28 +1,28 @@
-local InputContainer = require("ui/widget/container/inputcontainer")
-local WidgetContainer = require("ui/widget/container/widgetcontainer")
-local FrameContainer = require("ui/widget/container/framecontainer")
+--[[--
+ImageViewer displays an image with some simple manipulation options.
+]]
+
+local Blitbuffer = require("ffi/blitbuffer")
+local ButtonTable = require("ui/widget/buttontable")
 local CenterContainer = require("ui/widget/container/centercontainer")
-local VerticalGroup = require("ui/widget/verticalgroup")
-local OverlapGroup = require("ui/widget/overlapgroup")
 local CloseButton = require("ui/widget/closebutton")
-local ButtonTable = require("ui/widget/buttontable")
-local TextWidget = require("ui/widget/textwidget")
-local LineWidget = require("ui/widget/linewidget")
-local ImageWidget = require("ui/widget/imagewidget")
-local GestureRange = require("ui/gesturerange")
-local UIManager = require("ui/uimanager")
-local Screen = require("device").screen
 local Device = require("device")
 local Geom = require("ui/geometry")
+local GestureRange = require("ui/gesturerange")
 local Font = require("ui/font")
+local FrameContainer = require("ui/widget/container/framecontainer")
+local ImageWidget = require("ui/widget/imagewidget")
+local InputContainer = require("ui/widget/container/inputcontainer")
+local LineWidget = require("ui/widget/linewidget")
+local OverlapGroup = require("ui/widget/overlapgroup")
+local TextWidget = require("ui/widget/textwidget")
+local VerticalGroup = require("ui/widget/verticalgroup")
+local WidgetContainer = require("ui/widget/container/widgetcontainer")
+local UIManager = require("ui/uimanager")
+local Screen = Device.screen
 local logger = require("logger")
 local _ = require("gettext")
-local Blitbuffer = require("ffi/blitbuffer")
-
 
---[[
-Display image with some simple manipulation options
-]]
 local ImageViewer = InputContainer:new{
     -- Allow for providing same different input types as ImageWidget :
     -- a path to a file

frontend/ui/widget/linkbox.lua

@@ -1,10 +1,10 @@
-local InputContainer = require("ui/widget/container/inputcontainer")
+local Blitbuffer = require("ffi/blitbuffer")
+local Device = require("device")
+local Geom = require("ui/geometry")
 local GestureRange = require("ui/gesturerange")
+local InputContainer = require("ui/widget/container/inputcontainer")
 local UIManager = require("ui/uimanager")
-local Screen = require("device").screen
-local Geom = require("ui/geometry")
-local Device = require("device")
-local Blitbuffer = require("ffi/blitbuffer")
+local Screen = Device.screen
 
 local LinkBox = InputContainer:new{
     box = nil,