Nabble - codehaus - backport175

Re: Tag argument/javadoc question

2006-06-06T12:56:57Z

I think you can use a java taglet (doclet - can't remember the exact
name given) to do as if the @com.foo.bar was a know javadoc doclet
this is odd, but I don't see other ways.
Alex

On 6/6/06, William Press <wpress@...> wrote:

> Thanks for the info on the aliases file.
>
> FWIW, the warnings are a problem because we need our javadocs to be clean/correct, and we get *a lot* of unnecessary warnings that make it difficult to find real problems in our API documentation.
>
> Any other thoughts would be appreciated.
>
> - Bill
>
> -----Original Message-----
> From: jboner@... [mailto:jboner@...] On Behalf Of Jonas Bonér
> Sent: Tuesday, June 06, 2006 9:04 AM
> To: user@...
> Subject: Re: [backport175-user] Tag argument/javadoc question
>
> > Greetings,
> >
> >
> >
> > I would like to compile annotations that take multiple arguments, such as
> >
> >
> >
> > /**
> >
> > * @com.foo.bar(arg1="value 1", arg2="value 2")
> >
> > **/
> >
> > void noop() {
> >
> > }
> >
> >
> >
> > I compile my original java source using ant, and when I invoke the <javadoc>
> > task on the source, it gives me a warning about the unidentified tag. When
> > I use the <tag> nested tag to specify "@com.foo.bar", it still gives me a
> > warning, and the presence of quotes/spaces are taken kindly by <javadoc>.
>
> Is this a problem? We do not use JavaDoc but have our own parser (and
> is using QDox).
>
> >
> >
> >
> > Can I use the tag alias file with tag arguments? Or does this only allow
> > for specifying the tag name, itself?
> >
>
> No, it is very simplistic, only tag names for convenience. Like
> 'imports' or 'aliases'.
>
> /Jonas
>
> >
> >
> > Thanks,
> >
> > Bill
>
>
> --
> Jonas Bonér
> Terracotta, Inc.
>
> http://jonasboner.com
> http://www.terracottatech.com
> _______________________________________________________________________
> Notice: This email message, together with any attachments, may contain
> information of BEA Systems, Inc., its subsidiaries and affiliated
> entities, that may be confidential, proprietary, copyrighted and/or
> legally privileged, and is intended solely for the use of the individual
> or entity named in this message. If you are not the intended recipient,
> and have received this message in error, please immediately return this
> by email and then delete it.
>
> ---------------------------------------------------------------------
> To unsubscribe from this list please visit:
>
> http://xircles.codehaus.org/manage_email
>
>

---------------------------------------------------------------------
To unsubscribe from this list please visit:

http://xircles.codehaus.org/manage_email

From forum: backport175 - user

RE: Tag argument/javadoc question

2006-06-06T11:40:57Z

Thanks for the info on the aliases file.

FWIW, the warnings are a problem because we need our javadocs to be clean/correct, and we get *a lot* of unnecessary warnings that make it difficult to find real problems in our API documentation.

Any other thoughts would be appreciated.

- Bill

-----Original Message-----
From: jboner@... [mailto:jboner@...] On Behalf Of Jonas Bonér
Sent: Tuesday, June 06, 2006 9:04 AM
To: user@...
Subject: Re: [backport175-user] Tag argument/javadoc question

> Greetings,
>
>
>
> I would like to compile annotations that take multiple arguments, such as
>
>
>
> /**
>
> * @com.foo.bar(arg1="value 1", arg2="value 2")
>
> **/
>
> void noop() {
>
> }
>
>
>
> I compile my original java source using ant, and when I invoke the <javadoc>
> task on the source, it gives me a warning about the unidentified tag. When
> I use the <tag> nested tag to specify "@com.foo.bar", it still gives me a
> warning, and the presence of quotes/spaces are taken kindly by <javadoc>.

Is this a problem? We do not use JavaDoc but have our own parser (and
is using QDox).

>
>
>
> Can I use the tag alias file with tag arguments? Or does this only allow
> for specifying the tag name, itself?
>

No, it is very simplistic, only tag names for convenience. Like
'imports' or 'aliases'.

/Jonas

>
>
> Thanks,
>
> Bill

--
Jonas Bonér
Terracotta, Inc.

http://jonasboner.com
http://www.terracottatech.com
_______________________________________________________________________
Notice: This email message, together with any attachments, may contain
information of BEA Systems, Inc., its subsidiaries and affiliated
entities, that may be confidential, proprietary, copyrighted and/or
legally privileged, and is intended solely for the use of the individual
or entity named in this message. If you are not the intended recipient,
and have received this message in error, please immediately return this
by email and then delete it.

---------------------------------------------------------------------
To unsubscribe from this list please visit:

http://xircles.codehaus.org/manage_email

From forum: backport175 - user

Re: Tag argument/javadoc question

2006-06-06T10:03:46Z

From forum: backport175 - user

Tag argument/javadoc question

2006-06-05T17:23:15Z

Greetings,

I would like to compile annotations that take multiple arguments, such as

/**

* @com.foo.bar(arg1=“value 1”, arg2=”value 2”)

**/

void noop() {

}

I compile my original java source using ant, and when I invoke the <javadoc> task on the source, it gives me a warning about the unidentified tag. When I use the <tag> nested tag to specify “@com.foo.bar”, it still gives me a warning, and the presence of quotes/spaces are taken kindly by <javadoc>.

Can I use the tag alias file with tag arguments? Or does this only allow for specifying the tag name, itself?

Thanks,

Bill

From forum: backport175 - user

Re: [backport175-dev] backport 1.1 release?

2005-12-21T07:07:41Z

Forwarding to user list as well.

Cool. Thanks.

On 12/21/05, Hirotaka HONMA <manholex@...> wrote:

> Hi.
>
> I'm creating "Maven Backport175 Plugin".
> It provides the ability to compile the backport175
> annotations with Maven2.
> http://maven-backport175.sandbox.seasar.org/
>
> usage is here.
> http://maven-backport175.sandbox.seasar.org/usage.html
>
> regards.
>
> --
> Hirotaka HONMA <manholex@...>
> The Seasar Foundation
>
>
> On 12/2/05, Shinpei Ohtani <shinpei.ohtani@...> wrote:
> > Hi,
> >
> > We are glad 1.1 will be released.
> > And if we have pathces or other contributions, we will contribute to you.
> > (Maybe we have one(maven2 plugin or something like it),
> > but I don't know much about it now)
> >
> >
> > Thanx,
> >
> > 2005/12/1, Jonas Bone'r <jonas@...>:
> > > We have decided to do a 1.1 release, but are to busy to execute that plan ASAP.
> > > Hope to do it before christmas though.
> > >
> > > So, if you have patches, fixes, contributions etc. let un know now.
> > >
> > > Stay tuned.
> > >
> > > --
> > > The Backport175 Team.
> > >
> > > On 11/21/05, Shinpei Ohtani <shinpei.ohtani@...> wrote:
> > > > Hi all,
> > > >
> > > > We are looking forward to backport 175 released.
> > > > Can you give me a little bit info about when 1.1(or 1.1RC) is released?
> > > >
> > > > I don't want you to be in hurry to release.
> > > > But there is a need of 1.1 for Seasar so I need to say this.
> > > >
> > > >
> > > > Thanks,
> > > > --
> > > > =============================
> > > > Shinpei Ohtani
> > > > The Seasar foundation(http://www.seasar.org/en/)
> > > > =============================
> > > >
> > >
> > >
> > > --
> > > Jonas Bone'r
> > > Terracotta, Inc.
> > >
> > > http://www.terracottatech.com
> > > http://blogs.codehaus.org/people/jboner/
> > >
> >
> >
> > --
> > =============================
> > Shinpei Ohtani
> > The Seasar Foundation
> > =============================
> >
>

--
Jonas Bonér
Terracotta, Inc.

http://jonasboner.com
http://www.terracottatech.com

From forum: backport175 - user