categories.xml

@@ -2,7 +2,22 @@
 	<category name="Uncategorized" slug="uncategorized"/>
 	<category name="Widgets" slug="widgets">
 		<desc><![CDATA[
-			<p>Widgets are feature-rich, stateful plugins that have a full life-cycle, along with methods and events. Check out the <a href="/jQuery.widget/">widget factory</a> documentation for more details.</p>
+			<p>Widgets are feature-rich, stateful plugins that have a full life-cycle, along with methods and events. Check out the <a href="http://api.jqueryui.com/jQuery.widget/">widget factory</a> documentation for more details.
+				<div class="warning"><strong>Note</strong>: The base widget (<code>$.mobile.widget</code>) is deprecated as of 1.4 and will be removed in 1.5. It is now sufficient to base your custom jQuery Mobile widgets on the jQuery UI <a href="http://api.jqueryui.com/jQuery.widget/">widget factory</a> itself. This means that in your call to <code>$.widget()</code> you can omit the base altogether.
+					<pre><code>
+$.widget( "my.widget", /* NOTE: no base needed */ {
+  options: {
+    /* ... */
+  },
+
+  _create: function() {
+    /* ... */
+  }
+
+  /* ... */
+});</code></pre>
+				</div>
+			</p>
 ]]></desc>
 	</category>
 	<category name="Events" slug="events">
@@ -11,10 +26,21 @@
 	</category>
 	<category name="Methods" slug="methods">
 		<desc><![CDATA[
-			<p>jQuery Mobile exposes several methods on the $.mobile object for use in your applications.</p>]]></desc>
+			<p>jQuery Mobile exposes several methods and properties on the $.mobile object for use in your applications.</p>]]></desc>
+		<category name="Path" slug="path">
+			<desc><![CDATA[
+				<p>A collection of methods for dealing with paths.</p>
+			]]></desc>
+		</category>
 	</category>
-	<category name="Miscellaneous" slug="misc">
-		<desc></desc>
+	<category name="CSS Framework" slug="css-framework">
+		<desc><![CDATA[
+			<p>jQuery Mobile offers CSS-based enhancements for common user interface elements.</p>]]>
+		</desc>
+	</category>
+	<category name="Icons" slug="jqmicons">
+		<desc><![CDATA[
+			<p>jQuery Mobile offers a set of built-in icons that can be applied to buttons, collapsibles, listview buttons and more.</p>]]></desc>
 	</category>
 	<category name="Properties" slug="properties">
 		<desc><![CDATA[