summaryrefslogtreecommitdiff
path: root/includes/external/addressbook/node_modules/boolbase/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'includes/external/addressbook/node_modules/boolbase/README.md')
-rw-r--r--includes/external/addressbook/node_modules/boolbase/README.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/includes/external/addressbook/node_modules/boolbase/README.md b/includes/external/addressbook/node_modules/boolbase/README.md
new file mode 100644
index 0000000..85eefa5
--- /dev/null
+++ b/includes/external/addressbook/node_modules/boolbase/README.md
@@ -0,0 +1,10 @@
+#boolbase
+This very simple module provides two basic functions, one that always returns true (`trueFunc`) and one that always returns false (`falseFunc`).
+
+###WTF?
+
+By having only a single instance of these functions around, it's possible to do some nice optimizations. Eg. [`CSSselect`](https://github.com/fb55/CSSselect) uses these functions to determine whether a selector won't match any elements. If that's the case, the DOM doesn't even have to be touched.
+
+###And why is this a separate module?
+
+I'm trying to modularize `CSSselect` and most modules depend on these functions. IMHO, having a separate module is the easiest solution to this problem. \ No newline at end of file