Javadoc as a directory based task

[William Ferguson <wi...@mincom.com>]

I noticed that Javadoc is not a directory based task and as such does
not accept the includes/excudes attributes. Is any one working on adding
this?


William Ferguson

This transmission is for the intended addressee only and is confidential
information. If you have received this transmission in error, please
delete it and notify the sender. The contents of this E-mail are the
opinion of the writer only and are not endorsed by Mincom Limited unless
expressly stated otherwise.

Re: Javadoc as a directory based task

[Ken Wood <kw...@i2.com>]

Conversely, I'm faced with that very problem all the time
in multiple projects. A result of legacy code lying around
that people won't remove from the repository, but which
is no longer compiled. I tried to deal with it using "packagename=a.c.b.*,a.c.x.*,a.c.z.*"
but as already reported, that isn't working either. Ant insists on
looking at EVERY java file it can see in the directory tree...

Conor MacNeill wrote:

> William,
>
> I haven't really come up against a situation where I leave anything out of
> the javadoc. Nevertheless, I can see that there may be cases. You are
> proposing, I presume, that the sourcefiles attribute be replaced by  a set
> of files selected by include/exclude stuff. Sounds reasonable - when can you
> submit it :-)?
>
> Conor
>
> > -----Original Message-----
> > From: William Ferguson [mailto:williamf@mincom.com]
> > Sent: Tuesday, 25 July 2000 11:54
> > To: ant-dev@jakarta.apache.org
> > Subject: RE: Javadoc as a directory based task
> >
> >
> > OK, no-one replied to the original post, perhaps I can put it another
> > way.
> >
> > How do you use the Javadoc task when you specifically want to exclude
> > doco for some packages/classes.
> >
> >
> > William Ferguson
> >
> > This transmission is for the intended addressee only and is confidential
> > information. If you have received this transmission in error, please
> > delete it and notify the sender. The contents of this E-mail are the
> > opinion of the writer only and are not endorsed by Mincom Limited unless
> > expressly stated otherwise.
> >
> >
> > > -----Original Message-----
> > > From: William Ferguson [mailto:williamf@mincom.com]
> > > Sent: Monday, 24 July 2000 10:02
> > > To: Ant-Dev
> > > Subject: Javadoc as a directory based task
> > >
> > >
> > > I noticed that Javadoc is not a directory based task and as such does
> > > not accept the includes/excudes attributes. Is any one
> > > working on adding
> > > this?
> > >
> > >
> > > William Ferguson
> > >
> > > This transmission is for the intended addressee only and is
> > > confidential
> > > information. If you have received this transmission in error, please
> > > delete it and notify the sender. The contents of this E-mail are the
> > > opinion of the writer only and are not endorsed by Mincom
> > > Limited unless
> > > expressly stated otherwise.
> > >
> >
> >

Re: Javadoc as a directory based task

[Christopher Elkins <ce...@scardini.com>]

> I haven't really come up against a situation where I leave anything out of
> the javadoc. Nevertheless, I can see that there may be cases.
>
The obvious example is when you're excluding files from compilation. If certain
classes aren't compiled, it makes little sense to build the javadocs for them.

A more specific example: building a distributable client library from a mixed
client-server codebase. The client library contains none of the server classes
and should only contain client-code javadocs.

> Conor
>

--
Christopher Elkins

RE: Javadoc as a directory based task

[Conor MacNeill <co...@m64.com>]

William,

I haven't really come up against a situation where I leave anything out of
the javadoc. Nevertheless, I can see that there may be cases. You are
proposing, I presume, that the sourcefiles attribute be replaced by  a set
of files selected by include/exclude stuff. Sounds reasonable - when can you
submit it :-)?

Conor


> -----Original Message-----
> From: William Ferguson [mailto:williamf@mincom.com]
> Sent: Tuesday, 25 July 2000 11:54
> To: ant-dev@jakarta.apache.org
> Subject: RE: Javadoc as a directory based task
>
>
> OK, no-one replied to the original post, perhaps I can put it another
> way.
>
> How do you use the Javadoc task when you specifically want to exclude
> doco for some packages/classes.
>
>
> William Ferguson
>
> This transmission is for the intended addressee only and is confidential
> information. If you have received this transmission in error, please
> delete it and notify the sender. The contents of this E-mail are the
> opinion of the writer only and are not endorsed by Mincom Limited unless
> expressly stated otherwise.
>
>
> > -----Original Message-----
> > From: William Ferguson [mailto:williamf@mincom.com]
> > Sent: Monday, 24 July 2000 10:02
> > To: Ant-Dev
> > Subject: Javadoc as a directory based task
> >
> >
> > I noticed that Javadoc is not a directory based task and as such does
> > not accept the includes/excudes attributes. Is any one
> > working on adding
> > this?
> >
> >
> > William Ferguson
> >
> > This transmission is for the intended addressee only and is
> > confidential
> > information. If you have received this transmission in error, please
> > delete it and notify the sender. The contents of this E-mail are the
> > opinion of the writer only and are not endorsed by Mincom
> > Limited unless
> > expressly stated otherwise.
> >
>
>

RE: Javadoc as a directory based task

[William Ferguson <wi...@mincom.com>]

OK, no-one replied to the original post, perhaps I can put it another
way.

How do you use the Javadoc task when you specifically want to exclude
doco for some packages/classes.


William Ferguson

This transmission is for the intended addressee only and is confidential
information. If you have received this transmission in error, please
delete it and notify the sender. The contents of this E-mail are the
opinion of the writer only and are not endorsed by Mincom Limited unless
expressly stated otherwise.


> -----Original Message-----
> From: William Ferguson [mailto:williamf@mincom.com]
> Sent: Monday, 24 July 2000 10:02
> To: Ant-Dev
> Subject: Javadoc as a directory based task
>
>
> I noticed that Javadoc is not a directory based task and as such does
> not accept the includes/excudes attributes. Is any one
> working on adding
> this?
>
>
> William Ferguson
>
> This transmission is for the intended addressee only and is
> confidential
> information. If you have received this transmission in error, please
> delete it and notify the sender. The contents of this E-mail are the
> opinion of the writer only and are not endorsed by Mincom
> Limited unless
> expressly stated otherwise.
>