Problem with javadoc bullding and combination with JC 2.2.1 documentation.
Hi,
I am sure that most of us is developing applications using Eclipse and JCOP tools (or without that plug-in) and then come to the API javadoc generation.
The problem is, that i am trying to generate my on-card package Javadoc. Everything is fine, but it doesn't find eclipse javadoc for jc221, even when i generate javadoc like that: I wanr to concatenate the documentation i am producing with java card 2.2.1 docummentation.
C:\Documents and Settings\Ieva\workspace>javadoc -link file://c:/eclipse3.1.2/eclipse/plugins/com.ibm.bluez.jcop.eclipse_3.1.2/guide/reference/jdocs/jc221 jcpackage -d docs
It replies, that it doesn't find javacard.framework package. So I have no links to the Applet and other classes options in my javadoc. But it seems that it finds java.lang.Object from it.
I have tried all relative and absolute paths! And notrhing works: i still get warnings. Could you please help me?
Best regards,
Eve
[972 byte] By [
Ievaa] at [2007-11-27 11:32:21]
# 1
When you say "concatenate", I hope you understand that all -link does is add links from your document to the -link doc. It doesn't concatenate their list of packages together, for example.
The way -link works is that it searches for a file named package-list at that directory:
file://c:/eclipse3.1.2/eclipse/plugins/com.ibm.bluez.jcop.eclipse_3.1.2/guide/reference/jdocs/jc221/package-list
If I understand you correctly, that file needs to contain "javacard.framework" package name.
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#linkpackagelist
Is that the case?
-Doug
# 2
Hi,
Yes i understand the point of linking (not concatenattion). There is an outpur from java doc generation in eclipse with above mentioned -link option:
Loading source files for package a...
Constructing Javadoc information...
C:\Documents and Settings\ieva\workspace\a\src\a\A.java:6: package javacard.framework does not exist
import javacard.framework.APDU;
^
C:\Documents and Settings\ieva\workspace\a\src\a\A.java:7: package javacard.framework does not exist
import javacard.framework.ISO7816;
^
C:\Documents and Settings\ieva\workspace\a\src\a\A.java:8: package javacard.framework does not exist
import javacard.framework.Applet;
^
C:\Documents and Settings\ieva\workspace\a\src\a\A.java:9: package javacard.framework does not exist
import javacard.framework.ISOException;
^
C:\Documents and Settings\ieva\workspace\a\src\a\A.java:15: cannot find symbol
symbol: class Applet
public class A extends Applet {
^
C:\Documents and Settings\ieva\workspace\a\src\a\A.java:21: cannot find symbol
symbol : class APDU
location: class a.A
public void process(APDU apdu) {
^
And all this happens, despite the fact, that package-list in the direcctory is present . Its content is:
java.io
java.lang
java.rmi
javacard.framework
javacard.framework.service
javacard.security
javacardx.crypto
So, I don't understand, ehat i am doing wrong? May be my link option is incorrect? I am working on Windows OS.
Thanks for a help.
Best regards,
Eve
Ievaa at 2007-7-29 16:45:00 >
