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

Reply via email to