updated examples, added syntax notes