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

Doug Cutting commented on LUCENE-1083:
--------------------------------------

The changes to build.xml should be provided as a patch file.  For details, see:

http://wiki.apache.org/lucene-java/HowToContribute

JDIFF_HOME and jdiff.home should be undefined by default, and the target should 
do nothing when these are not defined, except perhaps print a warning.

The previous version should be defined as a subversion URL that is checked out 
somewhere in build/ if it doesn't already exist there, and updated otherwise.  
Typically the url would be to a tag.  We might do something like:

jdiff.prev.version="2.2.0"
jdiff.prev.url.base="http://svn.apache.org/repos/asf/lucene/java/tags/release-";
jdiff.prev.url="${prev.url.base}${jdiff.prev.version}"
jdiff.prev.dir="${build.dir}/jdiff/prev-${jdiff.prev.version}"

Does that sound reasonable?

> JDiff report of changes between different versions of Lucene
> ------------------------------------------------------------
>
>                 Key: LUCENE-1083
>                 URL: https://issues.apache.org/jira/browse/LUCENE-1083
>             Project: Lucene - Java
>          Issue Type: Improvement
>          Components: Javadocs
>    Affects Versions: 2.2
>            Reporter: Matt Doar
>         Attachments: core-jdiff.zip, jdiff_lucene_191_220.zip, 
> jdiff_lucene_210_220.zip
>
>
> I think that a helpful addition to the release process for Lucene would be 
> [JDiff|http://www.jdiff.org] reports of the API changes between different 
> versions. I am attaching reports of the differences between 1.9.1 and 2.2.0 
> and also between 2.1.0 and 2.2.0. The reports could be changed to only show 
> the public methods. The start page is changes.html.
> This is the Ant target I added to the top-level build.xml file in the JDiff 
> directory to produce a report:
> {noformat}
> <target name="lucene" depends="dist">
>   <taskdef name="jdiff" 
>            classname="jdiff.JDiffAntTask" 
>            classpath="${dist.dir}/antjdiff.jar" />
>   <jdiff destdir="${reports.dir}/lucene" 
>          verbose="on"
>          stats="on"
>          docchanges="on">
>     <old name="1.9.1">
>       <dirset dir="${examples.dir}/lucene-1.9.1/src/java" includes="org/**" />
>     </old>
>     <new name="2.2.0">
>       <dirset dir="${examples.dir}/lucene-2.2.0/src/java" includes="org/**" />
>     </new>
>   </jdiff>
> </target>
> {noformat}
> Disclaimer: I'm the author of JDiff

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to