more updates, added appendix