API tweaks, warning added to readme