Home | Contact Us | FAQ | Search & Site Map | Link to Us
Sign In | Join | Other 45 Sites in Network
HomeAnnouncementsWhite Papers
Discussion GroupsFirst AidDatabasesJavaBeansGUIJava 3DVirtual MachineCORBASecurityToolsGeneral
Java DirectoryOpen Source ProjectsSample Book ChaptersUser GroupsWeb Resources
Related Topics
Databases.NETMore Topics ...

Java Forum / First Aid / November 2003

Tip: Looking for answers? Try searching our database.

Javadoc - @see can't see abstract classes?

Thread view: 
Bruno Beloff - 28 Nov 2003 18:44 GMT
Hi

I've got a problem with getting @see to see an abstract class in another
package.  In the Javadoc I'm writing, I have:

    * @see        com.opmath.util.html.Countries

This results in the message:

   javadoc: warning - Tag @see: Class or Package not found:
com.opmath.util.html.Countries

The strange thing is that if I have an alternative link:

    * @see        com.opmath.util.html.Select

Everything works fine.  The classes 'Countries' and 'Select' are in the same
package, in the same JAR file (on my javadoc classpath), and their online
javadocs are at the same place:

http://www.opmath.com/components/utilities/1.3/docs/api/com/opmath/util/html
/package-summary.html

The only difference I can see is that 'Countries' is abstract, and 'Select'
isn't.  Incidentally, if I use the alternative javadoc @see form:

    * @see <a
href="http://www.opmath.com/components/utilities/1.3/docs/api/com/opmath/uti
l/html/Countries.html">com.opmath.util.html.Countries</a>

This works okay.

What's up?

   Bruno.
Roedy Green - 28 Nov 2003 19:14 GMT
>     * @see        com.opmath.util.html.Countries

Can you find any examples is Sun's JavaDoc of an @see to an abstract?

Perhaps you have found a bug.

Try explicitly making your interface public.  Maybe see only works on
explicitly public classes.

--
Canadian Mind Products, Roedy Green.
Coaching, problem solving, economical contract programming.
See http://mindprod.com/jgloss/jgloss.html for The Java Glossary.
Bruno Beloff - 28 Nov 2003 19:55 GMT
Thanks for the message.

The class I'm referring to is explicity public:

   public abstract class Countries
   ...

It has no corresponding interface declaration. It's not practical for me to
alter the package I'm referring to.  I haven't found any @see's to abstract
classes in Sun's javadocs, but that doesn't mean they're not there.

Has anyone got @see to work referencing an abstract class in a separate
package?

All the best,

       Bruno.

On 28/11/03 7:14 pm, in article qg7fsvoiqm427o0pu24s8cm64fj3u64cla@4ax.com,

>>     * @see        com.opmath.util.html.Countries
>
[quoted text clipped - 9 lines]
> Coaching, problem solving, economical contract programming.
> See http://mindprod.com/jgloss/jgloss.html for The Java Glossary.


Free Magazines

Get these publications absolutely FREE for up to 12 months. There are no hidden fees and no obligation. Simply choose a title, complete the application form and submit it. Read more ...

Oracle MagazineNetwork ComputingComputer WorldBio-IT WorldeWeekInformation WeekInfosecurity
 
Sign In
Join
My Latest Posts
My Monitored Threads
My Blog
My Photo Gallery
My Profile
My Homepage

Start New Thread
Enable EMail Alerts
Rate this Thread



©2008 Advenet LLC   Privacy Policy - Terms of Use
This website includes both content owned or controlled by Advenet as well as content owned or controlled by third parties.