• 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 all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Paul Clapham
  • Jeanne Boyarsky
  • Junilu Lacar
  • Henry Wong
Sheriffs:
  • Ron McLeod
  • Devaka Cooray
  • Tim Cooke
Saloon Keepers:
  • Tim Moores
  • Stephan van Hulst
  • Frits Walraven
  • Tim Holloway
  • Carey Brown
Bartenders:
  • Piet Souris
  • salvin francis
  • fred rosenberger

How do i run javadoc with packages?

 
Ranch Hand
Posts: 41
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
How do i run javadoc with packages
Also, I have read that I can't use :
e.g.
import java.util.*;
but to use
import java.util.Vector;
is it true ?
Thanks in advance
Karl
 
Ranch Hand
Posts: 48
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Karl,
The command line for running javadoc for packages (on windows) is:
javadoc -sourcepath c:\scdj\suncertify\src -package suncertify.db suncertify.server suncertify.client
Just place all the packages you want processed after the '-package' option. You can specify documentation for each package by including a file called 'package.html' in the source directory and placing the text you want in this 'package documentation' between <BODY> tags in the file.
About importing classes, both methods you mentioned are both legal and allowed. It is only advised that you use the explicit
<code>import java.util.Vector</code>
so that anyone can tell at a glance of looking at your source exactly which classes you used. This is not compulsory. Whatever approach you chose its important that you remain CONSISTENT in its use throughout your project.
Akanimo.
 
Karl Fu
Ranch Hand
Posts: 41
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Thanks Akanimo
However, i am still alittle confused in how to put comment for packages, can you explain it a little further.
So does adding comments to my static variables
Karl
 
Akanimo Udoh
Ranch Hand
Posts: 48
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Karl,
Just create a file called 'package.html' in the folder where the source code for the package is. i.e for a package called suncertify.server (whose *.java files are in c:\scdj\src\suncertify\server ) you would create the file in this directory.
Then open the file in text mode (just change the file extension to '.txt' when you finish change it back to '.html') and type:
<body>TYPE THE COMMENT FOR THE PACKAGE IN HERE <body>.
Thats all! (remember to rename the file to '.html') When you run javadoc you should then be able to see documentation for the whole package.
Hope its clear?
Akanimo.
[This message has been edited by Akanimo Udoh (edited July 02, 2001).]
 
Ranch Hand
Posts: 49
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Hi,
I'm little bit confused now. I've already submitted by assignment on thursday. But I used KAWA IDE to generate javadoc. I just placed all the java files in a folder and ran Javadoc from the IDE. It created all the HTML files including index etc. But I don't have HTMLS on Packages. Is that OK ? If anyone knows that is O.K. please reply back. That would be GREAT.
Thanks,
Ravi.
 
Why am I so drawn to cherry pie? I can't seem to stop. Save me tiny ad!
Devious Experiments for a Truly Passive Greenhouse!
https://www.kickstarter.com/projects/paulwheaton/greenhouse-1
    Bookmark Topic Watch Topic
  • New Topic