/*
  * TODO:
  *  - find a way to use the same string as in the @include lines to match the
- *    current window.location
+ *    current window.location. Look for something like GM_testUrl() which builds
+ *    the regexp starting from a glob line.
  *  - use xpath instead of regexp like in http://a32.me/2009/11/greasemonkey/
  *  - use jquery, like shown in http://a32.me/2009/11/greasemonkey/
  */
     return null;
   }
 
-
+  // This is used for sites adding the URL to the DOM after DOMContentLoaded,
+  // for example by some javascript library (like Silverlight.js on rai.tv).
   if (site.onEvent) {
     element.addEventListener(site.onEvent.evt, function(e) {
       if (site.onEvent.targetElement &&