You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Matt Doar (JIRA)" <ji...@apache.org> on 2007/12/06 21:17:43 UTC
[jira] Created: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
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
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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12549526 ]
Matt Doar commented on LUCENE-1083:
-----------------------------------
As an aside, Maven repositories in general could usefully be enhanced to
record this kind of information for a project, so that you could query them
for "current release", "prior patch release", "prior minor release", "prior
major release". For Lucene at 2.2.0, that would give 2.2.0,
2.1.x(non-existent, so detaults to
2.1.0?), 2.1.0 and 1.9.1. And then allow users to override what each value
is for a specific release of a project.
> 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: 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12551191 ]
Matt Doar commented on LUCENE-1083:
-----------------------------------
Below is an Ant target for the core classes that works in r603799 and supports restricting the report to just protected and public methods (the jdiff ant task doesn't support that). I'll also attach the report of the differences between 2.2.0 and 2.3.0-dev that was generated with this task. The ant target still needs some work to specify where jdiff is located, and to convert the periods in the prev.version string to underscores for the URL to the previous version javadocs.
{noformat}
<target name="jdiff-core" description="Generate jdiff for core classes">
<sequential>
<property name="JDIFF_HOME" value="D:/mdoar/jdiff/build/jdiff-1.1.0" />
<property name="jdiff.home" value="${JDIFF_HOME}" />
<property name="jdiff.reportdir" value="${javadoc.dir}/core-jdiff" />
<property name="jdiff.tmpdir" value="${javadoc.dir}/jdiff.tmp" />
<property name="prev.version" value="2.2.0" />
<property name="prev.src.dir" value="D:/mdoar/jdiff/examples/lucene-${prev.version}" />
<mkdir dir="${jdiff.reportdir}"/>
<mkdir dir="${jdiff.tmpdir}"/>
<echo message="Generate the XML representing the previous API" />
<javadoc access="${javadoc.access}"
encoding="${build.encoding}">
<doclet name="jdiff.JDiff"
path="${jdiff.home}/jdiff.jar:${jdiff.home}/xerces.jar">
<param name="-apidir" value="${jdiff.tmpdir}" />
<param name="-excludeclass" value="${javadoc.access}" />
<param name="-excludemember" value="${javadoc.access}" />
<param name="-apiname" value="${Name} ${prev.version} API" />
</doclet>
<packageset dir="${prev.src.dir}/src/java"/>
<classpath refid="javadoc.classpath"/>
</javadoc>
<echo message="Generate the XML representing the current API" />
<javadoc access="${javadoc.access}"
encoding="${build.encoding}">
<doclet name="jdiff.JDiff"
path="${jdiff.home}/jdiff.jar:${jdiff.home}/xerces.jar">
<param name="-apidir" value="${jdiff.tmpdir}" />
<param name="-excludeclass" value="${javadoc.access}" />
<param name="-excludemember" value="${javadoc.access}" />
<param name="-apiname" value="${Name} ${version} API" />
</doclet>
<packageset dir="src/java"/>
<classpath refid="javadoc.classpath"/>
</javadoc>
<echo message="Generate the JDiff report comparing the APIs" />
<javadoc
private="yes"
sourcepath="src/java"
destdir="${jdiff.reportdir}"
sourcefiles="${jdiff.home}/Null.java">
<doclet name="jdiff.JDiff"
path="${jdiff.home}/jdiff.jar:${jdiff.home}/xerces.jar">
<param name="-oldapi" value="${Name} ${prev.version} API" />
<param name="-newapi" value="${Name} ${version} API" />
<param name="-oldapidir" value="${jdiff.tmpdir}" />
<param name="-newapidir" value="${jdiff.tmpdir}" />
<param name="-javadocnew" value="../../core/" />
<!-- TODO change . to _ in prev.version-->
<param name="-javadocold" value="http://lucene.apache.org/java/${prev.version}/api/" />
<param name="-docchanges"/>
<param name="-stats"/>
</doclet>
<classpath refid="javadoc.classpath"/>
</javadoc>
<!-- Copy image files. black.gif is only needed if -stats was used -->
<copy file="${jdiff.home}/background.gif" todir="${jdiff.reportdir}" />
<copy file="${jdiff.home}/black.gif" todir="${jdiff.reportdir}" />
</sequential>
</target>
{noformat}
> 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: 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Grant Ingersoll (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12549429 ]
Grant Ingersoll commented on LUCENE-1083:
-----------------------------------------
Thanks, Matt. I assume the antjdiff.jar needs to be included somewhere? In order for this to work, you probably need to make it so it checks to see if that library exists before running it (check out the way the Clover test coverage works) and we can't include the actual JDiff libraries in Lucene b/c of licensing issues (I'm pretty sure, anyway), so ideally, your task would also download the library when executed and install it properly for users.
> 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: 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Issue Comment Edited: (LUCENE-1083) JDiff report of changes
between different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12551619 ]
mdoar edited comment on LUCENE-1083 at 12/13/07 1:48 PM:
-------------------------------------------------------------
The attached 1083_1.patch file against r604038 does most of what you suggested. The svn task is not in ant core yet, so I couldn't use it to check out the source of the previous version. I had to define the version number as 3 separate numbers because Ant doesn't make string subst easy on properties. All the links in the JDiff reports should work, including the links to the previous and current Javadocs.
was (Author: mdoar):
The attached 1083_1.patch file does most of what you suggested. The svn task is not in ant core yet, so I couldn't use it to check out the source of the previous version. I had to define the version number as 3 separate numbers because Ant doesn't make string subst easy on properties. All the links in the JDiff reports should work, including the links to the previous and current Javadocs.
> 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: 1083_1.patch, 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Updated: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Matt Doar updated LUCENE-1083:
------------------------------
Attachment: 1083_1.patch
The patch as requested by Doug.
> 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: 1083_1.patch, 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Doug Cutting (JIRA)" <ji...@apache.org>.
[ 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12551632 ]
Matt Doar commented on LUCENE-1083:
-----------------------------------
Ok, exec it will be, and I'll remove the jdiff.home line. The funny thing is that the "3 separate numbers" idea is Erik's suggestion, circa 2004 (http://www.ant-tasks.com/msg/18617.html)
> 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: 1083_1.patch, 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Updated: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Matt Doar updated LUCENE-1083:
------------------------------
Attachment: core-jdiff.zip
The differences between the API of the core classes of 2.2.0 and 2.3.0-dev as of revision 603799
> 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12551619 ]
Matt Doar commented on LUCENE-1083:
-----------------------------------
The attached 1083_1.patch file does most of what you suggested. The svn task is not in ant core yet, so I couldn't use it to check out the source of the previous version. I had to define the version number as 3 separate numbers because Ant doesn't make string subst easy on properties. All the links in the JDiff reports should work, including the links to the previous and current Javadocs.
> 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: 1083_1.patch, 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Updated: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Matt Doar updated LUCENE-1083:
------------------------------
Attachment: 1083_2.patch
This patch adds Doug's suggestion to use exec for svn. There is no need to update a source tree based on a tag, but I have added the target in case someone ever wanted to. If the checkout time is too long for developers, we could also make the XML file that represents a release available, and then use that, instead of regenerating it each time.
> 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: 1083_1.patch, 1083_2.patch, 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12549475 ]
Matt Doar commented on LUCENE-1083:
-----------------------------------
Grant,
I was imagining more that the release process for Lucene could be changed so that whoever is creating a release also runs JDiff to produce the HTML reports, which they then post on the website with the usual Javadocs, and possibly include the report in the released package, say in a directory named docs/changes next to where docs/api currently is.
The Maven javadoc task looks like it should be able to create the reports. I guess I should see if I can come up with a working example of that.
> 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: 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Doug Cutting (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12551625 ]
Doug Cutting commented on LUCENE-1083:
--------------------------------------
Thanks for updating this!
bq. The svn task is not in ant core yet.
Then we should use the 'exec' task until it's in broad distribution.
bq. + <property name="jdiff.home" location="D:/mdoar/jdiff/build/jdiff-1.1.0"/>
That line should not exist. Folks will need to define jdiff.home outside of this build file. That includes you. Typically it will be done on the command line, with -Djdiff.home=...
bq. I had to define the version number as 3 separate numbers because Ant doesn't make string subst easy on properties.
Erik, oh, great Ant wizard, any thoughts?
> 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: 1083_1.patch, 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Updated: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Matt Doar (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Matt Doar updated LUCENE-1083:
------------------------------
Attachment: jdiff_lucene_210_220.zip
jdiff_lucene_191_220.zip
> 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: 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
[jira] Commented: (LUCENE-1083) JDiff report of changes between
different versions of Lucene
Posted by "Doug Cutting (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/LUCENE-1083?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12549500 ]
Doug Cutting commented on LUCENE-1083:
--------------------------------------
The "prior release" is a new concept that needs to be added to the build to support this. Perhaps a property in common-build.xml that names the subversion tags of the prior major and minor releases, and the jdiff target could use these. The jdiff target should do nothing if jdiff.home is not defined. Some links to the jdiff output should be added somewhere in the docs. Folks who build releases would then be required to install jdiff and to define jdiff.home when they make releases, or else the releases will contain broken links. This should be documented on the wiki's HowToRelease page.
> 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: 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: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org