more text and new diagrams for paper