update docs

doc/classes/Event.html

@@ -144,7 +144,7 @@
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.3</a></i>
-<i style="float:right;">Last updated 2015-11-11 18:35:22 </i>
+<i style="float:right;">Last updated 2015-11-27 03:17:14 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>

doc/classes/Layout.html

@@ -384,7 +384,7 @@ found, and focuses that widget.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.3</a></i>
-<i style="float:right;">Last updated 2015-11-11 18:35:22 </i>
+<i style="float:right;">Last updated 2015-11-27 03:17:14 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>

doc/classes/Widget.html

@@ -33,6 +33,7 @@
 <h2>Contents</h2>
 <ul>
 <li><a href="#Functions">Functions</a></li>
+<li><a href="#Tables">Tables</a></li>
 <li><a href="#Methods">Methods</a></li>
 </ul>
 
@@ -57,11 +58,22 @@
 
 <h2><a href="#Functions">Functions</a></h2>
 <table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Widget.register">Widget.register (name, decorator)</a></td>
+	<td class="summary">Register a custom widget type.</td>
+	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#Luigi.Widget">Luigi.Widget (layout[, data])</a></td>
 	<td class="summary">Widget pseudo-constructor.</td>
 	</tr>
 </table>
+<h2><a href="#Tables">Tables</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Widget.typeDecorators">Widget.typeDecorators</a></td>
+	<td class="summary">Widget type registry.</td>
+	</tr>
+</table>
 <h2><a href="#Methods">Methods</a></h2>
 <table class="function_list">
 	<tr>
@@ -109,14 +121,6 @@
 	<td class="summary">Get the widget's calculated height.</td>
 	</tr>
 	<tr>
-	<td class="name" nowrap><a href="#Widget:setWidth">Widget:setWidth (width)</a></td>
-	<td class="summary">Set the widget's width.</td>
-	</tr>
-	<tr>
-	<td class="name" nowrap><a href="#Widget:setHeight">Widget:setHeight (height)</a></td>
-	<td class="summary">Set the widget's height.</td>
-	</tr>
-	<tr>
 	<td class="name" nowrap><a href="#Widget:getRectangle">Widget:getRectangle (useMargin, usePadding)</a></td>
 	<td class="summary">Get two points describing a rectangle within the widget.</td>
 	</tr>
@@ -137,6 +141,31 @@
     <h2 class="section-header "><a name="Functions"></a>Functions</h2>
     Methods
     <dl class="function">
+    <dt>
+    <a name = "Widget.register"></a>
+    <strong>Widget.register (name, decorator)</strong>
+    </dt>
+    <dd>
+    Register a custom widget type.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">name</span>
+            <span class="types"><a class="type" href="http://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+        A unique name for this type of widget.
+        </li>
+        <li><span class="parameter">decorator</span>
+            <span class="types"><span class="type">function(Widget)</span></span>
+        An initialization function for this type of widget.
+        </li>
+    </ul>
+
+
+
+
+
+</dd>
     <dt>
     <a name = "Luigi.Widget"></a>
     <strong>Luigi.Widget (layout[, data])</strong>
@@ -169,6 +198,51 @@ This table is identical to the constructed widget.
 
 
 
+</dd>
+</dl>
+    <h2 class="section-header "><a name="Tables"></a>Tables</h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "Widget.typeDecorators"></a>
+    <strong>Widget.typeDecorators</strong>
+    </dt>
+    <dd>
+    Widget type registry.
+
+
+    <h3>Fields:</h3>
+    <ul>
+        <li><span class="parameter">button</span>
+        A simple button
+        </li>
+        <li><span class="parameter">menu</span>
+        A menu bar
+        </li>
+        <li><span class="parameter">[</span>
+        A menu item
+        </li>
+        <li><span class="parameter">progress</span>
+        A progress bar
+        </li>
+        <li><span class="parameter">sash</span>
+        Resizes nearby widgets
+        </li>
+        <li><span class="parameter">slider</span>
+        Slides to adjust a normalized value
+        </li>
+        <li><span class="parameter">stepper</span>
+        Steps through a series of choices
+        </li>
+        <li><span class="parameter">text</span>
+        A text entry widget
+        </li>
+    </ul>
+
+
+
+
+
 </dd>
 </dl>
     <h2 class="section-header "><a name="Methods"></a>Methods</h2>
@@ -423,64 +497,6 @@ Cycles back around to the last widget in the tree from the layout root.
 
 
 
-</dd>
-    <dt>
-    <a name = "Widget:setWidth"></a>
-    <strong>Widget:setWidth (width)</strong>
-    </dt>
-    <dd>
-    Set the widget's width. </p>
-
-<p>Limited to space not occupied by siblings.
-
-
-    <h3>Parameters:</h3>
-    <ul>
-        <li><span class="parameter">width</span>
-            <span class="types"><span class="type">number</span></span>
-        The desired width. Actual width may differ.
-        </li>
-    </ul>
-
-    <h3>Returns:</h3>
-    <ol>
-
-           <span class="types"><span class="type">number</span></span>
-        The actual width of the widget.
-    </ol>
-
-
-
-
-</dd>
-    <dt>
-    <a name = "Widget:setHeight"></a>
-    <strong>Widget:setHeight (height)</strong>
-    </dt>
-    <dd>
-    Set the widget's height. </p>
-
-<p>Limited to space not occupied by siblings.
-
-
-    <h3>Parameters:</h3>
-    <ul>
-        <li><span class="parameter">height</span>
-            <span class="types"><span class="type">number</span></span>
-        The desired height. Actual height may differ.
-        </li>
-    </ul>
-
-    <h3>Returns:</h3>
-    <ol>
-
-           <span class="types"><span class="type">number</span></span>
-        The actual height of the widget.
-    </ol>
-
-
-
-
 </dd>
     <dt>
     <a name = "Widget:getRectangle"></a>
@@ -580,7 +596,7 @@ on the parent widget.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.3</a></i>
-<i style="float:right;">Last updated 2015-11-11 18:35:22 </i>
+<i style="float:right;">Last updated 2015-11-27 03:17:14 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>

doc/index.html

@@ -64,7 +64,7 @@
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.3</a></i>
-<i style="float:right;">Last updated 2015-11-11 18:35:22 </i>
+<i style="float:right;">Last updated 2015-11-27 03:17:14 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>

luigi/widget.lua

@@ -16,17 +16,31 @@ Event.injectBinders(Widget)
 
 Widget.isWidget = true
 
+--[[--
+Widget type registry.
+--]]--
 Widget.typeDecorators = {
-    button = require(ROOT .. 'widget.button'),
+    button = require(ROOT .. 'widget.button'), -- A simple button
-    menu = require(ROOT .. 'widget.menu'),
+    menu = require(ROOT .. 'widget.menu'), -- A menu bar
-    ['menu.item'] = require(ROOT .. 'widget.menu.item'),
+    ['menu.item'] = require(ROOT .. 'widget.menu.item'), -- A menu item
-    progress = require(ROOT .. 'widget.progress'),
+    progress = require(ROOT .. 'widget.progress'), -- A progress bar
-    sash = require(ROOT .. 'widget.sash'),
+    sash = require(ROOT .. 'widget.sash'), -- Resizes nearby widgets
-    slider = require(ROOT .. 'widget.slider'),
+    slider = require(ROOT .. 'widget.slider'), -- Slides to adjust a normalized value
-    stepper = require(ROOT .. 'widget.stepper'),
+    stepper = require(ROOT .. 'widget.stepper'), -- Steps through a series of choices
-    text = require(ROOT .. 'widget.text'),
+    text = require(ROOT .. 'widget.text'), -- A text entry widget
 }
 
+--[[--
+Register a custom widget type.
+
+@static
+
+@tparam string name
+A unique name for this type of widget.
+
+@tparam function(Widget) decorator
+An initialization function for this type of widget.
+--]]--
 function Widget.register (name, decorator)
     Widget.typeDecorators[name] = decorator
 end