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.
release41 branch was made on Apr 03 '05 for use in the NetBeans 4.1 release.
Specification versions: 6.0 begins after this point.release40 branch was made on Nov 01 '04 for use in the NetBeans 4.0 release.
Specification versions: 5.0 begins after this point.Fuller descriptions of all changes can be found below (follow links).
Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.
NbDocument.Colors moved to org.openide.options.
NbDocument.COLORS
PrintSettings
CloneableEditorSupport.notifyModified is called only on first modification
NbDocument.getDocument,
NbDocument.openDocument with offset parameter and
NbDocument.openDocument with line and column parameter
NbDocument.Colors moved to org.openide.options.
NbDocument.COLORS
PrintPreferences
PrintSettings
severity, custom_sidebar_color, browsable and priority
attributes
Line.SHOW_TOFRONT
CloneableEditorSupport.notifyModified is called only on first modification
getInputStream() method in CloneableEditorSupport
IndexOutOfBoundsException
can be thrown from NbDocument.findLineOffset method
Line methods deprecated in favor of annotations
IndentEngine a service type
PrintSettings.getPageFormat requires a printer job
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 1.20, your manifest should contain in its main attributes the line:
OpenIDE-Module-Module-Dependencies: org.openide.text > 1.20
NbDocument.getDocument,
NbDocument.openDocument with offset parameter and
NbDocument.openDocument with line and column parameter
NbDocument.Colors moved to org.openide.options.
NbDocument.COLORS
PrintPreferences
PrintSettings
severity, custom_sidebar_color, browsable and priority
attributes
Line.SHOW_TOFRONT
CloneableEditorSupport.notifyModified is called only on first modification
getInputStream() method in CloneableEditorSupport
Line methods deprecated in favor of annotations
org.openide.text.ActiveEditorDrop
org.openide.text.Annotatable
org.openide.text.Annotation
org.openide.text.AnnotationProvider
org.openide.text.CloneableEditor
org.openide.text.CloneableEditorSupport
CloneableEditorSupport.notifyModified is called only on first modification
getInputStream() method in CloneableEditorSupport
org.openide.text.CloneableEditorSupportRedirector
org.openide.windows.CloneableOpenSupport
org.openide.text.DataEditorSupport
org.openide.text.DocumentLine
Line methods deprecated in favor of annotations
org.openide.text.EditorSupport
org.openide.text.IndentEngine
IndentEngine a service type
org.openide.text.Line
Line.SHOW_TOFRONT
Line methods deprecated in favor of annotations
org.openide.text.NbDocument
NbDocument.getDocument,
NbDocument.openDocument with offset parameter and
NbDocument.openDocument with line and column parameter
NbDocument.Colors moved to org.openide.options.
NbDocument.COLORS
IndexOutOfBoundsException
can be thrown from NbDocument.findLineOffset method
org.openide.loaders.OpenSupport
org.openide.text.PositionRef
org.openide.text.PrintPreferences
PrintPreferences
org.openide.text.PrintSettings
PrintSettings
PrintSettings.getPageFormat requires a printer job
PositionRef; made by: sdedic; issues:
#244744
PositionRef can provide a Position object, but does not itself implement
the Position interface, although it can provide the offset.
The change is just to formally implement the j.s.t.Position.
NbDocument.getDocument,
NbDocument.openDocument with offset parameter and
NbDocument.openDocument with line and column parameter
NbDocument; made by: theofanis; issues:
#209058
First method gets the StyledDocument associated with a file while the other two are used to open the document associated with a file in the Editor window in a position specified by the offset or line and column while controlling open and visibility behavior.
CloneableEditorSupport; made by: err; issues:
#199568
Define semantics of a nested empty commit group.
Add MARK_COMMIT_GROUP to fill a gap in API;
It adds an inprogress commit-group and starts a new one.
CloneableEditor; made by: jtulach; issues:
#196810
CloneableEditor has a new utility method
closeLast.
CloneableEditor; made by: jtulach; issues:
#196810
CloneableEditor offers new constructor
that will reuse the lookup provided by its
CloneableEditorSupport.
CloneableEditor; made by: jtulach; issues:
#196810
Subclasses of CloneableEditor can manually request own
initialization by calling its
initializeBySupport
method.
NbDocument; made by: mmetelka; issues:
#204828
Added NbDocument.getEditToBeUndoneOfType() and NbDocument.getEditToBeRedoneOfType() to retrieve custom undoable edits that wrap document-generated undoable edits.
NbDocument; made by: mmetelka; issues:
#194816
addAnnotation() and removeAnnotation()
no longer re-plan their work into EDT.
CloneableEditorSupport; made by: err; issues:
#103467
Support for chunking edits via BEGIN_COMMIT_GROUP
and END_COMMIT_GROUP.
Actions may now be placed in Editors/TabActions to add
them to the context menu of the tab of an editor window.
NbDocument; made by: vstejskal; issues:
#97517
Deprecating BREAKPOINT_STYLE_NAME, ERROR_STYLE_NAME,
CURRENT_STYLE_NAME, NORMAL_STYLE_NAME in NbDocument class.
Document styles have been abandoned when Annotations API was created.
These constants are no longer functional.
CloneableEditorSupport; made by: mslama; issues:
#171713
Add CloneableEditorSupport.asynchronous to control if CloneableEditorSupport.open opens document synchronously or not. If CloneableEditorSupport.asynchronous return true then CloneableEditorSupport.open opens document synchronously and handles UserQuestionException. If CloneableEditorSupport.asynchronous return false then CloneableEditorSupport.open does not open document. Document is then opened during initialization of CloneableEditor form non AWT thread and UserQuestionException is handled there. Implementation of method asynchronous in CloneableEditorSupport returns false ie. it keeps original behavior of CloneableEditorSupport.open. Subclasses can overwrite method asynchronous to return true to avoid blocking AWT thread by call CloneableEditorSupport.open which calls CloneableEditorSupport.openDocument.
NbDocument; made by: mslama; issues:
#168415
Add NbDocument.findRecentEditorPane to allow non blocking retrieval of recently selected editor pane. Method returns null when editor pane initialization is not finished. Client is notified about finished pane initialization by property change event EditorCookie.Observable.PROP_OPENED_PANES. NbDocument.findRecentEditorPane is replacement for EditorCookie.getOpenedPanes which waits till all editor panes are initialized. It is nonblocking only when EditorCookie is instanceof CloneableEditorSupport.
Line; made by: mslama; issues:
#138146
Improve Line.show to have better control over its open/visibility behavior. Previous version of Line.show mixes open and visibility behavior into one parameter. New version separates this into 2 parameters. It is possible to use any combination of these 2 parameters without need to add new constants for previous version. 2 enum types ShowOpenType and ShowVisibilityType are added.
CloneableEditorSupport; made by: mmetelka; issues:
#13063
CloneableEditorSupport.saveDocument() checks document's "beforeSaveDocument" property for a Runnable to be executed before the actual save will be done.
CloneableEditor; made by: jtulach; issues:
#130171
In order to speedup, or remove the load of initialization of kit in AWT during startup, the initialization is done outside of AWT thread as much as possible. This provides new API for editor kits, one component and one system property.
NbDocument.Colors moved to org.openide.options.
NbDocument; made by: mslama; issues:
#88531
Class NbDocument.Colors was removed to remove dependency on org.openide.options.
Runtime backward compatibility was ensured by moving into org.openide.options module which is
already deprecated.
NbDocument.COLORS
NbDocument; made by: mslama; issues:
#88531
Field NbDocument.COLORS was removed to remove dependency on org.openide.options.
PrintPreferences
PrintPreferences; made by: rmatous; issues:
#88531
Class PrintPreferences was added as replacement for original
class PrintSettings.
PrintSettings
org.openide.text.PrintSettings; made by: rmatous; issues:
#88531
Classes PrintSettings and PrintSettingsBeanInfo
were removed. Runtime backward compatibility was ensured
by moving both into org.openide.options module which is already deprecated.
Line; made by: pnejedly; issues:
#94607
The Line.show() method accepts show mode constant,
that influences the way the Line is displayed on the request.
These additional constants provide new modes for opening the line
in a shared editor window that can be replaced by subsequent calls of
Line.show(SHOW_REUSE) on Lines from different
Document. This is useful for quick source browsing without
cluttering the UI with too many opened editors.
CloneableEditorSupportRedirector; made by: jtulach; issues:
#51690
The CloneableEditorSupportRedirector
class allows a redirection of operations on a CloneableEditorSupport
object to another one. This can be useful if there are two logical
files representing one physical and one wants to have just a single
editor for both files. In such case just implement the
CloneableEditorSupportRedirector.
CloneableEditorSupport; made by: vstejskal; issues:
#52657
The CloneableEditorSupport.getEditorKit() method
allows to access EditorKits registered in
MimeLookup. This is meant to be the primary way of finding
EditorKits registered by Netbeans modules. The
JEditorPane.createEditorKitForContentType and the
other related methods in JEditorPane should only be
used for finding EditorKits provided by JDK.
CloneableEditor; made by: saubrecht; issues:
#50129
The custom JEditorPane used by CloneableEditor
has a custom DropTarget
instance which listens for some special objects (usually files) being
dragged over the editor pane and uses an instace of
ExternalDropHandler class from the global
Lookup to see if the drop can be accepted.
If the dragged object is supported then the caret in the editor does
not follow the cursor to indicate the drop position as if when dragging
a text snippet and regular Drop-Copy cursor is shown instead.
When the object is dropped into the editor the ExternalDropHandler
will process it (e.g. opens the file in a new editor tab).
CloneableEditorSupport CloneableEditor org.openide.text.DataEditorSupport; made by: dsimonek; issues:
#66777
A messageHtmlName method has been added to
CloneableEditorSupport to allow for display names with html tags.
CloneableEditor uses this new method to set its html display name
correctly. Also DataEditorSupport now overrides
messageHtmlName to connect with Node.getHtmlDisplayName.
ActiveEditorDrop; made by: mroskanin; issues:
#61367
An ActiveEditorDrop interface has been added due to
drag and drop callback support described at issue #61367
CloneableEditorSupport CloneableEditor; made by: abadea; issues:
#60922
A wrapEditorComponent method has been added to
CloneableEditorSupport allowing to wrap the editor component
in another component.
severity, custom_sidebar_color, browsable and priority
attributes
severity, custom_sidebar_color, browsable and priority
attributes.
Line.SHOW_TOFRONT
Line; issues:
#47825
EditorSupportLineSet and brings
editor's parent Window to be fronted above all other top-level windows.
CloneableEditorSupport.notifyModified is called only on first modification
CloneableEditorSupport; made by: jtulach; issues:
#52493
It has been found that CloneableEditorSupport.notifyModified
is called more often than it should. It used to be called after every
keystroke, which is bad, as its return value could not be honored -
it is not possible to prevent modification when the document is already
modified. Now the method is called only on first modification of the
document and if it returns false, the modification is not allowed.
This may be incompatible for clients that relied on the often calls.
Such clients need to be fixed.
CloneableEditorSupport; made by: pnejedly; issues:
#51441
Deprecated EditorSupport has had a method
openAt, which has no easy replacement in
CloneableEditorSupport.
The method is implemented in CloneableEditorSupport,
but is package private. This change makes it protected.
CloneableEditorSupport.Pane interface,
Pane.ensureVisible(). The implementing classes should ensure that the pane's component
is open and visible after calling this method. Is used in CloneableEditorSupport.openAt().
Line; made by: jtulach; issues:
#43484
AnnotationProvider; made by: pnejedly; issues:
#41345
NbDocument CloneableEditorSupport CloneableEditor org.openide.text.EditorSupport; made by: mkleint; issues:
#41085
CloneableEditorSupport; made by: pnejedly; issues:
#37892
CloneableEditorSupport.documentID
to allow subclasses to compute preferred ID String used for
TopComponent persistence.
getInputStream() method in CloneableEditorSupport
CloneableEditorSupport; made by: pjiricka; issues:
#34692
CloneableEditorSupport; made by: jtulach; issues:
#32937
PositionRef org.openide.text.DataEditorSupport; made by: jtulach; issues:
#32143
PositionRef.getEditorSupport() method
has been removed to enabled separation of EditorSupport to openide-loaders.jar
Line org.openide.text.DataEditorSupport; made by: jtulach; issues:
#32143
Line.getDataObject()
method had to be removed and replaced by Line.getLookup which
provides more general way for providing line context. The direct replacement
for the old method is DataObject DataEditorSupport.findDataObject(Line).
Line DocumentLine; made by: jtulach; issues:
#32143
Line and
DocumentLine constructors taking DataObject had to be
modified to take Lookup or plain Object instead.
CloneableEditorSupport; made by: jtulach; issues:
#32143
String messageLine (Line) that can be
overriden to provide meaningful display name for lines produced
by this support.
IndexOutOfBoundsException
can be thrown from NbDocument.findLineOffset method
NbDocument; issues:
#17144
NbDocument.findLineOffset() can throw an unchecked
IndexOutOfBoundsException. The method could throw
the exception also before (and also other kinds of them see the issue),
but it was not declared in javadoc. This change makes it compliant
to use with standard Swing text package and also with
Line.Set.getCurrent() method.
Annotation
Annotation.notifyAttached() and
Annotation.notifyDetached().
Annotatable
Annotatable.getText(). Listeners can be attached to
Annotatable.PROP_TEXT property.
Annotatable
Line methods deprecated in favor of annotations
Line DocumentLine
setBreakpoint, isBreakpoint,
markError, unmarkError,
markCurrentLine, unmarkCurrentLine, and
canBeMarkedCurrent are deprecated. Use
Annotation.attach() and detach() instead.
Line now extends Annotatable abstract class.
Annotation Annotatable NbDocument
NbDocument methods like markError,
markCurrent, markNormal are deprecated. Use
addAnnotation and removeAnnotation instead.
CloneableEditorSupport; made by:
initializeCloneableEditor to allow easier
customization of the editor after creation and also after deserialization.
CloneableEditorSupport
getUndoRedo() method was made protected final instead of
final.
CloneableEditorSupport
updateTitles() method was made protected final instead of
private.
IndentEngine a service type
IndentEngine
ServiceType. A few new methods relating to lookup.
register had been deleted as it is no longer useful); the
method was then restored but made deprecated.
org.openide.text.EditorSupport CloneableEditorSupport CloneableEditor org.openide.loaders.OpenSupport org.openide.windows.CloneableOpenSupport
EditorSupport and
OpenSupport, so that subclasses can have much finer control
over pieces of its functionality.
NbDocument
NbDocument.COLORS and NbDocument.Colors
deprecated.
boston. These classes were long disused (and should only have
ever been used by the editor module anyway, which did not need them).
PrintSettings.getPageFormat requires a printer job
org.openide.text.PrintSettings
getPageFormat method now requires a PrinterJob
argument.
boston. User-stored settings of this class should be
backwards compatible, however code directly calling
getPageFormat will produce a deprecation warning. Probably no
one should be directly referring to this class or its BeanInfo outside the
package; public only because it is a system option that must be public to
appear.