Phing does not fail when a Phpdoc child task itself fails, and I can't tell from the manual that there is any way to tell Phing to fail when the PhpDoc task fails.
I've tested this several ways:
- put bad values in phpdoc's args, to force an "ERROR" message from phpdoc itself;
- kill the php process while phpdoc was running;
- phpdoc threw an malloc() failure due to low memory;
In all cases, Phing just keeps going like the phpdoc task finished successfully. I even put two phpdoc tasks in the same phing target, thinking perhaps the target would fail after the first phpdoc task failed, but no, it went right on to the second phpdoc task.
Shouldn't it be reporting a build failure when the phpdoc task failed, or is this an enhancement that needs to be added to Phing? Or, worse, is Phing already supposed to fail but Phpdoc is returning a success exit code even when it itself fails?