Merge lp:~knitzsche/ubuntu-html5-theme/ubuntu-html5-theme-yuidoc into lp:~ubuntu-html5-theme-devs/ubuntu-html5-theme/ambiance

[Kyle Nitzsche]

This MR does three main things:
1) Implements yuidoc comments in all js files to support API doc generation, and provides yuidoc assets (theme dir and json file) needed to build the API docs. Bug LP: #1241029
3) Provides JS classes for shape and page with corresponding UbuntuUI prototype constructor functions. Bug LP: #1243248
4) Adds a getEl(UbuntuUIObject) to return the element for any Ubuntu class. Also LP: #1243248

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:114
http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-ci/17/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-trusty/2/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-trusty-amd64-ci/1/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-trusty-armhf-ci/1/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-trusty-amd64/2/console

Click here to trigger a rebuild:
http://10.97.0.26:8080/job/ubuntu-html5-theme-ci/17/rebuild

review: Needs Fixing (continuous-integration)

[Kyle Nitzsche (knitzsche)]

I am uncertain whether I need to do something to address the ps-jenkins failure reported above...

[Adnane Belmadiaf (daker)]

The header part is a dup of tabs.js, tabs so we can match SDK name http://developer.ubuntu.com/api/qml/sdk-1.0/Ubuntu.Components.Tabs/

The tabs example :

<li class="active" data-role="tab">
    <a href="#item1" id="firstTab">First</a>
</li>

so here item1 is the ID of the page you want to display

review: Needs Fixing

[Kyle Nitzsche (knitzsche)]

Hi Adnane. It seems to me there are a few goals here:
1) Provide a place in the JS source for documenting how *every* Ubuntu HTML element is declared in HTML. (bug 1243248).
2) Provide an API landing page for each of the design.ubuntu.com Building Block pages. Design has pages for Header and Tabs: http://design.ubuntu.com/apps/building-blocks/header http://design.ubuntu.com/apps/building-blocks/tabs

So the MR adds the UbuntUI header proptotype, even though it doesn't currently give coders much. It DOES give the documentation a single view of all HTML declarations though (implementation is still incomplete).

[Kyle Nitzsche (knitzsche)]

This discussion gives me a chance to clarify my intent with this: I think we need a class for every Ubuntu HTML "widget" usually, (but unfortunately not always) defined by existence of a data-role attribute. These classes then can form the framework for documenting the system (including HTML declarations) AND they provide a comprehensive framework for accessing every Ubuntu widget through JS. So these classes are useful even when there are no class specific functions, as is the case right now with both tabs and header classes.

[Adnane Belmadiaf (daker)]

I see your point, so +1 from me but please fix the tabs example :

<li class="active" data-role="tab">
    <a href="#item1" id="firstTab">First</a>
</li>

here item1 is the ID of the page you want to display

review: Needs Fixing

[Kyle Nitzsche (knitzsche)]

The reason I have not explained that the href is supposed to be the id attribute of the page you want to display when the user clicks the Tab is that I cannot make it work myself. So let's clarify the expectations and file a bug as needed.

Suppose there is html like this and no additional app javascript to handle tab/anchor click events:
    <header data-role="header">
        <nav data-role="navbar" class="tabs" >
          <div class="tabs-inner">
            <ul>
            <li class="active" role="tab">
              <a href="#" class="tab-item">My Header</a>
            </li>
            <li class="active" role="tab">
              <a href="page2" class="tab-item">Page 2</a>
            </li>
            </ul>
          </div>
        </nav>
      </header>

      <div data-role="content">

        <div data-role="pagestack">

          <div data-role="page" id="main">
[...]
          </div>

          <div data-role="page" id="page2">
          <h1>Hello from page2</h1>
          <section data-role="list" id="item-view-content">
          </section>

        </div>

When you click the second Header Tab ("Page 2"), it does *not* cause page2 to display. I assume the expectation is that page2 DOES display.

Perhaps my expectation is incorrect? If so, am I doing wrong, or is this a bug (I don't see it).

If my understanding is correct, I certainly can document it here ASAP, but there should be a bug filed I suppose...

[Adnane Belmadiaf (daker)]

Ah i see it's because this MR hasn't been merged https://code.launchpad.net/~daker/ubuntu-html5-theme/fix.1216873/+merge/185360

[Kyle Nitzsche (knitzsche)]

Today's docs built from my branch are here: http://people.canonical.com/~knitzsche/yuidoc-ubuntu-html5-theme/31oct2013/

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:115
http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-ci/18/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-trusty/271/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-trusty-amd64-ci/2/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-trusty-armhf-ci/2/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-trusty-amd64/271/console

Click here to trigger a rebuild:
http://10.97.0.26:8080/job/ubuntu-html5-theme-ci/18/rebuild

review: Needs Fixing (continuous-integration)

[Kyle Nitzsche (knitzsche)]

OK, pushed the built docs from this branch. Now using "latest" dir name:
http://people.canonical.com/~knitzsche/yuidoc-ubuntu-html5-theme/latest/

[David Barth (dbarth)]

The documentation is comprehensive and a very nice addition to the project. +1 for me.

I'll let you guys handle typos and updates in this MR, or as a set of bugs.

review: Approve

[PS Jenkins bot (ps-jenkins)]

FAILED: Autolanding.
More details in the following jenkins job:
http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-autolanding/151/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-trusty/302/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-trusty-amd64-autolanding/4/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-html5-theme-trusty-armhf-autolanding/4/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-trusty-amd64/302/console

review: Needs Fixing (continuous-integration)

[Kyle Nitzsche (knitzsche)]

I am having trouble figuring out what the continuous integration failure just above means and what, if anything, I need to do to fix it.

Can someone please advise?

[lp:~knitzsche/ubuntu-html5-theme/ubuntu-html5-theme-yuidoc]

94. By Kyle Nitzsche on 2013-11-01

Continuous Integration failures were apparently caused by missing copyright
information in three files that I copied from the yudiuoc 'simple' theme
(which I have now customized a little form Ubuntu). The Yuidoc install root
dir has a LICENSE file that states copyright and redistribution terms.
I have copied that text into the three files in this version of the simple
theme directory.

[PS Jenkins bot (ps-jenkins)]

review: Approve (continuous-integration)

=== modified file '0.1/ambiance/js/buttons.js'
--- 0.1/ambiance/js/buttons.js	2013-10-19 12:21:19 +0000
+++ 0.1/ambiance/js/buttons.js	2013-11-01 20:18:13 +0000
@@ -20,12 +20,34 @@
  * <http://www.gnu.org/licenses/>.
  */
 
-/* Buttons */
+/**
+ * A Button.
+
+ Note the Ubuntu CSS style classes: <em>success</em>, <em>warning</em>, and <em>danger</em>
+
+ * @class Button
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      <button data-role="button" id="buttonID">text</button>
+
+      Javascript access:
+      var button = UI.button("buttonID");
+ */
 var Button = function (id) {
     this.id =  id;
 };
 
 Button.prototype = {
+    /**
+     * Associate a function with the button's Click event
+     * @method click
+     * @param {Function} callback - The function to execute on click
+     * @example
+        UI.button("buttonid").click(function(){
+         console.log("clicked");
+        });
+     */
     click: function (callback) {
     if ( ! document.getElementById(this.id)) {
         throw "Invalid button ID: " + String(this.id);
 
=== modified file '0.1/ambiance/js/core.js'
--- 0.1/ambiance/js/core.js	2013-09-12 21:32:09 +0000
+++ 0.1/ambiance/js/core.js	2013-11-01 20:18:13 +0000
@@ -20,6 +20,24 @@
  * <http://www.gnu.org/licenses/>
  */
 
+/**
+ * @module UbuntuUI
+ */
+
+/**
+ * UbuntuUI is the critical Ubuntu HTML5 framework class. You need to construct an UbuntuUI object and initialize it to have an Ubuntu HTML5 app. You then use this object to access Ubuntu HTML5 objects (and object methods) that correspond to the Ubuntu HTML5 DOM elements. 
+
+Note: The UbuntuUI object is "UI" in all API doc examples.
+ * @class UbuntuUI
+ * @constructor
+ * @example
+      var UI = new UbuntuUI();
+      window.onload = function () {
+        UI.init();
+        UI.pagestack.push('pageid');
+        [...]
+      };
+ */
 var UbuntuUI = (function () {
 
     PAGESTACK_BACK_ID = 'ubuntu-pagestack-back';
@@ -142,28 +160,93 @@
             }
         },
 
+        /**
+         * Required call that initializes the UbuntuUI object
+         * @method {} init
+         */
         init: function () {
             this.__setupPage(document);
         },
 
+        /**
+         * Gets an Ubuntu Page object
+         * @method page
+         * @param {ID} id - The element's id attrubute
+         * @return {Page} - The Page with the specified id
+         */
+        page: function (id) {
+            if (typeof Page != 'undefined' && Page ) {
+                return new Page(id);
+            }
+        },
+
+        /**
+         * Gets an Ubuntu Shape object
+         * @method shape
+         * @param {ID} id - The element's id attrubute
+         * @return {Shape} - The Shape with the specified id
+         */
+        shape: function (id) {
+            if (typeof Shape != 'undefined' && Shape ) {
+                return new Shape(id);
+            }
+        },
+
+        /**
+         * Gets an Ubuntu Button object
+         * @method button
+         * @param {ID} id - The element's id attrubute
+         * @return {Button} - The Button with the specified id
+         */
         button: function (id) {
             if (typeof Button != 'undefined' && Button) {
                 return new Button(id);
             }
         },
 
+        /**
+         * Gets an Ubuntu Dialog object
+         * @method dialog
+         * @param {ID} id - The element's id attrubute
+         * @return {Dialog} - The Dialog with the specified id
+         */
         dialog: function (id) {
             if (typeof Dialog != 'undefined' && Dialog) {
                 return new Dialog(id);
             }
         },
 
+        /**
+         * Gets an Ubuntu Popover object
+         * @method popover
+         * @param {Element} el - The element to which the Popover's position is relative
+         * @param {ID} id - The element's id attrubute
+         * @return {Popover} - The Popover with the specified id
+         */
         popover: function (elem, id) {
             if (typeof Popover != 'undefined' && Popover) {
                 return new Popover(elem, id);
             }
         },
 
+        /**
+         * Gets an Ubuntu Header object
+         * @method header
+         * @param {ID} id - The element's id attrubute
+         * @return {Header} - The Header with the specified id
+         */
+        header: function (id) {
+            if (typeof Header != 'undefined' && Header) {
+                return new Header(id);
+            }
+        },
+
+        /**
+         * Gets an Ubuntu Tabs object
+         * @method tabs
+         * @param {ID} id - The element's id attrubute
+         * @return {Tabs} - The Tabs with the specified id
+         */
         tabs: function (selector) {
             if (typeof Tabs != 'undefined' && Tabs) {
                 if (selector === undefined)
@@ -174,23 +257,51 @@
             }
         },
 
+        /**
+         * Gets an Ubuntu Toolbar object
+         * @method toolbar
+         * @param {ID} id - The element's id attrubute
+         * @return {Toolbar} - The Toolbar with the specified id
+         */
         toolbar: function (id) {
             if (typeof Toolbar != 'undefined' && Toolbar) {
                 return new Toolbar(this, id);
             }
         },
 
+        /**
+         * Gets an Ubuntu List
+         * @method list
+         * @param {Selector} selector - A selector that JavaScript querySelector method understands
+         * @return {List}
+         */
         list: function (selector) {
             if (typeof List != 'undefined' && List) {
                 return new List(selector);
             }
         },
 
+        /**
+         * Gets this UbuntuUI's single Pagestack object
+         * @method pagestack
+         * @return {Pagestack} - The Pagestack
+         */
         get pagestack() {
             return this._pageStack;
-        }
+        },
+
+        /**
+         * Gets the HTML element associated with an Ubuntu HTML5 JavaScript object
+         * @method getEl
+         * @param {UbuntuObject} object - An UbuntuUI widget object
+         * @return {Element} - The HTML element
+         */
+        getEl: function(widget) {
+          return document.getElementById(widget.id);
+        },
+
     };
 
     return UbuntuUI;
 
-})();
 \ No newline at end of file
+})();
 
=== modified file '0.1/ambiance/js/dialogs.js'
--- 0.1/ambiance/js/dialogs.js	2013-07-17 15:27:43 +0000
+++ 0.1/ambiance/js/dialogs.js	2013-11-01 20:18:13 +0000
@@ -20,18 +20,52 @@
  * <http://www.gnu.org/licenses/>.
  */
 
-/* Dialogs */
+/**
+ * Dialogs are modal full-screen popups that prevent other GUI interactions with the application until dismissed.
+
+Dialogs wrap arbitrary markup.
+
+Dialogs are declared inside the <em>content</em> div as a sibling to the <em>pagestack</em> div.
+ * @class Dialog
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      <div data-role="content">
+        <div data-role="pagestack">
+          [...]
+        </div>
+        <div data-role="dialog" id="dialogID">
+          [...]
+        </div>
+      </div>
+
+      JavaScript access:
+      var dialog = UI.dialog("dialogID");
+
+ */
 var Dialog = function (id) {
     this.dialog = document.getElementById(id);
 };
 
 Dialog.prototype = {
+    /**
+     * Display a dialog by adding 'active' CSS class
+     * @method show
+     */
     show: function () {
         this.dialog.classList.add('active');
     },
+    /**
+     * Hide a dialog by removing 'active' class
+     * @method hide
+     */
     hide: function () {
         this.dialog.classList.remove('active');
     },
+    /**
+     * Toggle a dialog, which means removing its 'active' class if it has one, or adding the 'active' class if it does not have one
+     * @method toggle
+     */
     toggle: function () {
         this.dialog.classList.toggle('active');
     }
 
=== added file '0.1/ambiance/js/header.js'
--- 0.1/ambiance/js/header.js	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/header.js	2013-11-01 20:18:13 +0000
@@ -0,0 +1,65 @@
+/*
+ * Copyright (C) 2013 Adnane Belmadiaf <[e-mail]>
+ * License granted by Canonical Limited
+ *
+ * This file is part of ubuntu-html5-theme.
+ *
+ * This package is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as 
+ * published by the Free Software Foundation; either version 3 of the 
+ * License, or
+ * (at your option) any later version.
+ 
+ * This package is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ 
+ * You should have received a copy of the GNU Lesser General Public 
+ * License along with this program. If not, see 
+ * <http://www.gnu.org/licenses/>.
+ */
+
+/**
+ * An Ubuntu Header wraps Tabs. Together they provide the main navigation widget at the top of an Ubuntu HTML5 app.
+
+Declare the Header and its Tabs in HTML as a direct child of the top level Page as a sibling to the <em>content</em> div.
+######Contained list provides Page navigation
+A contained unordered list has list items, each of which has an anchor (&lt;a&gt;) whose <em>href</em> attribute is a hash char ("#") followed by a Page ID. Clicking the Header/Tabs allows the user to navigate to the Pages identified by these IDs.
+
+ * @class Header
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      <body>
+        <div data-role="page">
+          <header data-role="header" id="headerID">
+            <div class="tabs-inner">
+              <ul data-role="tabs">
+                <li class="active" data-role="tab">
+                  <a href="#main">Main</a>
+                </li>
+                <li data-role="tab">
+                  <a href="#page2">Two</a>
+                </li>
+              </ul>
+            </div>
+          </header>
+          <div data-role="content">
+            [...]
+          </div>
+        </div>
+      </body>
+
+      JavaScript access:
+      var header = UI.header("headerID");
+ */
+var Header= function (id) {
+    this.id =  id;
+};
+
+Header.prototype = {
+    /**
+     * Placeholder for future methods
+     */
+};
 
=== modified file '0.1/ambiance/js/list.js'
--- 0.1/ambiance/js/list.js	2013-10-30 20:51:51 +0000
+++ 0.1/ambiance/js/list.js	2013-11-01 20:18:13 +0000
@@ -20,7 +20,35 @@
  * <http://www.gnu.org/licenses/>.
  */
 
-/* Lists */
+/**
+ * A List comes with various options, including: a <em>header</em>, main text (pushed left), an icon (pushed left), and a secondary label (pushed right).
+ * @class List
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+     <section data-role="list" id="testlist">
+       <header>My header text</header>
+       <ul>
+         <li>
+           <a href="#">Main text, to the left</a>
+         </li>
+         <li>
+           <a href="#">Main text</a>
+           <label>Right text</label>
+         </li>
+         <li>
+           <aside>
+             <img src="someicon.png">
+           </aside>
+           <a href="#">Main text</a>
+           <label>Right</label>
+         </li>
+       </ul>
+      </section>
+
+      JavaScript access:
+        var list = UI.list('[id="testlist"]');
+ */
 var List = (function () {
     var LIST_DATA_ROLE = 'list';
 
@@ -45,6 +73,11 @@
     };
 
     List.prototype = {
+        /**
+         * Add or Set the List Header
+         * @method setHeader
+         * @param {String} text - The header text
+         */ 
         setHeader: function (text) {
             if (typeof (text) == 'string') {
                 var header = this._list.querySelectorAll('header');
@@ -65,21 +98,16 @@
                 header.innerText = text;
             }
         },
-        /*
-      \brief Appends a item to the list
-
-      Appends a given item to the current list.
-
-      \param text A string of text (images & custom html not supported at the moment)
-      \param onclick (optional) A function callback that is to be called when the item is clicked.
-                     It will be called with the clicked node as a parameter along with the value of
-             user_data (if any).
-      \param id (optional) An optional Id for the added node, the id will only be added if it does not already
-                           conflict with another one.
-          \param user_data (optional) An javascript entity that will be passed to the onclick callback (if any)
-                                  when the event has been trigger.
-      \return added item node or null
-     */
+	    /**
+         * Append an item to a list
+         * @method append
+         * @param {String} text - The main text, flushed left (no markup)
+         * @param {[String]} label - Additional text, flushed right (no markup)
+         * @param {[ID]} id - An id attribute value set for the new list item (must be unique in DOM)
+         * @param {[Function]} onclick - The click callback function
+         * @param {[Object*]} user_data - Additional data that is passed to the click callback
+         * @return {Element} - The created list item, or null on failure ot create
+         */
         append: function (text, label, id, onclick, user_data) {
             var li = document.createElement('li');
             var a = document.createElement('a');
@@ -110,45 +138,41 @@
 
             return li;
         },
-        /*
-      \brief returns the nth child item from a list
-
-      \param index Index of the child to return (0 based number)
-      \return selected item node or null
-     */
+        /**
+         * Gets a list item &lt;li&gt; by its index, where index counting starts from 1
+         * @method at
+         * @param {Number} index
+         * @return The list item, or null on failure 
+         */
         at: function (index) {
             if (typeof (index) != 'number')
                 return null;
             return this._list.querySelector('ul').querySelector('li:nth-child(' + index + ')');
         },
-        /*
-      \brief removes the nth child item from a list
-
-      \param index Index of the child to remove (0 based number)
-      \return nothing
-     */
+        /**
+         * Removes a list item &lt;li&gt; by its index, where index counting starts from 1
+         * @method remove
+         * @param {Number} index
+         */
         remove: function (index) {
             var item = this.at(index);
             if (item) {
                 item.parentNode.removeChild(item);
             }
         },
-        /*
-      \brief removes all the child items from a list
-      \return nothing
-     */
+        /**
+         * Removes all items from a list
+         * @method removeAllItems
+         */
         removeAllItems: function () {
             if (this._list.querySelector('ul'))
                 this._list.querySelector('ul').innerHTML = '';
         },
-        /*
-      \brief iterator over the list of list items and calls a function on each one
-
-      \param func function to be called for each list item. The function
-                  receives the DOM node associated with the current item along with its
-              index.
-      \return nothing
-    */
+        /**
+         * Iterates over all list items and runs a provided function on each
+         * @method forEach
+         * @param {Function} func - The function to run on each list item
+         */
         forEach: function (func) {
             if (typeof (func) !== 'function')
                 return;
 
=== added file '0.1/ambiance/js/page.js'
--- 0.1/ambiance/js/page.js	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/page.js	2013-11-01 20:18:13 +0000
@@ -0,0 +1,62 @@
+/*
+ * Copyright (C) 2013 Adnane Belmadiaf <[e-mail]>
+ * License granted by Canonical Limited
+ *
+ * This file is part of ubuntu-html5-theme.
+ *
+ * This package is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as 
+ * published by the Free Software Foundation; either version 3 of the 
+ * License, or
+ * (at your option) any later version.
+ 
+ * This package is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ 
+ * You should have received a copy of the GNU Lesser General Public 
+ * License along with this program. If not, see 
+ * <http://www.gnu.org/licenses/>.
+ */
+
+/**
+ * An Ubuntu app consists of a Pagestack containing one or more Pages. Each page displays full-screen. See the Pagestack class.
+
+Each Page must have an <em>id</em> attriubute. This is used to push the Page to the top of the Pagestack (see the Pagestack class).
+
+Navigation between Pages is typically provided by the Header and its Tabs. See the Header class.
+ * @class Page
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      </body>
+        <div data-role="page">
+          <header data-role="header">
+            [...]
+          </header>
+          <div data-role="content">
+            <div data-role="pagestack">
+              <div data-role="page" id="main">
+                [...]
+              </div>
+              <div data-role="page" id="ID">
+                [...]
+              </div>
+            </div>
+          </div>
+        </div>
+      </body>
+
+      JavaScript access:
+      var page = UI.page("pageID");
+ */
+var Page = function (id) {
+    this.id =  id;
+};
+
+Page.prototype = {
+    /*
+     * placeholder for future methods
+     */
+};
 
=== modified file '0.1/ambiance/js/pagestacks.js'
--- 0.1/ambiance/js/pagestacks.js	2013-10-19 12:21:19 +0000
+++ 0.1/ambiance/js/pagestacks.js	2013-11-01 20:18:13 +0000
@@ -20,8 +20,52 @@
  * <http://www.gnu.org/licenses/>.
  */
 
-/* Pagestack */
-
+/**
+ * The Pagestack manages all Pages in a stack data structure. Initially, the Pagestack contains no Pages. The <em>push()</em> method is normally executed on load to display the app starting page.
+
+      UI.pagestack.push("pageID")
+
+The topmost Page on the Pagestack is always displayed.
+
+The Pagestack is declared as a direct child of the <em>content</em> div.
+
+#####Default application wide footer
+The Pagestack contains a default <em>footer</em> (represented in JavaScript as a Toolbar), even if you do not declare one in HTML. The <em>footer</em> has a single Back button. 
+#####Customized application wide footer
+This application-wide <em>footer</em> can be customized (for example, you can add Buttons) by declaring a <em>footer</em> as a direct child of the <em>pagestack</em> div (see example). 
+######Page specific footers
+A <em>page</em> may declare a page-specific <em>footer</em> as a child element.
+
+ * @class Pagestack
+ * @namespace UbuntuUI
+ * @constructor
+ * @example
+
+     <div data-role="page">
+        <header data-role="header">
+          [...]
+        </header>
+        <div data-role="content">
+          <div data-role="pagestack">
+            <div data-role="page" id="main">
+            </div>
+            <div data-role="page" id="page2">
+              [...]
+              <footer data-role="footer" class="revealed" id="footerPage2">
+                [...]
+              </footer>
+            </div>
+            <footer data-role="footer" class="revealed" id="footerAppWide">
+              [...]
+            </footer>
+          </div>  <!-- end of Pagestack div -->
+        </div>
+      </div>
+
+      JavaScript:
+      UI.pagestack.METHOD();
+
+ */
 var Pagestack = (function () {
 
     function __safeCall(f, args, errorfunc) {
@@ -81,6 +125,12 @@
                 footer.classList.add('revealed');
             }
         },
+        /**
+         * Push a page to the top of this pagestack
+         * @method push
+         * @param {String} id - The id attribute of the page element to be pushed
+         * @param {Object} properties - This param is not currently used
+         */
         push: function (id, properties) {
             try {
                 __safeCall(this.__setAllPagesVisibility.bind(this), [false]);
@@ -89,21 +139,41 @@
                 this._pages.push(id);
             } catch (e) {}
         },
+        /**
+         * Checks for zero pages in this pagestack
+         * @method isEmpty
+         * @return {Boolean} - True when this pagestack has no pages, else false
+         */
         isEmpty: function () {
             return this._pages.length === 0;
         },
+        /**
+         * Gets the id attribute of the page element on top of this pagestack
+         * @method currentPage
+         * @return {PageID|Null} - The topmost page's id attribute, else null when there are no pages on this pagestack
+         */
         currentPage: function () {
             return this.isEmpty() ? null : this._pages[this._pages.length - 1];
         },
+        /**
+         * Gets the number of pages in this pagestack
+         * @method depth
+         * @return {Number} - The number of pages in this pagestack
+         */
         depth: function () {
             return this._pages.length;
         },
+
         clear: function () {
             if (this.isEmpty())
                 return;
             __safeCall(this.__deactivate.bind(this), [this.currentPage()]);
             this._pages = [];
         },
+        /**
+         * Pops the current page off this pagestack, which causes the next page to become the top page and to display
+         * @method pop
+         */
         pop: function () {
             if (this.isEmpty())
                 return;
 
=== modified file '0.1/ambiance/js/popovers.js'
--- 0.1/ambiance/js/popovers.js	2013-08-31 14:25:59 +0000
+++ 0.1/ambiance/js/popovers.js	2013-11-01 20:18:13 +0000
@@ -20,7 +20,40 @@
  * <http://www.gnu.org/licenses/>.
  */
 
-/* Popover */
+/**
+ * A Popover is a div containng markup that can pop up and disappear. (Unlike a Dialog, Popovers are not full screen.)
+
+A Popoves often contain a List whose items are connected to useful JavaScript functions.
+
+
+######Popover Position
+The Popover's position is set relative to a specified base element with the <em>data-gravity="LETTER"</em> attribute. LETTER values:
+
+ - 'n': the base element is above the Popover
+ - 's': the base element is below the Popover
+ - 'e': the base element is to the east of (to the right of) the Popover (in right-to-left locales)
+ - 'w': the base element is to the west of (to the left of) the Popover (in right-to-left locale)
+
+ * @class Popover
+ * @constructor
+ * @namespace UbuntuUI
+ * @param {String} elem - The element to which the Popover's position is relative
+ * @param {ID} id - The id attribute of the Popover in HTML
+ * @example
+
+      <p id="popoverBase">Text</p>
+      <div class="popover active" data-gravity="n" id="popover">
+        <ul class="list">
+          <li class="active"><a href="#">Item1</a></li>
+          <li><a href="#">Item2</a></li>
+        </ul>
+      </div>
+
+      Javascript:
+      var popBase = document.getElementByID("popoverBase");
+      var popover = UI.popover(popBase, "popover");
+ */
+
 var Popover = function (elem, id) {
     this.id = id;
     this.popover = document.getElementById(id);
@@ -30,6 +63,10 @@
 };
 
 Popover.prototype = {
+    /** 
+     * Display a Popover
+     * @method show
+     */
     show: function () {
         if (this.popover === null) {
             console.error('The popover with the ID #' + this.id + ' doesn\'t exist');
@@ -103,12 +140,20 @@
 
         return this.popover;
     },
+    /**
+     * Hide a Popover
+     * @method hide
+     */
     hide: function () {
         this.popover.classList.remove('active');
         this.popover.style.top = '0px';
         this.popover.style.left = '0px';
         return this.popover;
     },
+    /**
+     * Toggle show/hide status of a Popover
+     * @method toggle
+     */
     toggle: function () {
         if (this.popover === null) {
             console.error('The popover with the ID #' + this.id + ' doesn\'t exist');
 
=== added file '0.1/ambiance/js/shape.js'
--- 0.1/ambiance/js/shape.js	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/shape.js	2013-11-01 20:18:13 +0000
@@ -0,0 +1,59 @@
+/*
+ * Copyright (C) 2013 Adnane Belmadiaf <[e-mail]>
+ * License granted by Canonical Limited
+ *
+ * This file is part of ubuntu-html5-theme.
+ *
+ * This package is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as 
+ * published by the Free Software Foundation; either version 3 of the 
+ * License, or
+ * (at your option) any later version.
+ 
+ * This package is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ 
+ * You should have received a copy of the GNU Lesser General Public 
+ * License along with this program. If not, see 
+ * <http://www.gnu.org/licenses/>.
+ */
+
+/**
+ * An Ubuntu Shape contains and decorates (with CSS styles) some markup, often an <em>img</em>.
+ * @class Shape
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      <div data-role="shape" id="shapeID">
+        <img src="URI"/>
+      </div>
+
+      JavaScript access:
+      var shape = UI.shape("shapeID");
+
+ */
+var Shape = function (id) {
+    this.id =  id;
+};
+
+Shape.prototype = {
+    /**
+     * Associate a function with the Click event
+     * @method click
+     * @param {Function} - The function to execute on click
+     * @example
+        UI.shape("id").click(function(){
+         console.log("Clicked");
+        });
+     */
+    click: function (callback) {
+      if ( ! document.getElementById(this.id)) {
+        throw "Error. id attribute: " + String(this.id) + " is not present in DOM";
+      } else {
+        var el = document.getElementById(this.id);
+        el.addEventListener('click', callback);
+      }
+    },
+};
 
=== modified file '0.1/ambiance/js/tabs.js'
--- 0.1/ambiance/js/tabs.js	2013-09-12 21:32:09 +0000
+++ 0.1/ambiance/js/tabs.js	2013-11-01 20:18:13 +0000
@@ -20,7 +20,38 @@
  * <http://www.gnu.org/licenses/>
  */
 
-/* Tabs */
+/**
+ * Tabs are the standard way to provide app navigation from your application Header. See the Header class for more information.
+
+Declare the Header and Tabs in HTML as a direct child of the top level Page as a sibling to the content div.
+
+ * @class Tabs
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      <body>
+        <div data-role="page">
+          <header data-role="header" id="headerID">
+            <div class="tabs-inner">
+              <ul data-role="tabs">
+                <li class="active" data-role="tab">
+                  <a href="#main">Main</a>
+                </li>
+                <li data-role="tab">
+                  <a href="#page2">Two</a>
+                </li>
+              </ul>
+            </div>
+          </header>
+          <div data-role="content">
+            [...]
+          </div>
+        </div>
+      </body>
+
+      JavaScript:
+      var tabs = UI.tabs();
+*/
 var Tabs = function (UbuntuUI, tabs) {
     var pageX,
         pageY,
@@ -170,4 +201,4 @@
     [].forEach.call(document.querySelectorAll('[data-role="tab"]'), function (el) {
         el.addEventListener('click', onClicked, false);
     });
-};
 \ No newline at end of file
+};
 
=== modified file '0.1/ambiance/js/toolbars.js'
--- 0.1/ambiance/js/toolbars.js	2013-09-12 21:32:09 +0000
+++ 0.1/ambiance/js/toolbars.js	2013-11-01 20:18:13 +0000
@@ -20,21 +20,67 @@
  * <http://www.gnu.org/licenses/>.
  */
 
-/* Toolbars */
+/**
+ * A Toolbar is the JavaScript representation of an Ubuntu HTML5 app <em>footer</em>. 
+
+######Contained List provides buttons
+The Toolbar contains a List, where each list item is treated as a Button (see below). List items (Buttons) are pushed to the right. The default Back button always exists to the left and does not need to be declared. 
+
+#####Default and custom footers
+See the Pagestack class documentation for information about the default application-wide Footer, customizing it, and adding Page-specific Footers.
+ * @class Toolbar
+ * @constructor
+ * @namespace UbuntuUI
+ * @example
+      <footer data-role="footer" class="revealed" id="footerID">
+        <div data-role="list">
+          <ul>
+            <li>
+              <a href="#" id="home">Home</a>
+            </li>
+          </ul>
+        </div>
+      </footer>
+
+      JavaScript access:
+      var toolbar = UI.footer("footerID");
+      UI.button('home').click(function () {
+        UI.pagestack.push("main");
+      });
+
+ */
+
 var Toolbar = function (UbuntuUI, id) {
     this.toolbar = document.getElementById(id);
 };
 
 Toolbar.prototype = {
+    /**-
+     * Display a Toolbar
+     * @method show
+     */
     show: function () {
         this.toolbar.classList.add('revealed');
     },
+    /**-
+     * Hide a Toolbar
+     * @method hide
+     */
     hide: function () {
         this.toolbar.classList.remove('revealed');
     },
+    /**
+     * Toggle show/hide status of a Toolbar
+     * @method toggle
+     */
     toggle: function () {
         this.toolbar.classList.toggle('revealed');
     },
+    /**
+     * Provide a callback function that's called with the Toolbar is touched
+     * @method touch
+     * @param {Function} function - The function that is called when the Toolbar is touched
+     */
     touch: function (callback) {
         this.toolbar.addEventListener(UbuntuUI.touchEvents.touchEnd, callback);
     }
 
=== added directory '0.1/ambiance/js/yuidoc-theme'
=== added directory '0.1/ambiance/js/yuidoc-theme/assets'
=== added directory '0.1/ambiance/js/yuidoc-theme/assets/css'
=== added file '0.1/ambiance/js/yuidoc-theme/assets/css/external-small.png'
 Binary files 0.1/ambiance/js/yuidoc-theme/assets/css/external-small.png	1970-01-01 00:00:00 +0000 and 0.1/ambiance/js/yuidoc-theme/assets/css/external-small.png	2013-11-01 20:18:13 +0000 differ
=== added file '0.1/ambiance/js/yuidoc-theme/assets/css/logo.png'
 Binary files 0.1/ambiance/js/yuidoc-theme/assets/css/logo.png	1970-01-01 00:00:00 +0000 and 0.1/ambiance/js/yuidoc-theme/assets/css/logo.png	2013-11-01 20:18:13 +0000 differ
=== added file '0.1/ambiance/js/yuidoc-theme/assets/css/main.css'
--- 0.1/ambiance/js/yuidoc-theme/assets/css/main.css	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/css/main.css	2013-11-01 20:18:13 +0000
@@ -0,0 +1,429 @@
+/*
+Font sizes for all selectors other than the body are given in percentages,
+with 100% equal to 13px. To calculate a font size percentage, multiply the
+desired size in pixels by 7.6923076923.
+
+Here's a quick lookup table:
+
+10px - 76.923%
+11px - 84.615%
+12px - 92.308%
+13px - 100%
+14px - 107.692%
+15px - 115.385%
+16px - 123.077%
+17px - 130.769%
+18px - 138.462%
+19px - 146.154%
+20px - 153.846%
+*/
+
+html {
+    background: #fff;
+    color: #333;
+    overflow-y: scroll;
+}
+
+body {
+    font: 13px/1.4 'Lucida Grande', 'Lucida Sans Unicode', 'DejaVu Sans', 'Bitstream Vera Sans', 'Helvetica', 'Arial', sans-serif;
+    margin: 0;
+    padding: 0;
+}
+
+/* -- Links ----------------------------------------------------------------- */
+a {
+    color: #DD4814;
+    text-decoration: none;
+}
+
+a:hover { text-decoration: underline; }
+
+/* "Jump to Table of Contents" link is shown to assistive tools, but hidden from
+   sight until it's focused. */
+.jump {
+    position: absolute;
+    padding: 3px 6px;
+    left: -99999px;
+    top: 0;
+}
+
+.jump:focus { left: 40%; }
+
+/* -- Paragraphs ------------------------------------------------------------ */
+p { margin: 1.3em 0; }
+dd p, td p { margin-bottom: 0; }
+dd p:first-child, td p:first-child { margin-top: 0; }
+
+/* -- Headings -------------------------------------------------------------- */
+h1, h2, h3, h4, h5, h6 {
+    color: #DD4814
+    font-family: 'Ubuntu', sans-serif;
+    font-weight: bold;
+    line-height: 1.1;
+    margin: 1.1em 0 0.5em;
+}
+
+h1 {
+    font-size: 184.6%;
+    color: #30418C;
+    margin: 0.75em 0 0.5em;
+}
+
+h2 {
+    font-size: 153.846%;
+    color: #E48A2B;
+}
+
+h3 { font-size: 138.462%; }
+
+h4 {
+    border-bottom: 1px solid #DBDFEA;
+    color: #E48A2B;
+    font-size: 115.385%;
+    font-weight: normal;
+    padding-bottom: 2px;
+}
+
+h5, h6 { font-size: 107.692%; }
+
+/* -- Code and examples ----------------------------------------------------- */
+code, kbd, pre, samp {
+    font-family: Menlo, Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;
+    font-size: 92.308%;
+    line-height: 1.35;
+}
+
+p code, p kbd, p samp {
+    background: #FCFBFA;
+    border: 1px solid #EFEEED;
+    padding: 0 3px;
+}
+
+a code, a kbd, a samp,
+pre code, pre kbd, pre samp,
+table code, table kbd, table samp,
+.intro code, .intro kbd, .intro samp,
+.toc code, .toc kbd, .toc samp {
+    background: none;
+    border: none;
+    padding: 0;
+}
+
+pre.code, pre.terminal, pre.cmd {
+    overflow-x: auto;
+    *overflow-x: scroll;
+    padding: 0.3em 0.6em;
+}
+
+pre.code {
+    background: #FCFBFA;
+    border: 1px solid #EFEEED;
+    border-left-width: 5px;
+}
+
+pre.terminal, pre.cmd {
+    background: #F0EFFC;
+    border: 1px solid #D0CBFB;
+    border-left: 5px solid #D0CBFB;
+}
+
+/* Don't reduce the font size of <code>/<kbd>/<samp> elements inside <pre>
+   blocks. */
+pre code, pre kbd, pre samp { font-size: 100%; }
+
+/* Used to denote text that shouldn't be selectable, such as line numbers or
+   shell prompts. Guess which browser this doesn't work in. */
+.noselect {
+    -moz-user-select: -moz-none;
+    -khtml-user-select: none;
+    -webkit-user-select: none;
+    -o-user-select: none;
+    user-select: none;
+}
+
+/* -- Lists ----------------------------------------------------------------- */
+dd { margin: 0.2em 0 0.7em 1em; }
+dl { margin: 1em 0; }
+dt { font-weight: bold; }
+
+/* -- Tables ---------------------------------------------------------------- */
+caption, th { text-align: left; }
+
+table {
+    border-collapse: collapse;
+    width: 100%;
+}
+
+td, th {
+    border: 1px solid #fff;
+    padding: 5px 12px;
+    vertical-align: top;
+}
+
+td { background: #E6E9F5; }
+td dl { margin: 0; }
+td dl dl { margin: 1em 0; }
+td pre:first-child { margin-top: 0; }
+
+th {
+    background: #D2D7E6;/*#97A0BF*/
+    border-bottom: none;
+    border-top: none;
+    color: #000;/*#FFF1D5*/
+    font-family: 'Trebuchet MS', sans-serif;
+    font-weight: bold;
+    line-height: 1.3;
+    white-space: nowrap;
+}
+
+
+/* -- Layout and Content ---------------------------------------------------- */
+#doc {
+    margin: auto;
+    min-width: 1024px;
+}
+
+#main { width: 754px; }
+#sidebar { width: 270px; margin: 0 15px; }
+
+.content { padding: 0 20px 0 25px; }
+
+/* -- Sidebar --------------------------------------------------------------- */
+.sidebox {
+    background: #F9F9FC;/*E6E9F5*/
+    border: 1px solid #D4D8EB;
+
+    -moz-border-radius: 4px;
+    -webkit-border-radius: 4px;
+    border-radius: 4px;
+    -moz-box-shadow: 0 0 6px rgba(0, 0, 0, 0.15);
+    -webkit-box-shadow: 0 0 6px rgba(0, 0, 0, 0.15);
+    box-shadow: 0 0 6px rgba(0, 0, 0, 0.15);
+    font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Lucida Sans', 'Helvetica', 'Arial', sans-serif;
+    margin: 0 0 15px 0;
+    padding-bottom: 1px;
+}
+
+.sidebox h2 {
+    background: #E5E6F1;
+    -moz-border-radius: 4px 4px 0 0;
+    -webkit-border-radius: 4px 4px 0 0;
+    border-radius: 4px 4px 0 0;
+    color: #5E6BA4;
+    font-weight: bold;
+    font-size: 107.692%;
+    margin: 0;
+    padding: 4px 7px 5px;
+}
+
+.sidebox .bd {
+    font-size: 84.615%;
+    padding: 0 5px 0 8px;
+}
+
+.sidebox li { list-style-type: disc; color:#D4D5E3; }
+
+.sidebox ol, .sidebox ul {
+    margin-left: 0;
+    padding-left: 16px;
+}
+
+.sidebox ol ol, .sidebox ol ul,
+.sidebox ul ol, .sidebox ul ul {
+    margin: 0;
+    padding-left: 16px;
+}
+
+/* -- Table of Contents ----------------------------------------------------- */
+
+/* The #toc id refers to the single global table of contents, while the .toc
+   class refers to generic TOC lists that could be used throughout the page. */
+
+.toc code, .toc kbd, .toc samp { font-size: 100%; }
+.toc li { font-weight: bold; }
+.toc li li { font-weight: normal; }
+
+/* -- Intro and Example Boxes ----------------------------------------------- */
+.intro, .example { margin-bottom: 2em; }
+
+.example {
+    -moz-border-radius: 4px;
+    -webkit-border-radius: 4px;
+    border-radius: 4px;
+    -moz-box-shadow: 0 0 5px #bfbfbf;
+    -webkit-box-shadow: 0 0 5px #bfbfbf;
+    box-shadow: 0 0 5px #bfbfbf;
+    padding: 1em;
+}
+
+.intro {
+    background: none repeat scroll 0 0 #F0F1F8; border: 1px solid #D4D8EB; padding: 0 1em;
+}
+
+/* -- Other Styles ---------------------------------------------------------- */
+
+/* These are probably YUI-specific, and should be moved out of Selleck's default
+   theme. */
+
+.button {
+    border: 1px solid #dadada;
+    -moz-border-radius: 3px;
+    -webkit-border-radius: 3px;
+    border-radius: 3px;
+    color: #444;
+    display: inline-block;
+    font-family: Helvetica, Arial, sans-serif;
+    font-size: 92.308%;
+    font-weight: bold;
+    padding: 4px 13px 3px;
+    -moz-text-shadow: 1px 1px 0 #fff;
+    -webkit-text-shadow: 1px 1px 0 #fff;
+    text-shadow: 1px 1px 0 #fff;
+    white-space: nowrap;
+
+    background: #EFEFEF; /* old browsers */
+    background: -moz-linear-gradient(top, #f5f5f5 0%, #efefef 50%, #e5e5e5 51%, #dfdfdf 100%); /* firefox */
+    background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#f5f5f5), color-stop(50%,#efefef), color-stop(51%,#e5e5e5), color-stop(100%,#dfdfdf)); /* webkit */
+    filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#f5f5f5', endColorstr='#dfdfdf',GradientType=0 ); /* ie */
+}
+
+.button:hover {
+    border-color: #466899;
+    color: #fff;
+    text-decoration: none;
+    -moz-text-shadow: 1px 1px 0 #222;
+    -webkit-text-shadow: 1px 1px 0 #222;
+    text-shadow: 1px 1px 0 #222;
+
+    background: #6396D8; /* old browsers */
+    background: -moz-linear-gradient(top, #6396D8 0%, #5A83BC 50%, #547AB7 51%, #466899 100%); /* firefox */
+    background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#6396D8), color-stop(50%,#5A83BC), color-stop(51%,#547AB7), color-stop(100%,#466899)); /* webkit */
+    filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#6396D8', endColorstr='#466899',GradientType=0 ); /* ie */
+}
+
+.newwindow { text-align: center; }
+
+.header .version em {
+    display: block;
+    text-align: right;
+}
+
+.yui3-skin-sam #classdocs .yui3-tabview-panel {
+    background-color: transparent;
+}
+
+.yui3-skin-sam #classdocs .yui3-tabview-panel {
+    border: none;
+}
+
+.yui3-skin-sam .yui3-tabview .yui3-tab,
+.yui3-skin-sam .yui3-tabview .yui3-tab-selected,
+.yui3-skin-sam .yui3-tabview .yui3-tab-hover {
+    background: -moz-linear-gradient(center top , #F4F0EC 0%, #D6D2CE 100%) repeat scroll 0 0 transparent;
+    border-bottom: 1px solid #DEDCD9;
+    border-right: 1px solid #CDCBC8;
+    border-left: 1px solid #CDCBC8;
+    border-top: 1px solid #DADADA;
+    color: #333333;
+    text-decoration: none;
+}
+.yui3-skin-sam .yui3-tabview .yui3-tab-label,
+.yui3-skin-sam .yui3-tabview .yui3-tab-selected .yui3-tab-label {
+    border: none;
+    background: none;
+    font-size: 100%;
+    color: #000;
+}
+
+.yui3-skin-sam .yui3-tabview .yui3-tab-selected,
+.yui3-skin-sam .yui3-tabview .yui3-tab-hover {
+    background: none;
+    background-color: #fff;
+    border-bottom-color: #FFFFFF;
+    border-top: 2px solid #8193C9;
+    font-weight: bold;
+    color: #000;
+
+}
+
+.yui3-skin-sam .yui3-tabview-list {
+    border-color: #DFDFDF;
+    border-width: 0 0 1px; 
+}
+
+
+a.external {
+    background-image: url(external-small.png);
+    background-repeat: no-repeat;
+    background-position: 0 0;
+    padding-left: 16px;
+}
+
+#classdocs .item {
+    border-bottom: 1px solid #466899;
+    margin: 1em 0;
+    padding: 1.5em;
+}
+
+#classdocs .item .params p,
+    #classdocs .item .returns p,{
+    display: inline;
+}
+
+#classdocs .item em code, #classdocs .item em.comment {
+    color: green;
+}
+
+#classdocs .item em.comment a {
+    color: green;
+    text-decoration: underline;
+}
+
+#classdocs .foundat {
+    font-size: 11px;
+    font-style: normal;
+}
+
+.attrs .emits {
+    margin-left: 2em;
+    padding: .5em;
+    border-left: 1px dashed #ccc;
+}
+
+abbr {
+    border-bottom: 1px dashed #ccc;
+    font-size: 80%;
+    cursor: help;
+}
+
+.prettyprint li.L0, 
+.prettyprint li.L1, 
+.prettyprint li.L2, 
+.prettyprint li.L3, 
+.prettyprint li.L5, 
+.prettyprint li.L6, 
+.prettyprint li.L7, 
+.prettyprint li.L8 {
+    list-style: decimal;
+}
+
+ul li p {
+    margin-top: 0;
+}
+
+.method .name {
+    font-size: 110%;
+}
+
+#hd {
+    background: -moz-linear-gradient(center top , #DCDBD9 0%, #F6F5F3 100%) repeat scroll 0 0 transparent;
+    border-bottom: 1px solid #DFDFDF;
+    padding: 0 15px 1px 20px;
+    margin-bottom: 15px;
+}
+
+#hd img {
+    margin-right: 10px;
+    vertical-align: middle;
+}
+
 
=== added directory '0.1/ambiance/js/yuidoc-theme/assets/js'
=== added file '0.1/ambiance/js/yuidoc-theme/assets/js/tabs.js'
--- 0.1/ambiance/js/yuidoc-theme/assets/js/tabs.js	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/js/tabs.js	2013-11-01 20:18:13 +0000
@@ -0,0 +1,67 @@
+/*
+ * Copyright 2011 Yahoo! Inc.
+ * All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *     * Redistributions of source code must retain the above copyright
+ *       notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in the
+ *       documentation and/or other materials provided with the distribution.
+ *     * Neither the name of the Yahoo! Inc. nor the
+ *       names of its contributors may be used to endorse or promote products
+ *       derived from this software without specific prior written permission.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL YAHOO! INC. BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+
+
+YUI({
+    insertBefore: 'site_styles'
+}).use('tabview', function(Y) {
+    var classdocs = Y.one('#classdocs'),
+        tabviewIndexTable = {};
+    if (classdocs) {
+        if (classdocs.all('li').size()) {
+            var tabview = new Y.TabView({ srcNode: classdocs });
+            tabview.render();
+			classdocs.all('li a').each(function (item, index) {
+				var hash = item.get(['hash']);
+					type = hash.substring(1);
+				if (!tabviewIndexTable[type]) {
+					tabviewIndexTable[type] = index;
+				}
+			})
+			Y.all('.sidebox.on-page').each(function (item, index) {
+				var children = item.all('li a');
+				children.each(function (cItem, cIndex) {
+					return function () {
+						var handleClick = function (e) {
+							var node      = Y.one(this),
+								hash      = node.get(['hash']),
+								hashValue = hash.substring(1).split('_'),
+								type      = hashValue.shift(),
+								ogKey     = hashValue.join('_'); // in case the hash had other underscores
+							if (tabviewIndexTable[type] > -1 && tabviewIndexTable[type] !== currentTab) {
+								currentTab = tabviewIndexTable[type];
+								tabview.selectChild(tabviewIndexTable[type]);
+							}
+						}
+						Y.on('click', handleClick, cItem)
+					}()
+				})
+			});
+        }
+    }
+});
 
=== added file '0.1/ambiance/js/yuidoc-theme/assets/js/yui-prettify.js'
--- 0.1/ambiance/js/yuidoc-theme/assets/js/yui-prettify.js	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/js/yui-prettify.js	2013-11-01 20:18:13 +0000
@@ -0,0 +1,44 @@
+/*
+ * Copyright 2011 Yahoo! Inc.
+ * All rights reserved.
+ *-
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *     * Redistributions of source code must retain the above copyright
+ *       notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in the
+ *       documentation and/or other materials provided with the distribution.
+ *     * Neither the name of the Yahoo! Inc. nor the
+ *       names of its contributors may be used to endorse or promote products
+ *       derived from this software without specific prior written permission.
+ *-
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL YAHOO! INC. BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+YUI().use('node', function(Y) {
+    var code = Y.all('.prettyprint.linenums');
+    if (code.size()) {
+        code.each(function(c) {
+            var lis = c.all('ol li'),
+                l = 1;
+            lis.each(function(n) {
+                n.prepend('<a name="LINENUM_' + l + '"></a>');
+                l++;
+            });
+        });
+        var h = location.hash;
+        location.hash = '';
+        h = h.replace('LINE_', 'LINENUM_');
+        location.hash = h;
+    }
+});
 
=== added directory '0.1/ambiance/js/yuidoc-theme/assets/vendor'
=== added directory '0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify'
=== added file '0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/CHANGES.html'
--- 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/CHANGES.html	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/CHANGES.html	2013-11-01 20:18:13 +0000
@@ -0,0 +1,130 @@
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <title>Change Log</title>
+  </head>
+  <body bgcolor="white">
+    <a style="float:right" href="README.html">README</a>
+
+    <h1>Known Issues</h1>
+    <ul>
+      <li>Perl formatting is really crappy.  Partly because the author is lazy and
+      partly because Perl is
+      <a href="http://www.perlmonks.org/?node_id=663393">hard</a> to parse.
+      <li>On some browsers, <code>&lt;code&gt;</code> elements with newlines in the text
+      which use CSS to specify <code>white-space:pre</code> will have the newlines
+      improperly stripped if the element is not attached to the document at the time
+      the stripping is done.  Also, on IE 6, all newlines will be stripped from
+      <code>&lt;code&gt;</code> elements because of the way IE6 produces
+      <code>innerHTML</code>.  Workaround: use <code>&lt;pre&gt;</code> for code with
+      newlines.
+    </ul>
+
+    <h1>Change Log</h1>
+    <h2>29 March 2007</h2>
+    <ul>
+      <li>Added <a href="tests/prettify_test.html#PHP">tests</a> for PHP support
+        to address 
+      <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=3"
+       >issue 3</a>.
+      <li>Fixed
+      <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=6"
+       >bug</a>: <code>prettyPrintOne</code> was not halting.  This was not
+        reachable through the normal entry point.
+      <li>Fixed
+      <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=4"
+       >bug</a>: recursing into a script block or PHP tag that was not properly
+        closed would not silently drop the content.
+        (<a href="tests/prettify_test.html#issue4">test</a>)
+      <li>Fixed
+      <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=8"
+       >bug</a>: was eating tabs
+        (<a href="tests/prettify_test.html#issue8">test</a>)
+      <li>Fixed entity handling so that the caveat
+        <blockquote>
+          <p>Caveats: please properly escape less-thans.  <tt>x&amp;lt;y</tt>
+          instead of <tt>x&lt;y</tt>, and use <tt>&quot;</tt> instead of 
+          <tt>&amp;quot;</tt> for string delimiters.</p>
+        </blockquote>
+        is no longer applicable.
+      <li>Added noisefree's C#
+      <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=4"
+       >patch</a>
+      <li>Added a <a href="http://google-code-prettify.googlecode.com/files/prettify-small.zip">distribution</a> that has comments and
+        whitespace removed to reduce download size from 45.5kB to 12.8kB.
+    </ul>
+    <h2>4 Jul 2008</h2>
+    <ul>
+      <li>Added <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=17">language specific formatters</a> that are triggered by the presence
+      of a <code>lang-&lt;language-file-extension&gt;</code></li>
+      <li>Fixed <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=29">bug</a>: python handling of <code>'''string'''</code>
+      <li>Fixed bug: <code>/</code> in regex <code>[charsets] should not end regex</code>
+    </ul>
+    <h2>5 Jul 2008</h2>
+    <ul>
+      <li>Defined language extensions for Lisp and Lua</code>
+    </ul>
+    <h2>14 Jul 2008</h2>
+    <ul>
+      <li>Language handlers for F#, OCAML, SQL</code>
+      <li>Support for <code>nocode</code> spans to allow embedding of line
+      numbers and code annotations which should not be styled or otherwise
+      affect the tokenization of prettified code.
+      See the issue 22
+      <a href="tests/prettify_test.html#issue22">testcase</a>.</code>
+    </ul>
+    <h2>6 Jan 2009</h2>
+    <ul>
+      <li>Language handlers for Visual Basic, Haskell, CSS, and WikiText</li>
+      <li>Added <tt>.mxml</tt> extension to the markup style handler for
+        Flex <a href="http://en.wikipedia.org/wiki/MXML">MXML files</a>.  See
+        <a
+        href="http://code.google.com/p/google-code-prettify/issues/detail?id=37"
+        >issue 37</a>.
+      <li>Added <tt>.m</tt> extension to the C style handler so that Objective
+        C source files properly highlight.  See
+        <a
+        href="http://code.google.com/p/google-code-prettify/issues/detail?id=58"
+       >issue 58</a>.
+      <li>Changed HTML lexer to use the same embedded source mechanism as the
+        wiki language handler, and changed to use the registered
+        CSS handler for STYLE element content.
+    </ul>
+    <h2>21 May 2009</h2>
+    <ul>
+      <li>Rewrote to improve performance on large files.
+        See <a href="http://mikesamuel.blogspot.com/2009/05/efficient-parsing-in-javascript.html">benchmarks</a>.</li>
+      <li>Fixed bugs with highlighting of Haskell line comments, Lisp
+        number literals, Lua strings, C preprocessor directives,
+        newlines in Wiki code on Windows, and newlines in IE6.</li>
+    </ul>
+    <h2>14 August 2009</h2>
+    <ul>
+      <li>Fixed prettifying of <code>&lt;code&gt;</code> blocks with embedded newlines.
+    </ul>
+    <h2>3 October 2009</h2>
+    <ul>
+      <li>Fixed prettifying of XML/HTML tags that contain uppercase letters.
+    </ul>
+    <h2>19 July 2010</h2>
+    <ul>
+      <li>Added support for line numbers.  Bug
+        <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=22"
+         >22</a></li>
+      <li>Added YAML support.  Bug
+        <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=123"
+         >123</a></li>
+      <li>Added VHDL support courtesy Le Poussin.</li>
+      <li>IE performance improvements.  Bug
+        <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=102"
+         >102</a> courtesy jacobly.</li>
+      <li>A variety of markup formatting fixes courtesy smain and thezbyg.</li>
+      <li>Fixed copy and paste in IE[678].
+      <li>Changed output to use <code>&amp;#160;</code> instead of
+        <code>&amp;nbsp;</code> so that the output works when embedded in XML.
+        Bug
+        <a href="http://code.google.com/p/google-code-prettify/issues/detail?id=108"
+         >108</a>.</li>
+    </ul>
+  </body>
+</html>
 
=== added file '0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/COPYING'
--- 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/COPYING	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/COPYING	2013-11-01 20:18:13 +0000
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
 
=== added file '0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/README.html'
--- 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/README.html	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/README.html	2013-11-01 20:18:13 +0000
@@ -0,0 +1,203 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+  <head>
+    <title>Javascript code prettifier</title>
+
+    <link href="src/prettify.css" type="text/css" rel="stylesheet" />
+
+    <script src="src/prettify.js" type="text/javascript"></script>
+
+    <style type="text/css">
+      body { margin-left: .5in }
+      h1, h2, h3, h4, .footer { margin-left: -.4in; }
+    </style>
+  </head>
+
+  <body onload="prettyPrint()" bgcolor="white">
+    <small style="float: right">Languages : <a href="README-zh-Hans.html">CH</a></small>
+    <h1>Javascript code prettifier</h1>
+
+    <h2>Setup</h2>
+    <ol>
+      <li><a href="http://code.google.com/p/google-code-prettify/downloads/list">Download</a> a distribution
+      <li>Include the script and stylesheets in your document
+        (you will need to make sure the css and js file are on your server, and
+         adjust the paths in the <tt>script</tt> and <tt>link</tt> tag)
+        <pre class="prettyprint">
+&lt;link href="prettify.css" type="text/css" rel="stylesheet" />
+&lt;script type="text/javascript" src="prettify.js">&lt;/script></pre>
+      <li>Add <code class="prettyprint lang-html">onload="prettyPrint()"</code> to your
+      document's body tag.
+      <li>Modify the stylesheet to get the coloring you prefer</li>
+    </ol>
+
+    <h2>Usage</h2>
+    <p>Put code snippets in
+    <tt>&lt;pre class="prettyprint"&gt;...&lt;/pre&gt;</tt>
+    or <tt>&lt;code class="prettyprint"&gt;...&lt;/code&gt;</tt>
+    and it will automatically be pretty printed.
+
+    <table summary="code examples">
+      <tr>
+        <th>The original
+        <th>Prettier
+      <tr>
+        <td><pre style="border: 1px solid #888;padding: 2px"
+             ><a name="voila1"></a>class Voila {
+public:
+  // Voila
+  static const string VOILA = "Voila";
+
+  // will not interfere with embedded <a href="#voila1">tags</a>.
+}</pre>
+
+        <td><pre class="prettyprint"><a name="voila2"></a>class Voila {
+public:
+  // Voila
+  static const string VOILA = "Voila";
+
+  // will not interfere with embedded <a href="#voila2">tags</a>.
+}</pre>
+    </table>
+
+    <h2>FAQ</h2>
+    <h3 id="langs">Which languages does it work for?</h3>
+    <p>The comments in <tt>prettify.js</tt> are authoritative but the lexer
+    should work on a number of languages including C and friends,
+    Java, Python, Bash, SQL, HTML, XML, CSS, Javascript, and Makefiles.
+    It works passably on Ruby, PHP, VB, and Awk and a decent subset of Perl
+    and Ruby, but, because of commenting conventions, doesn't work on
+    Smalltalk, or CAML-like languages.</p>
+
+    <p>LISPy languages are supported via an extension:
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-lisp.js"
+     ><code>lang-lisp.js</code></a>.</p>
+    <p>And similarly for
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-css.js"
+     ><code>CSS</code></a>,
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-hs.js"
+     ><code>Haskell</code></a>,
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-lua.js"
+     ><code>Lua</code></a>,
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-ml.js"
+     ><code>OCAML, SML, F#</code></a>,
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-vb.js"
+     ><code>Visual Basic</code></a>,
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-sql.js"
+     ><code>SQL</code></a>,
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-proto.js"
+     ><code>Protocol Buffers</code></a>, and
+    <a href="http://code.google.com/p/google-code-prettify/source/browse/trunk/src/lang-wiki.js"
+     ><code>WikiText</code></a>..
+
+    <p>If you'd like to add an extension for your favorite language, please
+    look at <tt>src/lang-lisp.js</tt> and file an
+    <a href="http://code.google.com/p/google-code-prettify/issues/list"
+     >issue</a> including your language extension, and a testcase.</p>
+
+    <h3>How do I specify which language my code is in?</h3>
+    <p>You don't need to specify the language since <code>prettyprint()</code>
+    will guess.  You can specify a language by specifying the language extension
+    along with the <code>prettyprint</code> class like so:</p>
+    <pre class="prettyprint lang-html"
+>&lt;pre class=&quot;prettyprint <b>lang-html</b>&quot;&gt;
+  The lang-* class specifies the language file extensions.
+  File extensions supported by default include
+    "bsh", "c", "cc", "cpp", "cs", "csh", "cyc", "cv", "htm", "html",
+    "java", "js", "m", "mxml", "perl", "pl", "pm", "py", "rb", "sh",
+    "xhtml", "xml", "xsl".
+&lt;/pre&gt;</pre>
+
+    <h3>It doesn't work on <tt>&lt;obfuscated code sample&gt;</tt>?</h3>
+    <p>Yes.  Prettifying obfuscated code is like putting lipstick on a pig
+    &mdash; i.e. outside the scope of this tool.</p>
+
+    <h3>Which browsers does it work with?</h3>
+    <p>It's been tested with IE 6, Firefox 1.5 &amp; 2, and Safari 2.0.4.
+    Look at <a href="tests/prettify_test.html">the test page</a> to see if it
+    works in your browser.</p>
+
+    <h3>What's changed?</h3>
+    <p>See the <a href="CHANGES.html">change log</a></p>
+
+    <h3>Why doesn't Prettyprinting of strings work on WordPress?</h3>
+    <p>Apparently wordpress does "smart quoting" which changes close quotes.
+    This causes end quotes to not match up with open quotes.
+    <p>This breaks prettifying as well as copying and pasting of code samples.
+    See
+    <a href="http://wordpress.org/support/topic/125038"
+    >WordPress's help center</a> for info on how to stop smart quoting of code
+    snippets.</p>
+
+    <h3 id="linenums">How do I put line numbers in my code?</h3>
+    <p>You can use the <code>linenums</code> class to turn on line
+    numbering.  If your code doesn't start at line number 1, you can
+    add a colon and a line number to the end of that class as in
+    <code>linenums:52</code>.
+
+    <p>For example
+<pre class="prettyprint">&lt;pre class="prettyprint linenums:<b>4</b>"
+&gt;// This is line 4.
+foo();
+bar();
+baz();
+boo();
+far();
+faz();
+&lt;pre&gt;</pre>
+    produces
+<pre class="prettyprint linenums:4"
+>// This is line 4.
+foo();
+bar();
+baz();
+boo();
+far();
+faz();
+</pre>
+
+    <h3>How do I prevent a portion of markup from being marked as code?</h3>
+    <p>You can use the <code>nocode</code> class to identify a span of markup
+    that is not code.
+<pre class="prettyprint">&lt;pre class=prettyprint&gt;
+int x = foo();  /* This is a comment  &lt;span class="nocode"&gt;This is not code&lt;/span&gt;
+  Continuation of comment */
+int y = bar();
+&lt;/pre&gt;</pre>
+produces
+<pre class="prettyprint">
+int x = foo();  /* This is a comment  <span class="nocode">This is not code</span>
+  Continuation of comment */
+int y = bar();
+</pre>
+
+    <p>For a more complete example see the issue22
+    <a href="tests/prettify_test.html#issue22">testcase</a>.</p>
+
+    <h3>I get an error message "a is not a function" or "opt_whenDone is not a function"</h3>
+    <p>If you are calling <code>prettyPrint</code> via an event handler, wrap it in a function.
+    Instead of doing
+    <blockquote>
+      <code class="prettyprint lang-js"
+       >addEventListener('load', prettyPrint, false);</code>
+    </blockquote>
+    wrap it in a closure like
+    <blockquote>
+      <code class="prettyprint lang-js"
+       >addEventListener('load', function (event) { prettyPrint() }, false);</code>
+    </blockquote>
+    so that the browser does not pass an event object to <code>prettyPrint</code> which
+    will confuse it.
+
+    <br><br><br>
+
+    <div class="footer">
+<!-- Created: Tue Oct  3 17:51:56 PDT 2006 -->
+<!-- hhmts start -->
+Last modified: Wed Jul 19 13:56:00 PST 2010
+<!-- hhmts end -->
+    </div>
+  </body>
+</html>
 
=== added file '0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/prettify-min.css'
--- 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/prettify-min.css	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/prettify-min.css	2013-11-01 20:18:13 +0000
@@ -0,0 +1,1 @@
+.pln{color:#000}@media screen{.str{color:#080}.kwd{color:#008}.com{color:#800}.typ{color:#606}.lit{color:#066}.pun,.opn,.clo{color:#660}.tag{color:#008}.atn{color:#606}.atv{color:#080}.dec,.var{color:#606}.fun{color:red}}@media print,projection{.str{color:#060}.kwd{color:#006;font-weight:bold}.com{color:#600;font-style:italic}.typ{color:#404;font-weight:bold}.lit{color:#044}.pun,.opn,.clo{color:#440}.tag{color:#006;font-weight:bold}.atn{color:#404}.atv{color:#060}}pre.prettyprint{padding:2px;border:1px solid #888}ol.linenums{margin-top:0;margin-bottom:0}li.L0,li.L1,li.L2,li.L3,li.L5,li.L6,li.L7,li.L8{list-style-type:none}li.L1,li.L3,li.L5,li.L7,li.L9{background:#eee}
 \ No newline at end of file
 
=== added file '0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/prettify-min.js'
--- 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/prettify-min.js	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/assets/vendor/prettify/prettify-min.js	2013-11-01 20:18:13 +0000
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2011 Yahoo! Inc.
+ * All rights reserved.
+ *-
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *     * Redistributions of source code must retain the above copyright
+ *       notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in the
+ *       documentation and/or other materials provided with the distribution.
+ *     * Neither the name of the Yahoo! Inc. nor the
+ *       names of its contributors may be used to endorse or promote products
+ *       derived from this software without specific prior written permission.
+ *-
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL YAHOO! INC. BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+window.PR_SHOULD_USE_CONTINUATION=true;var prettyPrintOne;var prettyPrint;(function(){var O=window;var j=["break,continue,do,else,for,if,return,while"];var v=[j,"auto,case,char,const,default,double,enum,extern,float,goto,int,long,register,short,signed,sizeof,static,struct,switch,typedef,union,unsigned,void,volatile"];var q=[v,"catch,class,delete,false,import,new,operator,private,protected,public,this,throw,true,try,typeof"];var m=[q,"alignof,align_union,asm,axiom,bool,concept,concept_map,const_cast,constexpr,decltype,dynamic_cast,explicit,export,friend,inline,late_check,mutable,namespace,nullptr,reinterpret_cast,static_assert,static_cast,template,typeid,typename,using,virtual,where"];var y=[q,"abstract,boolean,byte,extends,final,finally,implements,import,instanceof,null,native,package,strictfp,super,synchronized,throws,transient"];var T=[y,"as,base,by,checked,decimal,delegate,descending,dynamic,event,fixed,foreach,from,group,implicit,in,interface,internal,into,is,let,lock,object,out,override,orderby,params,partial,readonly,ref,sbyte,sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort,var,virtual,where"];var s="all,and,by,catch,class,else,extends,false,finally,for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then,throw,true,try,unless,until,when,while,yes";var x=[q,"debugger,eval,export,function,get,null,set,undefined,var,with,Infinity,NaN"];var t="caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END";var J=[j,"and,as,assert,class,def,del,elif,except,exec,finally,from,global,import,in,is,lambda,nonlocal,not,or,pass,print,raise,try,with,yield,False,True,None"];var g=[j,"alias,and,begin,case,class,def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo,rescue,retry,self,super,then,true,undef,unless,until,when,yield,BEGIN,END"];var I=[j,"case,done,elif,esac,eval,fi,function,in,local,set,then,until"];var B=[m,T,x,t+J,g,I];var f=/^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float)\d*)\b/;var D="str";var A="kwd";var k="com";var Q="typ";var H="lit";var M="pun";var G="pln";var n="tag";var F="dec";var K="src";var R="atn";var o="atv";var P="nocode";var N="(?:^^\\.?|[+-]|[!=]=?=?|\\#|%=?|&&?=?|\\(|\\*=?|[+\\-]=|->|\\/=?|::?|<<?=?|>>?>?=?|,|;|\\?|@|\\[|~|{|\\^\\^?=?|\\|\\|?=?|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\\s*";function l(ab){var af=0;var U=false;var ae=false;for(var X=0,W=ab.length;X<W;++X){var ag=ab[X];if(ag.ignoreCase){ae=true}else{if(/[a-z]/i.test(ag.source.replace(/\\u[0-9a-f]{4}|\\x[0-9a-f]{2}|\\[^ux]/gi,""))){U=true;ae=false;break}}}var aa={b:8,t:9,n:10,v:11,f:12,r:13};function ad(aj){var ai=aj.charCodeAt(0);if(ai!==92){return ai}var ah=aj.charAt(1);ai=aa[ah];if(ai){return ai}else{if("0"<=ah&&ah<="7"){return parseInt(aj.substring(1),8)}else{if(ah==="u"||ah==="x"){return parseInt(aj.substring(2),16)}else{return aj.charCodeAt(1)}}}}function V(ah){if(ah<32){return(ah<16?"\\x0":"\\x")+ah.toString(16)}var ai=String.fromCharCode(ah);return(ai==="\\"||ai==="-"||ai==="]"||ai==="^")?"\\"+ai:ai}function Z(an){var ar=an.substring(1,an.length-1).match(new RegExp("\\\\u[0-9A-Fa-f]{4}|\\\\x[0-9A-Fa-f]{2}|\\\\[0-3][0-7]{0,2}|\\\\[0-7]{1,2}|\\\\[\\s\\S]|-|[^-\\\\]","g"));var ah=[];var ap=ar[0]==="^";var ao=["["];if(ap){ao.push("^")}for(var at=ap?1:0,al=ar.length;at<al;++at){var aj=ar[at];if(/\\[bdsw]/i.test(aj)){ao.push(aj)}else{var ai=ad(aj);var am;if(at+2<al&&"-"===ar[at+1]){am=ad(ar[at+2]);at+=2}else{am=ai}ah.push([ai,am]);if(!(am<65||ai>122)){if(!(am<65||ai>90)){ah.push([Math.max(65,ai)|32,Math.min(am,90)|32])}if(!(am<97||ai>122)){ah.push([Math.max(97,ai)&~32,Math.min(am,122)&~32])}}}}ah.sort(function(aw,av){return(aw[0]-av[0])||(av[1]-aw[1])});var ak=[];var aq=[];for(var at=0;at<ah.length;++at){var au=ah[at];if(au[0]<=aq[1]+1){aq[1]=Math.max(aq[1],au[1])}else{ak.push(aq=au)}}for(var at=0;at<ak.length;++at){var au=ak[at];ao.push(V(au[0]));if(au[1]>au[0]){if(au[1]+1>au[0]){ao.push("-")}ao.push(V(au[1]))}}ao.push("]");return ao.join("")}function Y(an){var al=an.source.match(new RegExp("(?:\\[(?:[^\\x5C\\x5D]|\\\\[\\s\\S])*\\]|\\\\u[A-Fa-f0-9]{4}|\\\\x[A-Fa-f0-9]{2}|\\\\[0-9]+|\\\\[^ux0-9]|\\(\\?[:!=]|[\\(\\)\\^]|[^\\x5B\\x5C\\(\\)\\^]+)","g"));var aj=al.length;var ap=[];for(var am=0,ao=0;am<aj;++am){var ai=al[am];if(ai==="("){++ao}else{if("\\"===ai.charAt(0)){var ah=+ai.substring(1);if(ah){if(ah<=ao){ap[ah]=-1}else{al[am]=V(ah)}}}}}for(var am=1;am<ap.length;++am){if(-1===ap[am]){ap[am]=++af}}for(var am=0,ao=0;am<aj;++am){var ai=al[am];if(ai==="("){++ao;if(!ap[ao]){al[am]="(?:"}}else{if("\\"===ai.charAt(0)){var ah=+ai.substring(1);if(ah&&ah<=ao){al[am]="\\"+ap[ah]}}}}for(var am=0;am<aj;++am){if("^"===al[am]&&"^"!==al[am+1]){al[am]=""}}if(an.ignoreCase&&U){for(var am=0;am<aj;++am){var ai=al[am];var ak=ai.charAt(0);if(ai.length>=2&&ak==="["){al[am]=Z(ai)}else{if(ak!=="\\"){al[am]=ai.replace(/[a-zA-Z]/g,function(aq){var ar=aq.charCodeAt(0);return"["+String.fromCharCode(ar&~32,ar|32)+"]"})}}}}return al.join("")}var ac=[];for(var X=0,W=ab.length;X<W;++X){var ag=ab[X];if(ag.global||ag.multiline){throw new Error(""+ag)}ac.push("(?:"+Y(ag)+")")}return new RegExp(ac.join("|"),ae?"gi":"g")}function b(aa,Y){var W=/(?:^|\s)nocode(?:\s|$)/;var ab=[];var Z=0;var X=[];var V=0;function U(ac){switch(ac.nodeType){case 1:if(W.test(ac.className)){return}for(var af=ac.firstChild;af;af=af.nextSibling){U(af)}var ae=ac.nodeName.toLowerCase();if("br"===ae||"li"===ae){ab[V]="\n";X[V<<1]=Z++;X[(V++<<1)|1]=ac}break;case 3:case 4:var ad=ac.nodeValue;if(ad.length){if(!Y){ad=ad.replace(/[ \t\r\n]+/g," ")}else{ad=ad.replace(/\r\n?/g,"\n")}ab[V]=ad;X[V<<1]=Z;Z+=ad.length;X[(V++<<1)|1]=ac}break}}U(aa);return{sourceCode:ab.join("").replace(/\n$/,""),spans:X}}function C(U,W,Y,V){if(!W){return}var X={sourceCode:W,basePos:U};Y(X);V.push.apply(V,X.decorations)}var w=/\S/;function p(U){var X=undefined;for(var W=U.firstChild;W;W=W.nextSibling){var V=W.nodeType;X=(V===1)?(X?U:W):(V===3)?(w.test(W.nodeValue)?U:X):X}return X===U?undefined:X}function h(W,V){var U={};var X;(function(){var af=W.concat(V);var aj=[];var ai={};for(var ad=0,ab=af.length;ad<ab;++ad){var aa=af[ad];var ae=aa[3];if(ae){for(var ag=ae.length;--ag>=0;){U[ae.charAt(ag)]=aa}}var ah=aa[1];var ac=""+ah;if(!ai.hasOwnProperty(ac)){aj.push(ah);ai[ac]=null}}aj.push(/[\0-\uffff]/);X=l(aj)})();var Z=V.length;var Y=function(aj){var ab=aj.sourceCode,aa=aj.basePos;var af=[aa,G];var ah=0;var ap=ab.match(X)||[];var al={};for(var ag=0,at=ap.length;ag<at;++ag){var ai=ap[ag];var ar=al[ai];var ak=void 0;var ao;if(typeof ar==="string"){ao=false}else{var ac=U[ai.charAt(0)];if(ac){ak=ai.match(ac[1]);ar=ac[0]}else{for(var aq=0;aq<Z;++aq){ac=V[aq];ak=ai.match(ac[1]);if(ak){ar=ac[0];break}}if(!ak){ar=G}}ao=ar.length>=5&&"lang-"===ar.substring(0,5);if(ao&&!(ak&&typeof ak[1]==="string")){ao=false;ar=K}if(!ao){al[ai]=ar}}var ad=ah;ah+=ai.length;if(!ao){af.push(aa+ad,ar)}else{var an=ak[1];var am=ai.indexOf(an);var ae=am+an.length;if(ak[2]){ae=ai.length-ak[2].length;am=ae-an.length}var au=ar.substring(5);C(aa+ad,ai.substring(0,am),Y,af);C(aa+ad+am,an,r(au,an),af);C(aa+ad+ae,ai.substring(ae),Y,af)}}aj.decorations=af};return Y}function i(V){var Y=[],U=[];if(V.tripleQuotedStrings){Y.push([D,/^(?:\'\'\'(?:[^\'\\]|\\[\s\S]|\'{1,2}(?=[^\']))*(?:\'\'\'|$)|\"\"\"(?:[^\"\\]|\\[\s\S]|\"{1,2}(?=[^\"]))*(?:\"\"\"|$)|\'(?:[^\\\']|\\[\s\S])*(?:\'|$)|\"(?:[^\\\"]|\\[\s\S])*(?:\"|$))/,null,"'\""])}else{if(V.multiLineStrings){Y.push([D,/^(?:\'(?:[^\\\']|\\[\s\S])*(?:\'|$)|\"(?:[^\\\"]|\\[\s\S])*(?:\"|$)|\`(?:[^\\\`]|\\[\s\S])*(?:\`|$))/,null,"'\"`"])}else{Y.push([D,/^(?:\'(?:[^\\\'\r\n]|\\.)*(?:\'|$)|\"(?:[^\\\"\r\n]|\\.)*(?:\"|$))/,null,"\"'"])}}if(V.verbatimStrings){U.push([D,/^@\"(?:[^\"]|\"\")*(?:\"|$)/,null])}var ab=V.hashComments;if(ab){if(V.cStyleComments){if(ab>1){Y.push([k,/^#(?:##(?:[^#]|#(?!##))*(?:###|$)|.*)/,null,"#"])}else{Y.push([k,/^#(?:(?:define|e(?:l|nd)if|else|error|ifn?def|include|line|pragma|undef|warning)\b|[^\r\n]*)/,null,"#"])}U.push([D,/^<(?:(?:(?:\.\.\/)*|\/?)(?:[\w-]+(?:\/[\w-]+)+)?[\w-]+\.h(?:h|pp|\+\+)?|[a-z]\w*)>/,null])}else{Y.push([k,/^#[^\r\n]*/,null,"#"])}}if(V.cStyleComments){U.push([k,/^\/\/[^\r\n]*/,null]);U.push([k,/^\/\*[\s\S]*?(?:\*\/|$)/,null])}if(V.regexLiterals){var aa=("/(?=[^/*])(?:[^/\\x5B\\x5C]|\\x5C[\\s\\S]|\\x5B(?:[^\\x5C\\x5D]|\\x5C[\\s\\S])*(?:\\x5D|$))+/");U.push(["lang-regex",new RegExp("^"+N+"("+aa+")")])}var X=V.types;if(X){U.push([Q,X])}var W=(""+V.keywords).replace(/^ | $/g,"");if(W.length){U.push([A,new RegExp("^(?:"+W.replace(/[\s,]+/g,"|")+")\\b"),null])}Y.push([G,/^\s+/,null," \r\n\t\xA0"]);var Z=/^.[^\s\w\.$@\'\"\`\/\\]*/;U.push([H,/^@[a-z_$][a-z_$@0-9]*/i,null],[Q,/^(?:[@_]?[A-Z]+[a-z][A-Za-z_$@0-9]*|\w+_t\b)/,null],[G,/^[a-z_$][a-z_$@0-9]*/i,null],[H,new RegExp("^(?:0x[a-f0-9]+|(?:\\d(?:_\\d+)*\\d*(?:\\.\\d*)?|\\.\\d\\+)(?:e[+\\-]?\\d+)?)[a-z]*","i"),null,"0123456789"],[G,/^\\[\s\S]?/,null],[M,Z,null]);return h(Y,U)}var L=i({keywords:B,hashComments:true,cStyleComments:true,multiLineStrings:true,regexLiterals:true});function S(W,ah,aa){var V=/(?:^|\s)nocode(?:\s|$)/;var ac=/\r\n?|\n/;var ad=W.ownerDocument;var ag=ad.createElement("li");while(W.firstChild){ag.appendChild(W.firstChild)}var X=[ag];function af(am){switch(am.nodeType){case 1:if(V.test(am.className)){break}if("br"===am.nodeName){ae(am);if(am.parentNode){am.parentNode.removeChild(am)}}else{for(var ao=am.firstChild;ao;ao=ao.nextSibling){af(ao)}}break;case 3:case 4:if(aa){var an=am.nodeValue;var ak=an.match(ac);if(ak){var aj=an.substring(0,ak.index);am.nodeValue=aj;var ai=an.substring(ak.index+ak[0].length);if(ai){var al=am.parentNode;al.insertBefore(ad.createTextNode(ai),am.nextSibling)}ae(am);if(!aj){am.parentNode.removeChild(am)}}}break}}function ae(al){while(!al.nextSibling){al=al.parentNode;if(!al){return}}function aj(am,at){var ar=at?am.cloneNode(false):am;var ap=am.parentNode;if(ap){var aq=aj(ap,1);var ao=am.nextSibling;aq.appendChild(ar);for(var an=ao;an;an=ao){ao=an.nextSibling;aq.appendChild(an)}}return ar}var ai=aj(al.nextSibling,0);for(var ak;(ak=ai.parentNode)&&ak.nodeType===1;){ai=ak}X.push(ai)}for(var Z=0;Z<X.length;++Z){af(X[Z])}if(ah===(ah|0)){X[0].setAttribute("value",ah)}var ab=ad.createElement("ol");ab.className="linenums";var Y=Math.max(0,((ah-1))|0)||0;for(var Z=0,U=X.length;Z<U;++Z){ag=X[Z];ag.className="L"+((Z+Y)%10);if(!ag.firstChild){ag.appendChild(ad.createTextNode("\xA0"))}ab.appendChild(ag)}W.appendChild(ab)}function E(af){var X=/\bMSIE\s(\d+)/.exec(navigator.userAgent);X=X&&+X[1]<=8;var ao=/\n/g;var an=af.sourceCode;var ap=an.length;var Y=0;var ad=af.spans;var V=ad.length;var aj=0;var aa=af.decorations;var ab=aa.length;var ac=0;aa[ab]=ap;var av,at;for(at=av=0;at<ab;){if(aa[at]!==aa[at+2]){aa[av++]=aa[at++];aa[av++]=aa[at++]}else{at+=2}}ab=av;for(at=av=0;at<ab;){var aw=aa[at];var ae=aa[at+1];var Z=at+2;while(Z+2<=ab&&aa[Z+1]===ae){Z+=2}aa[av++]=aw;aa[av++]=ae;at=Z}ab=aa.length=av;var au=af.sourceNode;var ak;if(au){ak=au.style.display;au.style.display="none"}try{var ah=null;while(aj<V){var ai=ad[aj];var U=ad[aj+2]||ap;var ar=aa[ac+2]||ap;var Z=Math.min(U,ar);var am=ad[aj+1];var W;if(am.nodeType!==1&&(W=an.substring(Y,Z))){if(X){W=W.replace(ao,"\r")}am.nodeValue=W;var al=am.ownerDocument;var aq=al.createElement("span");aq.className=aa[ac+1];var ag=am.parentNode;ag.replaceChild(aq,am);aq.appendChild(am);if(Y<U){ad[aj+1]=am=al.createTextNode(an.substring(Z,U));ag.insertBefore(am,aq.nextSibling)}}Y=Z;if(Y>=U){aj+=2}if(Y>=ar){ac+=2}}}finally{if(au){au.style.display=ak}}}var u={};function d(W,X){for(var U=X.length;--U>=0;){var V=X[U];if(!u.hasOwnProperty(V)){u[V]=W}else{if(O.console){console.warn("cannot override language handler %s",V)}}}}function r(V,U){if(!(V&&u.hasOwnProperty(V))){V=/^\s*</.test(U)?"default-markup":"default-code"}return u[V]}d(L,["default-code"]);d(h([],[[G,/^[^<?]+/],[F,/^<!\w[^>]*(?:>|$)/],[k,/^<\!--[\s\S]*?(?:-\->|$)/],["lang-",/^<\?([\s\S]+?)(?:\?>|$)/],["lang-",/^<%([\s\S]+?)(?:%>|$)/],[M,/^(?:<[%?]|[%?]>)/],["lang-",/^<xmp\b[^>]*>([\s\S]+?)<\/xmp\b[^>]*>/i],["lang-js",/^<script\b[^>]*>([\s\S]*?)(<\/script\b[^>]*>)/i],["lang-css",/^<style\b[^>]*>([\s\S]*?)(<\/style\b[^>]*>)/i],["lang-in.tag",/^(<\/?[a-z][^<>]*>)/i]]),["default-markup","htm","html","mxml","xhtml","xml","xsl"]);d(h([[G,/^[\s]+/,null," \t\r\n"],[o,/^(?:\"[^\"]*\"?|\'[^\']*\'?)/,null,"\"'"]],[[n,/^^<\/?[a-z](?:[\w.:-]*\w)?|\/?>$/i],[R,/^(?!style[\s=]|on)[a-z](?:[\w:-]*\w)?/i],["lang-uq.val",/^=\s*([^>\'\"\s]*(?:[^>\'\"\s\/]|\/(?=\s)))/],[M,/^[=<>\/]+/],["lang-js",/^on\w+\s*=\s*\"([^\"]+)\"/i],["lang-js",/^on\w+\s*=\s*\'([^\']+)\'/i],["lang-js",/^on\w+\s*=\s*([^\"\'>\s]+)/i],["lang-css",/^style\s*=\s*\"([^\"]+)\"/i],["lang-css",/^style\s*=\s*\'([^\']+)\'/i],["lang-css",/^style\s*=\s*([^\"\'>\s]+)/i]]),["in.tag"]);d(h([],[[o,/^[\s\S]+/]]),["uq.val"]);d(i({keywords:m,hashComments:true,cStyleComments:true,types:f}),["c","cc","cpp","cxx","cyc","m"]);d(i({keywords:"null,true,false"}),["json"]);d(i({keywords:T,hashComments:true,cStyleComments:true,verbatimStrings:true,types:f}),["cs"]);d(i({keywords:y,cStyleComments:true}),["java"]);d(i({keywords:I,hashComments:true,multiLineStrings:true}),["bsh","csh","sh"]);d(i({keywords:J,hashComments:true,multiLineStrings:true,tripleQuotedStrings:true}),["cv","py"]);d(i({keywords:t,hashComments:true,multiLineStrings:true,regexLiterals:true}),["perl","pl","pm"]);d(i({keywords:g,hashComments:true,multiLineStrings:true,regexLiterals:true}),["rb"]);d(i({keywords:x,cStyleComments:true,regexLiterals:true}),["js"]);d(i({keywords:s,hashComments:3,cStyleComments:true,multilineStrings:true,tripleQuotedStrings:true,regexLiterals:true}),["coffee"]);d(h([],[[D,/^[\s\S]+/]]),["regex"]);function e(X){var W=X.langExtension;try{var U=b(X.sourceNode,X.pre);var V=U.sourceCode;X.sourceCode=V;X.spans=U.spans;X.basePos=0;r(W,V)(X);E(X)}catch(Y){if(O.console){console.log(Y&&Y.stack?Y.stack:Y)}}}function z(Y,X,W){var U=document.createElement("pre");U.innerHTML=Y;if(W){S(U,W,true)}var V={langExtension:X,numberLines:W,sourceNode:U,pre:1};e(V);return U.innerHTML}function c(aj){function ab(al){return document.getElementsByTagName(al)}var ah=[ab("pre"),ab("code"),ab("xmp")];var V=[];for(var ae=0;ae<ah.length;++ae){for(var ac=0,Y=ah[ae].length;ac<Y;++ac){V.push(ah[ae][ac])}}ah=null;var Z=Date;if(!Z.now){Z={now:function(){return +(new Date)}}}var aa=0;var U;var af=/\blang(?:uage)?-([\w.]+)(?!\S)/;var ak=/\bprettyprint\b/;var W=/\bprettyprinted\b/;var ag=/pre|xmp/i;var ai=/^code$/i;var ad=/^(?:pre|code|xmp)$/i;function X(){var ar=(O.PR_SHOULD_USE_CONTINUATION?Z.now()+250:Infinity);for(;aa<V.length&&Z.now()<ar;aa++){var at=V[aa];var au=at.className;if(ak.test(au)&&!W.test(au)){var aw=false;for(var ao=at.parentNode;ao;ao=ao.parentNode){var ax=ao.tagName;if(ad.test(ax)&&ao.className&&ak.test(ao.className)){aw=true;break}}if(!aw){at.className+=" prettyprinted";var aq=au.match(af);var am;if(!aq&&(am=p(at))&&ai.test(am.tagName)){aq=am.className.match(af)}if(aq){aq=aq[1]}var ap;if(ag.test(at.tagName)){ap=1}else{var an=at.currentStyle;var al=(an?an.whiteSpace:(document.defaultView&&document.defaultView.getComputedStyle)?document.defaultView.getComputedStyle(at,null).getPropertyValue("white-space"):0);ap=al&&"pre"===al.substring(0,3)}var av=at.className.match(/\blinenums\b(?::(\d+))?/);av=av?av[1]&&av[1].length?+av[1]:true:false;if(av){S(at,av,ap)}U={langExtension:aq,sourceNode:at,numberLines:av,pre:ap};e(U)}}}if(aa<V.length){setTimeout(X,250)}else{if(aj){aj()}}}X()}var a=O.PR={createSimpleLexer:h,registerLangHandler:d,sourceDecorator:i,PR_ATTRIB_NAME:R,PR_ATTRIB_VALUE:o,PR_COMMENT:k,PR_DECLARATION:F,PR_KEYWORD:A,PR_LITERAL:H,PR_NOCODE:P,PR_PLAIN:G,PR_PUNCTUATION:M,PR_SOURCE:K,PR_STRING:D,PR_TAG:n,PR_TYPE:Q,prettyPrintOne:O.prettyPrintOne=z,prettyPrint:O.prettyPrint=c};if(typeof define==="function"&&define.amd){define("google-code-prettify",[],function(){return a})}})();PR.registerLangHandler(PR.createSimpleLexer([],[[PR.PR_DECLARATION,/^<!\w[^>]*(?:>|$)/],[PR.PR_COMMENT,/^<\!--[\s\S]*?(?:-\->|$)/],[PR.PR_PUNCTUATION,/^(?:<[%?]|[%?]>)/],["lang-",/^<\?([\s\S]+?)(?:\?>|$)/],["lang-",/^<%([\s\S]+?)(?:%>|$)/],["lang-",/^<xmp\b[^>]*>([\s\S]+?)<\/xmp\b[^>]*>/i],["lang-handlebars",/^<script\b[^>]*type\s*=\s*['"]?text\/x-handlebars-template['"]?\b[^>]*>([\s\S]*?)(<\/script\b[^>]*>)/i],["lang-js",/^<script\b[^>]*>([\s\S]*?)(<\/script\b[^>]*>)/i],["lang-css",/^<style\b[^>]*>([\s\S]*?)(<\/style\b[^>]*>)/i],["lang-in.tag",/^(<\/?[a-z][^<>]*>)/i],[PR.PR_DECLARATION,/^{{[#^>/]?\s*[\w.][^}]*}}/],[PR.PR_DECLARATION,/^{{&?\s*[\w.][^}]*}}/],[PR.PR_DECLARATION,/^{{{>?\s*[\w.][^}]*}}}/],[PR.PR_COMMENT,/^{{![^}]*}}/]]),["handlebars","hbs"]);PR.registerLangHandler(PR.createSimpleLexer([[PR.PR_PLAIN,/^[ \t\r\n\f]+/,null," \t\r\n\f"]],[[PR.PR_STRING,/^\"(?:[^\n\r\f\\\"]|\\(?:\r\n?|\n|\f)|\\[\s\S])*\"/,null],[PR.PR_STRING,/^\'(?:[^\n\r\f\\\']|\\(?:\r\n?|\n|\f)|\\[\s\S])*\'/,null],["lang-css-str",/^url\(([^\)\"\']*)\)/i],[PR.PR_KEYWORD,/^(?:url|rgb|\!important|@import|@page|@media|@charset|inherit)(?=[^\-\w]|$)/i,null],["lang-css-kw",/^(-?(?:[_a-z]|(?:\\[0-9a-f]+ ?))(?:[_a-z0-9\-]|\\(?:\\[0-9a-f]+ ?))*)\s*:/i],[PR.PR_COMMENT,/^\/\*[^*]*\*+(?:[^\/*][^*]*\*+)*\//],[PR.PR_COMMENT,/^(?:<!--|-->)/],[PR.PR_LITERAL,/^(?:\d+|\d*\.\d+)(?:%|[a-z]+)?/i],[PR.PR_LITERAL,/^#(?:[0-9a-f]{3}){1,2}/i],[PR.PR_PLAIN,/^-?(?:[_a-z]|(?:\\[\da-f]+ ?))(?:[_a-z\d\-]|\\(?:\\[\da-f]+ ?))*/i],[PR.PR_PUNCTUATION,/^[^\s\w\'\"]+/]]),["css"]);PR.registerLangHandler(PR.createSimpleLexer([],[[PR.PR_KEYWORD,/^-?(?:[_a-z]|(?:\\[\da-f]+ ?))(?:[_a-z\d\-]|\\(?:\\[\da-f]+ ?))*/i]]),["css-kw"]);PR.registerLangHandler(PR.createSimpleLexer([],[[PR.PR_STRING,/^[^\)\"\']+/]]),["css-str"]);
 
=== added directory '0.1/ambiance/js/yuidoc-theme/layouts'
=== added file '0.1/ambiance/js/yuidoc-theme/layouts/main.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/layouts/main.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/layouts/main.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>{{htmlTitle}}</title>
+    <link rel="stylesheet" href="{{yuiGridsUrl}}">
+    <link rel="stylesheet" href="{{projectAssets}}/vendor/prettify/prettify-min.css">
+    <link rel="stylesheet" href="{{projectAssets}}/css/main.css" id="site_styles">
+    <script src="{{yuiSeedUrl}}"></script>
+</head>
+<body class="yui3-skin-sam">
+
+<div id="doc">
+    <div id="hd" class="yui3-g header">
+        <div class="yui3-u-3-4">
+            <h1><a href="{{projectRoot}}index.html"><img src="{{projectAssets}}/css/logo.png">{{title}}</a></h1>
+        </div>
+        <div class="yui3-u-1-4 version">
+            <em>API Docs for: {{projectVersion}}</em>
+        </div>
+    </div>
+    <div class="yui3-g">
+
+        <div id="sidebar" class="yui3-u">
+            {{>sidebar}}
+        </div>
+
+        <div id="main" class="yui3-u">
+            <div class="content">{{>layout_content}}</div>
+        </div>
+    </div>
+</div>
+<script src="{{projectAssets}}/vendor/prettify/prettify-min.js"></script>
+<script>prettyPrint();</script>
+<script src="{{projectAssets}}/js/yui-prettify.js"></script>
+<script src="{{projectAssets}}/js/tabs.js"></script>
+</body>
+</html>
 
=== added directory '0.1/ambiance/js/yuidoc-theme/partials'
=== added file '0.1/ambiance/js/yuidoc-theme/partials/attrs.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/attrs.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/attrs.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,23 @@
+<a name="attrs_{{name}}"></a>
+<div class="attrs item">
+    `{{name}}` {{#if type}}<strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong>{{/if}}
+    {{#if extended_from}}<em>`/* Extended from {{extended_from}} */`</em>{{/if}}
+    {{#if overwritten_from}}<em>`/* Overwritten from {{name}} */`</em>{{/if}}
+    <br>
+    <span class="foundat"><a href="../{{foundAt}}">`{{file}}:{{line}}`</a></span>
+    {{{attrDescription}}}
+    {{#if emit}}
+    <div class="emits">
+        Fires: <strong>`{{name}}Change(e)`</strong>
+        <p>Fires when the value for the configuration attribute `{{name}}` is changed. You can listen for the event using the `on` method if you wish to be notified before the attribute's value has changed, or using the `after` method if you wish to be notified after the attribute's value has changed.</p>
+        <strong>Parameters:</strong><br>
+        `e` <strong>&lt;EventFacade&gt;</strong> An Event Facade object with the following attribute specific properties added:
+        <ul>
+            <li>`prevVal` The value of the attribute, prior to it being set</li>
+            <li>`newVal` The value the attribute is to be set to</li>
+            <li>`attrName` The name of the attribute being set</li>
+            <li>`subAttrName` If setting a property within the attribute's value, the name of the sub-attribute property being set</li>
+        </ul>
+    </div>
+    {{/if}}
+</div>
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/classes.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/classes.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/classes.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,73 @@
+<h4>Class {{moduleName}}</h4>
+{{#if uses}}
+    Uses:
+    {{#each uses}}
+        <a href="{{this}}.html">{{this}}</a>
+    {{/each}}
+    <br>
+{{/if}}
+{{#if extension_for}}
+    Extension For:
+    {{#each extension_for}}
+        <a href="{{this}}.html">{{this}}</a>
+    {{/each}}
+    <br>
+{{/if}}
+{{#if extends}}
+    Extends: {{#crossLink extends}}{{/crossLink}}<br>
+{{/if}}
+<span class="foundat">Class defined in: <a href="../{{foundAt}}">`{{file}}:{{line}}`</a></span>
+<div class="intro">{{{classDescription}}}</div>
+
+{{#if is_constructor}}
+    {{#is_constructor}}
+    {{>method}}
+    {{/is_constructor}}
+{{/if}}
+
+<div id="classdocs">
+    <ul>
+        {{#if methods}}
+        <li><a href="#methods">Methods</a></li>
+        {{/if}}
+        {{#if properties}}
+        <li><a href="#props">Properties</a></li>
+        {{/if}}
+        {{#if attrs}}
+        <li><a href="#attrs">Attributes</a></li>
+        {{/if}}
+        {{#if events}}
+        <li><a href="#events">Events</a></li>
+        {{/if}}
+    </ul>
+    <div>
+        {{#if methods}}
+            <div id="methods">
+            {{#methods}}
+                {{>method}}
+            {{/methods}}
+            </div>
+        {{/if}}
+        {{#if properties}}
+            <div id="props">
+            {{#properties}}
+                {{>props}}
+            {{/properties}}
+            </div>
+        {{/if}}
+        {{#if attrs}}
+            <div id="attrs">
+            {{#attrs}}
+                {{>attrs}}
+            {{/attrs}}
+            </div>
+        {{/if}}
+        {{#if events}}
+            <div id="events">
+            {{#events}}
+                {{>events}}
+            {{/events}}
+            </div>
+        {{/if}}
+    </div>
+</div>
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/events.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/events.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/events.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,35 @@
+<a name="events_{{name}}"></a>
+<div class="events item">
+    `{{name}}` {{#if type}}<strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong>{{/if}}
+    {{#if extended_from}}<em>`/* Extended from {{extended_from}} */</em>`{{/if}}
+    {{#if overwritten_from}}<em>`/* Overwritten from {{name}} */`</em>{{/if}}
+    <br>
+    <span class="foundat"><a href="../{{foundAt}}">`{{file}}:{{line}}`</a></span>
+    {{{eventDescription}}}
+    {{#if params}}
+    <strong>Extra event object properties:</strong>
+    <ul>
+    {{#params}}
+        <li>
+        {{#if optional}}
+            `[{{name}}{{#if optdefault}}={{optdefault}}{{/if}}]` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong>
+        {{else}}
+            `{{name}}` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong>
+        {{/if}}
+        {{#if multiple}}
+            <abbr title="Denotes that this argument can contain (n) number">(*..n)</abbr>
+        {{/if}}
+        {{{description}}}
+            {{#if props}}
+            <ul>
+            {{#props}}
+                <li>`{{name}}` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong> {{{description}}}
+            {{/props}}
+            </ul>
+            {{/if}}
+        </li>
+    {{/params}}
+    </ul>
+    {{/if}}
+</div>
+
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/files.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/files.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/files.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,6 @@
+<h4>{{fileName}}</h4>
+
+<pre class="code prettyprint linenums">
+{{fileData}}
+</pre>
+
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/index.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/index.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/index.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,54 @@
+<h4>Welcome to Ubuntu HTML5 API Docs version 0.1</h4>
+
+<p>These pages provide reference docs for the Ubunbtu HTML5 framework.</p>
+
+<p>See <a href="http://developer.ubuntu.com">developer.ubuntu.com</a> for more information on writing Ubuntu HTML5 apps, including: using the Ubuntu SDK, creating HTML5 app projects, importing Ubuntu HTML5 CSS and JavaScript into your app, and more. </p>
+
+<h4>Ubuntu HTML5 widgets</h4>
+
+<p>The Ubuntun HTML5 framework provides a set of "widgets" you use to build an application in the Ubuntu style (see <a href="design.ubuntu.com">design.ubuntu.com</a> for descriptions of Ubuntu app "building blocks" with links to APIs for each supported implementation toolkit). For example, an Ubuntu HTML5 app has a dynamic Header with Tabs that together provide navigation through the app's Pages. Pages may contain Lists, Popovers, Buttons, Shapes, and a lot more. The app has a Footer (also called a Toolbar) to which you can add Buttons. There are many options and the list keeps growing!<p>
+<p>Each widget has its HTML part, a corresponding JavaScript object (many of which provide additional methods), and CSS styles.</p>
+
+<h4>What you need to know</h4>
+
+<p>To write Ubuntu HTML5 apps, you need to know:</p>
+
+<ul>
+  <li>How to <em>declare</em> each widget type in HTML</li>
+  <li>How to acces the JavaScript widget objects and use their methods</li>
+  <li>How to initialize the Ubuntu HTML5 framework at app load time</li>
+</ul>
+
+<p>These topics are introduced here and explained in the class documentation.</p>
+
+<h4>Elements and special attributes</h4>
+
+<p>Ubuntu HTML5 apps use normal HTML/HTML5 elements (like &lt;div&gt;, &lt;section&gt;, &lt;ul&gt;, and so on). However, special attributes are added to some key elements to declare them as Ubuntu HTML5 elements. This connects them with the Ubuntu HTML5 JavaScript framework. The <em>data-role</em> attribute is often used. Its value indicates the type of Ubuntu HTML5 element. For example, here's a button: &lt;div data-role="button"&gt;.</p>
+
+</p>Making correct HTML declarations is necessary to connect your DOM elements to the Ubuntu HTML5 JavaScript framework and to Ubuntu HTML CSS styles. See the JavaScript class docs for sample HTML declarations.</p>
+
+<h4><em>id</em> attributes</h4>
+
+<p>You can declare most Ubuntu HTML5 elements without <em>id</em> attributes. They will pick up the CSS styles and look fine. But, you generally need an <em>id</em> attribute to access the corresponding JavaScript objects. So it's a good idea to add them.</p>
+
+<h4>JavaScript classes and methods</h4>
+
+<p>Almost every Ubuntu HTML5 DOM element has a corresponding Ubuntu HTML5 JavaScript object. These are created automatically when you create an UbuntuUI object and execute its init() method. (This is usually done at startup, for example in the <em>window.onload</em> function).</p>
+
+<p>Many of these classes/objects have additional methods. For example, the List class provides methods to add items to the list, remove an item, apply a function to all items, and more.</p>
+
+<h4>How these docs are organized</h4>
+
+<p>These pages or organized by the Ubuntu HTML5 JavaScript classes. Each class has an example showing how the corresponding HTML is declared (as needed). And of course each class has API documentation explaining usage of all (public) methods.</p>
+
+<p>The single most important class is UbuntuUI, so start there.</p>
+
+<p>Then, an Ubuntu HTML5 app is structured as a PageStack of Pages, so be sure to visit those classes.</p>
+
+<h4>Ubuntu HTML5 CSS</h4>
+
+<p>Be sure to check out the Ubuntu HTML5 CSS files you import into your app. They provide a set of styles that theme the HTML5 widgets to the Ubuntu app design and style.</p>
+
+<h4>Let's grow this!</h4>
+
+<p>Let's work together to keep HTML5 as a top-notch app development framework on Ubuntu. Everyone can help by filing bugs, triaging them, and of course, fixing them. So let's get to work writing apps!</p>
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/method.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/method.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/method.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,56 @@
+<a name="methods_{{name}}"></a>
+<div class="method item{{#if access}} {{access}}{{/if}}">
+    {{#if final}}<code>final</code> {{/if}}{{#if returnType}}{{#crossLink returnType}}{{/crossLink}} {{/if}}<strong class="name">`{{name}}`</strong>( `{{paramsList}} ` ) {{#if access}}<em>`/* {{access}} method */`</em>{{/if}}
+    <br>
+    <span class="foundat">
+    {{#if overwritten_from}}
+        Defined in <a href="{{overwritten_from/class}}.html#method_{{overwritten_from/name}}">{{overwritten_from/class}}</a> but overwritten locally: 
+    {{else}}
+        {{#if extended_from}} Defined in <a href="{{extended_from}}.html#method_{{name}}">{{extended_from}}</a>: {{/if}}
+    {{/if}}
+        <a href="../{{foundAt}}">`{{file}}:{{line}}`</a>
+    </span><br>
+    {{{methodDescription}}}
+    {{#if params}}
+    <strong>Parameters:</strong>
+    <ul class="params">
+    {{#params}}
+        <li>
+        {{#if optional}}
+            `[{{name}}{{#if optdefault}}={{optdefault}}{{/if}}]` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong>
+        {{else}}
+            `{{name}}` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong>
+        {{/if}}
+        {{#if multiple}}
+            <abbr title="Denotes that this argument can contain (n) number">(*..n)</abbr>
+        {{/if}}
+        {{{description}}}
+            {{#if props}}
+            <ul>
+            {{#props}}
+                <li>`{{name}}` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong> {{{description}}}
+                {{#if props}}
+                    <ul>
+                        {{#props}}
+                            <li>`{{name}}` <strong>&lt;{{#crossLink type}}{{/crossLink}}&gt;</strong> {{{description}}} </li>
+                        {{/props}}
+                    </ul>
+                {{/if}}
+                </li>
+            {{/props}}
+            </ul>
+            {{/if}}
+        </li>
+    {{/params}}
+    </ul>
+    {{/if}}
+    {{#if return}}
+    {{#return}}
+    <br><div class="returns"><strong>Returns:</strong> {{#if type}}&lt;{{#crossLink type}}{{/crossLink}}&gt; {{/if}}{{{description}}}</div>
+    {{/return}}
+    {{/if}}
+    {{#if example}}
+        <h5>Example</h5>
+        {{{example}}}
+    {{/if}}
+</div>
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/module.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/module.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/module.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,28 @@
+
+<h2>{{moduleName}}</h2>
+<div class="intro">{{{moduleDescription}}}</div>
+
+<div class="yui3-g">
+    <div class="yui3-u-1-2">
+        {{#if moduleClasses}}
+        <p>This module has the following classes:</p>
+        <ul>
+        {{#moduleClasses}}
+            <li><a href="{{../projectRoot}}classes/{{name}}.html">{{displayName}}</a></li>
+        {{/moduleClasses}}
+        </ul>
+        {{/if}}
+    </div>
+    <div class="yui3-u-1-2">
+        {{#if subModules}}
+        <p>This module has the following submodules:</p>
+        <ul>
+        {{#subModules}}
+            <li id="{{name}}"><a href="{{../projectRoot}}modules/{{name}}.html">{{displayName}}</a><p>{{{description}}}</p></li>
+        {{/subModules}}
+        </ul>
+        {{/if}}
+    </div>
+</div>
+<br><br>
+<span class="foundat">Module description found: <a href="../{{foundAt}}">`{{file}}:{{line}}`</a></span>
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/props.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/props.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/props.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,10 @@
+<a name="props_{{name}}"></a>
+<div class="props item">
+    `{{name}}` &lt;<strong>{{#crossLink type}}{{/crossLink}}</strong>&gt;{{#if final}} <em>(final)</em>{{/if}}{{#if static}} <em>(static)</em>{{/if}}<br>
+    <span class="foundat"><a href="../{{foundAt}}">`{{file}}:{{line}}`</a></span>
+    {{{propertyDescription}}}
+    {{#if example}}
+        <h5>Example</h5>
+        {{{example}}}
+    {{/if}}
+</div>
 
=== added file '0.1/ambiance/js/yuidoc-theme/partials/sidebar.handlebars'
--- 0.1/ambiance/js/yuidoc-theme/partials/sidebar.handlebars	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/partials/sidebar.handlebars	2013-11-01 20:18:13 +0000
@@ -0,0 +1,105 @@
+<div id="modules" class="sidebox">
+    <div class="hd">
+        <h2 class="no-toc">Modules</h2>
+    </div>
+    <div class="bd">
+        <ul>
+            {{#modules}}
+                <li><a href="{{../projectRoot}}modules/{{name}}.html">{{displayName}}</a>
+                {{#if submodules}}
+                    <ul>
+                        {{#submodules}}
+                            <li><a href="{{../../../projectRoot}}modules/{{../name}}.html#{{displayName}}">{{displayName}}</a></li>
+                        {{/submodules}}
+                    </ul>
+                {{/if}}
+                </li>
+            {{/modules}}
+        </ul>
+    </div>
+</div>
+
+<div id="classes" class="sidebox">
+    <div class="hd">
+        <h2 class="no-toc">Classes</h2>
+    </div>
+    <div class="bd">
+        <ul>
+            {{#classes}}
+                <li><a href="{{../projectRoot}}classes/{{name}}.html">{{displayName}}</a></li>
+            {{/classes}}
+        </ul>
+    </div>
+</div>
+
+{{#if methods}}
+<div id="methods-on-page" class="sidebox on-page">
+    <div class="hd">
+        <h2 class="no-toc">Methods On Page</h2>
+    </div>
+    <div class="bd">
+        <ul>
+            {{#methods}}
+                <li><a href="#methods_{{name}}">{{name}}</a></li>
+            {{/methods}}
+        </ul>
+    </div>
+</div>
+{{/if}}
+
+{{#if events}}
+<div id="events-on-page" class="sidebox on-page">
+    <div class="hd">
+        <h2 class="no-toc">Events On Page</h2>
+    </div>
+    <div class="bd">
+        <ul>
+            {{#events}}
+                <li><a href="#events_{{name}}">{{name}}</a></li>
+            {{/events}}
+        </ul>
+    </div>
+</div>
+{{/if}}
+
+{{#if props}}
+<div id="props-on-page" class="sidebox">
+    <div class="hd">
+        <h2 class="no-toc">Props On Page</h2>
+    </div>
+    <div class="bd">
+        <ul>
+            {{#events}}
+                <li><a href="#props_{{name}}">{{name}}</a></li>
+            {{/events}}
+        </ul>
+    </div>
+</div>
+{{/if}}
+
+{{#if attributes}}
+<div id="attrs-on-page" class="sidebox on-page">
+    <div class="hd">
+        <h2 class="no-toc">Attributes On Page</h2>
+    </div>
+    <div class="bd">
+        <ul>
+            {{#events}}
+                <li><a href="#attrs_{{name}}">{{name}}</a></li>
+            {{/events}}
+        </ul>
+    </div>
+</div>
+{{/if}}
+
+{{#if fileTree}}
+<div id="fileTree" class="sidebox">
+    <div class="hd">
+        <h2 class="no-toc">Files</h2>
+    </div>
+    <div class="bd">
+        {{#buildFileTree fileTree}}{{/buildFileTree}}
+    </div>
+</div>
+{{/if}}
+
 
=== added file '0.1/ambiance/js/yuidoc-theme/theme.json'
--- 0.1/ambiance/js/yuidoc-theme/theme.json	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc-theme/theme.json	2013-11-01 20:18:13 +0000
@@ -0,0 +1,4 @@
+{
+    "yuiGridsUrl": "http://yui.yahooapis.com/3.8.0pr2/build/cssgrids/cssgrids-min.css",
+    "yuiSeedUrl": "http://yui.yahooapis.com/combo?3.8.0pr2/build/yui/yui-min.js"
+}
 
=== added file '0.1/ambiance/js/yuidoc.json'
--- 0.1/ambiance/js/yuidoc.json	1970-01-01 00:00:00 +0000
+++ 0.1/ambiance/js/yuidoc.json	2013-11-01 20:18:13 +0000
@@ -0,0 +1,9 @@
+{
+    "name": "Ubuntu HTML5 API",
+    "description": "Ubuntu HTML5 API: JavaScript for HTML5 Ubuntu Apps",
+    "version": "0.1",
+    "options": {
+        "outdir": "./build",
+        "themedir": "yuidoc-theme"
+    }
+}