Win a copy of Practice Tests for OCP Java 17 Certification Exam (1Z0-829) this week in the OCPJP forum!
  • Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Tim Cooke
  • Campbell Ritchie
  • Jeanne Boyarsky
  • Ron McLeod
  • Liutauras Vilda
Sheriffs:
  • Rob Spoor
  • Junilu Lacar
  • paul wheaton
Saloon Keepers:
  • Stephan van Hulst
  • Tim Moores
  • Tim Holloway
  • Carey Brown
  • Scott Selikoff
Bartenders:
  • Piet Souris
  • Jj Roberts
  • fred rosenberger

Javadoc Question

 
Ranch Hand
Posts: 61
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I have a stupid question about the javadoc for the assignment. I have about 18 java source files and after I ran javadoc for my project it generated about 43 html files. In the Exam Cram 2 Java 2 Developer book by Alain Trottier he said he had 10 source files that produced 100 javadoc html files.

Are we supposed to somehow link our javadoc to the J2SE javadoc API? Otherwise, references to any J2SE core classes do not show up as links in my javadoc. I would think this is ok - that we do not need to link to the core API.

Just wondering since my project did not generate as many javadoc files as the Exam Cram book related to.

Thanks for any input!!
 
Ranch Hand
Posts: 357
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi David,

I don't think it matters for the number of generated files if you link to the core classes or not. As far as I can tell the only difference is that it creates links. Which is nicer IMHO.

Your number of files sound about correct by the way. It will generate a html file for every class or interface and some extra for every package and some for the entire project. A 100 would seem a bit too much to me.

Frans.
[ May 27, 2005: Message edited by: Frans Janssen ]
 
David Sham
Ranch Hand
Posts: 61
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
So, then how do you link your javadoc to the core classes API javadoc? Or is this required?

Thanks for any input!
 
Ranch Hand
Posts: 146
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
You can make your javadoc link to the J2SE docs with the link attribute on the javadoc command. Here's the ant target I use:

 
Frans Janssen
Ranch Hand
Posts: 357
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I used this command:



Frans.
reply
    Bookmark Topic Watch Topic
  • New Topic