0
@@ -1,5 +1,5 @@
0
 /*
0
- * Copyright 2006-2007 Open Source Applications Foundation
0
+ * Copyright 2006-2008 Open Source Applications Foundation
0
  *
0
  * Licensed under the Apache License, Version 2.0 (the "License");
0
  * you may not use this file except in compliance with the License.
0
@@ -14,12 +14,20 @@
0
  * limitations under the License.
0
 */
0
 
0
+
0
+/**
0
+ * summary:
0
+ *      This module provides convenience functions for account related tasks.
0
+ * description:
0
+ *      This module provides convenience functions for account related tasks
0
+ *      related to account creation and maintenence.
0
+ */
0
+
0
+dojo.provide('cosmo.account.common');
0
 dojo.require("cosmo.util.validate");
0
 dojo.require("cosmo.convenience");
0
 dojo.require("cosmo.util.html");
0
 
0
-dojo.provide('cosmo.account.common');
0
-
0
 cosmo.account.formTypes = {
0
   CREATE: 'create',
0
   SETTINGS: 'settings' };

0
@@ -1,5 +1,5 @@
0
 /*
0
- * Copyright 2006-2007 Open Source Applications Foundation
0
+ * Copyright 2006-2008 Open Source Applications Foundation
0
  *
0
  * Licensed under the Apache License, Version 2.0 (the "License");
0
  * you may not use this file except in compliance with the License.
0
@@ -14,6 +14,13 @@
0
  * limitations under the License.
0
 */
0
 
0
+/**
0
+ * summary:
0
+ *      This module provides convenience functions for account creation.
0
+ * description:
0
+ *      This module provides functions creating, submitting and dealing with
0
+ *      results of an account creation form.
0
+ */
0
 dojo.provide('cosmo.account.create');
0
 
0
 dojo.require("cosmo.env");

0
@@ -1,5 +1,5 @@
0
 /*
0
- * Copyright 2006-2007 Open Source Applications Foundation
0
+ * Copyright 2006-2008 Open Source Applications Foundation
0
  *
0
  * Licensed under the Apache License, Version 2.0 (the "License");
0
  * you may not use this file except in compliance with the License.
0
@@ -14,6 +14,12 @@
0
  * limitations under the License.
0
 */
0
 
0
+/**
0
+ * summary:
0
+ *      This module provides convenience functions for account login.
0
+ * description:
0
+ *      This module provides functions to handle login workflows.
0
+ */
0
 dojo.provide('cosmo.account.login');
0
 
0
 dojo.require("cosmo.env");

0
@@ -1,5 +1,5 @@
0
 /*
0
- * Copyright 2007 Open Source Applications Foundation
0
+ * Copyright 2007-2008 Open Source Applications Foundation
0
  *
0
  * Licensed under the Apache License, Version 2.0 (the "License");
0
  * you may not use this file except in compliance with the License.
0
@@ -14,6 +14,13 @@
0
  * limitations under the License.
0
 */
0
 
0
+/**
0
+ * summary:
0
+ *      This module provides convenience functions for user preferences.
0
+ * description:
0
+ *      This module provides convenience functions for creating,
0
+ *      editing and deleting server side user preferences.
0
+ */
0
 dojo.provide("cosmo.account.preferences");
0
 
0
 dojo.require("cosmo.app.pim");
0
@@ -32,7 +39,7 @@ cosmo.account.preferences = new function () {
0
     this.setCookiePreference = function(key, val){
0
         return dojo.cookie(key, val, {path: "/"});
0
     };
0
-	
0
+
0
     this.getPreference = function(key, kwArgs){
0
     return cosmo.app.pim.serv.getPreference(key, kwArgs);
0
     };
0
@@ -48,7 +55,7 @@ cosmo.account.preferences = new function () {
0
     this.deletePreference = function(key, kwArgs){
0
     return cosmo.app.pim.serv.deletePreferences(key, kwArgs);
0
     };
0
-    
0
+
0
     this.getPreferences = function(kwArgs){
0
     return cosmo.app.pim.serv.getPreferences(kwArgs);
0
     };

0
@@ -1,5 +1,5 @@
0
 /*
0
- * Copyright 2006 Open Source Applications Foundation
0
+ * Copyright 2007-2008 Open Source Applications Foundation
0
  *
0
  * Licensed under the Apache License, Version 2.0 (the "License");
0
  * you may not use this file except in compliance with the License.
0
@@ -13,8 +13,15 @@
0
  * See the License for the specific language governing permissions and
0
  * limitations under the License.
0
 */
0
-dojo.provide("cosmo.account.settings");
0
 
0
+/**
0
+ * summary:
0
+ *      This module provides convenience functions for user settings.
0
+ * description:
0
+ *      This module provides convenience functions for creating,
0
+ *      editing and deleting server side user settings.
0
+ */
0
+dojo.provide("cosmo.account.settings");
0
 
0
 dojo.require("cosmo.env");
0
 dojo.require("cosmo.util.i18n");

0
@@ -16,7 +16,9 @@
0
  * summary:
0
  *      This module provides utility functions for working with Atompub services
0
  * description:
0
- *      TODO: fill this in
0
+ *      This module provides utility functions for working with Atompub services.
0
+ *      In particular, it provide easy ways of navigating and retrieving information
0
+ *      about and contained in Atompub services.
0
  */
0
 dojo.provide("cosmo.atompub");
0
 dojo.require("dojox.data.dom");

0
@@ -12,11 +12,17 @@
0
  * limitations under the License.
0
  */
0
 
0
- /**
0
+/**
0
  * summary:
0
  *      This module provides an implementation of HTTP Basic authentication
0
  * description:
0
- *      TODO: fill this in
0
+ *      This module provides an implementation of HTTP Basic authentication
0
+ *      via a clean API that can be reused with other authentication mechanisms.
0
+ *      To use it, first set authentication credentials using
0
+ *      <code>cosmo.auth.basic.setUsername</code> and
0
+ *      <code>cosmo.auth.basic.setPassword</code>.
0
+ *      Next, get a Request object that can be passed to <code>dojo.xhrGet</code>
0
+ *      with <code>cosmo.auth.basic.getAuthorizedRequest</code>.
0
  */
0
 
0
 dojo.provide("cosmo.auth.basic");

0
@@ -19,7 +19,15 @@
0
  *      http://www.xml.com/pub/a/2003/12/17/dive.html
0
  *      http://www.oasis-open.org/committees/wss/documents/WSS-Username-02-0223-merged.pdf
0
  * description:
0
- *      TODO: fill this in
0
+ *      This module provides an implementation of HTTP WSSE authentication
0
+ *      via a clean API that can be reused with other authentication mechanisms.
0
+ *      To use it, first set authentication credentials using
0
+ *      <code>cosmo.auth.wsse.setUsername</code> and
0
+ *      <code>cosmo.auth.wsse.setPassword</code>.
0
+ *      Next, get a Request object that can be passed to <code>dojo.xhrGet</code>
0
+ *      with <code>cosmo.auth.wsse.getAuthorizedRequest</code>.
0
+ *
0
+ *      This module does not address server side nonce timeouts.
0
  */
0
 
0
 dojo.provide("cosmo.auth.wsse");

0
@@ -1,5 +1,5 @@
0
 /*
0
- * Copyright 2006 Open Source Applications Foundation
0
+ * Copyright 2006-2008 Open Source Applications Foundation
0
  *
0
  * Licensed under the Apache License, Version 2.0 (the "License");
0
  * you may not use this file except in compliance with the License.
0
@@ -14,10 +14,18 @@
0
  * limitations under the License.
0
 */
0
 
0
-dojo.require("cosmo.util.i18n");
0
-
0
+/**
0
+ * summary:
0
+ *      This module provides general use convenience functions.
0
+ * description:
0
+ *      This module provides general use convenience functions including
0
+ *      the popular JavaScript-ism "bling," that is, $, and underscore
0
+ *      for string i18n.
0
+ */
0
 dojo.provide("cosmo.convenience");
0
 
0
+dojo.require("cosmo.util.i18n");
0
+
0
 dojo.global.$ = function (s) {
0
     return document.getElementById(s);
0
 }

0
@@ -14,7 +14,12 @@
0
  * limitations under the License.
0
 */
0
 
0
-
0
+/**
0
+ * summary:
0
+ *   This module provides constants used by datetime libraries;
0
+ * description:
0
+ *   This module provides constants used by datetime libraries;
0
+ */
0
 dojo.provide("cosmo.datetime");
0
 
0
 cosmo.datetime = new function () {

0
@@ -304,7 +304,7 @@ cosmo.datetime.Date.prototype.getTimezoneOffsetForGivenDate = function(date){
0
         }
0
     }
0
     return offsetMin;
0
-    
0
+
0
 }
0
 
0
 /**
0
@@ -338,7 +338,7 @@ cosmo.datetime.Date.prototype.getUserPrefTimezoneOffsetForGivenDate = function(d
0
             date.getFullYear(), date.getMonth(), date.getDate(),
0
             date.getHours(), date.getMinutes(), date.getSeconds());
0
     return offsetMin;
0
-    
0
+
0
 }
0
 /**
0
  * Formats the date in it's original timezone, using the strftime function
0
@@ -379,7 +379,7 @@ cosmo.datetime.Date.prototype.add = function(interv, incr) {
0
     var dt = dojo.date.add(new Date(this.toUTC()), interv, incr);
0
     // Get incremented Date
0
     // 'n', 'd', etc., string keys
0
-    
0
+
0
     // Update this date based on the new UTC
0
     this.updateFromUTC(dt.getTime());
0
 };
0
@@ -481,16 +481,16 @@ cosmo.datetime.Date.prototype.getCanonicalTzId = function(){
0
     if (!this.tzId){
0
         return null;
0
     }
0
-    
0
+
0
     var tz = cosmo.datetime.timezone.getTimezone(this.tzId);
0
-    
0
+
0
     if (!tz){
0
         return this.tzId;
0
     }
0
-    
0
+
0
     return tz.tzId;
0
 }
0
-    
0
+
0
 cosmo.datetime.Date.prototype.equals = function (/*cosmo.datetime.Date*/ that){
0
     return  that != null &&
0
             this.year == that.year &&
0
@@ -503,7 +503,7 @@ cosmo.datetime.Date.prototype.equals = function (/*cosmo.datetime.Date*/ that){
0
             this.getCanonicalTzId() == that.getCanonicalTzId() &&
0
             this.utc == that.utc;
0
 }
0
-    
0
+
0
 
0
 cosmo.datetime.Date.prototype.hash = function (){
0
     var hash =   this.year + ":"

0
@@ -21,6 +21,12 @@
0
  * @fileoverview provides information about the Cosmo environment.
0
  * @author Bobby Rullo br@osafoundation.org
0
  * @license Apache License 2.0
0
+ * summary:
0
+ *      This module provides quite a bit of global state.
0
+ * description:
0
+ *      This module provides quite a bit of global state.
0
+ *      Moving forward we should try to move all global state in the
0
+ *      system here, and avoid this kind of state whenever possible.
0
  */
0
 
0
 dojo.provide("cosmo.env");

0
@@ -16,14 +16,13 @@
0
 dojo.provide("cosmo.model");
0
 dojo.provide("cosmo.oldmodel");
0
 
0
-dojo.require("cosmo.util.debug");
0
 dojo.require("cosmo.util.hash");
0
 dojo.require("cosmo.datetime");
0
 dojo.require("cosmo.datetime.Date");
0
 
0
 cosmo.model.sortEvents = function(/*Array|cosmo.util.hash.Hash*/ events){
0
-// summary: Sorts a collection of events based on start date. 
0
-//          If the start dates are equal, longer events are  
0
+// summary: Sorts a collection of events based on start date.
0
+//          If the start dates are equal, longer events are
0
 //          sorted first
0
 
0
     var hash = events instanceof cosmo.util.hash.Hash;
0
@@ -35,11 +34,11 @@ cosmo.model.sortEvents = function(/*Array|cosmo.util.hash.Hash*/ events){
0
         var eventStamp = event.getEventStamp();
0
         var startDate = eventStamp.getStartDate();
0
         var endDate = eventStamp.getEndDate();
0
-        
0
+
0
         event.__startUTC = startDate.toUTC();
0
         event.__endUTC = endDate.toUTC();
0
     }
0
-    
0
+
0
     events.sort(cosmo.model._eventComparator);
0
 
0
     for (var x = 0; x < events.length; x++){

0
@@ -12,6 +12,14 @@
0
  * limitations under the License.
0
  */
0
 
0
+/**
0
+ * summary:
0
+ *   This module chooses and provides a local storage provider.
0
+ * description:
0
+ *   This module chooses and provides a local storage provider.
0
+ *   If WHATWG dom storage is available, it will use that, otherwise
0
+ *   it will default to cookie storage.
0
+ */
0
 dojo.provide("cosmo.storage");
0
 dojo.require("cosmo.storage.Dom");
0
 dojo.require("cosmo.storage.Cookie");

0
@@ -13,7 +13,7 @@
0
  * See the License for the specific language governing permissions and
0
  * limitations under the License.
0
 */
0
-/* General styles for admin ui (this includes account browser, password recovery, etc)
0
+/* Styles for the AwesomeBox.
0
  *
0
  */
0
 

0
@@ -1,4 +1,20 @@
0
-/* copied from tundra css */
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for dijit Checkbox adapted from tundra css */
0
+
0
 .cosmo .dijitToggleButton .dijitCheckBoxIcon {
0
   background-image: url('images/checkmarkNoBorder.gif');
0
 }

0
@@ -1,3 +1,21 @@
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for the CollectionSelector.
0
+ *
0
+ */
0
 #collectionSelectorContainer {
0
     height: 176px;
0
     overflow: auto;

0
@@ -1,3 +1,21 @@
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for the detail view.
0
+ *
0
+ */
0
 @import url("Checkbox.css");
0
 @import url("HintText.css");
0
 

0
@@ -1,6 +1,21 @@
0
-
0
-/* Dialog */
0
-/* This adapted from Dojo dialog styling. */
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for the dijit Dialog adapted from tundra.
0
+ *
0
+ */
0
 
0
 .cosmo .dijitDialog {
0
   background: #fff;

0
@@ -1,3 +1,21 @@
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for hint text.
0
+ *
0
+ */
0
 .hintText {
0
     color: #9B9B9B;
0
 }
0
\ No newline at end of file

0
@@ -1,4 +1,21 @@
0
-/* List view */
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for the list view.
0
+ *
0
+ */
0
 #listViewContainer {
0
     position: absolute;
0
     display: none;

0
@@ -1,3 +1,21 @@
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");
0
+ * you may not use this file except in compliance with the License.
0
+ * You may obtain a copy of the License at
0
+ *
0
+ *     http://www.apache.org/licenses/LICENSE-2.0
0
+ *
0
+ * Unless required by applicable law or agreed to in writing, software
0
+ * distributed under the License is distributed on an "AS IS" BASIS,
0
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0
+ * See the License for the specific language governing permissions and
0
+ * limitations under the License.
0
+*/
0
+/* Styles for the mini calendar.
0
+ *
0
+ */
0
 #miniCal {
0
     position: absolute;
0
     border: 0px;

0
@@ -1,3 +1,21 @@
0
+/*
0
+ * Copyright 2008 Open Source Applications Foundation
0
+ *
0
+ * Licensed under the Apache License, Version 2.0 (the "License");