Description: ------------ Using any of the PHP v5 versions (5.1.6, 5.2.0, 5.2.1) I run PhpDocumentor (CVS Head) against, in the sourcecode view of the source file, all subsequent lines of a multiline tag description get an extra leading space. Test script: --------------- <?php /** * Page Directive for BugReport3.php * * @author $Author$ * @version $Name$ * @package BugReports * @todo NEEDS PAGE DIRECTIVE * WRITTEN AND UNDERSTOOD * BUT NOT IMMORTALIZED */ ?> Expected result: ---------------- <?php /** * Page Directive for BugReport3.php * * @author $Author$ * @version $Name$ * @package BugReports * @todo NEEDS PAGE DIRECTIVE * WRITTEN AND UNDERSTOOD * BUT NOT IMMORTALIZED */ ?> Actual result: -------------- <?php /** * Page Directive for BugReport3.php * * @author $Author$ * @version $Name$ * @package BugReports * @todo NEEDS PAGE DIRECTIVE * WRITTEN AND UNDERSTOOD * BUT NOT IMMORTALIZED */ ?>

I forgot to explicitly mention that this does NOT happen with PHP v4 that I test with (4.4.2, 4.4.4, 4.4.5, 4.4.6).

Looks like a trailing space on the docblock "*" per-line marker (" * ") was colliding with a fully intact description text with all its leading space padding ("&nbps; &nbspTEXT"). Had to add a check to ensure that when given a pure text string (no tags in it), and that string had more than one leading space ("hmmm, leading spacesmust be for lining up indented text"), then we have to prevent the trailing space in "&nbsp*&nbps;" from overspacing the TEXT indention by one.

Started to build a test suite for HighlightParser->getInlineTags() method, but there is proving to be too much object setup required, and I can't deal with it all very well on my one 1024x768 laptop screen... I'm missing my second monitor right about now. I got the test suite file started, with three very simple tests in it, though I couldn't get far enough to build a test specifically covering this bug condition. Greetings from the beach!

!@#$%^... looks like this patch is stripping a space off a tag's description text. I'm not sure why this wasn't evident to me when first developing the patch, unless it's due to the tags in question (class docblock for clone.inc.php) having indention spaces themselves, whereas my test file docblock tags did not have indention spaces. This patch isn't going to suffice.

At some point were going to have to refactor that code so it can be reasonably tested (and understood). Patch wise I think your going to have to detect tabs to make things work

Verified this bug still exists in v1.4.2 on PHP 5.2.5.

Had revisited this bug, and noticed another problem due to this bug: all the docblock lines that begin with "*" lose their leading space before the "*". So, the multiline indented TODO value is wreaking double havoc...

No more feature work on phpDocumentor 1.x. Check out the new phpDocumentor 2.x (http://www.phpdoc.org/).