added some more notes and references and header output