cleanup and comments ; mail header detection fix

added some comments and prettied up the code a little bit

need to update self.next_mail in ParagraphStream after outputting a
paragraph (if this was a header, the next paragraph could also be one).

Need to note in a Paragraph whether it is a mail header or not, because
the word splitting is different in the former case than the latter.