Solved

How to make javadoc aware of external .jar

Posted on 2006-11-24
23
965 Views
Last Modified: 2013-11-23
Hi,
I practise javadoc on my sources from the commandline (i.c. spawned from an application)
Since some time I started to make use of downloaded .jar's
Compilation works as a charm.
Now javadoc is complaining that some imports from and references to external .jar's can't be checked.
The javadoc output is correct, but I would like to suppress (that is solve) the error messages.
I tried the -classpath option but that is probably not the right way.

;JOOP!
0
Comment
Question by:sciuriware
  • 12
  • 5
  • 5
  • +1
23 Comments
 
LVL 86

Expert Comment

by:CEHJ
ID: 18006471
Can we see some of the error messages?
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18006790
Working on a wrapper around the Toedter JDateChooser:

Test.java:25: package com.toedter.calendar does not exist
import com.toedter.calendar.JDateChooser;
                            ^
Test.java:61: cannot find symbol
symbol  : class JDateChooser


;JOOP!
0
 
LVL 10

Expert Comment

by:mbvvsatish
ID: 18006800
0
 
LVL 35

Expert Comment

by:girionis
ID: 18006825
Can you post the command line you use?
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18006841
javadoc.exe -public -d javadocPath *.java

This worked perfectly for years until I started to use jcalendar.jar

;JOOP!
0
 
LVL 35

Expert Comment

by:girionis
ID: 18006863
What happens if you do this

javadoc.exe -public -d javadocPath jcalendar.jar *.java
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18006924
javadoc: error - Illegal package name: jcalendar.jar

;JOOP!
0
 
LVL 35

Expert Comment

by:girionis
ID: 18006935
Not sure whatelse to try. As a last resort, what happens if you extract the files from jcalendar.jar and use the -classpath option?
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007054
I guess that then I will create a compound javadoc of my stuff and that made by Toedter.

;JOOP!
0
 
LVL 86

Expert Comment

by:CEHJ
ID: 18007088
Try extracting the classes and re-jarring them. I had exactly the same problem when i tried it, although i didn't then take the course of action i just mentioned
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007098
re-jarring the downloaded library?
What's that good for?

;JOOP!
0
How to run any project with ease

Manage projects of all sizes how you want. Great for personal to-do lists, project milestones, team priorities and launch plans.
- Combine task lists, docs, spreadsheets, and chat in one
- View and edit from mobile/offline
- Cut down on emails

 
LVL 86

Expert Comment

by:CEHJ
ID: 18007106
I thought the thing might be corrupt
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007114
Checked: it is fine (and my programs run with it).

No the problem is with javadoc, somehow it 'knows' of standard libraries and
besides, I wonder why it does difficult about references that are not used
to produce the javadoc output.
;JOOP!
0
 
LVL 86

Assisted Solution

by:CEHJ
CEHJ earned 145 total points
ID: 18007124
Well i got exactly the same error message anyway. Is it *in* the classpath btw?
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007185
Yes, i.e. the .jar is in a 'lib' directory that is in the directory mentioned in CLASSPATH.

;JOOP!
0
 
LVL 35

Accepted Solution

by:
girionis earned 355 total points
ID: 18007275
You should put the jar itself in the classpath, export CLASSPATH=$CLASSPATH:/home/user/lib/jcalendar.jar
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007314
I already did that.

;JOOP!
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007919
I found it:

             javadoc.exe -public -d javadocPath -extdirs lib *.java
                                                               ^^^^^^^

Funny because now it should not recognise the standard libraries.

;JOOP!
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007929
Sorry folks, no CLASSPATH, no corruption, no weird doclet ....

;JOOP!
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18007932
I'm going to spread some points, because this item must be available to others.

;
J
O
O
P
!
0
 
LVL 86

Expert Comment

by:CEHJ
ID: 18010776
:-)
0
 
LVL 35

Expert Comment

by:girionis
ID: 18017670
:)
0
 
LVL 24

Author Comment

by:sciuriware
ID: 18017733
(:-)}={

0

Featured Post

How to run any project with ease

Manage projects of all sizes how you want. Great for personal to-do lists, project milestones, team priorities and launch plans.
- Combine task lists, docs, spreadsheets, and chat in one
- View and edit from mobile/offline
- Cut down on emails

Join & Write a Comment

Java had always been an easily readable and understandable language.  Some relatively recent changes in the language seem to be changing this pretty fast, and anyone that had not seen any Java code for the last 5 years will possibly have issues unde…
Introduction This article is the first of three articles that explain why and how the Experts Exchange QA Team does test automation for our web site. This article explains our test automation goals. Then rationale is given for the tools we use to a…
Viewers learn about the “while” loop and how to utilize it correctly in Java. Additionally, viewers begin exploring how to include conditional statements within a while loop and avoid an endless loop. Define While Loop: Basic Example: Explanatio…
Viewers learn how to read error messages and identify possible mistakes that could cause hours of frustration. Coding is as much about debugging your code as it is about writing it. Define Error Message: Line Numbers: Type of Error: Break Down…

743 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question

Need Help in Real-Time?

Connect with top rated Experts

15 Experts available now in Live!

Get 1:1 Help Now