← Back to branch summary

~ubuntu-branches/ubuntu/quantal/netbeans/quantal

« back to all changes in this revision

Viewing changes to debuggercore/api/apichanges.xml

  • Committer: Bazaar Package Importer
  • Author(s): Marek Slama
  • Date: 2008-01-29 14:11:22 UTC
  • Revision ID: james.westby@ubuntu.com-20080129141122-fnzjbo11ntghxfu7
Tags: upstream-6.0.1
Import upstream version 6.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
debuggercore/api/apichanges.xml
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!--
 
3
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 
4
 
 
5
Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
 
6
 
 
7
 
 
8
The contents of this file are subject to the terms of either the GNU
 
9
General Public License Version 2 only ("GPL") or the Common
 
10
Development and Distribution License("CDDL") (collectively, the
 
11
"License"). You may not use this file except in compliance with the
 
12
License. You can obtain a copy of the License at
 
13
http://www.netbeans.org/cddl-gplv2.html
 
14
or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
 
15
specific language governing permissions and limitations under the
 
16
License.  When distributing the software, include this License Header
 
17
Notice in each file and include the License file at
 
18
nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this
 
19
particular file as subject to the "Classpath" exception as provided
 
20
by Sun in the GPL Version 2 section of the License file that
 
21
accompanied this code. If applicable, add the following below the
 
22
License Header, with the fields enclosed by brackets [] replaced by
 
23
your own identifying information:
 
24
"Portions Copyrighted [year] [name of copyright owner]"
 
25
 
 
26
Contributor(s):
 
27
 
 
28
The Original Software is NetBeans. The Initial Developer of the Original
 
29
Software is Sun Microsystems, Inc. Portions Copyright 1997-2007 Sun
 
30
Microsystems, Inc. All Rights Reserved.
 
31
 
 
32
If you wish your version of this file to be governed by only the CDDL
 
33
or only the GPL Version 2, indicate your decision by adding
 
34
"[Contributor] elects to include this software in this distribution
 
35
under the [CDDL or GPL Version 2] license." If you do not indicate a
 
36
single choice of license, a recipient has the option to distribute
 
37
your version of this file under either the CDDL, the GPL Version 2 or
 
38
to extend the choice of license to its licensees as provided above.
 
39
However, if you add GPL Version 2 code and therefore, elected the GPL
 
40
Version 2 license, then the option applies only if the new code is
 
41
made subject to such option by the copyright holder.
 
42
-->
 
43
 
 
44
<?xml-stylesheet href="../../nbbuild/javadoctools/apichanges.xsl" type="text/xsl"?>
 
45
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../../nbbuild/javadoctools/apichanges.dtd">
 
46
 
 
47
<!-- INFO FOR PEOPLE ADDING CHANGES:
 
48
[most of contents snipped - see openide's apichanges for how-to instructions]
 
49
<change>
 
50
    <api name="compiler"/>
 
51
    <summary>Some brief description here, can use <b>XHTML</b></summary>
 
52
    <version major="1" minor="99"/>
 
53
    <date day="13" month="6" year="2001"/>
 
54
    <author login="jrhacker"/>
 
55
    <compatibility addition="yes"/>
 
56
    <description>
 
57
        The main description of the change here.
 
58
        Again can use full <b>XHTML</b> as needed.
 
59
    </description>
 
60
    <class package="org.openide.compiler" name="DoWhatIWantCompiler"/>
 
61
    <issue number="14309"/>
 
62
</change>
 
63
-->
 
64
 
 
65
<apichanges>
 
66
 
 
67
<!-- First, a list of API names you may use: -->
 
68
<apidefs>
 
69
        <apidef name="DebuggerCoreAPI">Debugger Core API</apidef>
 
70
</apidefs>
 
71
 
 
72
<!-- ACTUAL CHANGES BEGIN HERE: -->
 
73
 
 
74
<changes>
 
75
    <change id="debugger-dual-actions">
 
76
        <api name="DebuggerCoreAPI"/>
 
77
        <summary>Support for "dual" actions added.</summary>
 
78
        <date day="29" month="4" year="2004"/>
 
79
        <author login="jjancura"/>
 
80
        <compatibility binary="incompatible" source="incompatible" addition="yes" deletion="yes" modification="yes"/>
 
81
        <description>
 
82
            According to Debugger UI Specification there are some actions that have two different 
 
83
            meanings. for example Step Into action. When some Java Debugger session is running it steps
 
84
            into the current method. But if there is no session running it should start a new session
 
85
            for Main Project and stop in its main method. Thats why we have to update support for debugger 
 
86
            actions. Changes made:
 
87
            <ul>
 
88
                <li>
 
89
                    Support methods for managing and sharing actions has been moved from DebuggerEngine
 
90
                    to new class ActionsManager.
 
91
                </li>
 
92
                <li>
 
93
                    Debugger Action Constants has been move from DebuggerEngine to ActionsManager.
 
94
                </li>
 
95
                <li>
 
96
                    New common ancestor of DebuggerManager, Session and Debugger Engine has been 
 
97
                    introduced - LookupProvider. From now you can register the same action in differen
 
98
                    context levels.
 
99
                </li>
 
100
                <li>
 
101
                    DebuggerManager.getActionsManager () method has been added. You can register 
 
102
                    ActionProviders for default root context (managed by DebuggerManager). These actions
 
103
                    can be in enabled state even if there is no current DebuggerEngine!
 
104
                </li>
 
105
                <li>
 
106
                    DebuggerEngine parameter of method ActionsProvider.doAction (...) has been removed.
 
107
                </li>
 
108
            </ul>
 
109
        </description>
 
110
    </change>
 
111
    <change id="DebuggerEngine-synch-start">
 
112
        <api name="DebuggerCoreAPI"/>
 
113
        <summary>Support for synchronouous start of DebuggerEngines added.</summary>
 
114
        <date day="3" month="5" year="2004"/>
 
115
        <author login="jjancura"/>
 
116
        <compatibility binary="incompatible" source="compatible" modification="yes"/>
 
117
        <description>
 
118
            <p>
 
119
                <code>void DebuggerManager.startDebugging (DebuggerInfo)</code> has been changed to <code>DebuggerEngine[] 
 
120
                DebuggerManager.startDebugging (DebuggerInfo)</code>. So it returns array of all DebuggerEngines
 
121
                created for given DebuggerInfo.
 
122
            </p>
 
123
        </description>
 
124
    </change>
 
125
    <change id="ToggleBreakpointAction-etc.">
 
126
        <api name="DebuggerCoreAPI"/>
 
127
        <summary>Support for ToggleBreakpointAction added, and some bugfix of Debugger Actions support API.</summary>
 
128
        <date day="9" month="5" year="2004"/>
 
129
        <author login="jjancura"/>
 
130
        <compatibility binary="incompatible" source="incompatible" modification="yes"/>
 
131
        <description>
 
132
            <p>
 
133
                <code>ActionsManager.doAction (...)</code>, 
 
134
                <code>ActionsProvider.doAction (...)</code> and 
 
135
                <code>ActionsManagerListener.actionPefrormed (...)</code> methods
 
136
                will not return boolean any longer. This parameter was unusefull and it was not posible to 
 
137
                implement it in some meaningful way.
 
138
            </p>
 
139
        </description>
 
140
    </change>
 
141
    <change id="Breakpoint.group.name">
 
142
        <api name="DebuggerCoreAPI"/>
 
143
        <summary>Support for Breakpoints Group added.</summary>
 
144
        <date day="13" month="5" year="2004"/>
 
145
        <author login="jjancura"/>
 
146
        <compatibility binary="compatible" source="compatible" addition="yes"/>
 
147
        <description>
 
148
            <p>
 
149
                Breakpoint.getGroupName (), Breakpoint.setGroupName () methods were added.
 
150
                Breakpoint.PROP_GROUP_NAME has been added.
 
151
            </p>
 
152
        </description>
 
153
    </change>
 
154
    <change id="ActionsProviderSupport.isEnabled-nonfinal">
 
155
        <api name="DebuggerCoreAPI"/>
 
156
        <summary>final modifier removed from ActionsProviderSupport.isEnabled.</summary>
 
157
        <version major="1" minor="3"/>
 
158
        <date day="23" month="11" year="2004"/>
 
159
        <author login="jjancura"/>
 
160
        <compatibility binary="compatible" source="compatible" modification="yes"/>
 
161
        <description>
 
162
            <p>
 
163
                Having final modifier for this method can be too obstructive in some cases. I had a problem writing tests.
 
164
            </p>
 
165
        </description>
 
166
    </change>
 
167
    <change id="ActionsManager-ActionsProvider.postAction">
 
168
        <api name="DebuggerCoreAPI"/>
 
169
        <summary>Debugger actions can be posted asynchronously.</summary>
 
170
        <version major="1" minor="5"/>
 
171
        <date day="24" month="8" year="2005"/>
 
172
        <author login="mentlicher"/>
 
173
        <compatibility binary="compatible" source="compatible" addition="yes"/>
 
174
        <description>
 
175
            <p>
 
176
                Added methods:
 
177
                <code>ActionsManager.postAction(Object)</code>, 
 
178
                <code>ActionsProvider.postAction(Object, Runnable)</code>,
 
179
                These can be used to call and implement asynchronous actions.
 
180
            </p>
 
181
        </description>
 
182
    </change>
 
183
    <change id="ActionsManager.ACTION_STEP_OPERATION">
 
184
        <api name="DebuggerCoreAPI"/>
 
185
        <summary>Support for stepping over operations.</summary>
 
186
        <version major="1" minor="9"/>
 
187
        <date day="1" month="2" year="2007"/>
 
188
        <author login="mentlicher"/>
 
189
        <compatibility binary="compatible" source="compatible" addition="yes"/>
 
190
        <description>
 
191
            <p>
 
192
                Added fields:
 
193
                <code>ActionsManager.ACTION_STEP_OPERATION</code>, 
 
194
                This constant is used in action performer which implements an operation step.
 
195
            </p>
 
196
        </description>
 
197
    </change>
 
198
    <change id="Breakpoint.validity">
 
199
        <api name="DebuggerCoreAPI"/>
 
200
        <summary>Support for breakpoint validity.</summary>
 
201
        <version major="1" minor="10"/>
 
202
        <date day="21" month="2" year="2007"/>
 
203
        <author login="mentlicher"/>
 
204
        <compatibility binary="compatible" source="compatible" addition="yes"/>
 
205
        <description>
 
206
            <p>
 
207
                Added fields:
 
208
                <code>Breakpoint.PROP_VALIDITY</code> - 
 
209
                This constant is used in property change events as a notification about change in validity.<br/>
 
210
                <code>Breakpoint.VALIDITY</code> - enumeration of constants for breakpoint validity.
 
211
            </p>
 
212
            <p>
 
213
                Added methods:
 
214
                <code>Breakpoint.getValidity()</code>,
 
215
                <code>Breakpoint.getValidityMessage()</code>,
 
216
                <code>Breakpoint.setValidity()</code> - validity management.
 
217
            </p>
 
218
        </description>
 
219
    </change>
 
220
    <change id="Breakpoint.hitCounts">
 
221
        <api name="DebuggerCoreAPI"/>
 
222
        <summary>Add filter for hit counts to breakpoints.</summary>
 
223
        <version major="1" minor="11"/>
 
224
        <date day="21" month="5" year="2007"/>
 
225
        <author login="mentlicher"/>
 
226
        <compatibility binary="compatible" source="compatible" addition="yes"/>
 
227
        <description>
 
228
             <p>
 
229
             To be able to set breakpoint for number of iterations, we need to add a filter for hit counts into Breakpoint API.
 
230
             </p>
 
231
             <p>
 
232
                 Added methods:<br/>
 
233
                 <code>Breakpoint.getHitCountFilter()</code>,
 
234
                 <code>Breakpoint.getHitCountFilteringStyle()</code>,
 
235
                 <code>Breakpoint.setHitCountFilter()</code>.
 
236
             </p>
 
237
             <p>
 
238
                 Added fields:<br/>
 
239
                 <code>Breakpoint.PROP_HIT_COUNT_FILTER</code>,
 
240
                 <code>Breakpoint.HIT_COUNT_FILTERING_STYLE</code>.
 
241
             </p>
 
242
        </description>
 
243
    </change>
 
244
 
 
245
</changes>
 
246
 
 
247
  <!-- Now the surrounding HTML text and document structure: -->
 
248
 
 
249
  <htmlcontents>
 
250
<!--
 
251
 
 
252
                            NO NO NO NO NO!
 
253
 
 
254
         ==============>    DO NOT EDIT ME!  <======================
 
255
 
 
256
          AUTOMATICALLY GENERATED FROM APICHANGES.XML, DO NOT EDIT
 
257
 
 
258
                SEE xml/api/doc/changes/apichanges.xml
 
259
 
 
260
-->
 
261
    <head>
 
262
      <title>Debugger Core API changes by date</title>
 
263
      <link rel="stylesheet" href="prose.css" type="text/css"/>
 
264
    </head>
 
265
    <body>
 
266
 
 
267
<p class="overviewlink"><a href="overview-summary.html">Overview</a></p>
 
268
 
 
269
<h1>Introduction</h1>
 
270
 
 
271
<p>This document lists changes made to the Debugger Core APIs. Please ask on the 
 
272
    <code>nbdev@netbeans.org</code>
 
273
    mailing list if you have any questions about the details of a
 
274
    change, or are wondering how to convert existing code to be compatible.
 
275
</p>
 
276
 
 
277
      <hr/><standard-changelists module-code-name="org.netbeans.api.debugger/1"/>
 
278
 
 
279
      <hr/><p>@FOOTER@</p>
 
280
 
 
281
    </body>
 
282
  </htmlcontents>
 
283
</apichanges>