blob: 2bcfe38f88a82722d6550da515c1fa8e027b3e2e [file] [log] [blame]
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Change History for the File Systems API</title>
<link rel="stylesheet" href="prose.css" type="text/css">
</head>
<body>
<p class="overviewlink">
<a href="overview-summary.html" shape="rect">Overview</a>
</p>
<h1>Introduction</h1>
<h2>What do the Dates Mean?</h2>
<p>
The supplied dates indicate when the API change was made, on the CVS
trunk. From this you can generally tell whether the change should be
present in a given build or not; for trunk builds, simply whether it
was made before or after the change; for builds on a stabilization
branch, whether the branch was made before or after the given date. In
some cases corresponding API changes have been made both in the trunk
and in an in-progress stabilization branch, if they were needed for a
bug fix; this ought to be marked in this list.
</p>
<ul>
<li>The <code>release41</code> branch was made on Apr 03 '05 for use in the NetBeans 4.1 release.
Specification versions: 6.0 begins after this point.</li>
<li>The <code>release40</code> branch was made on Nov 01 '04 for use in the NetBeans 4.0 release.
Specification versions: 5.0 begins after this point.</li>
</ul>
<hr>
<h1>
<a name="list-all-apis">Index of APIs</a>
</h1>
<ul>
<li>
<a href="#filesystems_nb">Filesystems API - NetBeans extensions</a>
</li>
</ul>
<h1>
<a name="incompat-by-date">Incompatible changes by date</a>
</h1>
<p>Fuller descriptions of all changes can be found below (follow links).</p>
<p>Not all deprecations are listed here, assuming that the deprecated
APIs continue to essentially work. For a full deprecation list, please
consult the
<a href="deprecated-list.html">Javadoc</a>.</p>
<ul>
<li>(Oct 3 '14) <a href="#FileSystemStatus.icons2">FileSystem.Status API removed</a>
</li>
<li>(Apr 11 '14) <a href="#FileSystemStatus.icons">FileSystem.Status icon annotation moved</a>
</li>
</ul>
<h1>
<a name="all-by-date">All changes by date</a>
</h1>
<ul>
<li>(Oct 3 '14) <a href="#FileSystemStatus.icons2">FileSystem.Status API removed</a>
</li>
<li>(Apr 11 '14) <a href="#FileSystemStatus.icons">FileSystem.Status icon annotation moved</a>
</li>
</ul>
<h1>
<a name="all-by-version">Changes by version</a>
</h1>
<p>
These API specification versions may be used to indicate that a module
requires a certain API feature in order to function. For example, if you
see here a feature you need which is labelled <samp>1.20</samp>, your
manifest should contain in its main attributes the line:
</p>
<pre>OpenIDE-Module-Module-Dependencies: $codebase &gt; 1.20</pre>
<ul>
<li>
(9.1) <a href="#FileSystemStatus.icons2">FileSystem.Status API removed</a>
</li>
<li>
(9.0) <a href="#FileSystemStatus.icons">FileSystem.Status icon annotation moved</a>
</li>
</ul>
<h1>
<a name="all-by-class">Changes by affected class</a>
</h1>
<h2>
<a name="org.openide.filesystems.FileSystem"><code><span style="color:gray">org.openide.filesystems.</span>FileSystem</code></a>
</h2><ul><li>(Oct 3 '14) <a href="#FileSystemStatus.icons2">FileSystem.Status API removed</a>
</li>
<li>(Apr 11 '14) <a href="#FileSystemStatus.icons">FileSystem.Status icon annotation moved</a>
</li></ul><h2>
<a name="org.openide.filesystems.StatusDecorator"><code><span style="color:gray">org.openide.filesystems.</span>StatusDecorator</code></a>
</h2><ul><li>(Oct 3 '14) <a href="#FileSystemStatus.icons2">FileSystem.Status API removed</a>
</li></ul><hr>
<h1>
<a name="details-by-api">Details of all changes by API and date</a>
</h1>
<hr style="width:50%">
<h2>
<a name="filesystems_nb">Filesystems API - NetBeans extensions</a>
</h2>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="FileSystemStatus.icons2">FileSystem.Status API removed</a>
</h3>
<em>Oct 3 '14; API spec. version: 9.1; affected top-level classes: <code>org.openide.filesystems.StatusDecorator</code> <code>org.openide.filesystems.FileSystem</code>; made by: sdedic; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=247200">
#247200</a></em>
<br>
<p>
The FileSystem.Status was entirely removed, as it references class java.awt.Image, which
is not available in compact jdk profiles and may trigger GUI system initialization. See
javadocs of <a href="../org-openide-filesystems/org/openide/filesystems/StatusDecorator.html" shape="rect">StatusDecorator</a>
for details.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="FileSystemStatus.icons">FileSystem.Status icon annotation moved</a>
</h3>
<em>Apr 11 '14; API spec. version: 9.0; affected top-level classes: <code>org.openide.filesystems.FileSystem</code>; made by: sdedic; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=243561">
#243561</a></em>
<br>
<p>
The default implementation of FileSystem.Status annotated file's icon using ImageUtilities
which uses AWT graphics etc. Such dependency is not desirable in a standalone FileSystem API
library.
</p>
<p>
The builtin implementation now does not work with the icon at all and returns null. A proper
implementation for FileSystem.Status is looked up in default Lookup and is implemented
properly (with Icon annotations) in <code>openide.filesystems.nb</code> module.
</p>
<hr>
<p><span class="footnote">Built on September 14 2018.&nbsp;&nbsp;|&nbsp;&nbsp; Copyright &#169; 2017-2018 Apache Software Foundation. All Rights Reserved.</span></p>
</body>
</html>