blob: e100d939bcb3cead9dd8923ad6021eaf2697e8f5 [file] [log] [blame]
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Change History for the Text 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="#text">Text API</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>(Feb 7 '11) <a href="#NbDocument-Annotatable">NbDocument.Annotatable threading changes</a>
</li>
<li>(Mar 25 '08) <a href="#initializeOnBackground">EditorKit, Document and co. are loaded on background by default</a>
</li>
<li>(May 22 '07) <a href="#NbDocument.Colors">Public static inner class <code>NbDocument.Colors</code> moved to org.openide.options.</a>
</li>
<li>(May 22 '07) <a href="#NbDocument.COLORS">Remove public field <code>NbDocument.COLORS</code></a>
</li>
<li>(May 22 '07) <a href="#PrintSettings">Removing <code>PrintSettings</code></a>
</li>
<li>(Jan 14 '05) <a href="#not-calling-CloneableEditorSupport-notifyModified-that-often">
<code>CloneableEditorSupport.notifyModified</code> is called only on first modification</a>
</li>
<li>(Apr 2 '03) <a href="#PositionRef-getEditorSupport">PositionRef.getEditorSupport() removed</a>
</li>
<li>(Apr 2 '03) <a href="#Line-getDataObject">Line.getDataObject() removed</a>
</li>
<li>(Apr 2 '03) <a href="#new_Line-DataObject">Line constructor changed</a>
</li>
</ul>
<h1>
<a name="all-by-date">All changes by date</a>
</h1>
<ul>
<li>(May 25 '14) <a href="#PositionRef.Position">Implement Position interface for compatibility</a>
</li>
<li>(Mar 21 '12) <a href="#NbDocument.openDocument">Added methods <code>NbDocument.getDocument</code>,
<code>NbDocument.openDocument</code> with offset parameter and
<code>NbDocument.openDocument</code> with line and column parameter</a>
</li>
<li>(Jul 20 '11) <a href="#mark-commit-group">fix hole in commit-groups about empty commit group</a>
</li>
<li>(Jun 1 '11) <a href="#CE.closeLast.boolean">CloneableEditor.closeLast</a>
</li>
<li>(Jun 1 '11) <a href="#CE.associateLookup">CloneableEditor(associateLookup)</a>
</li>
<li>(Jun 1 '11) <a href="#initializeBySupport">CloneableEditor.initializeBySupport</a>
</li>
<li>(May 10 '11) <a href="#NbDocument-getEditToBeUndoneOfType">Added NbDocument.getEditToBeUndoneOfType</a>
</li>
<li>(Feb 7 '11) <a href="#NbDocument-Annotatable">NbDocument.Annotatable threading changes</a>
</li>
<li>(Nov 24 '10) <a href="#commit-groups">Better support for vi mode</a>
</li>
<li>(Aug 16 '10) <a href="#Editors-TabActions">Ability to inject actions into editor tab context menus</a>
</li>
<li>(Dec 21 '09) <a href="#NbDocument-style-constants-deprecated">Deprecating style constants in NbDocument</a>
</li>
<li>(Oct 1 '09) <a href="#CloneableEditorSupport.asynchronousOpen">Add CloneableEditorSupport.asynchronousOpen</a>
</li>
<li>(Aug 12 '09) <a href="#NbDocument.findRecentEditorPane">Add NbDocument.findRecentEditorPane</a>
</li>
<li>(Jul 7 '08) <a href="#Line.show">Improve Line.show</a>
</li>
<li>(May 16 '08) <a href="#beforeSaveRunnable">"beforeSaveRunnable" document property</a>
</li>
<li>(Mar 25 '08) <a href="#initializeOnBackground">EditorKit, Document and co. are loaded on background by default</a>
</li>
<li>(May 22 '07) <a href="#NbDocument.Colors">Public static inner class <code>NbDocument.Colors</code> moved to org.openide.options.</a>
</li>
<li>(May 22 '07) <a href="#NbDocument.COLORS">Remove public field <code>NbDocument.COLORS</code></a>
</li>
<li>(May 22 '07) <a href="#PrintPreferences">Adding <code>PrintPreferences</code></a>
</li>
<li>(May 22 '07) <a href="#PrintSettings">Removing <code>PrintSettings</code></a>
</li>
<li>(Mar 5 '07) <a href="#Line.SHOW_REUSE">Adding Line.SHOW_REUSE and Line.SHOW_REUSE_NEW constants for Line.show method</a>
</li>
<li>(Feb 7 '07) <a href="#CloneableEditorSupportRedirector">CloneableEditorSupportRedirector</a>
</li>
<li>(Aug 2 '06) <a href="#CloneableEditorSupport.getEditorKit">Adding CloneableEditorSupport.getEditorKit method</a>
</li>
<li>(May 30 '06) <a href="#EditorPaneDragAndDrop">Editor panes listen for special objects being dragged over them</a>
</li>
<li>(Oct 31 '05) <a href="#CloneableEditorSupport-messageHtmlName">Added CloneableEditorSupport.messageHtmlName method</a>
</li>
<li>(Aug 9 '05) <a href="#ActiveEditorDrop">Added ActiveEditorDrop interface</a>
</li>
<li>(Jul 22 '05) <a href="#CloneableEditorSupport-wrapEditorComponent">Added CloneableEditorSupport.wrapEditorComponent</a>
</li>
<li>(Jul 18 '05) <a href="#annotations-error-stripe">Annotation type extended with <code>severity</code>, <code>custom_sidebar_color</code>, <code>browsable</code> and <code>priority</code>
attributes
</a>
</li>
<li>(Mar 21 '05) <a href="#Line.SHOW_TOFRONT">Added a new constant <code>Line.SHOW_TOFRONT</code>
</a>
</li>
<li>(Jan 14 '05) <a href="#not-calling-CloneableEditorSupport-notifyModified-that-often">
<code>CloneableEditorSupport.notifyModified</code> is called only on first modification</a>
</li>
<li>(Dec 6 '04) <a href="#CloneableEditor-openAt">CloneableEditor.openAt made protected</a>
</li>
<li>(Aug 24 '04) <a href="#CloneableEditorSupport.Pane">Enhance SPI interface for CloneableEditorSupport.Pane providers</a>
</li>
<li>(Jun 8 '04) <a href="#issue-43484">Line.getOriginalLineNumber</a>
</li>
<li>(Apr 30 '04) <a href="#issue-41345">Support for AnnotationProvider interface</a>
</li>
<li>(Apr 20 '04) <a href="#issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</li>
<li>(Feb 2 '04) <a href="#issue-37892">Allow CloneableEditorSupport subclasses to specify
persistence ID for the associated editor TopComponent.
</a>
</li>
<li>(Jun 26 '03) <a href="#issue-34692">New <code>getInputStream()</code> method in CloneableEditorSupport</a>
</li>
<li>(Apr 18 '03) <a href="#issue-32937">CloneableEditorSupport takes Lookup for its Lines in constructor</a>
</li>
<li>(Apr 2 '03) <a href="#PositionRef-getEditorSupport">PositionRef.getEditorSupport() removed</a>
</li>
<li>(Apr 2 '03) <a href="#Line-getDataObject">Line.getDataObject() removed</a>
</li>
<li>(Apr 2 '03) <a href="#new_Line-DataObject">Line constructor changed</a>
</li>
<li>(Apr 2 '03) <a href="#CloneableEditorSupport.messageLine">CloneableEditorSupport can provide display name for its Lines</a>
</li>
<li>(Oct 31 '01) <a href="#issue-17144">Added to javadoc an <code>IndexOutOfBoundsException</code>
can be thrown from <code>NbDocument.findLineOffset</code> method
</a>
</li>
<li>(Oct 12 '01) <a href="#version-1.38">Notifications about annotation attaching/detaching added</a>
</li>
<li>(Sep 25 '01) <a href="#Annotatable.getText">Get content of Annotatable</a>
</li>
<li>(Sep 25 '01) <a href="#Annotatable-isDeleted-getAnnotationCount-final">Annotatable.isDeleted and Annotatable.getAnnotationCount are final</a>
</li>
<li>(Jul 9 '01) <a href="#Line.mark-deprecated">
<code>Line</code> methods deprecated in favor of annotations</a>
</li>
<li>(Jul 9 '01) <a href="#Annotations-API">New annotations API published</a>
</li>
<li>(Dec 1 '00) <a href="#5.85602765688684E14">Customization of editor support after creation</a>
</li>
<li>(Jul 21 '00) <a href="#7.301099361103E12">Can control undo/redo on editor supports</a>
</li>
<li>(Jul 17 '00) <a href="#1.16811111011151E14">Can control title format for editor supports</a>
</li>
<li>(Jun 23 '00) <a href="#115339"><code>IndentEngine</code> a service type</a>
</li>
<li>(May 29 '00) <a href="#4.492034912079E12">Refactoring of editor and open supports</a>
</li>
<li>(Mar 27 '00) <a href="#2.50572581841E11">Setting colors for lines deprecated</a>
</li>
<li>(Feb 24 '00) <a href="#5.6681861E7"><code>PrintSettings.getPageFormat</code> requires a printer job</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: org.openide.text &gt; 1.20</pre>
<ul>
<li>
(6.64) <a href="#PositionRef.Position">Implement Position interface for compatibility</a>
</li>
<li>
(6.49) <a href="#NbDocument-getEditToBeUndoneOfType">Added NbDocument.getEditToBeUndoneOfType</a>
</li>
<li>
(6.46) <a href="#NbDocument.openDocument">Added methods <code>NbDocument.getDocument</code>,
<code>NbDocument.openDocument</code> with offset parameter and
<code>NbDocument.openDocument</code> with line and column parameter</a>
</li>
<li>
(6.40) <a href="#mark-commit-group">fix hole in commit-groups about empty commit group</a>
</li>
<li>
(6.39) <a href="#CE.closeLast.boolean">CloneableEditor.closeLast</a>
</li>
<li>
(6.39) <a href="#CE.associateLookup">CloneableEditor(associateLookup)</a>
</li>
<li>
(6.39) <a href="#initializeBySupport">CloneableEditor.initializeBySupport</a>
</li>
<li>
(6.35) <a href="#NbDocument-Annotatable">NbDocument.Annotatable threading changes</a>
</li>
<li>
(6.34) <a href="#commit-groups">Better support for vi mode</a>
</li>
<li>
(6.32) <a href="#Editors-TabActions">Ability to inject actions into editor tab context menus</a>
</li>
<li>
(6.29) <a href="#NbDocument-style-constants-deprecated">Deprecating style constants in NbDocument</a>
</li>
<li>
(6.26) <a href="#CloneableEditorSupport.asynchronousOpen">Add CloneableEditorSupport.asynchronousOpen</a>
</li>
<li>
(6.24) <a href="#NbDocument.findRecentEditorPane">Add NbDocument.findRecentEditorPane</a>
</li>
<li>
(6.21) <a href="#Line.show">Improve Line.show</a>
</li>
<li>
(6.20) <a href="#beforeSaveRunnable">"beforeSaveRunnable" document property</a>
</li>
<li>
(6.18) <a href="#initializeOnBackground">EditorKit, Document and co. are loaded on background by default</a>
</li>
<li>
(6.16) <a href="#NbDocument.Colors">Public static inner class <code>NbDocument.Colors</code> moved to org.openide.options.</a>
</li>
<li>
(6.16) <a href="#NbDocument.COLORS">Remove public field <code>NbDocument.COLORS</code></a>
</li>
<li>
(6.16) <a href="#PrintPreferences">Adding <code>PrintPreferences</code></a>
</li>
<li>
(6.16) <a href="#PrintSettings">Removing <code>PrintSettings</code></a>
</li>
<li>
(6.14) <a href="#Line.SHOW_REUSE">Adding Line.SHOW_REUSE and Line.SHOW_REUSE_NEW constants for Line.show method</a>
</li>
<li>
(6.13) <a href="#CloneableEditorSupportRedirector">CloneableEditorSupportRedirector</a>
</li>
<li>
(6.12) <a href="#CloneableEditorSupport.getEditorKit">Adding CloneableEditorSupport.getEditorKit method</a>
</li>
<li>
(6.11) <a href="#EditorPaneDragAndDrop">Editor panes listen for special objects being dragged over them</a>
</li>
<li>
(6.8) <a href="#CloneableEditorSupport-messageHtmlName">Added CloneableEditorSupport.messageHtmlName method</a>
</li>
<li>
(6.6) <a href="#ActiveEditorDrop">Added ActiveEditorDrop interface</a>
</li>
<li>
(6.4) <a href="#CloneableEditorSupport-wrapEditorComponent">Added CloneableEditorSupport.wrapEditorComponent</a>
</li>
<li>
(6.3) <a href="#annotations-error-stripe">Annotation type extended with <code>severity</code>, <code>custom_sidebar_color</code>, <code>browsable</code> and <code>priority</code>
attributes
</a>
</li>
<li>
(5.8) <a href="#Line.SHOW_TOFRONT">Added a new constant <code>Line.SHOW_TOFRONT</code>
</a>
</li>
<li>
(5.4) <a href="#not-calling-CloneableEditorSupport-notifyModified-that-often">
<code>CloneableEditorSupport.notifyModified</code> is called only on first modification</a>
</li>
<li>
(5.2) <a href="#CloneableEditor-openAt">CloneableEditor.openAt made protected</a>
</li>
<li>
(4.45) <a href="#CloneableEditorSupport.Pane">Enhance SPI interface for CloneableEditorSupport.Pane providers</a>
</li>
<li>
(4.38) <a href="#issue-43484">Line.getOriginalLineNumber</a>
</li>
<li>
(4.31) <a href="#issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</li>
<li>
(4.30) <a href="#issue-41345">Support for AnnotationProvider interface</a>
</li>
<li>
(4.24) <a href="#issue-37892">Allow CloneableEditorSupport subclasses to specify
persistence ID for the associated editor TopComponent.
</a>
</li>
<li>
(4.7) <a href="#issue-34692">New <code>getInputStream()</code> method in CloneableEditorSupport</a>
</li>
<li>
(4.5) <a href="#issue-32937">CloneableEditorSupport takes Lookup for its Lines in constructor</a>
</li>
<li>
(4.3) <a href="#PositionRef-getEditorSupport">PositionRef.getEditorSupport() removed</a>
</li>
<li>
(4.3) <a href="#Line-getDataObject">Line.getDataObject() removed</a>
</li>
<li>
(4.3) <a href="#new_Line-DataObject">Line constructor changed</a>
</li>
<li>
(4.3) <a href="#CloneableEditorSupport.messageLine">CloneableEditorSupport can provide display name for its Lines</a>
</li>
<li>
(1.38) <a href="#version-1.38">Notifications about annotation attaching/detaching added</a>
</li>
<li>
(1.35) <a href="#Annotatable.getText">Get content of Annotatable</a>
</li>
<li>
(1.35) <a href="#Annotatable-isDeleted-getAnnotationCount-final">Annotatable.isDeleted and Annotatable.getAnnotationCount are final</a>
</li>
<li>
(1.20) <a href="#Line.mark-deprecated">
<code>Line</code> methods deprecated in favor of annotations</a>
</li>
<li>
(1.20) <a href="#Annotations-API">New annotations API published</a>
</li>
</ul>
<h1>
<a name="all-by-class">Changes by affected class</a>
</h1>
<h2>
<a name="org.openide.text.ActiveEditorDrop"><code><span style="color:gray">org.openide.text.</span>ActiveEditorDrop</code></a>
</h2><ul><li>(Aug 9 '05) <a href="#ActiveEditorDrop">Added ActiveEditorDrop interface</a>
</li></ul><h2>
<a name="org.openide.text.Annotatable"><code><span style="color:gray">org.openide.text.</span>Annotatable</code></a>
</h2><ul><li>(Sep 25 '01) <a href="#Annotatable.getText">Get content of Annotatable</a>
</li>
<li>(Sep 25 '01) <a href="#Annotatable-isDeleted-getAnnotationCount-final">Annotatable.isDeleted and Annotatable.getAnnotationCount are final</a>
</li>
<li>(Jul 9 '01) <a href="#Annotations-API">New annotations API published</a>
</li></ul><h2>
<a name="org.openide.text.Annotation"><code><span style="color:gray">org.openide.text.</span>Annotation</code></a>
</h2><ul><li>(Oct 12 '01) <a href="#version-1.38">Notifications about annotation attaching/detaching added</a>
</li>
<li>(Jul 9 '01) <a href="#Annotations-API">New annotations API published</a>
</li></ul><h2>
<a name="org.openide.text.AnnotationProvider"><code><span style="color:gray">org.openide.text.</span>AnnotationProvider</code></a>
</h2><ul><li>(Apr 30 '04) <a href="#issue-41345">Support for AnnotationProvider interface</a>
</li></ul><h2>
<a name="org.openide.text.CloneableEditor"><code><span style="color:gray">org.openide.text.</span>CloneableEditor</code></a>
</h2><ul><li>(Jun 1 '11) <a href="#CE.closeLast.boolean">CloneableEditor.closeLast</a>
</li>
<li>(Jun 1 '11) <a href="#CE.associateLookup">CloneableEditor(associateLookup)</a>
</li>
<li>(Jun 1 '11) <a href="#initializeBySupport">CloneableEditor.initializeBySupport</a>
</li>
<li>(Mar 25 '08) <a href="#initializeOnBackground">EditorKit, Document and co. are loaded on background by default</a>
</li>
<li>(May 30 '06) <a href="#EditorPaneDragAndDrop">Editor panes listen for special objects being dragged over them</a>
</li>
<li>(Oct 31 '05) <a href="#CloneableEditorSupport-messageHtmlName">Added CloneableEditorSupport.messageHtmlName method</a>
</li>
<li>(Jul 22 '05) <a href="#CloneableEditorSupport-wrapEditorComponent">Added CloneableEditorSupport.wrapEditorComponent</a>
</li>
<li>(Apr 20 '04) <a href="#issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</li>
<li>(May 29 '00) <a href="#4.492034912079E12">Refactoring of editor and open supports</a>
</li></ul><h2>
<a name="org.openide.text.CloneableEditorSupport"><code><span style="color:gray">org.openide.text.</span>CloneableEditorSupport</code></a>
</h2><ul><li>(Jul 20 '11) <a href="#mark-commit-group">fix hole in commit-groups about empty commit group</a>
</li>
<li>(Nov 24 '10) <a href="#commit-groups">Better support for vi mode</a>
</li>
<li>(Oct 1 '09) <a href="#CloneableEditorSupport.asynchronousOpen">Add CloneableEditorSupport.asynchronousOpen</a>
</li>
<li>(May 16 '08) <a href="#beforeSaveRunnable">"beforeSaveRunnable" document property</a>
</li>
<li>(Aug 2 '06) <a href="#CloneableEditorSupport.getEditorKit">Adding CloneableEditorSupport.getEditorKit method</a>
</li>
<li>(Oct 31 '05) <a href="#CloneableEditorSupport-messageHtmlName">Added CloneableEditorSupport.messageHtmlName method</a>
</li>
<li>(Jul 22 '05) <a href="#CloneableEditorSupport-wrapEditorComponent">Added CloneableEditorSupport.wrapEditorComponent</a>
</li>
<li>(Jan 14 '05) <a href="#not-calling-CloneableEditorSupport-notifyModified-that-often">
<code>CloneableEditorSupport.notifyModified</code> is called only on first modification</a>
</li>
<li>(Dec 6 '04) <a href="#CloneableEditor-openAt">CloneableEditor.openAt made protected</a>
</li>
<li>(Apr 20 '04) <a href="#issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</li>
<li>(Feb 2 '04) <a href="#issue-37892">Allow CloneableEditorSupport subclasses to specify
persistence ID for the associated editor TopComponent.
</a>
</li>
<li>(Jun 26 '03) <a href="#issue-34692">New <code>getInputStream()</code> method in CloneableEditorSupport</a>
</li>
<li>(Apr 18 '03) <a href="#issue-32937">CloneableEditorSupport takes Lookup for its Lines in constructor</a>
</li>
<li>(Apr 2 '03) <a href="#CloneableEditorSupport.messageLine">CloneableEditorSupport can provide display name for its Lines</a>
</li>
<li>(Dec 1 '00) <a href="#5.85602765688684E14">Customization of editor support after creation</a>
</li>
<li>(Jul 21 '00) <a href="#7.301099361103E12">Can control undo/redo on editor supports</a>
</li>
<li>(Jul 17 '00) <a href="#1.16811111011151E14">Can control title format for editor supports</a>
</li>
<li>(May 29 '00) <a href="#4.492034912079E12">Refactoring of editor and open supports</a>
</li></ul><h2>
<a name="org.openide.text.CloneableEditorSupportRedirector"><code><span style="color:gray">org.openide.text.</span>CloneableEditorSupportRedirector</code></a>
</h2><ul><li>(Feb 7 '07) <a href="#CloneableEditorSupportRedirector">CloneableEditorSupportRedirector</a>
</li></ul><h2>
<a name="org.openide.windows.CloneableOpenSupport"><code><span style="color:gray">org.openide.windows.</span>CloneableOpenSupport</code></a>
</h2><ul><li>(May 29 '00) <a href="#4.492034912079E12">Refactoring of editor and open supports</a>
</li></ul><h2>
<a name="org.openide.text.DataEditorSupport"><code><span style="color:gray">org.openide.text.</span>DataEditorSupport</code></a>
</h2><ul><li>(Oct 31 '05) <a href="#CloneableEditorSupport-messageHtmlName">Added CloneableEditorSupport.messageHtmlName method</a>
</li>
<li>(Apr 2 '03) <a href="#PositionRef-getEditorSupport">PositionRef.getEditorSupport() removed</a>
</li>
<li>(Apr 2 '03) <a href="#Line-getDataObject">Line.getDataObject() removed</a>
</li></ul><h2>
<a name="org.openide.text.DocumentLine"><code><span style="color:gray">org.openide.text.</span>DocumentLine</code></a>
</h2><ul><li>(Apr 2 '03) <a href="#new_Line-DataObject">Line constructor changed</a>
</li>
<li>(Jul 9 '01) <a href="#Line.mark-deprecated">
<code>Line</code> methods deprecated in favor of annotations</a>
</li></ul><h2>
<a name="org.openide.text.EditorSupport"><code><span style="color:gray">org.openide.text.</span>EditorSupport</code></a>
</h2><ul><li>(Apr 20 '04) <a href="#issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</li>
<li>(May 29 '00) <a href="#4.492034912079E12">Refactoring of editor and open supports</a>
</li></ul><h2>
<a name="org.openide.text.IndentEngine"><code><span style="color:gray">org.openide.text.</span>IndentEngine</code></a>
</h2><ul><li>(Jun 23 '00) <a href="#115339"><code>IndentEngine</code> a service type</a>
</li></ul><h2>
<a name="org.openide.text.Line"><code><span style="color:gray">org.openide.text.</span>Line</code></a>
</h2><ul><li>(Jul 7 '08) <a href="#Line.show">Improve Line.show</a>
</li>
<li>(Mar 5 '07) <a href="#Line.SHOW_REUSE">Adding Line.SHOW_REUSE and Line.SHOW_REUSE_NEW constants for Line.show method</a>
</li>
<li>(Mar 21 '05) <a href="#Line.SHOW_TOFRONT">Added a new constant <code>Line.SHOW_TOFRONT</code>
</a>
</li>
<li>(Jun 8 '04) <a href="#issue-43484">Line.getOriginalLineNumber</a>
</li>
<li>(Apr 2 '03) <a href="#Line-getDataObject">Line.getDataObject() removed</a>
</li>
<li>(Apr 2 '03) <a href="#new_Line-DataObject">Line constructor changed</a>
</li>
<li>(Jul 9 '01) <a href="#Line.mark-deprecated">
<code>Line</code> methods deprecated in favor of annotations</a>
</li></ul><h2>
<a name="org.openide.text.NbDocument"><code><span style="color:gray">org.openide.text.</span>NbDocument</code></a>
</h2><ul><li>(Mar 21 '12) <a href="#NbDocument.openDocument">Added methods <code>NbDocument.getDocument</code>,
<code>NbDocument.openDocument</code> with offset parameter and
<code>NbDocument.openDocument</code> with line and column parameter</a>
</li>
<li>(May 10 '11) <a href="#NbDocument-getEditToBeUndoneOfType">Added NbDocument.getEditToBeUndoneOfType</a>
</li>
<li>(Feb 7 '11) <a href="#NbDocument-Annotatable">NbDocument.Annotatable threading changes</a>
</li>
<li>(Dec 21 '09) <a href="#NbDocument-style-constants-deprecated">Deprecating style constants in NbDocument</a>
</li>
<li>(Aug 12 '09) <a href="#NbDocument.findRecentEditorPane">Add NbDocument.findRecentEditorPane</a>
</li>
<li>(May 22 '07) <a href="#NbDocument.Colors">Public static inner class <code>NbDocument.Colors</code> moved to org.openide.options.</a>
</li>
<li>(May 22 '07) <a href="#NbDocument.COLORS">Remove public field <code>NbDocument.COLORS</code></a>
</li>
<li>(Apr 20 '04) <a href="#issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</li>
<li>(Oct 31 '01) <a href="#issue-17144">Added to javadoc an <code>IndexOutOfBoundsException</code>
can be thrown from <code>NbDocument.findLineOffset</code> method
</a>
</li>
<li>(Jul 9 '01) <a href="#Annotations-API">New annotations API published</a>
</li>
<li>(Mar 27 '00) <a href="#2.50572581841E11">Setting colors for lines deprecated</a>
</li></ul><h2>
<a name="org.openide.loaders.OpenSupport"><code><span style="color:gray">org.openide.loaders.</span>OpenSupport</code></a>
</h2><ul><li>(May 29 '00) <a href="#4.492034912079E12">Refactoring of editor and open supports</a>
</li></ul><h2>
<a name="org.openide.text.PositionRef"><code><span style="color:gray">org.openide.text.</span>PositionRef</code></a>
</h2><ul><li>(May 25 '14) <a href="#PositionRef.Position">Implement Position interface for compatibility</a>
</li>
<li>(Apr 2 '03) <a href="#PositionRef-getEditorSupport">PositionRef.getEditorSupport() removed</a>
</li></ul><h2>
<a name="org.openide.text.PrintPreferences"><code><span style="color:gray">org.openide.text.</span>PrintPreferences</code></a>
</h2><ul><li>(May 22 '07) <a href="#PrintPreferences">Adding <code>PrintPreferences</code></a>
</li></ul><h2>
<a name="org.openide.text.PrintSettings"><code><span style="color:gray">org.openide.text.</span>PrintSettings</code></a>
</h2><ul><li>(May 22 '07) <a href="#PrintSettings">Removing <code>PrintSettings</code></a>
</li>
<li>(Feb 24 '00) <a href="#5.6681861E7"><code>PrintSettings.getPageFormat</code> requires a printer job</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="text">Text API</a>
</h2>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="PositionRef.Position">Implement Position interface for compatibility</a>
</h3>
<em>May 25 '14; API spec. version: 6.64; affected top-level classes: <a href="./org/openide/text/PositionRef.html"><code>PositionRef</code></a>; made by: sdedic; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=244744">
#244744</a></em>
<br>
<p>
PositionRef can provide a Position object, but does not itself implement
the Position interface, although it can provide the <code>offset</code>.
The change is just to formally implement the j.s.t.Position.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument.openDocument">Added methods <code>NbDocument.getDocument</code>,
<code>NbDocument.openDocument</code> with offset parameter and
<code>NbDocument.openDocument</code> with line and column parameter</a>
</h3>
<em>Mar 21 '12; API spec. version: 6.46; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: theofanis; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=209058">
#209058</a></em>
<br>
<p>
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.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="mark-commit-group">fix hole in commit-groups about empty commit group</a>
</h3>
<em>Jul 20 '11; API spec. version: 6.40; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: err; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=199568">
#199568</a></em>
<br>
<p>
Define semantics of a nested empty commit group.
Add <code>MARK_COMMIT_GROUP</code> to fill a gap in API;
It adds an inprogress commit-group and starts a new one.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CE.closeLast.boolean">CloneableEditor.closeLast</a>
</h3>
<em>Jun 1 '11; API spec. version: 6.39; affected top-level classes: <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=196810">
#196810</a></em>
<br>
<p>
<code>CloneableEditor</code> has a new utility method
<code>closeLast</code>.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CE.associateLookup">CloneableEditor(associateLookup)</a>
</h3>
<em>Jun 1 '11; API spec. version: 6.39; affected top-level classes: <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=196810">
#196810</a></em>
<br>
<p>
<code>CloneableEditor</code> offers new constructor
that will reuse the lookup provided by its
<a href="org/openide/text/CloneableEditorSupport.html" shape="rect">CloneableEditorSupport</a>.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="initializeBySupport">CloneableEditor.initializeBySupport</a>
</h3>
<em>Jun 1 '11; API spec. version: 6.39; affected top-level classes: <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=196810">
#196810</a></em>
<br>
<p>
Subclasses of <code>CloneableEditor</code> can manually request own
initialization by calling its
<a href="org/openide/text/CloneableEditor.html#initializeBySupport--" shape="rect">initializeBySupport</a>
method.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument-getEditToBeUndoneOfType">Added NbDocument.getEditToBeUndoneOfType</a>
</h3>
<em>May 10 '11; API spec. version: 6.49; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: mmetelka; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=204828">
#204828</a></em>
<br>
<p>
Added NbDocument.getEditToBeUndoneOfType()
and NbDocument.getEditToBeRedoneOfType()
to retrieve custom undoable edits that wrap document-generated
undoable edits.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument-Annotatable">NbDocument.Annotatable threading changes</a>
</h3>
<em>Feb 7 '11; API spec. version: 6.35; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: mmetelka; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=194816">
#194816</a></em>
<br>
<p>
<code>addAnnotation()</code> and <code>removeAnnotation()</code>
no longer re-plan their work into EDT.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="commit-groups">Better support for vi mode</a>
</h3>
<em>Nov 24 '10; API spec. version: 6.34; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: err; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=103467">
#103467</a></em>
<br>
<p>
Support for chunking edits via <code>BEGIN_COMMIT_GROUP</code>
and <code>END_COMMIT_GROUP</code>.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="Editors-TabActions">Ability to inject actions into editor tab context menus</a>
</h3>
<em>Aug 16 '10; API spec. version: 6.32; made by: jglick; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=189320">
#189320</a></em>
<br>
<p>
Actions may now be placed in <code>Editors/TabActions</code> to add
them to the context menu of the tab of an editor window.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument-style-constants-deprecated">Deprecating style constants in NbDocument</a>
</h3>
<em>Dec 21 '09; API spec. version: 6.29; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: vstejskal; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=97517">
#97517</a></em>
<br>
<p>
Deprecating <code>BREAKPOINT_STYLE_NAME</code>, <code>ERROR_STYLE_NAME</code>,
<code>CURRENT_STYLE_NAME</code>, <code>NORMAL_STYLE_NAME</code> in <code>NbDocument</code> class.
Document styles have been abandoned when <code>Annotation</code>s API was created.
These constants are no longer functional.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditorSupport.asynchronousOpen">Add CloneableEditorSupport.asynchronousOpen</a>
</h3>
<em>Oct 1 '09; API spec. version: 6.26; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: mslama; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=171713">
#171713</a></em>
<br>
<p>
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.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument.findRecentEditorPane">Add NbDocument.findRecentEditorPane</a>
</h3>
<em>Aug 12 '09; API spec. version: 6.24; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: mslama; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=168415">
#168415</a></em>
<br>
<p>
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.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="Line.show">Improve Line.show</a>
</h3>
<em>Jul 7 '08; API spec. version: 6.21; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a>; made by: mslama; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=138146">
#138146</a></em>
<br>
<p>
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.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="beforeSaveRunnable">"beforeSaveRunnable" document property</a>
</h3>
<em>May 16 '08; API spec. version: 6.20; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: mmetelka; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=13063">
#13063</a></em>
<br>
<p>
CloneableEditorSupport.saveDocument() checks document's "beforeSaveDocument" property
for a Runnable to be executed before the actual save will be done.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="initializeOnBackground">EditorKit, Document and co. are loaded on background by default</a>
</h3>
<em>Mar 25 '08; API spec. version: 6.18; affected top-level classes: <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=130171">
#130171</a></em>
<br>
<p>
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 <a href="architecture-summary.html#java-EditorKitInitialization" shape="rect">API for editor kits</a>,
one
<a href="architecture-summary.html#property-oldInitialization" shape="rect">component</a>
and one
<a href="architecture-summary.html#property-org.openide.text.CloneableEditor.oldInitialization" shape="rect">system</a>
property.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument.Colors">Public static inner class <code>NbDocument.Colors</code> moved to org.openide.options.</a>
</h3>
<em>May 22 '07; API spec. version: 6.16; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: mslama; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=88531">
#88531</a></em>
<br>
<p>
Class <code>NbDocument.Colors</code> 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.
</p>
<br>
<em><a href="http://wiki.netbeans.org/VersioningPolicy#Compatible_change_on_the_trunk">Binary-compatible</a></em>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="NbDocument.COLORS">Remove public field <code>NbDocument.COLORS</code></a>
</h3>
<em>May 22 '07; API spec. version: 6.16; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; made by: mslama; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=88531">
#88531</a></em>
<br>
<p>
Field <code>NbDocument.COLORS</code> was removed to remove dependency on org.openide.options.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="PrintPreferences">Adding <code>PrintPreferences</code></a>
</h3>
<em>May 22 '07; API spec. version: 6.16; affected top-level classes: <a href="./org/openide/text/PrintPreferences.html"><code>PrintPreferences</code></a>; made by: rmatous; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=88531">
#88531</a></em>
<br>
<p>
Class <code>PrintPreferences</code> was added as replacement for original
class <code>PrintSettings</code>.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="PrintSettings">Removing <code>PrintSettings</code></a>
</h3>
<em>May 22 '07; API spec. version: 6.16; affected top-level classes: <code>org.openide.text.PrintSettings</code>; made by: rmatous; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=88531">
#88531</a></em>
<br>
<p>
Classes <code>PrintSettings</code> and <code>PrintSettingsBeanInfo</code>
were removed. Runtime backward compatibility was ensured
by moving both into org.openide.options module which is already deprecated.
</p>
<br>
<em><a href="http://wiki.netbeans.org/VersioningPolicy#Compatible_change_on_the_trunk">Binary-compatible</a></em>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="Line.SHOW_REUSE">Adding Line.SHOW_REUSE and Line.SHOW_REUSE_NEW constants for Line.show method</a>
</h3>
<em>Mar 5 '07; API spec. version: 6.14; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a>; made by: pnejedly; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=94607">
#94607</a></em>
<br>
<p>The <code>Line.show()</code> 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
<code>Line.show(SHOW_REUSE)</code> on <code>Line</code>s from different
<code>Document</code>. This is useful for quick source browsing without
cluttering the UI with too many opened editors.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditorSupportRedirector">CloneableEditorSupportRedirector</a>
</h3>
<em>Feb 7 '07; API spec. version: 6.13; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupportRedirector.html"><code>CloneableEditorSupportRedirector</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=51690">
#51690</a></em>
<br>
<p>The <a href="org/openide/text/CloneableEditorSupportRedirector.html" shape="rect">CloneableEditorSupportRedirector</a>
class allows a redirection of operations on a <code>CloneableEditorSupport</code>
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
<a href="org/openide/text/CloneableEditorSupportRedirector.html" shape="rect">CloneableEditorSupportRedirector</a>.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditorSupport.getEditorKit">Adding CloneableEditorSupport.getEditorKit method</a>
</h3>
<em>Aug 2 '06; API spec. version: 6.12; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: vstejskal; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=52657">
#52657</a></em>
<br>
<p>The <code>CloneableEditorSupport.getEditorKit()</code> method
allows to access <code>EditorKit</code>s registered in
MimeLookup. This is meant to be the primary way of finding
<code>EditorKit</code>s registered by Netbeans modules. The
<code>JEditorPane.createEditorKitForContentType</code> and the
other related methods in <code>JEditorPane</code> should only be
used for finding <code>EditorKit</code>s provided by JDK.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="EditorPaneDragAndDrop">Editor panes listen for special objects being dragged over them</a>
</h3>
<em>May 30 '06; API spec. version: 6.11; affected top-level classes: <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a>; made by: saubrecht; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=50129">
#50129</a></em>
<br>
<p>The custom <code>JEditorPane</code> used by <code>CloneableEditor</code>
has a custom <code>DropTarget</code>
instance which listens for some special objects (usually files) being
dragged over the editor pane and uses an instace of
<code>ExternalDropHandler</code> class from the global
<code>Lookup</code> 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 <code>ExternalDropHandler</code>
will process it (e.g. opens the file in a new editor tab).
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditorSupport-messageHtmlName">Added CloneableEditorSupport.messageHtmlName method</a>
</h3>
<em>Oct 31 '05; API spec. version: 6.8; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a> <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a> <code>org.openide.text.DataEditorSupport</code>; made by: dsimonek; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=66777">
#66777</a></em>
<br>
<p>A <code>messageHtmlName</code> 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 <code>DataEditorSupport</code> now overrides
<code>messageHtmlName</code> to connect with <code>Node.getHtmlDisplayName</code>.</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="ActiveEditorDrop">Added ActiveEditorDrop interface</a>
</h3>
<em>Aug 9 '05; API spec. version: 6.6; affected top-level classes: <a href="./org/openide/text/ActiveEditorDrop.html"><code>ActiveEditorDrop</code></a>; made by: mroskanin; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=61367">
#61367</a></em>
<br>
<p>An <code>ActiveEditorDrop</code> interface has been added due to
drag and drop callback support described at <a href="http://www.netbeans.org/issues/show_bug.cgi?id=61367" shape="rect">issue #61367</a>
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditorSupport-wrapEditorComponent">Added CloneableEditorSupport.wrapEditorComponent</a>
</h3>
<em>Jul 22 '05; API spec. version: 6.4; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a> <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a>; made by: abadea; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=60922">
#60922</a></em>
<br>
<p>A <code>wrapEditorComponent</code> method has been added to
CloneableEditorSupport allowing to wrap the editor component
in another component.</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="annotations-error-stripe">Annotation type extended with <code>severity</code>, <code>custom_sidebar_color</code>, <code>browsable</code> and <code>priority</code>
attributes
</a>
</h3>
<em>Jul 18 '05; API spec. version: 6.3; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=55639">
#55639</a></em>
<br>
Annotation type was extended with <code>severity</code>, <code>custom_sidebar_color</code>, <code>browsable</code> and <code>priority</code>
attributes.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="Line.SHOW_TOFRONT">Added a new constant <code>Line.SHOW_TOFRONT</code>
</a>
</h3>
<em>Mar 21 '05; API spec. version: 5.8; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a>; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=47825">
#47825</a></em>
<br>
The new constant is used in the <code>EditorSupportLineSet</code> and brings
editor's parent <code>Window</code> to be fronted above all other top-level windows.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="not-calling-CloneableEditorSupport-notifyModified-that-often">
<code>CloneableEditorSupport.notifyModified</code> is called only on first modification</a>
</h3>
<em>Jan 14 '05; API spec. version: 5.4; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=52493">
#52493</a></em>
<br>
<p>
It has been found that <code>CloneableEditorSupport.notifyModified</code>
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.
<br>
This may be incompatible for clients that relied on the often calls.
Such clients need to be fixed.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditor-openAt">CloneableEditor.openAt made protected</a>
</h3>
<em>Dec 6 '04; API spec. version: 5.2; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: pnejedly; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=51441">
#51441</a></em>
<br>
<p>Deprecated <code>EditorSupport</code> has had a method
<code>openAt</code>, which has no easy replacement in
<code>CloneableEditorSupport</code>.
The method is implemented in <code>CloneableEditorSupport</code>,
but is package private. This change makes it protected.
</p>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="CloneableEditorSupport.Pane">Enhance SPI interface for CloneableEditorSupport.Pane providers</a>
</h3>
<em>Aug 24 '04; API spec. version: 4.45; made by: mleint; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=46127">
#46127</a></em>
<br>
Additional method to <code>CloneableEditorSupport.Pane</code> interface,
<code>Pane.ensureVisible()</code>. The implementing classes should ensure that the pane's component
is open and visible after calling this method. Is used in <code>CloneableEditorSupport.openAt()</code>.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-43484">Line.getOriginalLineNumber</a>
</h3>
<em>Jun 8 '04; API spec. version: 4.38; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=43484">
#43484</a></em>
<br>
A method that for a given line computes its original
line number. Is useful when user edits text and places a breakpoint
to find out what was the original line that the breakpoint should
be placed to.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-41345">Support for AnnotationProvider interface</a>
</h3>
<em>Apr 30 '04; API spec. version: 4.30; affected top-level classes: <a href="./org/openide/text/AnnotationProvider.html"><code>AnnotationProvider</code></a>; made by: pnejedly; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=41345">
#41345</a></em>
<br>
<ul>
<li>Added interface org.openide.text.AnnotationProvider</li>
<li>Call all instances of the interface found in the global lookup
when going to visualize given Annotatable.
</li>
</ul>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="issue-41085">Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</a>
</h3>
<em>Apr 20 '04; API spec. version: 4.31; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a> <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a> <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a> <code>org.openide.text.EditorSupport</code>; made by: mkleint; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=41085">
#41085</a></em>
<br>
In order to implement MultiViews, these changes were necessary to the org.openide.text package.
<ul>
<li>Added new subinterface to NbDocument -&gt; NbDocument.CustomToolbar which lets the implementors to define a custom toolbar.
It allows to present the toolbar in different environments (eg. multiviews)</li>
<li>CloneableEditorSupport defined a new interface CloneableEditorSupport.Pane and has a new protected method createPane() </li>
<li>The deprecated EditorSupport has a new protected method createPane() </li>
<li>CloneableEditor implements CloneableEditorSupport.Pane, thus
updateTitle was changed from protected to public and 2 additional methods from Pane interfacewere added</li>
</ul>
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! -->
<h3>
<a name="issue-37892">Allow CloneableEditorSupport subclasses to specify
persistence ID for the associated editor TopComponent.
</a>
</h3>
<em>Feb 2 '04; API spec. version: 4.24; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: pnejedly; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=37892">
#37892</a></em>
<br>
Adding protected <code>CloneableEditorSupport.documentID</code>
to allow subclasses to compute preferred ID String used for
TopComponent persistence.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-34692">New <code>getInputStream()</code> method in CloneableEditorSupport</a>
</h3>
<em>Jun 26 '03; API spec. version: 4.7; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: pjiricka; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=34692">
#34692</a></em>
<br>
New method that returns an InputStream which reads the current data
from the editor, taking into account the encoding of the file.
The returned InputStream contains the same data as if the file was written
out to the disk. Useful when interacting with a tool that expects an InputStream,
and the current (possibly modified) content of the editor is desired.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-32937">CloneableEditorSupport takes Lookup for its Lines in constructor</a>
</h3>
<em>Apr 18 '03; API spec. version: 4.5; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=32937">
#32937</a></em>
<br>
Allows subclasses of the support DataEditorSupport, etc. pass
additional information to each of its Lines. Such information
can consist of location like DataObject or FileObject.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="PositionRef-getEditorSupport">PositionRef.getEditorSupport() removed</a>
</h3>
<em>Apr 2 '03; API spec. version: 4.3; affected top-level classes: <a href="./org/openide/text/PositionRef.html"><code>PositionRef</code></a> <code>org.openide.text.DataEditorSupport</code>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=32143">
#32143</a></em>
<br>
For a long time deprecated <code>PositionRef.getEditorSupport()</code> method
has been removed to enabled separation of EditorSupport to openide-loaders.jar
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="Line-getDataObject">Line.getDataObject() removed</a>
</h3>
<em>Apr 2 '03; API spec. version: 4.3; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a> <code>org.openide.text.DataEditorSupport</code>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=32143">
#32143</a></em>
<br>
Due to separation of openide-loaders.jar the <code>Line.getDataObject()</code>
method had to be removed and replaced by <code>Line.getLookup</code> which
provides more general way for providing line context. The direct replacement
for the old method is <code>DataObject DataEditorSupport.findDataObject(Line)</code>.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="new_Line-DataObject">Line constructor changed</a>
</h3>
<em>Apr 2 '03; API spec. version: 4.3; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a> <a href="./org/openide/text/DocumentLine.html"><code>DocumentLine</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=32143">
#32143</a></em>
<br>
Due to separation of openide-loaders.jar the <code>Line</code> and
<code>DocumentLine</code> constructors taking DataObject had to be
modified to take Lookup or plain Object instead.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="CloneableEditorSupport.messageLine">CloneableEditorSupport can provide display name for its Lines</a>
</h3>
<em>Apr 2 '03; API spec. version: 4.3; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: jtulach; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=32143">
#32143</a></em>
<br>
Added method <code>String messageLine (Line)</code> that can be
overriden to provide meaningful display name for lines produced
by this support.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="issue-17144">Added to javadoc an <code>IndexOutOfBoundsException</code>
can be thrown from <code>NbDocument.findLineOffset</code> method
</a>
</h3>
<em>Oct 31 '01; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a>; issues: <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=17144">
#17144</a></em>
<br>
Added declaration to javadoc of the method
<code>NbDocument.findLineOffset()</code> can throw an unchecked
<code>IndexOutOfBoundsException</code>. 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
<code>Line.Set.getCurrent()</code> method.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="version-1.38">Notifications about annotation attaching/detaching added</a>
</h3>
<em>Oct 12 '01; API spec. version: 1.38; affected top-level classes: <a href="./org/openide/text/Annotation.html"><code>Annotation</code></a></em>
<br>
Added protected methods
<code>Annotation.notifyAttached()</code> and
<code>Annotation.notifyDetached()</code>.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="Annotatable.getText">Get content of Annotatable</a>
</h3>
<em>Sep 25 '01; API spec. version: 1.35; affected top-level classes: <a href="./org/openide/text/Annotatable.html"><code>Annotatable</code></a></em>
<br>
Added public abstract method
<code>Annotatable.getText()</code>. Listeners can be attached to
Annotatable.PROP_TEXT property.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="Annotatable-isDeleted-getAnnotationCount-final">Annotatable.isDeleted and Annotatable.getAnnotationCount are final</a>
</h3>
<em>Sep 25 '01; API spec. version: 1.35; affected top-level classes: <a href="./org/openide/text/Annotatable.html"><code>Annotatable</code></a></em>
<br>
The Annotatable.isDeleted and Annotatable.getAnnotationCount are final now.
<br>
<strong>Compatibility: </strong>
This is not considered as incompatible change,
because the API with these methods was not published yet.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="Line.mark-deprecated">
<code>Line</code> methods deprecated in favor of annotations</a>
</h3>
<em>Jul 9 '01; API spec. version: 1.20; affected top-level classes: <a href="./org/openide/text/Line.html"><code>Line</code></a> <a href="./org/openide/text/DocumentLine.html"><code>DocumentLine</code></a></em>
<br>
Because of publication of Annotation API, all previously used methods like
<code>setBreakpoint</code>, <code>isBreakpoint</code>,
<code>markError</code>, <code>unmarkError</code>,
<code>markCurrentLine</code>, <code>unmarkCurrentLine</code>, and
<code>canBeMarkedCurrent</code> are deprecated. Use
<code>Annotation.attach()</code> and <code>detach()</code> instead.
<code>Line</code> now extends <code>Annotatable</code> abstract class.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="Annotations-API">New annotations API published</a>
</h3>
<em>Jul 9 '01; API spec. version: 1.20; affected top-level classes: <a href="./org/openide/text/Annotation.html"><code>Annotation</code></a> <a href="./org/openide/text/Annotatable.html"><code>Annotatable</code></a> <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a></em>
<br>
Annotation API was published.
<br>
<strong>Compatibility: </strong>
Because of publication of Annotation API, all previously used
<code>NbDocument</code> methods like <code>markError</code>,
<code>markCurrent</code>, <code>markNormal</code> are deprecated. Use
<code>addAnnotation</code> and <code>removeAnnotation</code> instead.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="5.85602765688684E14">Customization of editor support after creation</a>
</h3>
<em>Dec 1 '00; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a>; made by: </em>
<br>
Added method <code>initializeCloneableEditor</code> to allow easier
customization of the editor after creation and also after deserialization.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="7.301099361103E12">Can control undo/redo on editor supports</a>
</h3>
<em>Jul 21 '00; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a></em>
<br>
<code>getUndoRedo()</code> method was made protected final instead of
final.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="1.16811111011151E14">Can control title format for editor supports</a>
</h3>
<em>Jul 17 '00; affected top-level classes: <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a></em>
<br>
<code>updateTitles()</code> method was made protected final instead of
private.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="115339"><code>IndentEngine</code> a service type</a>
</h3>
<em>Jun 23 '00; affected top-level classes: <a href="./org/openide/text/IndentEngine.html"><code>IndentEngine</code></a></em>
<br>
Now a <code>ServiceType</code>. A few new methods relating to lookup.
<br>
<strong>Compatibility: </strong>
Until Sep 27 '00, was incompatible
(<code>register</code> had been deleted as it is no longer useful); the
method was then restored but made deprecated.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="4.492034912079E12">Refactoring of editor and open supports</a>
</h3>
<em>May 29 '00; affected top-level classes: <code>org.openide.text.EditorSupport</code> <a href="./org/openide/text/CloneableEditorSupport.html"><code>CloneableEditorSupport</code></a> <a href="./org/openide/text/CloneableEditor.html"><code>CloneableEditor</code></a> <code>org.openide.loaders.OpenSupport</code> <code>org.openide.windows.CloneableOpenSupport</code></em>
<br>
Major refactoring of <code>EditorSupport</code> and
<code>OpenSupport</code>, so that subclasses can have much finer control
over pieces of its functionality.
<br>
<strong>Compatibility: </strong>
First broken, Sep 29 '00 restored backwards
compatibility.
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="2.50572581841E11">Setting colors for lines deprecated</a>
</h3>
<em>Mar 27 '00; affected top-level classes: <a href="./org/openide/text/NbDocument.html"><code>NbDocument</code></a></em>
<br>
<code>NbDocument.COLORS</code> and <code>NbDocument.Colors</code>
deprecated.
<br>
<strong>Compatibility: </strong>
First removed, later re-added but deprecated in trunk and
<code>boston</code>. These classes were long disused (and should only have
ever been used by the editor module anyway, which did not need them).
<!-- AUTOMATICALLY GENERATED - DO NOT EDIT ME! --><h3>
<a name="5.6681861E7"><code>PrintSettings.getPageFormat</code> requires a printer job</a>
</h3>
<em>Feb 24 '00; affected top-level classes: <code>org.openide.text.PrintSettings</code></em>
<br>
<code>getPageFormat</code> method now requires a <code>PrinterJob</code>
argument.
<br>
<strong>Compatibility: </strong>
First removed, later re-added but deprecated in trunk and
<code>boston</code>. User-stored settings of this class should be
backwards compatible, however code directly calling
<code>getPageFormat</code> 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.
<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>