<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other names may be trademarks of their respective owners.


The contents of this file are subject to the terms of either the GNU
General Public License Version 2 only ("GPL") or the Common
Development and Distribution License("CDDL") (collectively, the
"License"). You may not use this file except in compliance with the
License. You can obtain a copy of the License at
http://www.netbeans.org/cddl-gplv2.html
or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
specific language governing permissions and limitations under the
License.  When distributing the software, include this License Header
Notice in each file and include the License file at
nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the GPL Version 2 section of the License file that
accompanied this code. If applicable, add the following below the
License Header, with the fields enclosed by brackets [] replaced by
your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"

Contributor(s):

The Original Software is NetBeans. The Initial Developer of the Original
Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
Microsystems, Inc. All Rights Reserved.

If you wish your version of this file to be governed by only the CDDL
or only the GPL Version 2, indicate your decision by adding
"[Contributor] elects to include this software in this distribution
under the [CDDL or GPL Version 2] license." If you do not indicate a
single choice of license, a recipient has the option to distribute
your version of this file under either the CDDL, the GPL Version 2 or
to extend the choice of license to its licensees as provided above.
However, if you add GPL Version 2 code and therefore, elected the GPL
Version 2 license, then the option applies only if the new code is
made subject to such option by the copyright holder.
-->

<!--
Public ID: "-//NetBeans//DTD API changes list 1.0//EN"
Describes format of NetBeans API changes list.
-->

<!-- List of styles: -->
<!ENTITY % changeliststyles "
  list-all-apis
| incompat-by-date
| compat-by-date
| all-by-date
| all-by-version
| all-by-apis
| all-by-class
| details-by-date
| details-by-api
">

<!ENTITY % xhtml PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "../external/xhtml1-dtds/xhtml1-strict.dtd">
<!-- Override special to include date tags: -->
<!ENTITY % special "br | span | bdo | object | img | map | date">
<!-- Override lists to include change lists formatted in various ways: -->
<!ENTITY % lists "ul | ol | dl | changelist">
<!-- Override blocks to include standard-changelists: -->
<!ENTITY % blocktext "pre | hr | blockquote | address | standard-changelists">
<!-- Now include normal XHTML DTD: -->
%xhtml;

<!--
Document element.
-->
<!ELEMENT apichanges (apidefs, changes, htmlcontents)>

<!--
HTML contents of the document, with substitutions.
-->
<!ELEMENT htmlcontents (head, body)>

<!--
List of API changes, in no particular order.
-->
<!ELEMENT changes (change)*>

<!--
One API change. Giving an ID is recommended as it permits external hyperlinking
to the generated document (the ID will be used as an HTML anchor) - but if you
have one (and only one) associated issue, that will be used as a default stable
ID (format "issue-NNNNN"), or the version number will also be used as a default
stable ID (format "version-N.NN"). Giving the date is technically optional but
should be done for all new changes.
-->
<!ELEMENT change (api?, summary, version?, date?, author*, compatibility, description, class*, package*, issue*, branch*)>
<!ATTLIST change
          id ID #IMPLIED
>

<!--
Information about a Java class that is affected (unqualified name and package).
No inner classes please, outer only.
-->
<!ELEMENT class EMPTY>
<!ATTLIST class
          package CDATA #REQUIRED
          name CDATA #REQUIRED
          link (yes|no) "yes"
>

<!--
An affected Java package name.
-->
<!ELEMENT package EMPTY>
<!ATTLIST package
          name CDATA #REQUIRED
          link (yes|no) "yes"
>

<!--
Date on which the change was made (in the trunk).
-->
<!ELEMENT date EMPTY>
<!ATTLIST date
          day (1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20|21|22|23|24|25|26|27|28|29|30|31) #REQUIRED
          month (1|2|3|4|5|6|7|8|9|10|11|12) #REQUIRED
          year (1998|1999|2000|2001|2002|2003|2004|2005|2006|2007|2008|2009|2010|2011|2012|2013|2014|2015) #REQUIRED
>

<!--
Brief (one sentence) summary of the change.
-->
<!ELEMENT summary %Inline;>

<!--
The API specification version matching this change, if any.
-->
<!ELEMENT version EMPTY>
<!ATTLIST version
          major CDATA #REQUIRED
          minor CDATA #REQUIRED
          subminor CDATA #IMPLIED
          subsubminor CDATA #IMPLIED
>

<!--
A full textual description of the change, as freeform
HTML. May include multiple paragraphs etc.
-->
<!ELEMENT description %Flow;>

<!--
The API group which this change falls under, for categorization.
See <apidefs> for the list of choices.
-->
<!ELEMENT api EMPTY>
<!ATTLIST api
          name NMTOKEN #REQUIRED
>

<!--
What branch the change was made on. By default changes are assumed
to have occurred only on the trunk. If you make a change on a branch,
you must say so and say when this was done.
-->
<!ELEMENT branch (date?, version?)>
<!ATTLIST branch
          name (boston|release31|release32|pilsen|release33|release34|sierra) #REQUIRED
>

<!--
Mandatory information about compatibility and type of change.
At least one of deprecation, addition, deletion, or modification
must be set to "yes" (maybe more than one). You may specify
whether source and/or binary and/or semantic compatibility has
been retained; incompatible changes are listed prominently.
There may be some HTML content inside the element describing
details of compatibility or possibility of workarounds.
-->
<!ELEMENT compatibility %Flow;>
<!ATTLIST compatibility
          binary (compatible|incompatible) "compatible"
          source (compatible|incompatible) "compatible"
          semantic (compatible|incompatible) "compatible"
          deprecation (yes|no) "no"
          addition (yes|no) "no"
          deletion (yes|no) "no"
          modification (yes|no) "no"
>

<!--
Optional note about the person(s) committing the change.
Note that authors of changes are specified by (netbeans.org)
login ID, not full name.
-->
<!ELEMENT author EMPTY>
<!ATTLIST author
          login CDATA #REQUIRED
>

<!--
Optional issue(s) in IssueZilla justifying the change.
-->
<!ELEMENT issue EMPTY>
<!ATTLIST issue
          number CDATA #REQUIRED
>

<!--
A list of changes, formatted in a predefined way.
-->
<!ELEMENT changelist EMPTY>
<!ATTLIST changelist
          style (%changeliststyles;) #REQUIRED
>

<!--
The usually needed change lists.
-->
<!ELEMENT standard-changelists EMPTY>
<!ATTLIST standard-changelists
          module-code-name CDATA #REQUIRED
>

<!--
Definitions of APIs available.
Supply a code name for each and a display name as the element content.
-->
<!ELEMENT apidefs (apidef*)>
<!ELEMENT apidef %Inline;>
<!ATTLIST apidef
          name NMTOKEN #REQUIRED
>
