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.
Summary: | Include java api doc into NB+JDK bundle | ||
---|---|---|---|
Product: | installer | Reporter: | jirka_x1 <jirka_x1> |
Component: | JDK bundle | Assignee: | Libor Fischmeistr <lfischmeistr> |
Status: | NEW --- | ||
Severity: | blocker | CC: | av-nb, johnjullion, joshis |
Priority: | P3 | ||
Version: | 6.x | ||
Hardware: | PC | ||
OS: | All | ||
Issue Type: | ENHANCEMENT | Exception Reporter: |
Description
jirka_x1
2008-11-26 00:01:24 UTC
Read discussion in issue 76186, please and also add your vote to that issue... *** This issue has been marked as a duplicate of 76186 *** I saw issue 76186 before filing this. It is a related issue, but I don't see how it can be marked as a duplicate. I was suggesting to add java api doc only to the NB+jdk bundle, something that can be done tomorrow. Issue 76186 discusses automatized download of javadoc. This is far more complicated to do. I would suggest reopening this issue. Reopened because it is not a duplicate. See reasons in the previous comment. OK, I reassigned Issue 76186 to the other team. From this moment we treat this issue as the enhancement request to add javadoc to NetBeans/JDK bundle. Sorry for the late reply - I didn't add myself on CC:(. Issue 76186 says:
> IDE usually runs on 2 major JDK releases eg. NB 5.0 runs on JDK 1.4.2 and JDK 1.5.0.
> **For NB+JDK bundle this is question for wider audience.** I cannot decide we will
> bundle additional 40MB to installer.
I wanted to keep just one issue for "cannot use API docs in NB", so that we do not have similar issues and discussion of
wider audience can be more in one place...
But OK, no problem, we can have 2 issues, one for automatic download+installation of JavaDoc, one for bundling JavaDoc
in JDK+NB bundle...
Just to note. The integration of the JDK docs into the NetBeans IDE is pretty simple. The only thing to do is to extract the zip archive with the java api docs to the JDK directory (it creates "docs" directory with a bunch of files there). NetBeans automatically picks up that dir as the javadoc folder for the Java SE platform. So far I see 2 concerns regarding adding java api docs to NetBeans/JDK bundle: 1) extra download size. It means extra 56MB for NB/JDK6 bundle (current size is ~130MB) and 44MB for NB/JDK5 (~105MB) 2) some legal aspects It is also worth mentioning that for JDK5 the Japanese version of java api docs exist. Not sure how to handle that... I don't understand the legal issues, but: Ad Japanese version - if one downloads non-Japanese version of the IDE than English version of the javadoc would be included. Ad size - I did not realize that at the current internet speeds 40MB extra would be an issue. It takes under 2s to download 40 MB with a reasonable broadband. I just forgot that not all places have broadband. Since the distributions are created automatically, is it a problem to create one with and one without the docs? But maybe the best solution would be to simply put a note on the download page saying "And BTW the bundle does not contain javadoc which can be downloaded here; follow these steps to install it." It is easy to get an impression that by downloading the bundle one gets a complete thing. So when javadoc does not work one thinks something is broken, not that something extra must be downloaded. I understand it, Jirka. What about following, dlipin:
NB+JDK bundle would have a custom installer with one additional step, which would allow you to download and install the
some components, for example JDK (the right version+language), Glassfish server, ... etc. Simply, the current download
size would be approximately the same and user would be able to download additional software during the install time. It
shouldn't have any serious legal issues (?), right and should not be too difficult too (?).
> It is easy to get an impression that by downloading the bundle one gets a complete thing.
> So when javadoc does not work one thinks something is broken, not that something extra must be downloaded.
I think that pop-up window with instructions pops up in IDE when you invoke Help>Javadoc index search.
Assigned to new owner. |