"private" goals

[Daniel Bonniot <Da...@inria.fr>]

Hi,

On http://wiki.codehaus.org/maven/PluginCreation?action=highlight&value=goal it 
is said the following:

   Goals that the user will never use directly (ie, goals that check a username,
   prepare a directory structure, etc) don't have descriptions.

This convention makes perfect sense to me. But then, isn't it confusing that 
those goals appear in the ouput of 'maven -g'? When I see "Non documented goals 
:..." I expect that those are useful goals that are missing documentation.

Daniel



---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org

Re: "private" goals

[Tomasz Pik <pi...@ais.pl>]

Daniel Bonniot wrote:
> 
> Hi,
> 
> On 
> http://wiki.codehaus.org/maven/PluginCreation?action=highlight&value=goal 
> it is said the following:
> 
>   Goals that the user will never use directly (ie, goals that check a 
> username,
>   prepare a directory structure, etc) don't have descriptions.

I'm not sure if it's the best rule. Let's say it in Java language:
'method is private if don't have javadocs'.
Maybe it will be better to assume, that 'private' goal is named
using defined naming convention. With name starting with '_' for
example (so 'init' becomes '_init')?

Regards,
Tomek

> Daniel

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org