Description: ------------ You can specify the encoding of a php file by adding > declare(encoding = 'utf-8'); to the file. To be sure the file is parsed correctly, this declare needs to be the first command in the file. The problem is that phpcs reports a "Missing file doc comment" error. A file doc comment needs to follow the declaration, because the comment could already contain special non-ascii characters that can only be interpreted correctly when the encoding is known. Thus, the encoding declaration is to be allowed before the file doc block.

What can happen if you put the encoding declaration after encoded content: http://markmail.org/thread/2nvrx662lcrdvw7s

This bug has been fixed in CVS. If this was a documentation problem, the fix will appear on pear.php.net by the end of next Sunday (CET). If this was a problem with the pear.php.net website, the change should be live shortly. Otherwise, the fix will appear in the package's next release. Thank you for the report and for helping us make PEAR better.