This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 30372 - Arch questions for modules
Summary: Arch questions for modules
Status: RESOLVED FIXED
Alias: None
Product: platform
Classification: Unclassified
Component: Module System (show other bugs)
Version: 3.x
Hardware: All All
: P2 blocker (vote)
Assignee: Jesse Glick
URL:
Keywords: ARCH
Depends on: 30529
Blocks: 30370
  Show dependency tree
 
Reported: 2003-01-27 15:58 UTC by Jaroslav Tulach
Modified: 2008-12-22 17:23 UTC (History)
0 users

See Also:
Issue Type: TASK
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Jaroslav Tulach 2003-01-27 15:58:10 UTC 
Describe modules architecture by answering
NetBeans Arch Questions as described at

http://openide.netbeans.org/tutorial/api.html
Comment 1 Jaroslav Tulach 2003-01-27 16:27:46 UTC 
If you go to openide/arch directory, there is a build.xml prepared for you. If
you invoke "ant <nameofyourapi>" a arch-openide-yourapi.xml file should be
generated and you can start answer the questions there. When you are ready, run
the ant script once more -> html page is generated (you have to change
questionsverion to the right value). After that check the .xml into CVS. You can
delete .html
Comment 2 Jesse Glick 2003-01-29 23:13:31 UTC 
Does not work for me. I run

cd openide/arch
ant modules

and it generates arch-openide-modules.xml without complaints. But the
questions are missing - they show up as a comment "[question: null]"
with no <question> tag in the XML file.

And the file in its DOCTYPE refers to a file api-questions.xml in the
same directory, which does not exist. Did you forget to commit it or
something?

And if the *.html files are useless, please add them to .cvsignore.

And when I try to run the target twice (w/o answering anything) I just
get:

build.xml:36: Answers were created for questions version "1.1" but
current version of questions is "$Revision: 1.4 $"
Comment 3 Jaroslav Tulach 2003-01-30 09:15:46 UTC 
api-questions.xml are in nbbuild/antsrc/.../Arch-api-questions.xml.
The Arch task uses special entity resolver to locate them. If you want
to validate, either change SYSTEM name or comment out
&api-questions.xml when writing the document.

questionversion first time generation improved.

Please report a bug with the rest. This configuration works:

Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_01-b01)
Java HotSpot(TM) Client VM (build 1.4.1_01-b01, mixed mode)
Ant version 1.4.1 compiled on October 23 2001
Comment 4 Jesse Glick 2003-01-30 17:41:19 UTC 
Re. api-questions.xml: "The Arch task uses special entity resolver to
locate them. If you want to validate, either change SYSTEM name or
comment out &api-questions.xml when writing the document." - I am
*not* trying to validate. I am just running "ant modules" and it does
not work. See #30529. Your entity resolver is apparently broken, or
something else is wrong.

Other problems appears to have been fixed, thanks.
Comment 5 Jesse Glick 2003-01-31 17:19:16 UTC 
OK, done.
Comment 6 Jaroslav Tulach 2003-02-13 13:26:03 UTC 
Hello Jesse I have read your answers version 1.4 and I would like you
to update some parts :

1. could you use <api> tag to describe which API you export (openide
part and core part) and what is the stability? Probably in answer to
deploy-packages

2. could you please describe (or better point to specification) from
where you read the module files (for example the modules/ directory)
and stability of this contract?

3. exec-reflection: I guess you should mention issue 29356 as a case
when module system uses reflection

Beyond that I am not aware of anything unsaid.
Comment 7 Jesse Glick 2003-02-20 16:48:04 UTC 
Fixed all three points, I hope.