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