build: output: Fixing display of newlines in subprocess output

Reference to https://github.com/catkin/catkin_tools/pull/80#issuecomment-56607833
might want to update the comments, they are sort of confusing now.