M. Sokolewicz wrote:
> A lot of people might not know the info is there, but instead of
> removing it entirely I would suggest using an option to enable/disable
> it. The skeleton created should still be obvious to people who do not
> know much (if anything) about the way php-doc is made. So IMO it's not
> obvious to everyone that the description of that paremeter should go
> into that <para></para> section. Adding a switch (defaulting to off if
> you wish) would make it easier to create one with extra "debug" info
> which is useful to write the actual documentation. If people just want a
> raw skeleton, with _no_ additional manual editing involved, they should
> run it with a different flag/option/switch.
What about just put it inside a comment?
" <listitem>\n" .
" <para>\n" .
+ " <!-- Its description -->\n" .
" </para>\n" .
" </listitem>\n" .
Jakub Vrana
