diff --git a/4chan_x.user.js b/4chan_x.user.js
index 2e9b62ac2..e11600b89 100644
--- a/4chan_x.user.js
+++ b/4chan_x.user.js
@@ -270,6 +270,11 @@
       return ui.el.style.top = '999%';
     }
   };
+  /*
+  loosely follows the jquery api:
+  http://api.jquery.com/
+  not chainable
+  */
   $ = function(selector, root) {
     if (root == null) {
       root = d.body;
diff --git a/script.coffee b/script.coffee
index 2ee8af28e..12d39e15b 100644
--- a/script.coffee
+++ b/script.coffee
@@ -184,6 +184,11 @@ ui =
   hoverend: (e) ->
     ui.el.style.top = '999%'
 
+###
+loosely follows the jquery api:
+http://api.jquery.com/
+not chainable
+###
 $ = (selector, root=d.body) ->
   root.querySelector selector