Skip to main content

Add Java3D source jar file as a separate or part of the distribution

5 replies [Last post]
yowmhong
Offline
Joined: 2003-06-19
Points: 0

Hi Java3D team,

Please consider add the Java3D source jar file as one of the ant build target. There are so many times that tracing into Java3D source would be the most convinient and efficient way to develop Java3D applications. I used to use NetBeans occasionally to debug Java3D code and now I am using Eclipse for development all the time. Most IDEs has the ability to include the source Jar file and can be traced into the original source code with ease. In my opinion, with the integrated and instant JavaDoc ability along already justify the effort.
Having Java3D source jar file easily accessible can help in Java3D development. Easier to idenfity bugs, resolve ambiguities and, altimately contribute the solution to fix the problem. Not having to setup the whole Java3D development environment is the key to facilitate the development process.

IMHO, not so many people developing Java applications have the "C++" compiler installed in their machines and forcing developers to download the whole Java3D development trunk in order to trace into the source is something I would even hesitate to do. It is especially difficult if multiple Java3D versions are targeted.

Please consider this suggestion and build the Java3D source jar file either as a separate download or part of the daily build which of course has to be in-sync with the binary build.

Regards,

-- Scott

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
tmilard
Offline
Joined: 2004-03-25
Points: 0

I do agee. As a very average level developper:
- I personally do not have C++ compiler
- I would love to see the source in a debuging stop rather than the header of the method (of curse it is because I only have .class ).
- I never made it to install source. A simple jar seems also simple and nice way fromp my point of vue.

Thierry
Ps: I forgot
- I love java3D : Makes me feel I am a cool teenager maker of video games. Hey cheek, got joint ? hoola hoola hoop !

stylertim
Offline
Joined: 2006-05-04
Points: 0

Hi Scott!

1. If you need a javadoc, download the documentation and itegrate it into eclipse. the documentation is built to be used as a javadoc. works fine for me.

2. in fact the sources are all available through the java.net CVS. but i have to admit, i don't prefer this way of getting the sources. a seperate package would be very neat!

- Thomas

yowmhong
Offline
Joined: 2003-06-19
Points: 0

Hi Thomas,

Obviously we all come to the same conclusion. If the source jar file is available, JavaDoc simply comes with it for free! There is one very important aspect that JavaDoc along cannot provide is the source. A glimp of the source code can clarify any ambiguities by looking at the JavaDoc. Plus all the benefits mentioned in the original post.

> 1. If you need a javadoc, download the documentation
> and itegrate it into eclipse. the documentation is
> built to be used as a javadoc. works fine for me.
>
> 2. in fact the sources are all available through the
> java.net CVS. but i have to admit, i don't prefer
> this way of getting the sources. a seperate package
> would be very neat!
>
> - Thomas

-- Scott

jada
Offline
Joined: 2004-03-17
Points: 0

Good suggestion, Scott. Sorry, we didn't feel the pain as we alway work on the source. ;-) I've filed an issue so that we will not miss it this time.

Issue 467 : Add Java3D source jar file as a separate or part of the distribution

- Chien.

yowmhong
Offline
Joined: 2003-06-19
Points: 0

Chien, I've seen issue 467. thanks! ;-)

-- Scott