Description:
------------
Documatation states that e-mail address validated "against the syntax in RFC 822, with the exceptions that comments and whitespace folding are not supported.", which is not true.

Filter validates only against addr-spec specification part. Because such address is invalid "Test Example <test@example.com>". Another example is "test@localhost" which should be valid, brcause RFC 822 doesn't fore address to have a .domain part.

All exceptions should be mentioned, not only current two.

Test script:
---------------
<?php

$emails = array(
    'Test Example <test@example.com>',
    'test@localhost',
    'test@localhost.com'
);

foreach ($emails as $email) {
    echo (filter_var($email, FILTER_VALIDATE_EMAIL)) ? 
        "[+] Email '$email' is valid\n" : 
        "[-] Email '$email' is NOT valid\n";
}

Expected result:
----------------
[+] Email 'Test Example <test@example.com>' is valid
[+] Email 'test@localhost' is valid
[+] Email 'test@localhost.com' is valid

Actual result:
--------------
[-] Email 'Test Example <test@example.com>' is NOT valid
[-] Email 'test@localhost' is NOT valid
[+] Email 'test@localhost.com' is valid