Add loads of documentation to FormattingWriter
Add loads of documentation to FormattingWriter

The existing documentation was in part horribly outdated, and in part
simply missing.

HenningB/ceylon.formatter