[5444] in java-interest
javadoc broken?
daemon@ATHENA.MIT.EDU (garya@dreamchaser.org)
Fri Feb 9 05:45:28 1996
From: garya@dreamchaser.org
Date: Fri, 9 Feb 1996 02:11:33 -0700
To: java-interest@java.sun.com
In the 1.0 release, both Win95 and Solaris,
javadoc appears to be broken:
1. @author and @version are ignored:
/**
* MyClass Doc
* @version 1.1
* @author Frustrated
* @see C2
*/
public class DocTpt extends Object {
...
Produces a doc with text and a ref to C2 but no mention of version or author.
2. If I have the following hierarchy:
Dir
|
AllPkgs
/ \
Pkg Pkg2
/ \
Foo.java Foo2.java
While sitting in Dir, if I do
javadoc AllPkgs/Pkg/Foo.java AllPkgs/Pkg2/Foo2.java
Then
AllPkgs.Pkg.Foo.html
AllPkgs.Pkg2.Foo2.html
AllNames.html
tree.html
get generated correctly.
But package indexes aren't built; packages.html lists no packages.
If I do
javadoc AllPkgs/Pkg AllPkgs/Pkg2
Then
packages.html
Package-AllPkgs/Pkg.html
Package-AllPkgs/Pkg2.html
are generated, but Pkg.html and Pkg2.html have no refs to their components.
and packages.html has a reference to API_users_guide.html, which is nowhere
in sight.
Can someone shed some light on this?
Gary Aitken garya@ics.com (business)
-
This message was sent to the java-interest mailing list
Info: send 'help' to java-interest-request@java.sun.com
