update doc clarifying $eol and $newline