Skip to main content

please help - building BDJ javadocs API

13 replies [Last post]
javanetforme
Offline
Joined: 2010-06-05

Hi,

I am trying to build the Javadoc API Reference Documentation as directed in http://wiki.java.net/bin/view/Mobileand ... Definition. these are my queries:

1. is BD-ROM_Part3-2_v3.4_javadoc_080623-src-stubs.jar same as the jar file that we can get from java ME installation/power DVD installation etc? I mean if it is same then i dont have to send the license application for BD-J JavaDocStubs.

2. i unzipped the collected source i.e. fp10b.zip, jtv111.zip, pbp10b.zip, jsse103.zip, mug226-gem_packaged_media.zip and tried the command find fp10b -name '*.java' -print > files.list but the files are not found.(message : File not found - *.java)

If somebody has know how to build them correctly/successfully, please help.

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
0911314
Offline
Joined: 2010-07-11

ah yes.... just went thru the same issues.
any reason you're executing all the commands yourself though?? why not use the build.sh file and let it do the work?
i am running windows xp so i used cygwin. after much messing about, i got the shell script working error-free by following the instructions in the build.sh file.
create the "originals" folder and drop your zip files in there (don't unzip them, let the script do it for you), then open a shell window and run the script.
all things being well (paths all correct, files in the right place, filenames correct etc.) then it'll run (maybe with one or two warnings).
just be sure to check the filenames of your zip files because that's something i noticed - "BD-ROM_Part3-2_v3.4..." is in the build.sh file but i got "..._v2.2..." and "jtv111..." in the build.sh but the file i downloaded was "java_tv-1.1.1..." or something. so be wary of that...
but as i was told by Bill Foote, check each line of output and see what's going on.
i'm a rookie in all this, but maybe you can learn from my struggles and avoid the same problems.
luck good.

javanetforme
Offline
Joined: 2010-06-05

Thanks for the reply.

I got the licensed bdj stubs and then tried to run build.sh file through cygwin(operating system xp).

Now the directories gets unzipped properly but problem arises with the javac and javadoc commands. I even set JAVA_HOME in cygwin with : export JAVA_HOME=/cygdrive/c/"Program Files"/Java/jdk1.6.0 and then changed the javac command to $JAVA_HOME/bin/javac ... but it doesnt work

also, tried to link the exe files javac and javadoc as mentioned in http://cs.nyu.edu/~yap/prog/cygwin/FAQs.html :

> cd /usr/local/bin
> ln -s /cygdrive/c/"Program Files"/Java/jdk1.6.0/bin/javac.exe .

this also doesnt work.

Basically the commands are not working even after doing above steps.If anybody built them in cygwin please help.

Thanks.

0911314
Offline
Joined: 2010-07-11

i think if you try to follow too many sets of instructions, you'll end up losing yourself.
use cygwin. create the "originals" directory as per the instructions.
put all your zip files into the originals directory.
verify the file names of your originals match the file names in the build.sh file. these are the file names that the various commands (unzip, javac, javadoc etc) will look for when the script executes.
if any of these file names are different (as was the case with my stubs from the BDA, and the TV API), you will get errors.
make sure you have zip, unzip, javac, etc (all the commands that the shell will use) in your path.
as BillF told me, try typing "javac -version" in your shell and you should get something like javac 1.6.0_17
if you get an error msg, your path ain't set up.

javanetforme
Offline
Joined: 2010-06-05

Hi,

Thanks for the reply. All the file names are ok. javac -version gives 1.6.0.
This is what i am getting now :

When i keep -bootclasspath with javac and javadoc.. it says can not find java.lang in bootclasspath or classpath.

When i changed -bootclasspath to -classpath, the html files got generated but it failed to create classes.zip files as it couldnt find class references.

any idea?

dekz
Offline
Joined: 2010-07-04

>javac -bootclasspath classes
the bootclasspath reference here lets you cross compile for a different platform. You're going to need to keep that and not change to classpath initially.

The stubs provided are java files. The process is to generate the the javadocs from the source and compile the source into stubs which run on VM 1.3.

You might have a bad installation of JDK or your path variables are broken/missing.

javanetforme
Offline
Joined: 2010-06-05

found that it was looking for rt.jar at C:\Program Files\Java\jdk1.6.0\jre\lib\ext\

so i copied rt.jar at this path and then tried with -bootclasspath.

This time it didnt give me java.lang error and created the docs but still didnt create classes.zip ... as some class references are not found.

chihiro_saito
Offline
Joined: 2006-11-08

Hi,

Just like dekz and others are saying, you don't want to be using jdk's rt.jar to the bootclasspath - if you do that, then the resulting javadoc and stub jar will contain APIs that are a part of jdk but not in bd-j. which is exactly what you don't want. Try fixing the java.lang error with bootclasspath pointing to the zip files that you've gathered properly for bd-j.

http://wiki.java.net/bin/view/Mobileandembedded/BDJPlatformDefinition

If you're getting java.lang error, then you're probably not having Sun's classes in place. They can be downloaded from the oracle site now, below.

http://www.oracle.com/technetwork/java/javame/bluray-technote-142391.html

Cygwin shouldn't be a problem; I've generated stubs multiple times on cygwin...

Good luck,
Chihiro

javanetforme
Offline
Joined: 2010-06-05

Hi

thanks for the reply.

I downloaded fresh specs or FP, PBP etc. from http://www.oracle.com/technetwork/java/javame/downloads/index.html..but these doesnt have source files (.java). Is there some other place from where they can be downloaded?

billf
Offline
Joined: 2004-02-13

It looks like the download link is broken. The correct link for downloading the Sun parts of the documentation set is specified in the build script, and it is:

http://www.oracle.com/technetwork/java/javame/bluray-technote-142391.html

The Sun parts are all direct links to zip files, e.g. the Java TV API link is to http://java.sun.com/javame/reference/docs/jtv111.zip. Unfortunately, it looks like the zip files aren't there, and instead of a 404 error page, the web site is trying to be helpful by redirecting to a generic site. That's doing more harm than good, since it's obscuring the fact that the file that you need isn't there.

The trick to figuring this out is looking at the URL of the link (along the bottom of the browser, typically) before clicking on it.

I've alerted the relevant folks at Oracle, and asked them to post a note here when the download page is fixed.

Cheers,

Bill

plawlor
Offline
Joined: 2008-11-26

Hi,

Thanks for alerting us to the broken redirect and sorry for the confusion.

Java.sun.com was recently integrated into oracle.com. We turned off the redirect causing the error so please try again the links from http://www.oracle.com/technetwork/java/javame/bluray-technote-142391.html.

Let us know if you still have issues or if you come across other bad links/redirects.

Pat

billf
Offline
Joined: 2004-02-13

Hi Pat,

Thanks for the quick turnaround! I double-checked the links on the technote page, and everything looks good now.

Cheers,

Bill

javanetforme
Offline
Joined: 2010-06-05

Hi All,

Thanks for looking at the issue. Now the links works properly.

Now i am able to create classes.zip and the docs but with over 200 warnings. But that should work fine, i guess.

dekz
Offline
Joined: 2010-07-04

> 1. is
> BD-ROM_Part3-2_v3.4_javadoc_080623-src-stubs.jar same
> as the jar file that we can get from java ME
> installation/power DVD installation etc?
No, these are class files packaged in a jar, to generate the org.bluray.* you're going to need to get the java files from BDA.

>
> 2. i unzipped the collected source i.e. fp10b.zip,
> jtv111.zip, pbp10b.zip, jsse103.zip,
> mug226-gem_packaged_media.zip and tried the command
> find fp10b -name '*.java' -print > files.list but the
> files are not found.(message : File not found -
> *.java)
>
> If somebody has know how to build them
> correctly/successfully, please help.

Try to run the script provided on the page and report if it has errors