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: | Cannot add Javadoc to project jar | ||
|---|---|---|---|
| Product: | projects | Reporter: | tkellerer <tkellerer> |
| Component: | Libraries | Assignee: | Milos Kleint <mkleint> |
| Status: | RESOLVED FIXED | ||
| Severity: | blocker | CC: | alexlamsl, gsporar, jrojcek, mkleint, pbw |
| Priority: | P3 | Keywords: | API, API_REVIEW_FAST |
| Version: | 5.x | ||
| Hardware: | All | ||
| OS: | Windows XP | ||
| Issue Type: | ENHANCEMENT | Exception Reporter: | |
| Attachments: | relevant changes, both API and implementation | ||
|
Description
tkellerer
2005-12-16 11:08:30 UTC
This is related to shareable libraries. The shareabe libraries as currently designed will allow user to create shared library stored in the project (or elsewhere). You will need to create a library either, but not the global IDE library as in NB 5.0. Probably the UI should help you to do it or hide it when you add a jar/folder into your project's classpath. >> "The shareabe libraries as currently designed"
Are we talking about 5.0 or is this > 5.0?
Actually I think a "Javadoc" tab in the project properties would be perfectly
sufficient, there is no need to make this overly complex.
Do you have a link to a mailinglist thread to how this shareable libraries will work? It would be a good idea to have these libraries. But it should be possible to just annotate exisiting .jar's (in WEB-INF/lib) with source code and javadoc, by e.g. right-click on .jar: - add javadoc or add source - make/create shareable library Other projects could just automatcally detect and annotate source code and javadoc on behalf of the hashcode of the original .jar file. So i don't have to do this in every project again... Does this issue relate to free-form projects? pbw: re. relationship to freeform projects: probably the same story. Assuming you are already using the JAR successfully in your project, the only option in NB 5.0 is to go to Library Manager, make a new library (name irrelevant) pointing to that JAR location, and add Javadoc. Then you should get Javadoc associated with it. The main problems are (1) this is awkward and unintuitive; (2) even if the Javadoc happens to be located inside the project dir or otherwise accessible via a relative path, you cannot share this association with colleagues - they have to do the same setup on their own machines. It is indeed rather unintuitive - sharable libraries would be a good idea. The easiest solution would be to bind these libraries to projects only, but one might want to minimise the number of duplicated libraries opened in the IDE, in which case sticking to the present solution of Library Manager might be desirable. However, this may give rise to namespace conflict issues. Another issue that might be undesirable is the overall package size - packing 3rd party libraries into your project might significantly increase the overall size of your project. So if there is an online mechanism (similar to Maven's repository) to store and distribute relevant libraries and only package those not on the public repository (less popular / dev / pricate modules) with your project, which is global and local scopes respectively might be a good solution I wrote my similar idea here: http://www.netbeans.org/issues/show_bug.cgi?id=75117 Created attachment 55031 [details]
relevant changes, both API and implementation
attached is the proposed patch. please review additional changes in api were required due to high priority issue with previous implementation. (#126023, #126023) Please review. http://hg.netbeans.org/main/rev/c9d127d11201 thanks for review done |