Merge ~richardw/jarmon/auto-apidocumentationv10.8pre1

 * Cleanup and add further doc strings for compatibility with yuidoc
 * Add a tool to automatically download and run yuidoc on the source tree
 * Add a tool to automatically create a releasable source archive containing apidocs
 * Add documentation of the apidoc and release tools.
 * Rearrange the source tree - moving all examples into the docs/examplesfolder

3 files changed, 293 insertions, 0 deletions

diff --git a/docs/examples/assets/css/jquerytools.dateinput.skin1.css b/docs/examples/assets/css/jquerytools.dateinput.skin1.css
new file mode 100644
index 0000000..69aedb8
--- /dev/null
+++ b/docs/examples/assets/css/jquerytools.dateinput.skin1.css
@@ -0,0 +1,144 @@
+/* For the details, see: http://flowplayer.org/tools/dateinput/index.html#skinning */
+
+/* the input field */
+.date {
+    border:1px solid #ccc;
+    font-size:18px;
+    padding:4px;
+    text-align:center;
+    width:194px;
+    -moz-box-shadow:0 0 10px #eee inset;
+}
+
+/* calendar root element */
+#calroot {
+    margin-top:-1px;
+    width:198px;
+    padding:2px;
+    background-color:#fff;
+    font-size:11px;
+    border:1px solid #ccc;
+    -moz-border-radius:5px;
+    -webkit-border-radius:5px;
+    -moz-box-shadow: 0 0 15px #666;
+    -webkit-box-shadow: 0 0 15px #666;
+}
+
+/* head. contains title, prev/next month controls and possible month/year selectors */
+#calhead {
+    padding:2px 0;
+    height:22px;
+}
+
+#caltitle {
+    font-size:14px;
+    color:#0150D1;
+    float:left;
+    text-align:center;
+    width:155px;
+    line-height:20px;
+    text-shadow:0 1px 0 #ddd;
+}
+
+#calnext, #calprev {
+    display:block;
+    width:20px;
+    height:20px;
+    background:transparent url(../icons/prev.gif) no-repeat scroll center center;
+    float:left;
+    cursor:pointer;
+}
+
+#calnext {
+    background-image:url(../icons/next.gif);
+    float:right;
+}
+
+#calprev.caldisabled, #calnext.caldisabled {
+    visibility:hidden;
+}
+
+/* year/month selector */
+#caltitle select {
+    font-size:10px;
+}
+
+/* names of the days */
+#caldays {
+    height:14px;
+    border-bottom:1px solid #ddd;
+}
+
+#caldays span {
+    display:block;
+    float:left;
+    width:28px;
+    text-align:center;
+}
+
+/* container for weeks */
+#calweeks {
+    background-color:#fff;
+    margin-top:4px;
+}
+
+/* single week */
+.calweek {
+    clear:left;
+    height:22px;
+}
+
+/* single day */
+.calweek a {
+    display:block;
+    float:left;
+    width:27px;
+    height:20px;
+    text-decoration:none;
+    font-size:11px;
+    margin-left:1px;
+    text-align:center;
+    line-height:20px;
+    color:#666;
+    -moz-border-radius:3px;
+    -webkit-border-radius:3px;
+}
+
+/* different states */
+.calweek a:hover, .calfocus {
+    background-color:#ddd;
+}
+
+/* sunday */
+a.calsun {
+    color:red;
+}
+
+/* offmonth day */
+a.caloff {
+    color:#ccc;
+}
+
+a.caloff:hover {
+    background-color:rgb(245, 245, 250);
+}
+
+
+/* unselecteble day */
+a.caldisabled {
+    background-color:#efefef !important;
+    color:#ccc  !important;
+    cursor:default;
+}
+
+/* current day */
+#calcurrent {
+    background-color:#498CE2;
+    color:#fff;
+}
+
+/* today */
+#caltoday {
+    background-color:#333;
+    color:#fff;
+}
diff --git a/docs/examples/assets/css/style.css b/docs/examples/assets/css/style.css
new file mode 100644
index 0000000..561b11e
--- /dev/null
+++ b/docs/examples/assets/css/style.css
@@ -0,0 +1,87 @@
+body {
+    font-family: sans;
+    width: 960px;
+    margin: 20px auto 10px auto;
+}
+
+form div {
+    text-align: center;
+}
+
+h2 {
+    padding: 0 0 0 55px;
+    margin: 20px auto 5px auto;
+    font-size: 14px;
+    text-align: left;
+    clear: both;
+}
+
+p, li, dt, dd, td, th, div {
+    font-size: 12px;
+}
+
+.loading .title {
+    background-repeat: no-repeat;
+    background-position: 0 50%;
+    background-image: url(/assets/icons/loading.gif);
+}
+
+.range-preview {
+    height:50px;
+    margin: 0 auto 10px auto;
+    position: relative;
+}
+
+.chart {
+    height:200px;
+    width: 850px;
+    margin: 0 auto 0 auto;
+}
+
+.tickLabel {
+    width:50px;
+    overflow:hidden;
+}
+
+.graph-legend {
+    width: 790px;
+    padding: 5px 0 5px 0;
+    margin: 10px auto 0 auto;
+    background-color: #f7f7f7;
+    position: relative;
+    left: 25px;
+}
+
+.graph-legend .legendItem {
+    float: left;
+    cursor: pointer;
+    margin-right: 20px;
+    margin-top: 5px;
+    margin-left: 5px;
+}
+
+.graph-legend .disabled {
+    text-decoration: line-through;
+}
+
+.graph-legend .legendColorBox {
+    float: left;
+    margin-right: 5px;
+}
+
+input[type=checkbox] {
+    margin: 0;
+    padding: 0;
+    border: none;
+}
+
+.notice {
+    border: 1px solid Green;
+    background: #FFDDFF;
+    margin-bottom: 20px;
+    padding: 5px;
+}
+
+#calroot {
+    z-index: 2;
+}
diff --git a/docs/examples/assets/css/tabs-no-images.css b/docs/examples/assets/css/tabs-no-images.css
new file mode 100644
index 0000000..58a54b4
--- /dev/null
+++ b/docs/examples/assets/css/tabs-no-images.css
@@ -0,0 +1,62 @@
+
+/* root element for tabs  */
+ul.css-tabs {
+    margin:0 !important;
+    padding:0;
+    height:30px;
+    border-bottom:1px solid #666;
+}
+
+/* single tab */
+ul.css-tabs li {
+    float:left;
+    padding:0;
+    margin:0;
+    list-style-type:none;
+}
+
+/* link inside the tab. uses a background image */
+ul.css-tabs a {
+    float:left;
+    font-size:13px;
+    display:block;
+    padding:5px 30px;
+    text-decoration:none;
+    border:1px solid #666;
+    border-bottom:0px;
+    height:18px;
+    background-color:#efefef;
+    color:#777;
+    margin-right:2px;
+    -moz-border-radius-topleft: 4px;
+    -moz-border-radius-topright:4px;
+    position:relative;
+    top:1px;
+}
+
+ul.css-tabs a:hover {
+    background-color:#F7F7F7;
+    color:#333;
+}
+
+/* selected tab */
+ul.css-tabs a.current {
+    background-color:#ddd;
+    border-bottom:2px solid #ddd;
+    color:#000;
+    cursor:default;
+}
+
+
+/* tab pane */
+.css-panes > div {
+    display:none;
+    border:1px solid #666;
+    border-width:0 1px 1px 1px;
+    min-height:150px;
+    padding:15px 20px;
+    background-color:#ddd;
+}
+
+
+