You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@ant.apache.org by Martin Gainty <mg...@hotmail.com> on 2006/05/25 21:53:10 UTC

No package found

Javadoc task produces "folder does not contain any package"
What does this mean?
Thank You,

*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



Re: No package found

Posted by Martin Gainty <mg...@hotmail.com>.
its the vendor's responsibility to either inundate the implementor with debug information or throttle the logs back for production run
Just my 2 farthings,
M-

P.S
How come your timestamp says 12:23 instead of 17:23???

*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



----- Original Message ----- 
From: "Steve Loughran" <st...@apache.org>
To: "Ant Users List" <us...@ant.apache.org>
Sent: Friday, May 26, 2006 12:23 PM
Subject: Re: No package found


> Martin Gainty wrote:
>> Good Evening from across the pond-
>> 
>> As far as changing text strings I can see this as useful for language conversion and going with locale specific Resource implementation
>> but I cant see the benefit of that feature 
>> *unless you can put in something like a 'turbo switch' which will ignore package specifications*
>> 
> 
> I was thinking more of 'how do we replace an error message that nobody 
> without source access understands to one that is comprehensible'
> 
>> Cheers,
>> Martin-
>> *********************************************************************
>> This email message and any files transmitted with it contain confidential
>> information intended only for the person(s) to whom this email message is
>> addressed.  If you have received this email message in error, please notify
>> the sender immediately by telephone or email and destroy the original
>> message without making a copy.  Thank you.
>> 
>> 
>> 
>> ----- Original Message ----- 
>> From: "Steve Loughran" <st...@apache.org>
>> To: "Ant Users List" <us...@ant.apache.org>
>> Sent: Friday, May 26, 2006 9:57 AM
>> Subject: Re: No package found
>> 
>> 
>> 
>>>Martin Gainty wrote:
>>>
>>>>Heres my take
>>>>If I am coding a once - y thing and it WORKS and I say wait a minute
>>>>this is a waste of time since I am doing the SAME operation for all entities in a container
>>>>namely all file(s) in the folder
>>>>then I extract out the file specific stuff namely filename.extension and then use the folder spec
>>>>
>>>>the level of sophistication of Java Developer should know that when I point to this source folder thats it
>>>>If my equipment is pointing at the Sun when I should be pointing at Mars I might fry the equipment thats ok
>>>>after all we're all professionals and we're supposed to know what we're doing..I said supposed to
>>>>
>>>>My suggestions is Dont look for packages or anything else..thats way too much handlholding besides thats the implementor's job
>>>
>>>I think the problem is the same as with javac, or java, its not enough 
>>>to hand off files to the tool, you need to hand of files in the right 
>>>package hierarchy. Ant tasks do have to know what params to send down to 
>>>javadoc, and if you look at those options its clearly a complex beast. 
>>>If you look at the command line options, it seems to want to know about 
>>>packages to exclude and subpackages too.
>>>
>>>i.e. javadoc command line takes
>>>-a list of packages
>>>-a list of files in the root folder
>>>
>>>Ant works backwards from directories with java files in (or package.html 
>>>files) to create a list of packages.
>>>
>>>so i'd conclude that yes, we do need to know about packages. A file 
>>>submitted as a self contained file will be assumed to be in the default 
>>>package, not in some sub package that is somehow guess.
>>>
>>>
>>>What could be done is to improve the error messages to make it clear 
>>>what is going on and provide hints as how to fix the build file. A URL 
>>>to a wiki entry would be one option, e.g.
>>>
>>>[info] skipping empty package, see 
>>>http://ant.apache.org/wiki/messages/javadoc#packages
>>>
>>>
>>>
>>>
>>>>So the same functionality that works for srcdir should work the SAME for sourcepath except its not looking for a specific file its looking at the folder..
>>>>
>>>
>>>
>>>>Other than that...Hows life in oregon these days??
>>>
>>>wouldnt know. UK now. Got bored with all the skiing, mountain biking, 
>>>sunny summers.
>>>
>>>
>>>>As always Its expensive living here in the democratic republic ...
>>>
>>>
>>>I thought it was now the FDR, not the DDR ;?
>>>
>>>>Thanks Steve,
>>>>M-
>>>
>>>-steve
>>>
>>>---------------------------------------------------------------------
>>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>>For additional commands, e-mail: user-help@ant.apache.org
>>>
>>>
>> 
>> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
> 
>

Re: No package found

Posted by Steve Loughran <st...@apache.org>.
Martin Gainty wrote:
> Good Evening from across the pond-
> 
> As far as changing text strings I can see this as useful for language conversion and going with locale specific Resource implementation
> but I cant see the benefit of that feature 
> *unless you can put in something like a 'turbo switch' which will ignore package specifications*
> 

I was thinking more of 'how do we replace an error message that nobody 
without source access understands to one that is comprehensible'

> Cheers,
> Martin-
> *********************************************************************
> This email message and any files transmitted with it contain confidential
> information intended only for the person(s) to whom this email message is
> addressed.  If you have received this email message in error, please notify
> the sender immediately by telephone or email and destroy the original
> message without making a copy.  Thank you.
> 
> 
> 
> ----- Original Message ----- 
> From: "Steve Loughran" <st...@apache.org>
> To: "Ant Users List" <us...@ant.apache.org>
> Sent: Friday, May 26, 2006 9:57 AM
> Subject: Re: No package found
> 
> 
> 
>>Martin Gainty wrote:
>>
>>>Heres my take
>>>If I am coding a once - y thing and it WORKS and I say wait a minute
>>>this is a waste of time since I am doing the SAME operation for all entities in a container
>>>namely all file(s) in the folder
>>>then I extract out the file specific stuff namely filename.extension and then use the folder spec
>>>
>>>the level of sophistication of Java Developer should know that when I point to this source folder thats it
>>>If my equipment is pointing at the Sun when I should be pointing at Mars I might fry the equipment thats ok
>>>after all we're all professionals and we're supposed to know what we're doing..I said supposed to
>>>
>>>My suggestions is Dont look for packages or anything else..thats way too much handlholding besides thats the implementor's job
>>
>>I think the problem is the same as with javac, or java, its not enough 
>>to hand off files to the tool, you need to hand of files in the right 
>>package hierarchy. Ant tasks do have to know what params to send down to 
>>javadoc, and if you look at those options its clearly a complex beast. 
>>If you look at the command line options, it seems to want to know about 
>>packages to exclude and subpackages too.
>>
>>i.e. javadoc command line takes
>>-a list of packages
>>-a list of files in the root folder
>>
>>Ant works backwards from directories with java files in (or package.html 
>>files) to create a list of packages.
>>
>>so i'd conclude that yes, we do need to know about packages. A file 
>>submitted as a self contained file will be assumed to be in the default 
>>package, not in some sub package that is somehow guess.
>>
>>
>>What could be done is to improve the error messages to make it clear 
>>what is going on and provide hints as how to fix the build file. A URL 
>>to a wiki entry would be one option, e.g.
>>
>>[info] skipping empty package, see 
>>http://ant.apache.org/wiki/messages/javadoc#packages
>>
>>
>>
>>
>>>So the same functionality that works for srcdir should work the SAME for sourcepath except its not looking for a specific file its looking at the folder..
>>>
>>
>>
>>>Other than that...Hows life in oregon these days??
>>
>>wouldnt know. UK now. Got bored with all the skiing, mountain biking, 
>>sunny summers.
>>
>>
>>>As always Its expensive living here in the democratic republic ...
>>
>>
>>I thought it was now the FDR, not the DDR ;?
>>
>>>Thanks Steve,
>>>M-
>>
>>-steve
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>For additional commands, e-mail: user-help@ant.apache.org
>>
>>
> 
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org


Re: No package found

Posted by Martin Gainty <mg...@hotmail.com>.
Good Evening from across the pond-

As far as changing text strings I can see this as useful for language conversion and going with locale specific Resource implementation
but I cant see the benefit of that feature 
*unless you can put in something like a 'turbo switch' which will ignore package specifications*

Cheers,
Martin-
*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



----- Original Message ----- 
From: "Steve Loughran" <st...@apache.org>
To: "Ant Users List" <us...@ant.apache.org>
Sent: Friday, May 26, 2006 9:57 AM
Subject: Re: No package found


> Martin Gainty wrote:
>> Heres my take
>> If I am coding a once - y thing and it WORKS and I say wait a minute
>> this is a waste of time since I am doing the SAME operation for all entities in a container
>> namely all file(s) in the folder
>> then I extract out the file specific stuff namely filename.extension and then use the folder spec
>> 
>> the level of sophistication of Java Developer should know that when I point to this source folder thats it
>> If my equipment is pointing at the Sun when I should be pointing at Mars I might fry the equipment thats ok
>> after all we're all professionals and we're supposed to know what we're doing..I said supposed to
>> 
>> My suggestions is Dont look for packages or anything else..thats way too much handlholding besides thats the implementor's job
> 
> I think the problem is the same as with javac, or java, its not enough 
> to hand off files to the tool, you need to hand of files in the right 
> package hierarchy. Ant tasks do have to know what params to send down to 
> javadoc, and if you look at those options its clearly a complex beast. 
> If you look at the command line options, it seems to want to know about 
> packages to exclude and subpackages too.
> 
> i.e. javadoc command line takes
> -a list of packages
> -a list of files in the root folder
> 
> Ant works backwards from directories with java files in (or package.html 
> files) to create a list of packages.
> 
> so i'd conclude that yes, we do need to know about packages. A file 
> submitted as a self contained file will be assumed to be in the default 
> package, not in some sub package that is somehow guess.
> 
> 
> What could be done is to improve the error messages to make it clear 
> what is going on and provide hints as how to fix the build file. A URL 
> to a wiki entry would be one option, e.g.
> 
> [info] skipping empty package, see 
> http://ant.apache.org/wiki/messages/javadoc#packages
> 
> 
> 
>> 
>> So the same functionality that works for srcdir should work the SAME for sourcepath except its not looking for a specific file its looking at the folder..
>> 
> 
> 
>> Other than that...Hows life in oregon these days??
> 
> wouldnt know. UK now. Got bored with all the skiing, mountain biking, 
> sunny summers.
> 
>> As always Its expensive living here in the democratic republic ...
> 
> 
> I thought it was now the FDR, not the DDR ;?
>> 
>> Thanks Steve,
>> M-
> 
> -steve
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
> 
>

Re: No package found

Posted by Steve Loughran <st...@apache.org>.
Martin Gainty wrote:
> Heres my take
> If I am coding a once - y thing and it WORKS and I say wait a minute
> this is a waste of time since I am doing the SAME operation for all entities in a container
> namely all file(s) in the folder
> then I extract out the file specific stuff namely filename.extension and then use the folder spec
> 
> the level of sophistication of Java Developer should know that when I point to this source folder thats it
> If my equipment is pointing at the Sun when I should be pointing at Mars I might fry the equipment thats ok
> after all we're all professionals and we're supposed to know what we're doing..I said supposed to
> 
> My suggestions is Dont look for packages or anything else..thats way too much handlholding besides thats the implementor's job

I think the problem is the same as with javac, or java, its not enough 
to hand off files to the tool, you need to hand of files in the right 
package hierarchy. Ant tasks do have to know what params to send down to 
javadoc, and if you look at those options its clearly a complex beast. 
If you look at the command line options, it seems to want to know about 
packages to exclude and subpackages too.

i.e. javadoc command line takes
-a list of packages
-a list of files in the root folder

Ant works backwards from directories with java files in (or package.html 
files) to create a list of packages.

so i'd conclude that yes, we do need to know about packages. A file 
submitted as a self contained file will be assumed to be in the default 
package, not in some sub package that is somehow guess.


What could be done is to improve the error messages to make it clear 
what is going on and provide hints as how to fix the build file. A URL 
to a wiki entry would be one option, e.g.

[info] skipping empty package, see 
http://ant.apache.org/wiki/messages/javadoc#packages



> 
> So the same functionality that works for srcdir should work the SAME for sourcepath except its not looking for a specific file its looking at the folder..
> 


> Other than that...Hows life in oregon these days??

wouldnt know. UK now. Got bored with all the skiing, mountain biking, 
sunny summers.

> As always Its expensive living here in the democratic republic ...


I thought it was now the FDR, not the DDR ;?
> 
> Thanks Steve,
> M-

-steve

---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org


Re: No package found

Posted by Martin Gainty <mg...@hotmail.com>.
Heres my take
If I am coding a once - y thing and it WORKS and I say wait a minute
this is a waste of time since I am doing the SAME operation for all entities in a container
namely all file(s) in the folder
then I extract out the file specific stuff namely filename.extension and then use the folder spec

the level of sophistication of Java Developer should know that when I point to this source folder thats it
If my equipment is pointing at the Sun when I should be pointing at Mars I might fry the equipment thats ok
after all we're all professionals and we're supposed to know what we're doing..I said supposed to

My suggestions is Dont look for packages or anything else..thats way too much handlholding besides thats the implementor's job

So the same functionality that works for srcdir should work the SAME for sourcepath except its not looking for a specific file its looking at the folder..

Other than that...Hows life in oregon these days??
As always Its expensive living here in the democratic republic ...

Thanks Steve,
M-

*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



----- Original Message ----- 
From: "Steve Loughran" <st...@apache.org>
To: "Ant Users List" <us...@ant.apache.org>
Sent: Thursday, May 25, 2006 4:45 PM
Subject: Re: No package found


> Martin Gainty wrote:
>> Javadoc task produces "folder does not contain any package"
>> What does this mean?
>> Thank You,
>> 
> 
> I dont see this string in the current version, but there is something 
> very similar,
> 
>                 log(baseDir + " doesn\'t contain any packages, dropping 
> it.",
>                     Project.MSG_VERBOSE);
> 
> What the code is doing is scanning the filesets for directories 
> containing java files and or, if includenosourcedirs is set, 
> package.html files. If it only finds .java source in the toplevel file 
> it complains that these should be passed in as files, not a package. If 
> it completes its scan without finding anything to hand off to javadoc, 
> you see the message.
> 
> 1. is the message correct or is it missing something?
> 
> 2. what do you think the message should be changed to, to make it more 
> meaningful without being 20 lines long?
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
> 
>

Re: No package found

Posted by Steve Loughran <st...@apache.org>.
Martin Gainty wrote:
> Javadoc task produces "folder does not contain any package"
> What does this mean?
> Thank You,
> 

I dont see this string in the current version, but there is something 
very similar,

                 log(baseDir + " doesn\'t contain any packages, dropping 
it.",
                     Project.MSG_VERBOSE);

What the code is doing is scanning the filesets for directories 
containing java files and or, if includenosourcedirs is set, 
package.html files. If it only finds .java source in the toplevel file 
it complains that these should be passed in as files, not a package. If 
it completes its scan without finding anything to hand off to javadoc, 
you see the message.

1. is the message correct or is it missing something?

2. what do you think the message should be changed to, to make it more 
meaningful without being 20 lines long?

---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org


Re: No package found

Posted by Martin Gainty <mg...@hotmail.com>.
Good Afternoon All-

Apparently sourcepath attribute doesnt parse the value assigned inside Javadoc task 
If inside the <javadoc task you specify
sourcefiles="SourceFolder/Java1.java,SourceFolder/Java2.java" 
the JavaDoc task will parse and pick up the specific files but 
if you specify sourcepath="SourceFolder" in other words specify the SAME folder that previous sourcefiles had used 
the javadoc task ignores sourcepath and produces bogus message about 
Im going to enter this as a bug into bugzilla
As a FYI this is Ant 1.6.3
JDK 1.5.0_06

Vielen Danke,
Martin -
*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



----- Original Message ----- 
From: "Martin Gainty" <mg...@hotmail.com>
To: "Ant Developers List" <de...@ant.apache.org>
Cc: "Ant Users List" <us...@ant.apache.org>
Sent: Thursday, May 25, 2006 3:53 PM
Subject: No package found


Javadoc task produces "folder does not contain any package"
What does this mean?
Thank You,

*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



Re: No package found

Posted by Martin Gainty <mg...@hotmail.com>.
Good Afternoon All-

Apparently sourcepath attribute doesnt parse the value assigned inside Javadoc task 
If inside the <javadoc task you specify
sourcefiles="SourceFolder/Java1.java,SourceFolder/Java2.java" 
the JavaDoc task will parse and pick up the specific files but 
if you specify sourcepath="SourceFolder" in other words specify the SAME folder that previous sourcefiles had used 
the javadoc task ignores sourcepath and produces bogus message about 
Im going to enter this as a bug into bugzilla
As a FYI this is Ant 1.6.3
JDK 1.5.0_06

Vielen Danke,
Martin -
*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.



----- Original Message ----- 
From: "Martin Gainty" <mg...@hotmail.com>
To: "Ant Developers List" <de...@ant.apache.org>
Cc: "Ant Users List" <us...@ant.apache.org>
Sent: Thursday, May 25, 2006 3:53 PM
Subject: No package found


Javadoc task produces "folder does not contain any package"
What does this mean?
Thank You,

*********************************************************************
This email message and any files transmitted with it contain confidential
information intended only for the person(s) to whom this email message is
addressed.  If you have received this email message in error, please notify
the sender immediately by telephone or email and destroy the original
message without making a copy.  Thank you.