Eclipse PHP code formatter removes pipe symbols from @return comments <p>I'm using Eclipse Kepler (4.3.1) for a PHP project.</p> <p>I've stumbled across a problem with the eclipse code formatter for PHP regarding PHPDoc's @return with pipe (vertical bar) symbol: When having a comment like this:</p> <pre><code>&lt;?php /** * * @param string|array The parameter. Either a string or an array. * @return int|string The return value. Either an int or a string. */ function test($param) { } </code></pre> <p>Using the format function with [CTRL]+[SHIFT]+[F] results in:</p> <pre><code>&lt;?php /** * * @param * string|array The parameter. Either a string or an array. * @return int string return value. Either an int or a string. */ function test($param) { } </code></pre> <p>As one can see, the pipe symbol between 'int' and 'string' in the '@return' statement has been replaced by a space. But not only that. Also the first word of the description ('The') has been chopped off. On the other hand, it works just fine for the '@param' statement.</p> <p>phpdoc.org states, that the pipe symbol is used when handling ambigous return values: <a href="http://www.phpdoc.org/docs/latest/for-users/phpdoc/tags/return.html" rel="nofollow">phpdoc-@return</a></p> <p>Somebody also asked a question about this int the Eclipse Community Forums: <a href="http://www.eclipse.org/forums/index.php/t/683282/" rel="nofollow">Forum Post</a> just a few days ago.</p> <p>Using '@formatter:off' and '@formatter:on' is no option, since this setting is only local and others might not have it set.</p> <p>Does anyone know how to fix-configure the eclipse php code formatter? Does anybody have a workaround?</p>