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 67585 - improve platform manager help
Summary: improve platform manager help
Status: VERIFIED FIXED
Alias: None
Product: usersguide
Classification: Unclassified
Component: API Support (show other bugs)
Version: 5.x
Hardware: All All
: P3 blocker (vote)
Assignee: Geertjan Wielenga
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-10-26 13:46 UTC by pzajac
Modified: 2006-01-13 08:54 UTC (History)
0 users

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description pzajac 2005-10-26 13:46:50 UTC
The Netbeans platform doesn't describes where should be downloaded sources and
javadoc. 

The netbeans sourcese and javadoc be downloaded from:
http://www.netbeans.org/downloads/index.html

The sources and javadoc should be registered in two forms:
- zip distribution
- unpacked root folder of distrubution

Javadoc for default platfrom should be downloaded from update center. It is
located in Developing Netbeans folder.
Comment 1 Geertjan Wielenga 2005-10-26 14:36:39 UTC
Thanks for this info! OK, so now I have Javadoc from the Update Center. It is
registered automatically in the Javadoc tab of the NetBeans Platform Manager.
But I'm not clear why I would want to register the Sources. For debugging? I'm
sorry, it's not very clear to me.
Comment 2 Martin Krauskopf 2005-10-26 14:53:26 UTC
> It is registered automatically in the Javadoc tab of the 
> NetBeans Platform Manager

Yes, it should be.

> to register the Sources. For debugging?

As well as to make "Go To Sources" work on NB classes (e.g. TopComponent). i.e.
it is similar to have sources for Java Platform. Also javadoc should work if you
have only sources and don't have javadoc added (I believe) for a NB platform.
Comment 3 pzajac 2005-10-26 15:37:37 UTC
>Also javadoc should work if you
> have only sources and don't have javadoc added (I believe) for a NB platform.

it works :-)
Comment 4 Geertjan Wielenga 2005-10-26 18:03:26 UTC
Which folder in the NetBeans Platform sources must I select?
Comment 5 Jesse Glick 2005-10-26 19:42:58 UTC
"Which folder in the NetBeans Platform sources must I select?" - the folder
containing a subfolder "nbbuild", i.e. the top of the CVS checkout. In the case
of a ZIP file, I believe Martin arranged it so that you can just add the ZIP as
downloaded from the web site, despite the fact that the real root is the
netbeans-src folder inside the ZIP file.
Comment 6 Geertjan Wielenga 2005-10-27 10:42:55 UTC
I must be doing something wrong. I downloaded the NetBeans Plaform 5.0 beta
Sources (netbeans-5_0-beta-src-platform_sources.zip) from here:

http://www.netbeans.info/downloads/download.php

Then, in the NetBeans Platform Manager, I went to the Sources tab of my default
platform, and selected 'nbbuild', but i couldn't 'Go to Sources' and there was
no Javadoc. I also tried the nbbuild's parent directory (netbeans-src), which
didn't work either... 
Comment 7 Geertjan Wielenga 2005-10-27 10:47:36 UTC
Ah... stupid me. Should have downloaded the IDE sources, not the Platform sources...
Comment 8 Tomas Danek 2005-10-27 10:52:30 UTC
Martin yestedray commited fix of issue 62773, that enables you to use the
downloaded zip with sources. So in today's build you should be able to add to
sources only the zip file (no need if extracting and adding dirs.) Go to source
works for me fine. 
Comment 9 Geertjan Wielenga 2005-10-27 11:06:27 UTC
Yes, it works perfectly. I've just installed the latest continuous build. Then
attached ZIP file to Sources tab. Go to Soucres works. Javadoc works. Perfect. 

But, when I unzipped, it didn't work: I removed the ZIP file from the NetBeans
Platform Manager, added the 'nbbuild' folder of the unzipped file, but then Go
to Sources and Javadoc didn't work. I also tries adding parent of nbbuild, but
that didn't work either...
Comment 10 Tomas Danek 2005-10-27 11:42:03 UTC
you have to add parent (i.e.netbeans-src), not nbbuild. Works for me even with
added unziped dir. Did you set your module dependency on module in which you try
search some class??  Try to follow
http://qa.netbeans.org/apisupport/promo-f/NBPlatform-testspec.html
it should work.
Comment 11 Geertjan Wielenga 2005-10-27 12:00:41 UTC
Adding the folder doesn't let me go to sources or Javadoc. But adding the ZIP
does work. 
Comment 12 Tomas Danek 2005-10-27 12:34:28 UTC
Very strange.. file a speparate issue with exact steps to reproduce,assign it to
Martin (mkrauskopf)
Comment 13 Geertjan Wielenga 2005-11-23 10:24:22 UTC
Fixed the issue about the help topic in trunk.

Please verify that it is now complete!
Comment 14 pzajac 2006-01-13 08:54:30 UTC
verified