lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Hoss Man (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (LUCENE-4432) Make top-level default ant task print -projecthelp
Date Wed, 26 Sep 2012 01:32:09 GMT

    [ https://issues.apache.org/jira/browse/LUCENE-4432?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13463451#comment-13463451
] 

Hoss Man commented on LUCENE-4432:
----------------------------------

I know rmuir opened another issue to hide/disable "internal" targets so that the only ones
-projecthelp outputs are things users should actually run, so "ant -projecthelp" should be
fairly useful moving forward, but instead of making the default target just fork "ant -projecthelp"
wouldn't it be better to have it echo out a summary of the handful of _really_ important tasks?
eg: ivy-bootstrap, test, clean.

i mean ... stuff like the jenkins-\* targets will always need to be "public" so people can
run them, but if the goal is to make "ant" provide a useful intro to people about the targets
available, why don't we just use {{<echo>}} to tell people about the really important
ones, and let them run "ant -projecthelp" themselves?

Something like...

{noformat}
> ant
[echo]
[echo]  Welcome to Apache Lucene
[echo]
[echo]  For new developers, the important targets you should 
[echo]  be aware of are...
[echo]
[echo]  Tasks you may need to run once...
[echo]    ant ivy-bootstrap
[echo]    ant idea (setups up IDE configurations for IDEA)
[echo]    ant eclipses (setups up IDE configurations for IDEA)
[echo]
[echo]  Tasks that you may run frequently...
[echo]    ant test (to run all tests)
[echo]    ant clean (...)
[echo]    ...
[echo]
[echo]  To see a full list of build options run "ant -projecthelp"
[echo]
[echo]  Please review BUILD.txt for more information
{noformat}




                
> Make top-level default ant task print -projecthelp
> --------------------------------------------------
>
>                 Key: LUCENE-4432
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4432
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/build
>            Reporter: Uwe Schindler
>            Assignee: Uwe Schindler
>            Priority: Trivial
>             Fix For: 4.1, 5.0
>
>         Attachments: LUCENE-4432.patch, LUCENE-4432.patch
>
>
> The top-level ant default task runs test, which is confusing. Instead it should alias
"-projecthelp". This is easily possible with a trick: invoke ant's main class with <java
fork="false"/>.
> Solr has a good default task, it may also use the same trick, but I don't care here.
> Lucene's default task is jar-core... Maybe move the above task to common-build.xml and
let all default targets depend on "-projecthelp" task from common-build.xml?

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Mime
View raw message