<?xml version="1.0" encoding="UTF-8"?>

<?xml-stylesheet type="text/xml" href="../../nbbuild/javadoctools/apichanges.xsl"?>

<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../../nbbuild/javadoctools/apichanges.dtd">

<apichanges>

<!-- First, a list of API names you may use: -->

<apidefs>

<apidef name="general">Java Source API</apidef>

<!-- etc. -->

</apidefs>

<!-- ACTUAL CHANGES BEGIN HERE: -->

<changes>

<change id="server.is.free">

<api name="general"/>

<summary>Desktop independent parts of the Java Source module extracted</summary>

<version major="1" minor="0"/>

<date day="30" month="4" year="2014"/>

<author login="dbalek"/>

<compatibility modification="yes" addition="yes" binary="compatible" source="incompatible">

</compatibility>

<description>

<p>

Runtime compatibility remains, compile time compatibility is

mostly preserved too. It is however recommended to upgrade

dependencies of client modules. Try running

<code>ant fix-dependencies</code> in your Ant module.

</p>

</description>

<package name="org.netbeans.api.java.source"/>

<package name="org.netbeans.api.java.source.matching" link="no"/>

<package name="org.netbeans.api.java.source.support"/>

</change>

<change id="newUtilityMethods">

<api name="general"/>

<summary>Added couple of new utility methods to TreeUtilities, ElementUtilities, and SourceUtils.</summary>

<version major="0" minor="141"/>

<date day="14" month="4" year="2014"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added new utility methods getPathElementOfKind and getUninitializedFields to TreeUtilities.

Added new utility methods getElementName, findOverridableMethods, hasGetter and hasSetter to ElementUtilities.

Added new utility methods resolveCapturedType and getForwardReferences to SourceUtils.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<class package="org.netbeans.api.java.source" name="ElementUtilities" link="no"/>

<class package="org.netbeans.api.java.source" name="SourceUtils" link="no"/>

</change>

<change id="RemoteJavadocPolicy">

<api name="general"/>

<summary>Added a possibility to specify remote javadoc handling policy</summary>

<version major="0" minor="138"/>

<date day="15" month="7" year="2014"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a possibility to specify remote javadoc handling policy in <code>JavadocHelper</code>

</description>

<issue number="240501"/>

</change>

<change id="nodeReplacemenHints">

<api name="general"/>

<summary>Added API to preserve comments and whitespaces in transformations</summary>

<version major="0" minor="137"/>

<date day="10" month="7" year="2014"/>

<author login="sdedic"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

If a transformation moves a Tree node elsewhere, or produces a replacement of it, it can now mark the new tree as a 'replacement' for the old one,

which causes whitespaces (most notably comments) to attach to the replacement node.

</description>

</change>

<change id="findLabelSpan">

<api name="general"/>

<summary>Added utility methods to find span of a Label's name in the source.</summary>

<version major="0" minor="131"/>

<date day="19" month="11" year="2013"/>

<author login="ralphbenjamin"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added utility methods to find span of a Label's name in the source.

Returns starting and ending offset of the label's name in the source code that was parsed

(ie. CompilationInfo.getText()), which may differ from the positions in the source

document if it has been already altered.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="238560"/>

</change>

<change id="toScopeWithDisabledAccessibilityChecks">

<api name="general"/>

<summary>Adding <code>TreeUtilities.toScopeWithDisabledAccessibilityChecks</code> method.</summary>

<version major="0" minor="129"/>

<date day="20" month="8" year="2013"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Adding the utility method to create a Scope capable to access

all private methods and fields when parsing and evaluating expressions.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="234645"/>

</change>

<change id="findBodySpan">

<api name="general"/>

<summary>Added utility method to find span of a ClassTree's body in the source.</summary>

<version major="0" minor="127"/>

<date day="27" month="5" year="2013"/>

<author login="ralphbenjamin"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added utility method to find span of a ClassTree's body in the source.

Returns starting and ending offset of the body in the source code that was parsed

(ie. CompilationInfo.getText()), which may differ from the positions in the source

document if it has been already altered.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="229734"/>

</change>

<change id="GeneratorUtilities-createDefaultConstructor">

<api name="general"/>

<summary>Adding <code>GeneratorUtilities.createDefaultConstructor</code> method.</summary>

<version major="0" minor="126"/>

<date day="16" month="5" year="2013"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

A utility method createDefaulConstructor has been added to org.netbeans.api.java.source.GeneratorUtilities class.

</description>

<issue number="229233" />

</change>

<change id="DocTreesSupport">

<api name="general"/>

<summary>Added support for DocTrees.</summary>

<version major="0" minor="124"/>

<date day="3" month="5" year="2013"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added new methods to support working with DocTrees.

</description>

<class package="org.netbeans.api.java.source" name="CompilationInfo" link="no"/>

<class package="org.netbeans.api.java.source" name="WorkingCopy" link="no"/>

<class package="org.netbeans.api.java.source" name="TreeMaker" link="no"/>

<issue number="229081"/>

</change>

<change id="CodeStyle-Naming">

<api name="general"/>

<summary>Added <code>CodeStyleUtils</code>.</summary>

<version major="0" minor="123"/>

<date day="30" month="4" year="2013"/>

<author login="ralphbenjamin"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added class <code>CodeStyleUtils</code>, which helps with

conforming java names to the naming codestyle. Used for

variable naming and getter/setter names.

</description>

<class package="org.netbeans.api.java.source" name="CodeStyleUtils" link="no"/>

<issue number="228870"/>

</change>

<change id="ProfileSupport">

<api name="general"/>

<summary>Added support for JDK 8 Profiles.</summary>

<version major="0" minor="119"/>

<date day="12" month="4" year="2013"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>ProfileSupport</code> class providing utility methods for JDK 8 profiles.

</description>

<class package="org.netbeans.api.java.source.support" name="ProfileSupport" link="no"/>

<issue number="228384"/>

</change>

<change id="getSymbols">

<api name="general"/>

<summary>Added several methods to support Java 8 features.</summary>

<version major="0" minor="117"/>

<date day="28" month="2" year="2013"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>ClassIndex.getDeclaredSymbols</code>.

</description>

<class package="org.netbeans.api.java.source" name="ClassIndex" link="no"/>

<issue number="227607"/>

</change>

<change id="ElementUtilities-findElement">

<api name="general"/>

<summary>Added ElementUtilities.findElement</summary>

<version major="0" minor="115"/>

<date day="22" month="3" year="2013"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a new method to find an element based on its description:

<code>ElementUtilities.findElement</code>.

</description>

<issue number="227285"/>

</change>

<change id="LambdaEnhancements">

<api name="general"/>

<summary>Added several methods to support Java 8 features.</summary>

<version major="0" minor="112"/>

<date day="13" month="2" year="2013"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added several new methods to support Java 8 features. Namely: <code>ElementUtilities.isEffectivelyFinal</code>,

<code>TreeMaker.TypeAnnotation</code>, <code>TreeMaker.LambdaExpression</code>,

<code>TreeMaker.addLambdaParameter</code>, <code>TreeMaker.insertLambdaParameter</code>,

<code>TreeMaker.removeLambdaParameter</code>, <code>TreeMaker.setLambdaBody</code>,

<code>TreeMaker.MemberReference</code> and <code>TypeUtilities.getDescriptorType</code>.

<code>TreeMaker.setLabel</code> was updated to understand MemberReferences.

</description>

<issue number="225533"/>

</change>

<change id="SourceUtils-getDependentRoots">

<api name="general"/>

<summary>Added overloaded method <code>SourceUtils.getDependentRoots</code>.</summary>

<version major="0" minor="110"/>

<date day="31" month="12" year="2012"/>

<author login="ralphbenjamin"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a new overloaded method <code>getDependentRoots</code> to class <code>SourceUtils</code>,

that adds an option to filter non opened projects.

</description>

<class package="org.netbeans.api.java.source" name="SourceUtils" link="no"/>

<issue number="223917"/>

</change>

<change id="WorkingCopy-resolveRewriteTarget">

<api name="general"/>

<summary>Added <code>WorkingCopy.resolveRewriteTarget</code>.</summary>

<version major="0" minor="102"/>

<date day="11" month="4" year="2012"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a method <code>resolveRewriteTarget</code> to class <code>WorkingCopy</code>,

that returns the tree into which the given tree has been rewritten.

</description>

<class package="org.netbeans.api.java.source" name="WorkingCopy" link="no"/>

<issue number="209375"/>

</change>

<change id="GeneratorUtilities-createFromTemplate">

<api name="general"/>

<summary>Added <code>GeneratorUtilities.createFromTemplate</code>.</summary>

<version major="0" minor="100"/>

<date day="5" month="4" year="2012"/>

<author login="ralphbenjamin"/>

<compatibility addition="yes" binary="compatible" semantic="compatible" source="compatible" deletion="no" deprecation="no" modification="no"/>

<description>

Added the method <code>createFromTemplate</code> to class <code>GeneratorUtilities</code>,

which will create a new CompilationUnitTree from a template.

</description>

<class package="org.netbeans.api.java.source" name="GeneratorUtilities" link="no"/>

<issue number="209798"/>

</change>

<change id="GeneratorUtilities-appendToAnnotationValue">

<api name="general"/>

<summary>Added <code>GeneratorUtilities.appendToAnnotationValue</code>.</summary>

<version major="0" minor="99"/>

<date day="13" month="3" year="2012"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added two overloaded methods <code>appendToAnnotationValue</code> to class <code>GeneratorUtilites</code>,

which augment <code>ModifiersTree</code> or <code>CompilationUnitTree</code> with

annotation with the given attribute values.

</description>

<class package="org.netbeans.api.java.source" name="GeneratorUtilities" link="no"/>

<issue number="208570"/>

</change>

<change id="elementhandle-create">

<api name="general"/>

<summary>Added factory methods to create an <code>ElementHandle</code> for type and package.</summary>

<version major="0" minor="98"/>

<date day="13" month="3" year="2012"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a factory methods to create an <code>ElementHandle</code> for type and package from binary name.

</description>

<class package="org.netbeans.api.java.source" name="ElementHandle" link="no"/>

<issue number="209082"/>

</change>

<change id="references-count">

<api name="general"/>

<summary>Added <code>ReferencesCount</code> support class which provides frequences of type usage in a source root.</summary>

<version major="0" minor="97"/>

<date day="13" month="3" year="2012"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>ReferencesCount</code> support class which provides information how many classes on the source path (source root) are using

given type or package.

</description>

<issue number="209038"/>

</change>

<change id="class-members-order">

<api name="general"/>

<summary>Added several methods to <code>CodeStyle</code> supporting customization of the generated class members order and other minor formatting enhancements.</summary>

<version major="0" minor="96"/>

<date day="21" month="2" year="2012"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>CodeStyle.getClassMemberGroups</code>, <code>CodeStyle.getClassMemberInsertionPoint</code>,

to support customization of the generated class members order, and <code>CodeStyle.wrapAfterDotInChainedMethodCalls</code>,

<code>CodeStyle.getBlankLinesAfterAnonymousClassHeader</code>, <code>CodeStyle.spaceAroundAnnotationValueAssignOps</code>

to support minor formatting enhancements.

</description>

<issue number="208503"/>

</change>

<change id="SourceUtils-backgroundScan">

<api name="general"/>

<summary>Added <code>SourceUtils.waitUserActionTask</code>.</summary>

<version major="0" minor="95"/>

<date day="26" month="1" year="2012"/>

<author login="sdedic"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added class <code>ScanUtils</code>, which help to check completness of parsing data and allow to

restart processing after project scan finishes to see most complete data. Elements can be

checked using new methods

<code>checkElement</code>, <code>resolveElement</code>, <code>findElement</code> and <code>findTypeElement</code>

that throws an exception indicating the user task should be aborted and restarted later. See javadoc for more info.

</description>

<class package="org.netbeans.api.java.source" name="ScanUtils" link="no"/>

<issue number="207704"/>

</change>

<change id="Indexing-aware-JavaSourceTaskFactories">

<api name="general"/>

<summary>Added <code>TaskIndexingMode</code> into <code>JavaSourceTaskFactory</code>s</summary>

<version major="0" minor="94"/>

<date day="26" month="1" year="2012"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

The <code>CancellableTask</code>s created by the <code>JavaSourceTaskFactory</code>s are not executed during the scan to keep the semantic backward compatibility.

Constructors with the <code>TaskIndexingMode</code> were added into these factories to allow tasks to run during the scan.

</description>

<class package="org.netbeans.api.java.source" name="JavaParserResultTask" link="no"/>

<class package="org.netbeans.api.java.source" name="JavaSourceTaskFactory" link="no"/>

<class package="org.netbeans.api.java.source.support" name="SelectionAwareJavaSourceTaskFactory"/>

<class package="org.netbeans.api.java.source.support" name="LookupBasedJavaSourceTaskFactory"/>

<class package="org.netbeans.api.java.source.support" name="EditorAwareJavaSourceTaskFactory"/>

<class package="org.netbeans.api.java.source.support" name="CaretAwareJavaSourceTaskFactory"/>

<issue number="207459"/>

</change>

<change id="TreePathHandle-getElementHandle">

<api name="general"/>

<summary>Added <code>TreePathHandle.getElementHandle</code>.</summary>

<version major="0" minor="93"/>

<date day="30" month="11" year="2011"/>

<author login="jbecicka"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TreePathHandle.getElementHandle</code> that returns corresponding ElementHandle for given TreePathHandle.

</description>

<issue number="205719"/>

</change>

<change id="TreeUtilities-isCompileTimeConstantExpression">

<api name="general"/>

<summary>Added <code>TreeUtilities.isCompileTimeConstantExpression</code>.</summary>

<version major="0" minor="91"/>

<date day="7" month="11" year="2011"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TreeUtilities.isCompileTimeConstantExpression</code> that tests whether the given expression is a compile-time constant.

</description>

<issue number="204435"/>

</change>

<change id="CompilationInfo-cache">

<api name="general"/>

<summary>Added <code>CompilationInfo.getCachedValue</code>, <code>CompilationInfo.putCachedValue</code> and <code>CompilationInfo.CacheClearPolicy</code>.</summary>

<version major="0" minor="90"/>

<date day="26" month="10" year="2011"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>CompilationInfo.getCachedValue</code> and <code>CompilationInfo.putCachedValue</code> methods and

<code>CompilationInfo.CacheClearPolicy</code> enum so that tasks can easily store temporary data with predictable termination.

</description>

<issue number="203890"/>

</change>

<change id="PackageUsages">

<api name="general"/>

<summary>Added <code>ClassIndex.getResourcesForPackage</code> and <code>ClassIndex.getElementsForPackage</code>to allow to find package usages.</summary>

<version major="0" minor="89"/>

<date day="20" month="10" year="2011"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>ClassIndex.getResourcesForPackage</code> and <code>ClassIndex.getElementsForPackage</code>to allow to find package usages.

Currently the client which needs to find usages of all types declared in the package has to list the package and query usages of each type

individually which is inefficient.

</description>

<issue number="131944"/>

</change>

<change id="OrganizeImports">

<api name="general"/>

<summary>Added <code>GeneratorUtilities.addImports</code> and several methods to <code>CodeStyle</code> to support organizing imports.</summary>

<version major="0" minor="86"/>

<date day="29" month="8" year="2011"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>GeneratorUtilities.addImports</code> method to add import statements for given elements to a compilation unit

in a way that complies with the rules specified in <code>CodeStyle</code>. Added <code>CodeStyle.importInnerClasses</code>,

<code>CodeStyle.getImportGroups</code>, and <code>CodeStyle.separateImportGroups</code> to specify the rules.

</description>

<issue number="201254"/>

</change>

<change id="SourceUtils-computeDuplicates">

<api name="general"/>

<summary>Added SourceUtils.computeDuplicates to get code duplicates of provided expression</summary>

<version major="0" minor="85"/>

<date day="26" month="8" year="2011"/>

<author login="jbecicka"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a method <code>SourceUtils.computeDuplicates</code> to get code duplicates of provided expression.

</description>

<class package="org.netbeans.api.java.source" name="SourceUtils" link="no"/>

<issue number="199106"/>

</change>

<change id="ElementHandle-jvm-signature">

<api name="general"/>

<summary>Added SourceUtils.getJVMSignature to obtain the JVM signature for an ElementHandle</summary>

<version major="0" minor="84"/>

<date day="1" month="8" year="2011"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a method <code>SourceUtils.getJVMSignature</code> to obtain the JVM signature for an <code>ElementHandle</code>.

</description>

<class package="org.netbeans.api.java.source" name="SourceUtils" link="no"/>

<issue number="200237"/>

</change>

<change id="comments-reformat">

<api name="general"/>

<summary>Added several methods to <code>CodeStyle</code> to support reformatting of comments.</summary>

<version major="0" minor="83"/>

<date day="13" month="7" year="2011"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>CodeStyle.enableBlockCommentFormatting</code>, <code>CodeStyle.enableJavadocFormatting</code>,

<code>CodeStyle.wrapCommentText</code>, <code>CodeStyle.wrapOneLineComments</code>,

<code>CodeStyle.preserveNewLinesInCommentst</code>, <code>CodeStyle.blankLineAfterJavadocDescription</code>,

<code>CodeStyle.blankLineAfterJavadocParameterDescriptions</code>, <code>CodeStyle.blankLineAfterJavadocReturnTag</code>,

<code>CodeStyle.generateParagraphTagOnBlankLines</code>, <code>CodeStyle.alignJavadocParameterDescriptions</code>,

<code>CodeStyle.alignJavadocReturnDescriptions</code>, <code>CodeStyle.alignJavadocExceptionDescriptions</code>,

to support reformatting of comments.

</description>

<issue number="20672"/>

</change>

<change id="ClassIndex-package-scope">

<api name="general"/>

<summary>Added package search scope into <code>ClassIndex</code> to restrict search in given packages</summary>

<version major="0" minor="82"/>

<date day="22" month="6" year="2011"/>

<author login="tzezula"/>

<compatibility addition="yes"/>

<description>

Added package search scope into <code>ClassIndex</code> to restrict search in given packages.

</description>

<class package="org.netbeans.api.java.source" name="ClassIndex" link="no"/>

<issue number="197194"/>

</change>

<change id="TreeUtilities.findMethodParameterSpan">

<api name="general"/>

<summary>Find span of the MethodTree#getParameters() parameter list in the source.</summary>

<version major="0" minor="81"/>

<date day="1" month="6" year="2011"/>

<author login="ralphbenjamin"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

<code>TreeUtilities</code> has a new <code>findMethodParameterSpan(MethodTree method)</code> method.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="199080"/>

</change>

<change id="TreePathHandle-from-ElementHandle">

<api name="general"/>

<summary>TreePathHandle can be created from ElementHandle</summary>

<version major="0" minor="79"/>

<date day="26" month="4" year="2011"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

<code>TreePathHandle</code> has a new <code>from(ElementHandle)</code> method.

</description>

<class package="org.netbeans.api.java.source" name="TreePathHandle" link="no"/>

<issue number="197848"/>

</change>

<change id="run-modification-task-sourceless">

<api name="general"/>

<summary>JavaSource.runModificationTask can run on source-less JavaSources</summary>

<version major="0" minor="74"/>

<date day="21" month="1" year="2011"/>

<author login="jlahoda"/>

<compatibility addition="no" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

<code>JavaSource.runModificationTask</code> method works on source-less <code>JavaSource</code>s.

</description>

<class package="org.netbeans.api.java.source" name="JavaSource" link="no"/>

<issue number="119887"/>

</change>

<change id="index-based-is-main">

<api name="general"/>

<summary>Added a method for checking the existence of the main method using index only</summary>

<version major="0" minor="71"/>

<date day="10" month="12" year="2010"/>

<author login="tzezula"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added a new version of the <code>isMain</code> method into <code>org.netbeans.api.java.source.SourceUtils</code> which allows

check based only on index information.

</description>

<class package="org.netbeans.api.java.source" name="SourceUtils" link="no"/>

<issue number="191648"/>

</change>

<change id="jdk7-update-2">

<api name="general"/>

<summary>DisjointTypeTree renamed to DisjunctiveTypeTree, AnnotationTypeTree has been removed</summary>

<version major="0" minor="70"/>

<date day="12" month="11" year="2010"/>

<author login="jlahoda"/>

<compatibility binary="incompatible" deletion="no" deprecation="no" modification="yes" semantic="compatible" source="incompatible"/>

<description>

<code>com.sun.source.tree.DisjointTypeTree</code> renamed to <code>com.sun.source.tree.DisjunctiveTypeTree</code> from javac,

so adjusting <code>TreeMaker</code> to it. <code>com.sun.source.tree.AnnotationTypeTree</code> has been removed from javac and

is no longer available.

</description>

<class package="org.netbeans.api.java.source" name="TreeMaker" link="no"/>

</change>

<change id="jdk7-update">

<api name="general"/>

<summary>Added several methods to support new API for modeling JDK7 features.</summary>

<version major="0" minor="67"/>

<date day="12" month="10" year="2010"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>CodeStyle.alignMultilineTryResources</code>, <code>CodeStyle.spaceBeforeTryParen</code>,

<code>CodeStyle.spaceWithinTryParens</code>, <code>CodeStyle.wrapTryResources</code>

<code>TreeMaker.DisjointType</code>, <code>CodeStyle.Try</code> and <code>TreeUtilities.CLASS_TREE_KINDS</code>

to support new language features in JDK7.

</description>

<issue number="190767"/>

</change>

<change id="TreeMaker.PackageAnnotations">

<api name="general"/>

<summary>Added TreeMaker.CompilationUnit(List&lt;AnnotationTree&gt;, ...), TreeMaker.addPackageAnnotation, TreeMaker.insertPackageAnnotation, TreeMaker.removePackageAnnotation methods.</summary>

<version major="0" minor="66"/>

<date day="27" month="9" year="2010"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TreeMaker.CompilationUnit(List&lt;AnnotationTree&gt;, ...)</code>,

<code>TreeMaker.addPackageAnnotation</code>, <code>TreeMaker.insertPackageAnnotation</code>,

<code>TreeMaker.removePackageAnnotation</code> to allow modification of the list of package annotations.

</description>

<class package="org.netbeans.api.java.source" name="TreeMaker" link="no"/>

<issue number="157760"/>

</change>

<change id="TreeMaker.QualIdent_String">

<api name="general"/>

<summary>Added TreeMaker.QualIdent(String) and TreeMaker.Type(String) method.</summary>

<version major="0" minor="65"/>

<date day="16" month="9" year="2010"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TreeMaker.QualIdent(String)</code> and <code>TreeMaker.Type(String)</code> method, which allow

to construct QualIdents and Types from String specification.

</description>

<class package="org.netbeans.api.java.source" name="TreeMaker" link="no"/>

<issue number="190123"/>

</change>

<change id="TreeUtilities.translate">

<api name="general"/>

<summary>Added TreeUtilities.translate method.</summary>

<version major="0" minor="64"/>

<date day="8" month="9" year="2010"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TreeUtilities.translate</code> method, which allows

to construct new tree based on a given set of changes.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="190019"/>

</change>

<change id="TypeUtilities.getTypeName">

<api name="general"/>

<summary>Added TypeUtilities.getTypeName method.</summary>

<version major="0" minor="62"/>

<date day="13" month="7" year="2010"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TypeUtilities.getTypeName</code> method, which

allows to print type to string.

</description>

<class package="org.netbeans.api.java.source" name="TypeUtilities" link="no"/>

<issue number="104194"/>

</change>

<change id="SourceUtils.getAttributeValueCompletions">

<api name="general"/>

<summary>Added SourceUtils.getAttributeValueCompletions method.</summary>

<version major="0" minor="57"/>

<date day="2" month="3" year="2010"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>SourceUtils.getAttributeValueCompletions</code> method, which

returns a list of completions for an annotation attribute value suggested by

annotation processors.

</description>

<class package="org.netbeans.api.java.source" name="SourceUtils" link="no"/>

<issue number="111292"/>

</change>

<change id="TreeUtilities.exotic">

<api name="general"/>

<summary>Added support for encoding/decoding exotic identifiers to TreeUtilities.</summary>

<version major="0" minor="56"/>

<date day="24" month="2" year="2010"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added support for encoding/decoding exotic identifiers to <code>TreeUtilities</code>.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="180842"/>

</change>

<change id="GeneratorUtilities.copyComments">

<api name="general"/>

<summary>Added GeneratorUtilities.copyComments method.</summary>

<version major="0" minor="51"/>

<date day="27" month="10" year="2009"/>

<author login="jlahoda"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>GeneratorUtilities.copyComments</code> method, which

copies comments from one tree to another tree.

</description>

<class package="org.netbeans.api.java.source" name="GeneratorUtilities" link="no"/>

<issue number="175020"/>

</change>

<change id="TreeUtilities.isEnumConstant">

<api name="general"/>

<summary>Added TreeUtilities.isEnumConstant() method.</summary>

<version major="0" minor="48"/>

<date day="14" month="8" year="2009"/>

<author login="msauer"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>TreeUtilities.isEnumConstant()</code> method, which

determines whether tree represents an enum constant.

</description>

<class package="org.netbeans.api.java.source" name="TreeUtilities" link="no"/>

<issue number="170373"/>

</change>

<change id="CompilationInfo.getSourceVersion">

<api name="general"/>

<summary>Added CompilationInfo.getSourceVersion() method.</summary>

<version major="0" minor="47"/>

<date day="12" month="8" year="2009"/>

<author login="dbalek"/>

<compatibility addition="yes" binary="compatible" deletion="no" deprecation="no" modification="no" semantic="compatible" source="compatible"/>

<description>

Added <code>CompilationInfo.getSourceVersion()</code> to return the SourceVersion used by the javac compiler.

</description>

<class package="org.netbeans.api.java.source" name="CompilationInfo" link="no"/>

<issue number="169970"/>

</change>

<change id="JavaSource.patchedPublic">

<api name="general"/>

<summary>Removing the binary compatibility methods (using bytecode patching) from JavaSource</summary>

<version major="0" minor="46"/>

<date day="6" month="8" year="2009"/>

<author login="tzezula"/>

<compatibility binary="incompatible" deletion="yes" source="compatible"/>