updated comments, added demos