lib: added some JSDoc descriptions.
lib/misc.js: added notice of the failing test (see #3)