Document MAGICC's input and output formats more carefully

[znicholls]

When MAGICC7 comes out, we should carefully document its input and output formats. This exercise is more for our own benefit, given that anyone who uses pymagicc won't actually need to directly interact with these formats. It would also give us a place to add some of the quirks/hacks we've added, e.g. #315.