Index: modules/overlay/overlay-parent.js
===================================================================
RCS file: /cvs/drupal/drupal/modules/overlay/overlay-parent.js,v
retrieving revision 1.8
diff -u -p -r1.8 overlay-parent.js
--- modules/overlay/overlay-parent.js	23 Dec 2009 21:33:52 -0000	1.8
+++ modules/overlay/overlay-parent.js	24 Dec 2009 00:15:55 -0000
@@ -103,7 +103,7 @@ Drupal.overlay = Drupal.overlay || {
  *   - autoFit: boolean indicating whether the overlay should be resized to
  *     fit the contents of the document loaded.
  *   - onOverlayOpen: callback to invoke when the overlay is opened.
- *   - onOverlayCanClose: callback to allow external scripts decide if the
+ *   - onOverlayCanClose: callback to allow external scripts to decide if the
  *     overlay can be closed.
  *   - onOverlayClose: callback to invoke when the overlay is closed.
  *   - customDialogOptions: an object with custom jQuery UI Dialog options.
@@ -218,7 +218,7 @@ Drupal.overlay.create = function () {
       return false;
     }
 
-    // Allow external scripts decide if the overlay can be closed.
+    // Allow external scripts to decide if the overlay can be closed.
     // The external script should call Drupal.overlay.close() again when it is ready for closing.
     if ($.isFunction(self.options.onOverlayCanClose) && self.options.onOverlayCanClose(self) === false) {
       return false;
@@ -267,7 +267,8 @@ Drupal.overlay.create = function () {
     title: Drupal.t('Loading...'),
     zIndex: 500,
 
-    // When not set use a empty string so it is not applied and CSS can handle it.
+    // When the width is not set, use an empty string instead, so that CSS will
+    // be able to handle it.
     width: self.options.width || '',
     height: self.options.height,
 
@@ -280,7 +281,7 @@ Drupal.overlay.create = function () {
   self.$iframe = $(Drupal.theme('overlayElement'));
   self.$container = $(Drupal.theme('overlayContainer')).append(self.$iframe);
 
-  // Allow external script override default jQuery UI Dialog options.
+  // Allow external script to override the default jQuery UI Dialog options.
   $.extend(dialogOptions, self.options.customDialogOptions);
 
   // Create the jQuery UI Dialog.
@@ -316,8 +317,6 @@ Drupal.overlay.load = function (url) {
   // the dialog. The loaded class is not removed and added back again
   // while switching between pages with the overlay already open,
   // due to performance issues.
-
-  //self.$dialog.removeClass('overlay-loaded');
   self.$iframe
     .css('opacity', 0.2)
     .load(function () {