switch combination and modifications to new API - issue #56
update demo for new api.  Issue #56
update docs and move complement into combination function.  Issue #56
update readable to isReadable
prep for 1.0