appendix and some restructuring
table of content, encoding issues, spin output moved