[doc] some widget docs

frontend/ui/widget/horizontalgroup.lua

@@ -1,8 +1,9 @@
+--[[--
+A layout widget that puts objects besides each other.
+--]]
+
 local WidgetContainer = require("ui/widget/container/widgetcontainer")
 
---[[
-A Layout widget that puts objects besides each others
---]]
 local HorizontalGroup = WidgetContainer:new{
     align = "center",
     _size = nil,

frontend/ui/widget/overlapgroup.lua

@@ -1,8 +1,9 @@
+--[[--
+A layout widget that puts objects above each other.
+--]]
+
 local WidgetContainer = require("ui/widget/container/widgetcontainer")
 
---[[
-A Layout widget that puts objects above each other
---]]
 local OverlapGroup = WidgetContainer:new{
     _size = nil,
 }

frontend/ui/widget/textwidget.lua

@@ -1,12 +1,23 @@
+--[[--
+A TextWidget puts a string on a single line.
+
+Example:
+
+    UIManager:show(TextWidget:new{
+        text = "Make it so.",
+        face = Font:getFace("cfont"),
+        bold = true,
+        fgcolor = Blitbuffer.COLOR_GREY,
+    })
+
+--]]
+
+local Blitbuffer = require("ffi/blitbuffer")
+local Geom = require("ui/geometry")
+local RenderText = require("ui/rendertext")
 local Widget = require("ui/widget/widget")
 local Screen = require("device").screen
-local RenderText = require("ui/rendertext")
-local Geom = require("ui/geometry")
-local Blitbuffer = require("ffi/blitbuffer")
 
---[[
-A TextWidget puts a string on a single line
---]]
 local TextWidget = Widget:new{
     text = nil,
     face = nil,

frontend/ui/widget/verticalgroup.lua

@@ -1,8 +1,9 @@
+--[[--
+A layout widget that puts objects under each other.
+--]]
+
 local WidgetContainer = require("ui/widget/container/widgetcontainer")
 
---[[
-A Layout widget that puts objects under each other
---]]
 local VerticalGroup = WidgetContainer:new{
     align = "center",
     _size = nil,