← Back to branch summary

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

« back to all changes in this revision

Viewing changes to core/arch/arch-core-registry.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:
core/arch/arch-core-registry.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-2006 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
<!DOCTYPE api-answers PUBLIC "-//NetBeans//DTD Arch Answers//EN" "../../nbbuild/antsrc/org/netbeans/nbbuild/Arch.dtd" [
 
44
  <!ENTITY api-questions SYSTEM "../../nbbuild/antsrc/org/netbeans/nbbuild/Arch-api-questions.xml">
 
45
]>
 
46
 
 
47
<api-answers
 
48
  question-version="1.14"
 
49
  author="dkonecny@netbeans.org"
 
50
>
 
51
 
 
52
  &api-questions;
 
53
 
 
54
 
 
55
<!--
 
56
        <question id="arch-what">
 
57
            What is this project good for?
 
58
            <hint>
 
59
            Please provide here a few lines describing the project,
 
60
            what problem it should solve, provide links to documentation, 
 
61
            specifications, etc.
 
62
            </hint>
 
63
        </question>
 
64
-->
 
65
<answer id="arch-what">
 
66
        The Registry over FileSystem is a library implementing registry contexts over
 
67
        the filesystem. The library has very limited API and allows just create
 
68
        context for the FileObject. It is not expected that regular modules should 
 
69
        need to use this API.
 
70
        <api name="RegistryOverFSAPI" group="java" type="export" category="devel" url="@org-openide-filesystems@/index.html"/>
 
71
</answer>
 
72
 
 
73
 
 
74
 
 
75
<!--
 
76
        <question id="compat-i18n">
 
77
            Is your module correctly internationalized?
 
78
            <hint>
 
79
            Correct internationalization means that it obeys instuctions 
 
80
            at <a href="http://www.netbeans.org/download/dev/javadoc/org-openide-modules/org/openide/modules/doc-files/i18n-branding.html">
 
81
            NetBeans I18N pages</a>.
 
82
            </hint>
 
83
        </question>
 
84
-->
 
85
<answer id="compat-i18n">
 
86
No answer
 
87
</answer>
 
88
 
 
89
 
 
90
 
 
91
<!--
 
92
        <question id="compat-standards">
 
93
            Does the module implement or define any standards? Is the 
 
94
            implementation exact or does it deviate somehow?
 
95
        </question>
 
96
-->
 
97
<answer id="compat-standards">
 
98
No answer
 
99
</answer>
 
100
 
 
101
 
 
102
 
 
103
<!--
 
104
        <question id="compat-version">
 
105
            Can your module coexist with earlier and future
 
106
            versions of itself? Can you correctly read all old settings? Will future
 
107
            versions be able to read your current settings? Can you read
 
108
            or politely ignore settings stored by a future version?
 
109
            
 
110
            <hint>
 
111
            Very helpful for reading settings is to store version number
 
112
            there, so future versions can decide whether how to read/convert
 
113
            the settings and older versions can ignore the new ones.
 
114
            </hint>
 
115
        </question>
 
116
-->
 
117
<answer id="compat-version">
 
118
No answer
 
119
</answer>
 
120
 
 
121
 
 
122
 
 
123
<!--
 
124
        <question id="dep-jre">
 
125
            Which version of JRE do you need (1.2, 1.3, 1.4, etc.)?
 
126
            <hint>
 
127
            It is expected that if your module runs on 1.x that it will run 
 
128
            on 1.x+1 if no, state that please. Also describe here cases where
 
129
            you run different code on different versions of JRE and why.
 
130
            </hint>
 
131
        </question>
 
132
-->
 
133
<answer id="dep-jre">
 
134
No answer
 
135
</answer>
 
136
 
 
137
 
 
138
 
 
139
<!--
 
140
        <question id="dep-jrejdk">
 
141
            Do you require the JDK or is the JRE enough?
 
142
        </question>
 
143
-->
 
144
<answer id="dep-jrejdk">
 
145
No answer
 
146
</answer>
 
147
 
 
148
 
 
149
 
 
150
<!--
 
151
        <question id="dep-nb">
 
152
            What other NetBeans projects does this one depend on?
 
153
            <hint>
 
154
            If you want, describe such projects as imported API using
 
155
            the <code>&lt;api name=&quot;identification&quot; type=&quot;import or export&quot; category=&quot;stable&quot; url=&quot;where is the description&quot; /></code>
 
156
            </hint>
 
157
        </question>        
 
158
-->
 
159
<answer id="dep-nb">
 
160
    <defaultanswer generate='none' />
 
161
<ul>
 
162
<li><api type='import' group='java' category='private' name='org.openide.filesystems' url='@org-openide-filesystems@/overview-summary.html' >
 
163
            The module is needed for compilation. 
 
164
        
 
165
            The module is used during runtime. 
 
166
            
 
167
                Specification version 
 
168
                6.2
 
169
                is required.
 
170
            </api>
 
171
</li>            
 
172
<li><api type='import' group='java' category='private' name='org.openide.util' url='@org-openide-util@/overview-summary.html' >
 
173
            The module is needed for compilation. 
 
174
        
 
175
            The module is used during runtime. 
 
176
            
 
177
                Specification version 
 
178
                6.2
 
179
                is required.
 
180
            </api>
 
181
</li>            
 
182
<li><api type='import' group='java' category='private' name='org.openide.util.enumerations' url='@org-openide-util-enumerations@/overview-summary.html' >
 
183
            The module is needed for compilation. 
 
184
        
 
185
            The module is used during runtime. 
 
186
            
 
187
                Specification version 
 
188
                6.2
 
189
                is required.
 
190
            </api>
 
191
</li>            
 
192
<li><api type='import' group='java' category='private' name='org.openide.modules' url='@org-openide-modules@/overview-summary.html' >
 
193
            The module is needed for compilation. 
 
194
        
 
195
            The module is used during runtime. 
 
196
            
 
197
                Specification version 
 
198
                6.2
 
199
                is required.
 
200
            </api>
 
201
</li>            
 
202
<li><api type='import' group='java' category='private' name='org.openide.nodes' url='@org-openide-nodes@/overview-summary.html' >
 
203
            The module is needed for compilation. 
 
204
        
 
205
            The module is used during runtime. 
 
206
            
 
207
                Specification version 
 
208
                6.2
 
209
                is required.
 
210
            </api>
 
211
</li>            
 
212
<li><api type='import' group='java' category='private' name='org.openide.explorer' url='@org-openide-explorer@/overview-summary.html' >
 
213
            The module is needed for compilation. 
 
214
        
 
215
            The module is used during runtime. 
 
216
            
 
217
                Specification version 
 
218
                6.2
 
219
                is required.
 
220
            </api>
 
221
</li>            
 
222
<li><api type='import' group='java' category='private' name='org.openide.awt' url='@org-openide-awt@/overview-summary.html' >
 
223
            The module is needed for compilation. 
 
224
        
 
225
            The module is used during runtime. 
 
226
            
 
227
                Specification version 
 
228
                6.2
 
229
                is required.
 
230
            </api>
 
231
</li>            
 
232
<li><api type='import' group='java' category='private' name='org.openide.dialogs' url='@org-openide-dialogs@/overview-summary.html' >
 
233
            The module is needed for compilation. 
 
234
        
 
235
            The module is used during runtime. 
 
236
            
 
237
                Specification version 
 
238
                6.2
 
239
                is required.
 
240
            </api>
 
241
</li>            
 
242
<li><api type='import' group='java' category='private' name='org.openide.options' url='@org-openide-options@/overview-summary.html' >
 
243
            The module is needed for compilation. 
 
244
        
 
245
            The module is used during runtime. 
 
246
            
 
247
                Specification version 
 
248
                6.2
 
249
                is required.
 
250
            </api>
 
251
</li>            
 
252
<li><api type='import' group='java' category='private' name='org.openide.windows' url='@org-openide-windows@/overview-summary.html' >
 
253
            The module is needed for compilation. 
 
254
        
 
255
            The module is used during runtime. 
 
256
            
 
257
                Specification version 
 
258
                6.2
 
259
                is required.
 
260
            </api>
 
261
</li>            
 
262
<li><api type='import' group='java' category='private' name='org.openide.text' url='@org-openide-text@/overview-summary.html' >
 
263
            The module is needed for compilation. 
 
264
        
 
265
            The module is used during runtime. 
 
266
            
 
267
                Specification version 
 
268
                6.2
 
269
                is required.
 
270
            </api>
 
271
</li>            
 
272
<li><api type='import' group='java' category='private' name='org.openide.actions' url='@org-openide-actions@/overview-summary.html' >
 
273
            The module is needed for compilation. 
 
274
        
 
275
            The module is used during runtime. 
 
276
            
 
277
                Specification version 
 
278
                6.2
 
279
                is required.
 
280
            </api>
 
281
</li>            
 
282
<li><api type='import' group='java' category='private' name='org.openide.loaders' url='@org-openide-loaders@/overview-summary.html' >
 
283
            The module is needed for compilation. 
 
284
        
 
285
            The module is used during runtime. 
 
286
            </api>
 
287
</li>            
 
288
<li><api type='import' group='java' category='private' name='org.netbeans.modules.convertor' url='@org-netbeans-modules-convertor@/overview-summary.html' >
 
289
            The module is needed for compilation. 
 
290
        
 
291
            The module is used during runtime. 
 
292
            
 
293
                Specification version 
 
294
                1.2
 
295
                is required.
 
296
            </api>
 
297
</li>            
 
298
<li><api type='import' group='java' category='private' name='org.netbeans.modules.registry' url='@org-netbeans-modules-registry@/overview-summary.html' >
 
299
            The module is needed for compilation. 
 
300
        
 
301
            The module is used during runtime. 
 
302
            
 
303
                Specification version 
 
304
                1.7
 
305
                is required.
 
306
            </api>
 
307
</li>            
 
308
<li><api type='import' group='java' category='private' name='org.netbeans.core.startup'  >
 
309
            The module is needed for compilation. 
 
310
            The module is used during runtime to access details about layers.
 
311
    </api>
 
312
</li>            
 
313
<li><api type='import' group='java' category='private' name='org.netbeans.libs.xerces'  >
 
314
            The library module is used during runtime. 
 
315
            
 
316
                Specification version 
 
317
                1.2
 
318
                is required.
 
319
            </api>
 
320
</li>            
 
321
</ul>
 
322
</answer>
 
323
 
 
324
 
 
325
 
 
326
<!--
 
327
        <question id="dep-non-nb">
 
328
            What other projects outside NetBeans does this one depend on?
 
329
            
 
330
            <hint>
 
331
            Some non-NetBeans projects are packaged as NetBeans modules
 
332
            (see <a href="http://libs.netbeans.org/">libraries</a>) and
 
333
            it is prefered to use this approach when more modules may
 
334
            depend on such third-party library.
 
335
            </hint>
 
336
        </question>
 
337
-->
 
338
<answer id="dep-non-nb">
 
339
No answer
 
340
</answer>
 
341
 
 
342
 
 
343
 
 
344
<!--
 
345
        <question id="dep-platform">
 
346
            On which platforms does your module run? Does it run in the same
 
347
            way on each?
 
348
            <hint>
 
349
            If your module is using JNI or deals with special differences of
 
350
            OSes like filesystems, etc. please describe here what they are.
 
351
            </hint>
 
352
        </question>
 
353
-->
 
354
<answer id="dep-platform">
 
355
No answer
 
356
</answer>
 
357
 
 
358
 
 
359
 
 
360
<!--
 
361
        <question id="deploy-jar">
 
362
            Do you deploy just module JAR file(s) or other files as well?
 
363
            <hint>
 
364
            If your module consists of just one module JAR file, just confirm that.
 
365
            If it uses more than one JAR, describe where they are located, how
 
366
            they refer to each other. 
 
367
            If it consist of module JAR(s) and other files, please describe
 
368
            what is their purpose, why other files are necessary. Please 
 
369
            make sure that installation/deinstallation leaves the system 
 
370
            in state as it was before installation.
 
371
            </hint>
 
372
        </question>
 
373
-->
 
374
<answer id="deploy-jar">
 
375
No answer
 
376
</answer>
 
377
 
 
378
 
 
379
 
 
380
<!--
 
381
        <question id="deploy-nbm">
 
382
            Can you deploy an NBM via the Update Center?
 
383
            <hint>
 
384
            If not why?
 
385
            </hint>
 
386
        </question>
 
387
-->
 
388
<answer id="deploy-nbm">
 
389
No answer
 
390
</answer>
 
391
 
 
392
 
 
393
 
 
394
<!--
 
395
        <question id="deploy-packages">
 
396
            Are packages of your module made inaccessible by not declaring them
 
397
            public?
 
398
            
 
399
            <hint>
 
400
            NetBeans module system allows restriction of access rights to
 
401
            public classes of your module from other modules. This prevents
 
402
            unwanted dependencies of others on your code and should be used
 
403
            whenever possible (<a href="http://www.netbeans.org/download/apis/org/openide/doc-files/upgrade.html#3.4-public-packages">
 
404
            public packages
 
405
            </a>). 
 
406
            </hint>
 
407
        </question>
 
408
-->
 
409
<answer id="deploy-packages">
 
410
No answer
 
411
</answer>
 
412
 
 
413
 
 
414
 
 
415
<!--
 
416
        <question id="deploy-shared">
 
417
            Do you need to be installed in the shared location only, or in the user directory only,
 
418
            or can your module be installed anywhere?
 
419
            <hint>
 
420
            Installation location shall not matter, if it does explain why.
 
421
            Consider also whether <code>InstalledFileLocator</code> can help.
 
422
            </hint>
 
423
        </question>
 
424
-->
 
425
<answer id="deploy-shared">
 
426
No answer
 
427
</answer>
 
428
 
 
429
 
 
430
 
 
431
<!--
 
432
        <question id="exec-classloader">
 
433
            Does your code create its own class loader(s)?
 
434
            <hint>
 
435
            A bit unusual. Please explain why and what for.
 
436
            </hint>
 
437
        </question>
 
438
-->
 
439
<answer id="exec-classloader">
 
440
No answer
 
441
</answer>
 
442
 
 
443
 
 
444
 
 
445
<!--
 
446
        <question id="exec-component">
 
447
            Is execution of your code influenced by any (string) property
 
448
            of any of your components?
 
449
            
 
450
            <hint>
 
451
            Often <code>JComponent.getClientProperty</code>, <code>Action.getValue</code>
 
452
            or <code>PropertyDescriptor.getValue</code>, etc. are used to influence
 
453
            a behaviour of some code. This of course forms an interface that should
 
454
            be documented. Also if one depends on some interface that an object
 
455
            implements (<code>component instanceof Runnable</code>) that forms an
 
456
            API as well.
 
457
            </hint>
 
458
        </question>
 
459
-->
 
460
<answer id="exec-component">
 
461
No answer
 
462
</answer>
 
463
 
 
464
 
 
465
 
 
466
<!--
 
467
        <question id="exec-introspection">
 
468
            Does your module use any kind of runtime type information (<code>instanceof</code>,
 
469
            work with <code>java.lang.Class</code>, etc.)?
 
470
            <hint>
 
471
            Check for cases when you have an object of type A and you also
 
472
            expect it to (possibly) be of type B and do some special action. That
 
473
            should be documented. The same applies on operations in meta-level
 
474
            (Class.isInstance(...), Class.isAssignableFrom(...), etc.).
 
475
            </hint>
 
476
        </question>
 
477
-->
 
478
<answer id="exec-introspection">
 
479
No answer
 
480
</answer>
 
481
 
 
482
 
 
483
 
 
484
<!--
 
485
        <question id="exec-privateaccess">
 
486
            Are you aware of any other parts of the system calling some of 
 
487
            your methods by reflection?
 
488
            <hint>
 
489
            If so, describe the &quot;contract&quot; as an API. Likely private or friend one, but
 
490
            still API and consider rewrite of it.
 
491
            </hint>
 
492
        </question>
 
493
-->
 
494
<answer id="exec-privateaccess">
 
495
No answer
 
496
</answer>
 
497
 
 
498
 
 
499
 
 
500
<!--
 
501
        <question id="exec-process">
 
502
            Do you execute an external process from your module? How do you ensure
 
503
            that the result is the same on different platforms? Do you parse output?
 
504
            Do you depend on result code?
 
505
            <hint>
 
506
            If you feed an input, parse the output please declare that as an API.
 
507
            </hint>
 
508
        </question>
 
509
-->
 
510
<answer id="exec-process">
 
511
No answer
 
512
</answer>
 
513
 
 
514
 
 
515
 
 
516
<!--
 
517
        <question id="exec-property">
 
518
            Is execution of your code influenced by any environment or
 
519
            Java system (<code>System.getProperty</code>) property?
 
520
            
 
521
            <hint>
 
522
            If there is a property that can change the behaviour of your 
 
523
            code, somebody will likely use it. You should describe what it does 
 
524
            and the stability category of this API. You may use
 
525
            <pre>
 
526
                &lt;property name=&quot;id&quot; category=&quot;private&quot; >
 
527
                    description of the property, where it is used, what it influence, etc.
 
528
                &lt;/property>            
 
529
            </pre>
 
530
            </hint>
 
531
        </question>
 
532
-->
 
533
<answer id="exec-property">
 
534
No answer
 
535
</answer>
 
536
 
 
537
 
 
538
 
 
539
<!--
 
540
        <question id="exec-reflection">
 
541
            Does your code use Java Reflection to execute other code?
 
542
            <hint>
 
543
            This usually indicates a missing or unsufficient API in the other
 
544
            part of the system. If the other side is not aware of your dependency
 
545
            this contract can be easily broken.
 
546
            </hint>
 
547
        </question>
 
548
-->
 
549
<answer id="exec-reflection">
 
550
No answer
 
551
</answer>
 
552
 
 
553
 
 
554
 
 
555
<!--
 
556
        <question id="format-clipboard">
 
557
            Which data flavors (if any) does your code read from or insert to
 
558
            the clipboard (by access to clipboard on means calling methods on <code>java.awt.datatransfer.Transferable</code>?
 
559
            
 
560
            <hint>
 
561
            Often Node's deal with clipboard by usage of <code>Node.clipboardCopy, Node.clipboardCut and Node.pasteTypes</code>.
 
562
            Check your code for overriding these methods.
 
563
            </hint>
 
564
        </question>
 
565
-->
 
566
<answer id="format-clipboard">
 
567
No answer
 
568
</answer>
 
569
 
 
570
 
 
571
 
 
572
<!--
 
573
        <question id="format-dnd">
 
574
            Which protocols (if any) does your code understand during Drag &amp; Drop?
 
575
            <hint>
 
576
            Often Node's deal with clipboard by usage of <code>Node.drag, Node.getDropType</code>. 
 
577
            Check your code for overriding these methods. Btw. if they are not overriden, they
 
578
            by default delegate to <code>Node.clipboardCopy, Node.clipboardCut and Node.pasteTypes</code>.
 
579
            </hint>
 
580
        </question>
 
581
-->
 
582
<answer id="format-dnd">
 
583
No answer
 
584
</answer>
 
585
 
 
586
 
 
587
 
 
588
<!--
 
589
        <question id="format-types">
 
590
            Which protocols and file formats (if any) does your module read or write on disk,
 
591
            or transmit or receive over the network?
 
592
        </question>
 
593
-->
 
594
<answer id="format-types">
 
595
No answer
 
596
</answer>
 
597
 
 
598
 
 
599
 
 
600
<!--
 
601
        <question id="lookup-lookup">
 
602
            Does your module use <code>org.openide.util.Lookup</code>
 
603
            to find any components to communicate with? Which ones?
 
604
            
 
605
            <hint>
 
606
            Please describe the interfaces you are searching for, where 
 
607
            are defined, whether you are searching for just one or more of them,
 
608
            if the order is important, etc. Also clasify the stability of such
 
609
            API contract.
 
610
            </hint>
 
611
        </question>
 
612
-->
 
613
<answer id="lookup-lookup">
 
614
No answer
 
615
</answer>
 
616
 
 
617
 
 
618
 
 
619
<!--
 
620
        <question id="lookup-register">
 
621
            Do you register anything into lookup for other code to find?
 
622
            <hint>
 
623
            Do you register using layer file or using <code>META-INF/services</code>?
 
624
            Who is supposed to find your component?
 
625
            </hint>
 
626
        </question>
 
627
-->
 
628
<answer id="lookup-register">
 
629
No answer
 
630
</answer>
 
631
 
 
632
 
 
633
 
 
634
<!--
 
635
        <question id="lookup-remove">
 
636
            Do you remove entries of other modules from lookup?
 
637
            <hint>
 
638
            Why? Of course, that is possible, but it can be dangerous. Is the module
 
639
            your are masking resource from aware of what you are doing?
 
640
            </hint>
 
641
        </question>
 
642
-->
 
643
<answer id="lookup-remove">
 
644
No answer
 
645
</answer>
 
646
 
 
647
 
 
648
 
 
649
<!--
 
650
        <question id="perf-exit">
 
651
            Does your module run any code on exit?
 
652
        </question>
 
653
-->
 
654
<answer id="perf-exit">
 
655
No answer
 
656
</answer>
 
657
 
 
658
 
 
659
 
 
660
<!--
 
661
        <question id="perf-huge_dialogs">
 
662
            Does your module contain any dialogs or wizards with a large number of
 
663
            GUI controls such as combo boxes, lists, trees, or text areas?
 
664
        </question>
 
665
-->
 
666
<answer id="perf-huge_dialogs">
 
667
No answer
 
668
</answer>
 
669
 
 
670
 
 
671
 
 
672
<!--
 
673
        <question id="perf-limit">
 
674
            Are there any hardcoded or practical limits in the number or size of
 
675
            elements your code can handle?
 
676
        </question>
 
677
-->
 
678
<answer id="perf-limit">
 
679
No answer
 
680
</answer>
 
681
 
 
682
 
 
683
 
 
684
<!--
 
685
        <question id="perf-mem">
 
686
            How much memory does your component consume? Estimate
 
687
            with a relation to the number of windows, etc.
 
688
        </question>
 
689
-->
 
690
<answer id="perf-mem">
 
691
No answer
 
692
</answer>
 
693
 
 
694
 
 
695
 
 
696
<!--
 
697
        <question id="perf-menus">
 
698
            Does your module use dynamically updated context menus, or
 
699
            context-sensitive actions with complicated enablement logic?
 
700
        </question>
 
701
-->
 
702
<answer id="perf-menus">
 
703
No answer
 
704
</answer>
 
705
 
 
706
 
 
707
 
 
708
<!--
 
709
        <question id="perf-progress">
 
710
            Does your module execute any long-running tasks?
 
711
            <hint>Typically they are tasks like connecting over
 
712
            network, computing huge amount of data, compilation.
 
713
            Such communication should be done asynchronously (for example
 
714
            using <code>RequestProcessor</code>), definitively it should 
 
715
            not block AWT thread.
 
716
            </hint>
 
717
        </question>
 
718
-->
 
719
<answer id="perf-progress">
 
720
No answer
 
721
</answer>
 
722
 
 
723
 
 
724
 
 
725
<!--
 
726
        <question id="perf-scale">
 
727
            Which external criteria influence the performance of your
 
728
            program (size of file in editor, number of files in menu, 
 
729
            in source directory, etc.) and how well your code scales?
 
730
            Please include some estimates.
 
731
        </question>
 
732
-->
 
733
<answer id="perf-scale">
 
734
No answer
 
735
</answer>
 
736
 
 
737
 
 
738
 
 
739
<!--
 
740
        <question id="perf-startup">
 
741
            Does your module run any code on startup?
 
742
        </question>
 
743
-->
 
744
<answer id="perf-startup">
 
745
No answer
 
746
</answer>
 
747
 
 
748
 
 
749
 
 
750
<!--
 
751
        <question id="perf-wakeup">
 
752
            Does any piece of your code wake up periodically and do something
 
753
            even when the system is otherwise idle (no user interaction)?
 
754
        </question>
 
755
-->
 
756
<answer id="perf-wakeup">
 
757
No answer
 
758
</answer>
 
759
 
 
760
 
 
761
 
 
762
<!--
 
763
        <question id="resources-file">
 
764
            Does your module use <code>java.io.File</code> directly?
 
765
            
 
766
            <hint>
 
767
            NetBeans provide a logical wrapper over plain files called 
 
768
            <code>org.openide.filesystems.FileObject</code> that
 
769
            provides uniform access to such resources and is the prefered
 
770
            way that should be used. But of course there can be situations when
 
771
            this is not suitable.
 
772
            </hint>
 
773
        </question>
 
774
-->
 
775
<answer id="resources-file">
 
776
No answer
 
777
</answer>
 
778
 
 
779
 
 
780
 
 
781
<!--
 
782
        <question id="resources-layer">
 
783
            Does your module provide own layer? Does it create any files or
 
784
            folders in it? What it is trying to communicate by that and with which 
 
785
            components?
 
786
            
 
787
            <hint>
 
788
            NetBeans allows automatic and declarative installation of resources 
 
789
            by module layers. Module register files into appropriate places
 
790
            and other components use that information to perform their task
 
791
            (build menu, toolbar, window layout, list of templates, set of
 
792
            options, etc.). 
 
793
            </hint>
 
794
        </question>
 
795
-->
 
796
<answer id="resources-layer">
 
797
No answer
 
798
</answer>
 
799
 
 
800
 
 
801
 
 
802
<!--
 
803
        <question id="resources-mask">
 
804
            Does your module mask/hide/override any resources provided by other modules in
 
805
            their layers?
 
806
            
 
807
            <hint>
 
808
            If you mask a file provided by another module, you probably depend
 
809
            on that and do not want the other module to (for example) change
 
810
            the file's name. That module shall thus make that file available as an API
 
811
            of some stability category.
 
812
            </hint>
 
813
        </question>
 
814
-->
 
815
<answer id="resources-mask">
 
816
No answer
 
817
</answer>
 
818
 
 
819
 
 
820
 
 
821
<!--
 
822
        <question id="resources-read">
 
823
            Does your module read any resources from layers? For what purpose?
 
824
            
 
825
            <hint>
 
826
            As this is some kind of intermodule dependency, it is a kind of API.
 
827
            Please describe it and clasify according to 
 
828
            <a href="http://openide.netbeans.org/tutorial/api-design.html#categories">
 
829
            common stability categories</a>.
 
830
            </hint>
 
831
        </question>
 
832
-->
 
833
<answer id="resources-read">
 
834
No answer
 
835
</answer>
 
836
 
 
837
 
 
838
 
 
839
 
 
840
<!--
 
841
        <question id="arch-overall" when="init">
 
842
            Describe the overall architecture. 
 
843
            <hint>
 
844
            What will be API for 
 
845
            <a href="http://openide.netbeans.org/tutorial/api-design.html#design.apiandspi" shape="rect">
 
846
                clients and what support API</a>? 
 
847
            What parts will be pluggable?
 
848
            How will plug-ins be registered? Please use <code>&lt;api type="export"/&gt;</code>
 
849
            to describe your general APIs.
 
850
            If possible please provide 
 
851
            simple diagrams. 
 
852
            </hint>
 
853
        </question>
 
854
-->
 
855
 <answer id="arch-overall">
 
856
  <p>
 
857
   XXX no answer for arch-overall
 
858
  </p>
 
859
 </answer>
 
860
 
 
861
 
 
862
 
 
863
<!--
 
864
        <question id="arch-quality" when="init">
 
865
            How will the <a href="http://www.netbeans.org/community/guidelines/q-evangelism.html" shape="rect">quality</a>
 
866
            of your code be tested and 
 
867
            how are future regressions going to be prevented?
 
868
            <hint>
 
869
            What kind of testing do
 
870
            you want to use? How much functionality, in which areas,
 
871
            should be covered by the tests? 
 
872
            </hint>
 
873
        </question>
 
874
-->
 
875
 <answer id="arch-quality">
 
876
  <p>
 
877
   XXX no answer for arch-quality
 
878
  </p>
 
879
 </answer>
 
880
 
 
881
 
 
882
 
 
883
<!--
 
884
        <question id="arch-time" when="init">
 
885
            What are the time estimates of the work?
 
886
            <hint>
 
887
            Please express your estimates of how long the design, implementation,
 
888
            stabilization are likely to last. How many people will be needed to
 
889
            implement this and what is the expected milestone by which the work should be 
 
890
            ready?
 
891
            </hint>
 
892
        </question>
 
893
-->
 
894
 <answer id="arch-time">
 
895
  <p>
 
896
   XXX no answer for arch-time
 
897
  </p>
 
898
 </answer>
 
899
 
 
900
 
 
901
 
 
902
<!--
 
903
        <question id="arch-usecases" when="init">
 
904
            <hint>
 
905
                Content of this answer will be displayed as part of page at
 
906
                http://www.netbeans.org/download/dev/javadoc/usecases.html 
 
907
                You can use tags &lt;usecase name="name&gt; regular html description &lt;/usecase&gt;
 
908
                and if you want to use an URL you can prefix if with @TOP@ to begin
 
909
                at the root of your javadoc
 
910
            </hint>
 
911
        
 
912
            Describe the main <a href="http://openide.netbeans.org/tutorial/api-design.html#usecase" shape="rect">
 
913
            use cases</a> of the new API. Who will use it under
 
914
            what circumstances? What kind of code would typically need to be written
 
915
            to use the module?
 
916
        </question>
 
917
-->
 
918
 <answer id="arch-usecases">
 
919
  <p>
 
920
   XXX no answer for arch-usecases
 
921
  </p>
 
922
 </answer>
 
923
 
 
924
 
 
925
 
 
926
<!--
 
927
        <question id="arch-where" when="init">
 
928
            Where one can find sources for your module?
 
929
            <hint>
 
930
                Please provide link to the CVS web client at
 
931
                http://www.netbeans.org/download/source_browse.html
 
932
                or just use tag defaultanswer generate='here'
 
933
            </hint>
 
934
        </question>
 
935
-->
 
936
 <answer id="arch-where">
 
937
  <defaultanswer generate='here' />
 
938
 </answer>
 
939
 
 
940
 
 
941
 
 
942
 <answer id="deploy-dependencies">
 
943
  <p>
 
944
   Nothing.
 
945
  </p>
 
946
 </answer>
 
947
 
 
948
 
 
949
 
 
950
<!--
 
951
        <question id="exec-ant-tasks" when="impl">
 
952
            Do you define or register any ant tasks that other can use?
 
953
            
 
954
            <hint>
 
955
            If you provide an ant task that users can use, you need to be very
 
956
            careful about its syntax and behaviour, as it most likely forms an
 
957
                  API for end users and as there is a lot of end users, their reaction
 
958
            when such API gets broken can be pretty strong.
 
959
            </hint>
 
960
        </question>
 
961
-->
 
962
 <answer id="exec-ant-tasks">
 
963
  <p>
 
964
   XXX no answer for exec-ant-tasks
 
965
  </p>
 
966
 </answer>
 
967
 
 
968
 
 
969
 
 
970
<!--
 
971
        <question id="exec-threading" when="impl">
 
972
            What threading models, if any, does your module adhere to?
 
973
            <hint>
 
974
                If your module calls foreign APIs which have a specific threading model,
 
975
                indicate how you comply with the requirements for multithreaded access
 
976
                (synchronization, mutexes, etc.) applicable to those APIs.
 
977
                If your module defines any APIs, or has complex internal structures
 
978
                that might be used from multiple threads, declare how you protect
 
979
                data against concurrent access, race conditions, deadlocks, etc.,
 
980
                and whether such rules are enforced by runtime warnings, errors, assertions, etc.
 
981
                Examples: a class might be non-thread-safe (like Java Collections); might
 
982
                be fully thread-safe (internal locking); might require access through a mutex
 
983
                (and may or may not automatically acquire that mutex on behalf of a client method);
 
984
                might be able to run only in the event queue; etc.
 
985
                Also describe when any events are fired: synchronously, asynchronously, etc.
 
986
                Ideas: <a href="http://core.netbeans.org/proposals/threading/index.html#recommendations" shape="rect">Threading Recommendations</a> (in progress)
 
987
            </hint>
 
988
        </question>
 
989
-->
 
990
 <answer id="exec-threading">
 
991
  <p>
 
992
   XXX no answer for exec-threading
 
993
  </p>
 
994
 </answer>
 
995
 
 
996
 
 
997
 
 
998
<!--
 
999
        <question id="perf-spi" when="init">
 
1000
            How the performance of the plugged in code will be enforced?
 
1001
            <hint>
 
1002
            If you allow foreign code to be plugged into your own module, how
 
1003
            do you enforce that it will behave correctly and quickly and will not
 
1004
            negatively influence the performance of your own module?
 
1005
            </hint>
 
1006
        </question>
 
1007
-->
 
1008
 <answer id="perf-spi">
 
1009
  <p>
 
1010
   XXX no answer for perf-spi
 
1011
  </p>
 
1012
 </answer>
 
1013
 
 
1014
 
 
1015
 
 
1016
<!--
 
1017
        <question id="security-grant" when="final">
 
1018
            Does your code grant additional rights to some other code?
 
1019
            <hint>Avoid using a class loader that adds extra
 
1020
            permissions to loaded code unless really necessary.
 
1021
            Also note that your API implementation
 
1022
            can also expose unneeded permissions to enemy code by
 
1023
            calling AccessController.doPrivileged().</hint>
 
1024
        </question>
 
1025
-->
 
1026
 <answer id="security-grant">
 
1027
  <p>
 
1028
   XXX no answer for security-grant
 
1029
  </p>
 
1030
 </answer>
 
1031
 
 
1032
 
 
1033
 
 
1034
<!--
 
1035
        <question id="security-policy" when="final">
 
1036
            Does your functionality require modifications to the standard policy file?
 
1037
            <hint>Your code might pass control to third-party code not
 
1038
            coming from trusted domains. This could be code downloaded over the
 
1039
            network or code coming from libraries that are not bundled
 
1040
            with NetBeans. Which permissions need to be granted to which domains?</hint>
 
1041
        </question>
 
1042
-->
 
1043
 <answer id="security-policy">
 
1044
  <p>
 
1045
   XXX no answer for security-policy
 
1046
  </p>
 
1047
 </answer>
 
1048
 
 
1049
</api-answers>