Win a copy of Think Java: How to Think Like a Computer Scientist this week in the Java in General forum!
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

javadoc @author tags don't appear

 
Ed Connery
Ranch Hand
Posts: 70
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I've never been able to get the author tags to work in javadoc, and wondered if I was doing something wrong. In my most recent Cattle Drive exercise, the instructor's solution starts with a documentation comment. That one didn't work for me either, and it turns out it doesn't work for Katrina either. Any ideas? I'm appending my exchange with Katrina and the documentation comment in question:

************************

Strange! I have no idea...
I also just tried it and the author tags disappeared. Want to go ask on the forums?

On Wed, Mar 17, 2010 at 5:39 PM, Ed Connery <edconnery@pciglobal.com> wrote:
> Hi Katrina,
>
> I see we have our first javadoc comment here. Out of curiosity I ran
> javadoc on this, and--just as any time I tried it on my own code--the
> author tags just disappear and don't appear anywhere in the html.  Any
> idea why? [I'm using 1.6 here but the documentation of 1.6 seems to
> say these tags should work fine.]
>
>           -- Ed
>
>
>
> Here is the instructor's solution:
>
> /** This class will convert an integer to a verbal number. <p>
>
>    Instructor's solution for JavaRanch Cattle Drive assignment
> Java-4a<p>
>
>    Pass in a number such as 45 and get back a string like
>    "forty-five". <p>
>
>    This solution can handle numbers up to 99. <p>
>
>    @author Paul Wheaton
>    @author Marilyn de Queiroz
> */
> public class Say
> {...}
 
Christophe Verré
Sheriff
Posts: 14691
16
Eclipse IDE Ubuntu VI Editor
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
You must use the -author command line option to generate it.
 
Ed Connery
Ranch Hand
Posts: 70
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Ah, thank you Christophe!
 
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic