updates, and example code