Bug 53141 - Documentation of Property Task (and its Javadoc) implies that loadFromXML functionality exists since 1.7.1 (it doesn't)
Summary: Documentation of Property Task (and its Javadoc) implies that loadFromXML fun...
Status: RESOLVED FIXED
Alias: None
Product: Ant
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 1.8.3
Hardware: All All
: P2 major (vote)
Target Milestone: 1.9.0
Assignee: Ant Notifications List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-04-24 18:50 UTC by Mark Koczwara
Modified: 2012-04-25 04:12 UTC (History)
1 user (show)



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Mark Koczwara 2012-04-24 18:50:25 UTC
The documentation for the "property" task contains the following line:

http://ant.apache.org/manual/Tasks/property.html:
"Since Apache Ant 1.7.1 it is possible to load properties defined in xml according to Suns DTD, if Java5+ is present. For this the name of the file, resource or url has to end with .xml"

a) This doesn't seem to be true for 1.7.1 and I could find no indication in the Property.java source that this was the case.

b) 1.8.1+ versions of Property.java do contain the functionality described above (see the loadProperties method) but their Javadoc is marked @since 1.7.1

It's possible that I have misunderstood your usage of "since" (in which case: apologies), but it has been my understanding that it means that the functionality was present "in that version", not "after that version". Either way, it's either a mistake or misleading.
Comment 1 Stefan Bodewig 2012-04-25 04:12:14 UTC
The functionality has been added for bug 42946 in svn revision 559386 - by that time we had created a branch for 1.7.1 and the patch didn't get merged into the branch.  The since-tags have been added later and were attributed to 1.7.1 by accident because the patch was added before the release.

Fixed in svn revision 1330090