Thread: javadoc

javadoc

From
"Robert B. Easter"
Date:
Hi, when I run javadoc on the jdbc source, it doesn't show the comments.
Looks like the /** got replaced with /* everywhere. I'm looking at the CVS
stuff. Can anyone do a replacement of /* to /** on all the java files, or was
it intentionally done this way?

Robert B. Easter

Re: javadoc

From
"Thomas O'Dowd"
Date:
I think I remember discussions about running the code through
a beautifier at one stage. Not sure if it was done or not. That'd
be my guess on what happened.

Tom.

On Tue, Feb 19, 2002 at 07:21:07PM -0500, Robert B. Easter wrote:
> Hi, when I run javadoc on the jdbc source, it doesn't show the comments.
> Looks like the /** got replaced with /* everywhere. I'm looking at the CVS
> stuff. Can anyone do a replacement of /* to /** on all the java files, or was
> it intentionally done this way?
>
> Robert B. Easter
>
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Don't 'kill -9' the postmaster

--
Thomas O'Dowd. - Nooping - http://nooper.com
tom@nooper.com - Testing - http://nooper.co.jp/labs

Re: javadoc

From
Bruce Momjian
Date:
Robert B. Easter wrote:
> Hi, when I run javadoc on the jdbc source, it doesn't show the comments.
> Looks like the /** got replaced with /* everywhere. I'm looking at the CVS
> stuff. Can anyone do a replacement of /* to /** on all the java files, or was
> it intentionally done this way?

It was part of my pgjindent work. I can easily fix it.  Which ones do
people want changed?  All of them?

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026

Re: javadoc

From
Doug Fields
Date:
>It was part of my pgjindent work. I can easily fix it.  Which ones do
>people want changed?  All of them?

I believe that JavaDoc usually ignores /** when it is not expected, so, if
you changed every /* for a /** you would get at least all the JavaDocs,
rather than having some stuff be missing...

Cheers,

Doug