Index: misc/drupal.js
===================================================================
RCS file: /cvs/drupal/drupal/misc/drupal.js,v
retrieving revision 1.26
diff -u -d -F^\s*function -r1.26 drupal.js
--- misc/drupal.js	22 Aug 2006 09:00:31 -0000	1.26
+++ misc/drupal.js	22 Aug 2006 18:28:48 -0000
@@ -21,8 +21,20 @@ function isJsEnabled() {
   document.documentElement.className = 'js';
 }
 
+/**
+ * The global Drupal variable.
+ */
 Drupal = { };
 
+/**
+ * Merge an object into the Drupal namespace.
+ *
+ * @param obj
+ *   The object that should be merged into the Drupal namespace. Arbitrary objects
+ *   containing functions, variables or other objects can be used. An example object
+ *   would be { settings: { tree: { '/js/menu/tree': { mid: 206 } } } }. This item 
+ *   can now be accessed at Drupal.settings.tree['/js/menu/tree'].mid.
+ */
 Drupal.extend = function(obj) {
   for (var i in obj) {
     if (this[i]) {
@@ -32,7 +44,7 @@ function isJsEnabled() {
       this[i] = obj[i];
     }
   }
-}
+};
 
 /**
  * Make IE's XMLHTTP object accessible through XMLHttpRequest()