File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
http://aspose.com/file-tools
The moose likes IDEs, Version Control and other tools and the fly likes weird looking javadocs Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » Engineering » IDEs, Version Control and other tools
Bookmark "weird looking javadocs" Watch "weird looking javadocs" New topic
Author

weird looking javadocs

Alan Shiers
Ranch Hand

Joined: Sep 24, 2003
Posts: 237
HI Guys,

I just upgraded to JDK 1.7, which of course forced me to make some changes to my project. I'm working in Eclipse Helios. I finished all my changes so as to get rid of all the warning messages. Everything compiles and runs fine. Then I ran the javadoc utility. I wound up with a rather strange looking javadocs. Nothing at all looking like the javadocs generated for the JDK 1.7. Mine doesn't have any formatting whatsoever. Everything is in point form. After the javadoc finished it had one warning: warning: [options] bootstrap class path not set in conjunction with -source 1.6

I have no idea as to what to do about that in Eclipse. I made sure that all the classpath settings pointed to the new JDK libraries. So I don't know what else I need to fix to get the javadocs looking properly. I assume they are suppose to looke like the JDK 1.7 javadocs? Please see attached picture for an example of what one of my classes looks like from the generated javadocs. Please advise.

Alan


[Thumbnail for javadoc.gif]

Bear Bibeault
Author and ninkuma
Marshal

Joined: Jan 10, 2002
Posts: 60822
    
  65

For some reason (don't ask me, I don't use eclipse) the style sheet is not being applied.


[Asking smart questions] [Bear's FrontMan] [About Bear] [Books by Bear]
Alan Shiers
Ranch Hand

Joined: Sep 24, 2003
Posts: 237
You were right. That was it. I wound up going to the JDK 1.7 javadocs and downloading their stylesheet.css file. I put it in a special directory within the JDK1.7 folder on my hard drive and referenced it from Eclipse. Never had to do that before, but it worked.

Thanks,

Alan
Nick Fio
Greenhorn

Joined: Aug 05, 2012
Posts: 7

Alan Shiers wrote:You were right. That was it. I wound up going to the JDK 1.7 javadocs and downloading their stylesheet.css file. I put it in a special directory within the JDK1.7 folder on my hard drive and referenced it from Eclipse. Never had to do that before, but it worked.

Thanks,

Alan


First time poster here.

Thanks for this thread! I had just upgraded to Eclipse Juno and my javadocs for Java 7 were looking exactly like the pics posted above (Java 6 was looking normal though). Here's the link for the stylesheet...

http://docs.oracle.com/javase/7/docs/api/stylesheet.css

Since Google doesn't provide many helpful links on this particular issue (that, or my Google Fu is weak sauce), here's more wordy solution that worked for me:
I copied the linked-to file above into a text editor, saved it as stylesheet.css, and put it in the jdk1.7.0 folder. Then, when generating a javadoc on Eclipse, on the second page of Javadoc Generation, I clicked "Style sheet" and browsed to the file I had just dropped in there. Now my javadocs have Java 7 goodness!

Thanks again Alan!
 
It is sorta covered in the JavaRanch Style Guide.
 
subject: weird looking javadocs
 
Similar Threads
JavaDoc
rmic stub source
The deliverables of the project
Javadoc a whole App in one go.
NX: javadoc problem with assert keyword