<?xml version="1.0" encoding="UTF-8"?>
<!--
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-2007 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.
-->
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../nbbuild/javadoctools/apichanges.dtd">
<apichanges>
<apidefs>
<apidef name="text">Text API</apidef>
</apidefs>
<changes>
    <change id="PositionRef.Position">
        <api name="text"/>
        <summary>Implement Position interface for compatibility</summary>
        <version major="6" minor="64"/>
        <date day="25" month="5" year="2014"/>
        <author login="sdedic"/>
        <compatibility modification="yes" binary="compatible" source="compatible"/>
        <description>
            <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>
        </description>
        <class name="PositionRef" package="org.openide.text"/>
        <issue number="244744"/>
    </change>
    <change id="NbDocument-getEditToBeUndoneOfType">
        <api name="text"/>
        <summary>Added NbDocument.getEditToBeUndoneOfType</summary>
        <version major="6" minor="49"/>
        <date day="10" month="5" year="2011"/>
        <author login="mmetelka"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added NbDocument.getEditToBeUndoneOfType()
                and NbDocument.getEditToBeRedoneOfType()
                to retrieve custom undoable edits that wrap document-generated
                undoable edits.
            </p>
        </description>
        <class package="org.openide.text" name="NbDocument"/>
        <issue number="204828"/>
    </change>
      <change id="NbDocument.openDocument">
          <api name="text"/>
          <summary>Added methods <code>NbDocument.getDocument</code>, 
          <code>NbDocument.openDocument</code> with offset parameter and 
          <code>NbDocument.openDocument</code> with line and column parameter</summary>
          <version major="6" minor="46"/>
          <date day="21" month="3" year="2012"/>
          <author login="theofanis"/>
          <compatibility addition="yes"/>
          <description>
              <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>
          </description>
          <class package="org.openide.text" name="NbDocument"/>
          <issue number="209058"/>
      </change>
    <change id="mark-commit-group">
        <api name="text"/>
        <summary>fix hole in commit-groups about empty commit group</summary>
        <version major="6" minor="40"/>
        <date day="20" month="7" year="2011"/>
        <author login="err"/>
        <compatibility addition="yes"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <issue number="199568"/>
    </change>
    <change id="CE.closeLast.boolean">
        <api name="text"/>
        <summary>CloneableEditor.closeLast</summary>
        <version major="6" minor="39"/>
        <date day="1" month="6" year="2011"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" deletion="no"
          deprecation="yes" modification="no" semantic="compatible" 
        />
        <description>
            <p>
                <code>CloneableEditor</code> has a new utility method
                <code>closeLast</code>.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditor"/>
        <issue number="196810"/>
    </change>
    <change id="CE.associateLookup">
        <api name="text"/>
        <summary>CloneableEditor(associateLookup)</summary>
        <version major="6" minor="39"/>
        <date day="1" month="6" year="2011"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" deletion="no"
          deprecation="yes" modification="no" semantic="compatible" 
        />
        <description>
            <p>
                <code>CloneableEditor</code> offers new constructor
                that will reuse the lookup provided by its 
                <a href="@TOP@/org/openide/text/CloneableEditorSupport.html">CloneableEditorSupport</a>.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditor"/>
        <issue number="196810"/>
    </change>
    <change id="initializeBySupport">
        <api name="text"/>
        <summary>CloneableEditor.initializeBySupport</summary>
        <version major="6" minor="39"/>
        <date day="1" month="6" year="2011"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" deletion="no"
          deprecation="yes" modification="no" semantic="compatible" 
        />
        <description>
            <p>
                Subclasses of <code>CloneableEditor</code> can manually request own 
                initialization by calling its
                <a href="@TOP@/org/openide/text/CloneableEditor.html#initializeBySupport()">initializeBySupport</a>
                method.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditor"/>
        <issue number="196810"/>
    </change>
    <change id="NbDocument-Annotatable">
        <api name="text"/>
        <summary>NbDocument.Annotatable threading changes</summary>
        <version major="6" minor="35"/>
        <date day="7" month="2" year="2011"/>
        <author login="mmetelka"/>
        <compatibility semantic="incompatible"/>
        <description>
            <p>
                <code>addAnnotation()</code> and <code>removeAnnotation()</code>
                no longer re-plan their work into EDT.
            </p>
        </description>
        <class package="org.openide.text" name="NbDocument"/>
        <issue number="194816"/>
    </change>
    <change id="commit-groups">
        <api name="text"/>
        <summary>Better support for vi mode</summary>
        <version major="6" minor="34"/>
        <date day="24" month="11" year="2010"/>
        <author login="err"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Support for chunking edits via <code>BEGIN_COMMIT_GROUP</code>
                and <code>END_COMMIT_GROUP</code>.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <issue number="103467"/>
    </change>
    <change id="Editors-TabActions">
        <api name="text"/>
        <summary>Ability to inject actions into editor tab context menus</summary>
        <version major="6" minor="32"/>
        <date day="16" month="8" year="2010"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <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>
        </description>
        <issue number="189320"/>
    </change>
    <change id="NbDocument-style-constants-deprecated">
        <api name="text"/>
        <summary>Deprecating style constants in NbDocument</summary>
        <version major="6" minor="29"/>
        <date day="21" month="12" year="2009"/>
        <author login="vstejskal"/>
        <compatibility addition="no" deletion="no" modification="yes" binary="compatible" source="compatible"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="NbDocument"/>
        <issue number="97517"/>
    </change>
    <change id="CloneableEditorSupport.asynchronousOpen">
        <api name="text"/>
        <summary>Add CloneableEditorSupport.asynchronousOpen</summary>
        <version major="6" minor="26"/>
        <date day="1" month="10" year="2009"/>
        <author login="mslama"/>
        <compatibility addition="yes" deletion="no" modification="no" binary="compatible" source="compatible"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <issue number="171713"/>
    </change>
    <change id="NbDocument.findRecentEditorPane">
        <api name="text"/>
        <summary>Add NbDocument.findRecentEditorPane</summary>
        <version major="6" minor="24"/>
        <date day="12" month="8" year="2009"/>
        <author login="mslama"/>
        <compatibility addition="yes" deletion="no" modification="no" binary="compatible" source="compatible"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="NbDocument"/>
        <issue number="168415"/>
    </change>
    <change id="Line.show">
        <api name="text"/>
        <summary>Improve Line.show</summary>
        <version major="6" minor="21"/>
        <date day="7" month="7" year="2008"/>
        <author login="mslama"/>
        <compatibility addition="yes" deletion="no" modification="no" binary="compatible" source="compatible"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="Line"/>
        <issue number="138146"/>
    </change>
    <change id="beforeSaveRunnable">
        <api name="text"/>
        <summary>"beforeSaveRunnable" document property</summary>
        <version major="6" minor="20"/>
        <date day="16" month="5" year="2008"/>
        <author login="mmetelka"/>
        <compatibility addition="yes" deletion="no" modification="no" binary="compatible" source="compatible"/>
        <description>
            <p>
            CloneableEditorSupport.saveDocument() checks document's "beforeSaveDocument" property
            for a Runnable to be executed before the actual save will be done.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <issue number="13063"/>
    </change>
    <change id="initializeOnBackground">
        <api name="text"/>
        <summary>EditorKit, Document and co. are loaded on background by default</summary>
        <version major="6" minor="18"/>
        <date day="25" month="3" year="2008"/>
        <author login="jtulach"/>
        <compatibility deletion="no" binary="compatible" source="compatible" modification="yes" semantic="incompatible"/>
        <description>
            <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="@TOP@/architecture-summary.html#java-EditorKitInitialization">API for editor kits</a>, 
            one 
            <a href="@TOP@/architecture-summary.html#property-oldInitialization">component</a>
            and one 
            <a href="@TOP@/architecture-summary.html#property-org.openide.text.CloneableEditor.oldInitialization">system</a>
            property.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditor"/>
        <issue number="130171"/>
    </change>
    <change id="NbDocument.Colors">
        <api name="text"/>
        <summary>Public static inner class <code>NbDocument.Colors</code> moved to org.openide.options.</summary>
        <version major="6" minor="16"/>
        <date day="22" month="5" year="2007"/>
        <author login="mslama"/>
        <compatibility deletion="yes" binary="compatible" source="incompatible"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="NbDocument"/>
        <issue number="88531"/>
    </change>
    <change id="NbDocument.COLORS">
        <api name="text"/>
        <summary>Remove public field <code>NbDocument.COLORS</code></summary>
        <version major="6" minor="16"/>
        <date day="22" month="5" year="2007"/>
        <author login="mslama"/>
        <compatibility deletion="yes" binary="incompatible" source="incompatible"/>
        <description>
            <p>
                Field <code>NbDocument.COLORS</code> was removed to remove dependency on org.openide.options.
            </p>
        </description>
        <class package="org.openide.text" name="NbDocument"/>
        <issue number="88531"/>
    </change>
    <change id="PrintPreferences">
        <api name="text"/>
        <summary>Adding <code>PrintPreferences</code></summary>
        <version major="6" minor="16"/>
        <date day="22" month="5" year="2007"/>
        <author login="rmatous"/>
        <compatibility addition="yes" binary="compatible" source="compatible"/>
        <description>
            <p>
                Class <code>PrintPreferences</code> was added as replacement for original
                class <code>PrintSettings</code>.
            </p>
        </description>
        <class package="org.openide.text" name="PrintPreferences"/>
        <issue number="88531"/>
    </change>
    <change id="PrintSettings">
        <api name="text"/>
        <summary>Removing <code>PrintSettings</code></summary>
        <version major="6" minor="16"/>
        <date day="22" month="5" year="2007"/>
        <author login="rmatous"/>
        <compatibility deletion="yes" binary="compatible" source="incompatible"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="PrintSettings" link="no"/>
        <issue number="88531"/>
    </change>
    <change id="Line.SHOW_REUSE">    
        <api name="text"/>
        <summary>Adding Line.SHOW_REUSE and Line.SHOW_REUSE_NEW constants for Line.show method</summary>
        <version major="6" minor="14"/>
        <date day="5" month="3" year="2007"/>
        <author login="pnejedly"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="Line"/>
        <issue number="94607"/>
    </change>
    <change id="CloneableEditorSupportRedirector">
        <api name="text"/>
        <summary>CloneableEditorSupportRedirector</summary>
        <version major="6" minor="13"/>
        <date day="7" month="2" year="2007"/>
        <author login="jtulach"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <p>The <a href="@TOP@/org/openide/text/CloneableEditorSupportRedirector.html">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="@TOP@/org/openide/text/CloneableEditorSupportRedirector.html">CloneableEditorSupportRedirector</a>.
            </p>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupportRedirector"/>
        <issue number="51690"/>
    </change>

    <change id="CloneableEditorSupport.getEditorKit">
        <api name="text"/>
        <summary>Adding CloneableEditorSupport.getEditorKit method</summary>
        <version major="6" minor="12"/>
        <date day="2" month="8" year="2006"/>
        <author login="vstejskal"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <issue number="52657"/>
    </change>

    <change id="EditorPaneDragAndDrop">
        <api name="text"/>
        <summary>Editor panes listen for special objects being dragged over them</summary>
        <version major="6" minor="11"/>
        <date day="30" month="5" year="2006"/>
        <author login="saubrecht"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="CloneableEditor"/>
        <issue number="50129"/>
    </change>

    <change id="CloneableEditorSupport-messageHtmlName">
        <api name="text"/>
        <summary>Added CloneableEditorSupport.messageHtmlName method</summary>
        <version major="6" minor="8"/>
        <date day="31" month="10" year="2005"/>
        <author login="dsimonek"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <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>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <class package="org.openide.text" name="CloneableEditor"/>
        <class package="org.openide.text" name="DataEditorSupport" link="no" />
        <issue number="66777"/>
    </change>

    <change id="ActiveEditorDrop">
        <api name="text"/>
        <summary>Added ActiveEditorDrop interface</summary>
        <version major="6" minor="6"/>
        <date day="9" month="8" year="2005"/>
        <author login="mroskanin"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <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">issue #61367</a>
            </p>
        </description>
        <class package="org.openide.text" name="ActiveEditorDrop"/>
        <issue number="61367"/>
    </change>
    <change id="CloneableEditorSupport-wrapEditorComponent">
        <api name="text"/>
        <summary>Added CloneableEditorSupport.wrapEditorComponent</summary>
        <version major="6" minor="4"/>
        <date day="22" month="7" year="2005"/>
        <author login="abadea"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            <p>A <code>wrapEditorComponent</code> method has been added to
            CloneableEditorSupport allowing to wrap the editor component
            in another component.</p>
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <class package="org.openide.text" name="CloneableEditor"/>
        <issue number="60922"/>
    </change>
    <change id="annotations-error-stripe">
        <api name="text"/>
        <summary>Annotation type extended with <code>severity</code>, <code>custom_sidebar_color</code>, <code>browsable</code> and <code>priority</code>
                 attributes
        </summary>
        <version major="6" minor="3"/>
        <date day="18" month="7" year="2005"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            Annotation type was extended with <code>severity</code>, <code>custom_sidebar_color</code>, <code>browsable</code> and <code>priority</code>
                 attributes.
        </description>
        <issue number="55639"/>
    </change>
<change id="Line.SHOW_TOFRONT">
        <api name="text"/>
        <summary>Added a new constant <code>Line.SHOW_TOFRONT</code>
</summary>
        <version major="5" minor="8"/>
        <date day="21" month="3" year="2005"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            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.
        </description>
        <class package="org.openide.text" name="Line"/>
        <issue number="47825"/>
    </change>
<change id="CloneableEditor-openAt">
      <api name="text"/>
      <summary>CloneableEditor.openAt made protected</summary>
      <version major="5" minor="2"/>
      <date day="6" month="12" year="2004"/>
      <author login="pnejedly"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        <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>
      </description>
      <class package="org.openide.text" name="CloneableEditorSupport"/>
      <issue number="51441"/>
    </change>
    <change id="not-calling-CloneableEditorSupport-notifyModified-that-often">
      <api name="text"/>
      <summary>
<code>CloneableEditorSupport.notifyModified</code> is called only on first modification</summary>
      <version major="5" minor="4"/>
      <date day="14" month="1" year="2005"/>
      <author login="jtulach"/>
      <compatibility binary="compatible" source="compatible" semantic="incompatible" deprecation="no" addition="no" deletion="no" modification="no"/>
      <description>
        <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>
      </description>
      <class package="org.openide.text" name="CloneableEditorSupport"/>
      <issue number="52493"/>
    </change>
<change id="CloneableEditorSupport.Pane">
        <api name="text"/>
        <summary>Enhance SPI interface for CloneableEditorSupport.Pane providers</summary>
        <version major="4" minor="45"/>
        <date day="24" month="8" year="2004"/>
        <author login="mleint"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
            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>.
        </description>
        <issue number="46127"/>
    </change>
<change>
     <api name="text"/>
     <summary>Line.getOriginalLineNumber</summary>
     <version major="4" minor="38"/>
     <date day="8" month="6" year="2004"/>
     <author login="jtulach"/>
     <compatibility binary="compatible" addition="yes" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
     <description>
        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.
     </description>
     <class package="org.openide.text" name="Line"/>
     <issue number="43484"/>
    </change>
<change>
    <api name="text"/>
    <summary>Allow custom toolbar for NbDocument impls, editor panes separation in editor support classes</summary>
    <version major="4" minor="31"/>
    <date day="20" month="4" year="2004"/>
    <author login="mkleint"/>
    <compatibility addition="yes" modification="yes" deprecation="yes" semantic="compatible" binary="compatible" source="compatible" deletion="no"/>
    <description>
        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>
    </description>
    <class package="org.openide.text" name="NbDocument"/>
    <class package="org.openide.text" name="CloneableEditorSupport"/>
    <class package="org.openide.text" name="CloneableEditor"/>
    <class package="org.openide.text" name="EditorSupport" link="no" />
    <issue number="41085"/>
    </change>
<change>
    <api name="text"/>
    <summary>Support for AnnotationProvider interface</summary>
    <version major="4" minor="30"/>
    <date day="30" month="4" year="2004"/>
    <author login="pnejedly"/>
    <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
    <description>
        <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>
    </description>
    <class package="org.openide.text" name="AnnotationProvider"/>
    <issue number="41345"/>
    </change>
<change>
        <api name="text"/>
        <summary>Allow CloneableEditorSupport subclasses to specify
	   persistence ID for the associated editor TopComponent.
        </summary>
        <version major="4" minor="24"/> 
        <date day="2" month="2" year="2004"/>
        <author login="pnejedly"/>
        <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
        <description>
                Adding protected <code>CloneableEditorSupport.documentID</code>
                to allow subclasses to compute preferred ID String used for
                TopComponent persistence.
        </description>
        <class package="org.openide.text" name="CloneableEditorSupport"/>
        <issue number="37892"/>
    </change>
<change>
     <api name="text"/>
     <summary>New <code>getInputStream()</code> method in CloneableEditorSupport</summary>
     <version major="4" minor="7"/>
     <date day="26" month="6" year="2003"/>
     <author login="pjiricka"/>
     <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
     <description>
       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.
     </description>
     <class package="org.openide.text" name="CloneableEditorSupport"/>
     <issue number="34692"/>
    </change>
<change>
     <api name="text"/>
     <summary>CloneableEditorSupport takes Lookup for its Lines in constructor</summary>
     <version major="4" minor="5"/>
     <date day="18" month="4" year="2003"/>
     <author login="jtulach"/>
     <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
     <description>
       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.
     </description>
     <class package="org.openide.text" name="CloneableEditorSupport"/>
     <issue number="32937"/>
    </change>
<change id="PositionRef-getEditorSupport">
     <api name="text"/>
     <summary>PositionRef.getEditorSupport() removed</summary>
     <version major="4" minor="3"/>
     <date day="2" month="4" year="2003"/>
     <author login="jtulach"/>
     <compatibility deletion="yes" binary="incompatible" source="incompatible" semantic="compatible" deprecation="no" addition="no" modification="no"/>
     <description>
        For a long time deprecated <code>PositionRef.getEditorSupport()</code> method
        has been removed to enabled separation of EditorSupport to openide-loaders.jar
     </description>
     <class package="org.openide.text" name="PositionRef"/>
     <class package="org.openide.text" name="DataEditorSupport" link="no" />
     <issue number="32143"/>
    </change>
<change id="Line-getDataObject">
     <api name="text"/>
     <summary>Line.getDataObject() removed</summary>
     <version major="4" minor="3"/>
     <date day="2" month="4" year="2003"/>
     <author login="jtulach"/>
     <compatibility addition="yes" deletion="yes" binary="incompatible" source="incompatible" semantic="compatible" deprecation="no" modification="no"/>
     <description>
        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>.
     </description>
     <class package="org.openide.text" name="Line"/>
     <class package="org.openide.text" name="DataEditorSupport" link="no" />
     <issue number="32143"/>
    </change>
<change id="new_Line-DataObject">
     <api name="text"/>
     <summary>Line constructor changed</summary>
     <version major="4" minor="3"/>
     <date day="2" month="4" year="2003"/>
     <author login="jtulach"/>
     <compatibility addition="yes" deletion="yes" binary="incompatible" source="incompatible" semantic="compatible" deprecation="no" modification="no"/>
     <description>
        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. 
     </description>
     <class package="org.openide.text" name="Line"/>
     <class package="org.openide.text" name="DocumentLine"/>
     <issue number="32143"/>
    </change>
<change id="CloneableEditorSupport.messageLine">
     <api name="text"/>
     <summary>CloneableEditorSupport can provide display name for its Lines</summary>
     <version major="4" minor="3"/>
     <date day="2" month="4" year="2003"/>
     <author login="jtulach"/>
     <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
     <description>
        Added method <code>String messageLine (Line)</code> that can be
        overriden to provide meaningful display name for lines produced
        by this support.
     </description>
     <class package="org.openide.text" name="CloneableEditorSupport"/>
     <issue number="32143"/>
    </change>
<change id="Annotatable.getText">
      <api name="text"/>
      <summary>Get content of Annotatable</summary>
      <version major="1" minor="35"/>
      <date day="25" month="9" year="2001"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        Added public abstract method
        <code>Annotatable.getText()</code>. Listeners can be attached to
	Annotatable.PROP_TEXT property.
      </description>
      <class package="org.openide.text" name="Annotatable"/>
    </change>
<change id="Annotatable-isDeleted-getAnnotationCount-final">
      <api name="text"/>
      <summary>Annotatable.isDeleted and Annotatable.getAnnotationCount are final</summary>
      <version major="1" minor="35"/>
      <date day="25" month="9" year="2001"/>
      <compatibility modification="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" addition="no" deletion="no">
          This is not considered as incompatible change,
          because the API with these methods was not published yet.
      </compatibility>
      <description>
        The Annotatable.isDeleted and Annotatable.getAnnotationCount are final now.
      </description>
      <class package="org.openide.text" name="Annotatable"/>
    </change>
<change id="Line.mark-deprecated">
      <api name="text"/>
      <summary>
<code>Line</code> methods deprecated in favor of annotations</summary>
      <version major="1" minor="20"/>
      <date day="9" month="7" year="2001"/>
      <compatibility modification="yes" deprecation="yes" binary="compatible" source="compatible" semantic="compatible" addition="no" deletion="no"/>
      <description>
        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.
      </description>
      <class package="org.openide.text" name="Line"/>
      <class package="org.openide.text" name="DocumentLine"/>
    </change>
<change>
      <api name="text"/>
      <summary>Refactoring of editor and open supports</summary>
      <date day="29" month="5" year="2000"/>
      <compatibility addition="yes" deprecation="yes" binary="compatible" source="compatible" semantic="compatible" deletion="no" modification="no">
        First broken, <date day="29" month="9" year="2000"/> restored backwards
        compatibility.
      </compatibility>
      <description>
        Major refactoring of <code>EditorSupport</code> and
        <code>OpenSupport</code>, so that subclasses can have much finer control
        over pieces of its functionality. 
      </description>
      <class package="org.openide.text" name="EditorSupport" link="no" />
      <class package="org.openide.text" name="CloneableEditorSupport"/>
      <class package="org.openide.text" name="CloneableEditor"/>
      <class package="org.openide.loaders" name="OpenSupport" link="no" />
      <class package="org.openide.windows" name="CloneableOpenSupport" link="no" />
    </change>
<change>
      <api name="text"/>
      <summary>Customization of editor support after creation</summary>
      <date day="1" month="12" year="2000"/>
      <author login=""/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        Added method <code>initializeCloneableEditor</code> to allow easier
        customization of the editor after creation and also after deserialization.
      </description>
      <class package="org.openide.text" name="CloneableEditorSupport"/>
      <branch name="release31">
        <date day="1" month="12" year="2000"/>
      </branch>
    </change>
<change>
      <api name="text"/>
      <summary>Can control title format for editor supports</summary>
      <date day="17" month="7" year="2000"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        <code>updateTitles()</code> method was made protected final instead of
        private.
      </description>
      <class package="org.openide.text" name="CloneableEditorSupport"/>
    </change>
<change>
      <api name="text"/>
      <summary>Can control undo/redo on editor supports</summary>
      <date day="21" month="7" year="2000"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        <code>getUndoRedo()</code> method was made protected final instead of
        final.
      </description>
      <class package="org.openide.text" name="CloneableEditorSupport"/>
    </change>
<change>
      <api name="text"/>
      <summary><code>IndentEngine</code> a service type</summary>
      <date day="23" month="6" year="2000"/>
      <compatibility addition="yes" deprecation="yes" binary="compatible" source="compatible" semantic="compatible" deletion="no" modification="no">
        Until <date day="27" month="9" year="2000"/>, was incompatible
        (<code>register</code> had been deleted as it is no longer useful); the
        method was then restored but made deprecated.
      </compatibility>
      <description>
        Now a <code>ServiceType</code>. A few new methods relating to lookup.
      </description>
      <class package="org.openide.text" name="IndentEngine"/>
    </change>
<change>
      <api name="text"/>
      <summary><code>PrintSettings.getPageFormat</code> requires a printer job</summary>
      <date day="24" month="2" year="2000"/>
      <compatibility modification="yes" deprecation="yes" binary="compatible" source="compatible" semantic="compatible" addition="no" deletion="no">
        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.
      </compatibility>
      <description>
        <code>getPageFormat</code> method now requires a <code>PrinterJob</code>
        argument.
      </description>
      <class package="org.openide.text" name="PrintSettings" link="no"/>
    </change>
<change id="Annotations-API">
      <api name="text"/>
      <summary>New annotations API published</summary>
      <version major="1" minor="20"/>
      <date day="9" month="7" year="2001"/>
      <compatibility addition="yes" deprecation="yes" binary="compatible" source="compatible" semantic="compatible" deletion="no" modification="no">
        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.
      </compatibility>
      <description>
        Annotation API was published.
      </description>
      <class package="org.openide.text" name="Annotation"/>
      <class package="org.openide.text" name="Annotatable"/>
      <class package="org.openide.text" name="NbDocument"/>
    </change>
<change>
      <api name="text"/>
      <summary>Setting colors for lines deprecated</summary>
      <date day="27" month="3" year="2000"/>
      <compatibility deprecation="yes" binary="compatible" source="compatible" semantic="compatible" addition="no" deletion="no" modification="no">
        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).
      </compatibility>
      <description>
        <code>NbDocument.COLORS</code> and <code>NbDocument.Colors</code>
        deprecated.
      </description>
      <class package="org.openide.text" name="NbDocument"/>
    </change>
<change>
      <api name="text"/>
      <summary>Added to javadoc an <code>IndexOutOfBoundsException</code>
        can be thrown from <code>NbDocument.findLineOffset</code> method
      </summary>
      <date day="31" month="10" year="2001"/>
      <compatibility modification="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" addition="no" deletion="no"/>
      <description>
        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.
      </description>
      <class package="org.openide.text" name="NbDocument"/>
      <issue number="17144"/>
    </change>
<change>
      <api name="text"/>
      <summary>Notifications about annotation attaching/detaching added</summary>
      <version major="1" minor="38"/>
      <date day="12" month="10" year="2001"/>
      <compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
      <description>
        Added protected methods
        <code>Annotation.notifyAttached()</code> and
        <code>Annotation.notifyDetached()</code>.
      </description>
      <class package="org.openide.text" name="Annotation"/>
    </change>
</changes>
<htmlcontents>
<head>
<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">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/>
<standard-changelists module-code-name="org.openide.text"/>
<hr/>
<p>@FOOTER@</p>
</body>
</htmlcontents>
</apichanges>