Updated comments to use @todo annotation

Also updated to provide correct grammar, as well as formatting.

Author: weierophinney

src/Decode.php

@@ -122,19 +122,19 @@ public static function splitMessage($message, &$headers, &$body, $EOL = Mime::LI
             }
         }
 
-        // TODO: splitMime replaces removes \r which breaks
-        //       valid mime messages as returned by many mail servers
+        // @todo splitMime removes "\r" sequences, which breaks valid mime
+        // messages as returned by many mail servers
         $headersEOL = $EOL;
 
         // find an empty line between headers and body
         // default is set new line
-        // TODO: Maybe this is too much "magic", we should be more strict here
+        // @todo Maybe this is too much "magic"; we should be more strict here
         if (strpos($message, $EOL . $EOL)) {
             list($headers, $body) = explode($EOL . $EOL, $message, 2);
         // next is the standard new line
         } elseif ($EOL != "\r\n" && strpos($message, "\r\n\r\n")) {
             list($headers, $body) = explode("\r\n\r\n", $message, 2);
-            $headersEOL = "\r\n"; // Headers::fromString will fail with incorrect eol
+            $headersEOL = "\r\n"; // Headers::fromString will fail with incorrect EOL
         // next is the other "standard" new line
         } elseif ($EOL != "\n" && strpos($message, "\n\n")) {
             list($headers, $body) = explode("\n\n", $message, 2);