Bookmark manager js lib: Some cleanup of the event class docs....

chrome/browser/resources/bookmark_manager/js/cr/eventtarget.js

 // Copyright (c) 2010 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+/**
+ * @fileoverview This contains an implementation of the EventTarget interface
+ * as defined by DOM Level 2 Events.
+ */
+
 cr.define('cr', function() {
 
-  // TODO(arv): object.handleEvent
-
+  /**
+   * Creates a new EventTarget. This class implements the DOM level 2
+   * EventTarget interface and can be used wherever those are used.
+   * @constructor
+   */
   function EventTarget() {
   }
 
   EventTarget.prototype = {
 
     /**
      * Adds an event listener to the target.
      * @param {string} type The name of the event.
      * @param {!Function|{handleEvent:Function}} handler The handler for the
      *     event. This is called when the event is dispatched.
      */
     addEventListener: function(type, handler) {
       if (!this.listeners_)
-        this.listeners_ = {__proto__: null};
+        this.listeners_ = Object.create(null);
       if (!(type in this.listeners_)) {
         this.listeners_[type] = [handler];
       } else {
         var handlers = this.listeners_[type];
         if (handlers.indexOf(handler) < 0)
           handlers.push(handler);
       }
     },
 
     /**
@@ skipping 54 matching lines @@
 
       return !prevented && event.returnValue;
     }
   };
 
   // Export
   return {
     EventTarget: EventTarget
   };
 });