Merge branch 'master' of github.com:firebug/firequery

Author: janodvarko

lib/console-overlay.js

@@ -23,7 +23,11 @@ const { getJQuerifyCode } = require("./jquerify-code");
 
 /**
  * @overlay This object represents an overlay for the existing
- * Console panel and is responsible for Console customization.
+ * Console panel. It's responsible for Console customization.
+ * The overlay follows the life cycle of the pane. It's created when
+ * the panel is created (which happens when the panel is selected
+ * by the user for the first time) and it's destroyed when the
+ * Toolbox is destroyed.
  *
  * FireQuery is appending a new 'jQuerify' toolbar button
  */
@@ -74,6 +78,8 @@ const ConsoleOverlay = Class(
       command: this.onJQuerify.bind(this)
     });
 
+    // Load custom style-sheet into the panel window (content window of
+    // the panel's frame).
     let win = this.getPanelWindow();
     loadSheet(win, "chrome://firequery/skin/firequery.css", "author");
   },
@@ -94,6 +100,7 @@ const ConsoleOverlay = Class(
       return;
     }
 
+    // Evaluate jQuery script in the current page.
     let script = getJQuerifyCode();
     webConsoleClient.evaluateJSAsync(script, response => {
       if (response.error) {