API improved; example documented