You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@ant.apache.org by Res Pons <po...@hotmail.com> on 2007/04/06 06:28:18 UTC
javadoc
Almost wrong forum, I know...but...
I would like to test and run javadoc at a DOS prompt before writing ant code
for it but the problem is that when I cd into my project and execute the
following, I get an error1 and nothing happens.
c:\>cd Builds\project1
C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
javadocs
javadoc: error - File not found: "*.java"
1 error
How come javadoc is not recursing through my subfolders?
_________________________________________________________________
Get a FREE Web site, company branded e-mail and more from Microsoft Office
Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by Res Pons <po...@hotmail.com>.
Thank you for all your help. I will just do it in Ant, why reinvent the
whee?
----Original Message Follows----
From: "Scot P. Floess" <fl...@mindspring.com>
Reply-To: floess@mindspring.com
To: Ant Users List <us...@ant.apache.org>
Subject: Re: javadoc
Date: Tue, 10 Apr 2007 17:31:55 -0400
Res:
Yeah you do...that's why I recommended the Ant way :)
Scot
Res Pons wrote:
>Thanks for all your help. Be it in Dos/Batch or Linux/Shell, it looks like
>you have to traverse through dirs and subdirs as javadoc clearly does not
>understand recursing by itself. One of our engineers had confused me by
>saying that java doc should be able to recurse by itself w/o me telling it
>to.
>
>Looking at your scripts I see that I was basically doing the same thing in
>DOS.
>
>Thanks again
>
>----Original Message Follows----
>From: "Scot P. Floess" <fl...@mindspring.com>
>Reply-To: floess@mindspring.com
>To: Ant Users List <us...@ant.apache.org>
>Subject: Re: javadoc
>Date: Mon, 09 Apr 2007 20:27:26 -0400
>
>Res:
>
>I have very little experience writing Windows batch files - much better
>versed at Linux/Unix. With that said, here is how I would do javadoc where
>I want to output to a directory entitled "foo," and source code that exists
>in the current directory within a directory entitled "java":
>
>javadoc -d foo -sourcepath java `find . -type f -name \*.java`
>
>Regarding your additional requirement in which you wish to javadoc against
>3 directories, I'd probably do something like so:
>
>allDirs="proj1/src proj2/src proj3/src"
>for aDir in ${allDirs}
>do
> javadoc -d foo -sourcepath ${aDir} `find ${aDir} -type f -name \*.java`
>done
>
>Or something like it...clearly you can get as fancy as you want :)
>
>Scot
>
>Res Pons wrote:
>>Scot
>>
>>Thanks for your reply. I would like to do this in Ant eventually but I
>>think it would be easier for me to understand it in dos/batch before I
>>tackle it in Ant. I was originally doing a for-loop but one of our
>>engineers told me it's wrong:
>>
>>c:\masterproject>for /r %i in (*.java) do javadoc.exe %i -d mydocs
>>
>>Basically I'm starting at the root and looping/recursing down every path
>>and looking for all .java files. Is this not correct?
>>
>>
>>
>>----Original Message Follows----
>>From: "Scot P. Floess" <fl...@mindspring.com>
>>Reply-To: floess@mindspring.com
>>To: Ant Users List <us...@ant.apache.org>
>>Subject: Re: javadoc
>>Date: Mon, 09 Apr 2007 18:04:57 -0400
>>
>>Res:
>>
>>You are gonna need to specify all the java files to javadoc against...
>>
>>Type javadoc at the command line and it will tell you so :)
>>
>>If you were on a *nix environment you could do something with find...
>>
>>Curious...why don't you want to do this with Ant in your experimentation?
>>Clearly it does so much for you (for instance iterating down in the
>>dirs)...
>>
>>
>>Res Pons wrote:
>>>Reposting again.
>>>
>>>Shouldn't javadoc automatically recurse through directories? It doesn't
>>>for me. I would like to run javadoc at the root of all my projects w/o
>>>telling it it each .java file. We have a multi-project platform all
>>>residing within a master project and each having their own src subfolder
>>>and many .java source files:
>>>
>>>MasterProject
>>> proj1
>>> -src
>>> proj2
>>> -src
>>> proj3
>>> -src
>>>
>>>The command below, in my original email, does not work for me. But if I
>>>generate a for-loop at the DOS prompt from the root of all the projects,
>>>I get it to work but the result is is not correct. All the examples out
>>>there are geared toward a single project. How can I get javadoc to
>>>recurse automatically? I do not see a command line option. Once I
>>>successfully run this at the command prompt or from a batch file, I will
>>>then convert it to Ant/xml.
>>>
>>>Thanks
>>>
>>>----Original Message Follows----
>>>From: "Res Pons" <po...@hotmail.com>
>>>Reply-To: "Ant Users List" <us...@ant.apache.org>
>>>To: user@ant.apache.org
>>>Subject: javadoc
>>>Date: Thu, 05 Apr 2007 21:28:18 -0700
>>>
>>>Almost wrong forum, I know...but...
>>>
>>>I would like to test and run javadoc at a DOS prompt before writing ant
>>>code for it but the problem is that when I cd into my project and execute
>>>the following, I get an error1 and nothing happens.
>>>
>>>c:\>cd Builds\project1
>>>C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
>>>javadocs
>>>
>>>javadoc: error - File not found: "*.java"
>>>1 error
>>>
>>>How come javadoc is not recursing through my subfolders?
>>>
>>>_________________________________________________________________
>>>Get a FREE Web site, company branded e-mail and more from Microsoft
>>>Office Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>>>
>>>
>>>---------------------------------------------------------------------
>>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>>For additional commands, e-mail: user-help@ant.apache.org
>>>
>>>_________________________________________________________________
>>>Need a break? Find your escape route with Live Search Maps.
>>>http://maps.live.com/?icid=hmtag3
>>>
>>>
>>>---------------------------------------------------------------------
>>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>>For additional commands, e-mail: user-help@ant.apache.org
>>>
>>>
>>
>>--
>>Scot P. Floess
>>27 Lake Royale
>>Louisburg, NC 27549
>>
>>252-478-8087 (Home)
>>919-392-6730 (Work)
>>
>>Chief Architect JPlate http://sourceforge.net/projects/jplate
>>Chief Architect JavaPIM http://sourceforge.net/projects/javapim
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>For additional commands, e-mail: user-help@ant.apache.org
>>
>>_________________________________________________________________
>>Get a FREE Web site, company branded e-mail and more from Microsoft Office
>>Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>For additional commands, e-mail: user-help@ant.apache.org
>>
>>
>
>--
>Scot P. Floess
>27 Lake Royale
>Louisburg, NC 27549
>
>252-478-8087 (Home)
>919-392-6730 (Work)
>
>Chief Architect JPlate http://sourceforge.net/projects/jplate
>Chief Architect JavaPIM http://sourceforge.net/projects/javapim
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>For additional commands, e-mail: user-help@ant.apache.org
>
>_________________________________________________________________
>Need a break? Find your escape route with Live Search Maps.
>http://maps.live.com/?icid=hmtag3
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
_________________________________________________________________
Download Messenger. Join the im Initiative. Help make a difference today.
http://im.live.com/messenger/im/home/?source=TAGHM_APR07
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by "Scot P. Floess" <fl...@mindspring.com>.
Res:
Yeah you do...that's why I recommended the Ant way :)
Scot
Res Pons wrote:
> Thanks for all your help. Be it in Dos/Batch or Linux/Shell, it looks
> like you have to traverse through dirs and subdirs as javadoc clearly
> does not understand recursing by itself. One of our engineers had
> confused me by saying that java doc should be able to recurse by
> itself w/o me telling it to.
>
> Looking at your scripts I see that I was basically doing the same
> thing in DOS.
>
> Thanks again
>
> ----Original Message Follows----
> From: "Scot P. Floess" <fl...@mindspring.com>
> Reply-To: floess@mindspring.com
> To: Ant Users List <us...@ant.apache.org>
> Subject: Re: javadoc
> Date: Mon, 09 Apr 2007 20:27:26 -0400
>
> Res:
>
> I have very little experience writing Windows batch files - much
> better versed at Linux/Unix. With that said, here is how I would do
> javadoc where I want to output to a directory entitled "foo," and
> source code that exists in the current directory within a directory
> entitled "java":
>
> javadoc -d foo -sourcepath java `find . -type f -name \*.java`
>
> Regarding your additional requirement in which you wish to javadoc
> against 3 directories, I'd probably do something like so:
>
> allDirs="proj1/src proj2/src proj3/src"
> for aDir in ${allDirs}
> do
> javadoc -d foo -sourcepath ${aDir} `find ${aDir} -type f -name
> \*.java`
> done
>
> Or something like it...clearly you can get as fancy as you want :)
>
> Scot
>
> Res Pons wrote:
>> Scot
>>
>> Thanks for your reply. I would like to do this in Ant eventually but
>> I think it would be easier for me to understand it in dos/batch
>> before I tackle it in Ant. I was originally doing a for-loop but one
>> of our engineers told me it's wrong:
>>
>> c:\masterproject>for /r %i in (*.java) do javadoc.exe %i -d mydocs
>>
>> Basically I'm starting at the root and looping/recursing down every
>> path and looking for all .java files. Is this not correct?
>>
>>
>>
>> ----Original Message Follows----
>> From: "Scot P. Floess" <fl...@mindspring.com>
>> Reply-To: floess@mindspring.com
>> To: Ant Users List <us...@ant.apache.org>
>> Subject: Re: javadoc
>> Date: Mon, 09 Apr 2007 18:04:57 -0400
>>
>> Res:
>>
>> You are gonna need to specify all the java files to javadoc against...
>>
>> Type javadoc at the command line and it will tell you so :)
>>
>> If you were on a *nix environment you could do something with find...
>>
>> Curious...why don't you want to do this with Ant in your
>> experimentation? Clearly it does so much for you (for instance
>> iterating down in the dirs)...
>>
>>
>> Res Pons wrote:
>>> Reposting again.
>>>
>>> Shouldn't javadoc automatically recurse through directories? It
>>> doesn't for me. I would like to run javadoc at the root of all my
>>> projects w/o telling it it each .java file. We have a multi-project
>>> platform all residing within a master project and each having their
>>> own src subfolder and many .java source files:
>>>
>>> MasterProject
>>> proj1
>>> -src
>>> proj2
>>> -src
>>> proj3
>>> -src
>>>
>>> The command below, in my original email, does not work for me. But
>>> if I generate a for-loop at the DOS prompt from the root of all the
>>> projects, I get it to work but the result is is not correct. All
>>> the examples out there are geared toward a single project. How can
>>> I get javadoc to recurse automatically? I do not see a command line
>>> option. Once I successfully run this at the command prompt or from
>>> a batch file, I will then convert it to Ant/xml.
>>>
>>> Thanks
>>>
>>> ----Original Message Follows----
>>> From: "Res Pons" <po...@hotmail.com>
>>> Reply-To: "Ant Users List" <us...@ant.apache.org>
>>> To: user@ant.apache.org
>>> Subject: javadoc
>>> Date: Thu, 05 Apr 2007 21:28:18 -0700
>>>
>>> Almost wrong forum, I know...but...
>>>
>>> I would like to test and run javadoc at a DOS prompt before writing
>>> ant code for it but the problem is that when I cd into my project
>>> and execute the following, I get an error1 and nothing happens.
>>>
>>> c:\>cd Builds\project1
>>> C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr
>>> *.java -d javadocs
>>>
>>> javadoc: error - File not found: "*.java"
>>> 1 error
>>>
>>> How come javadoc is not recursing through my subfolders?
>>>
>>> _________________________________________________________________
>>> Get a FREE Web site, company branded e-mail and more from Microsoft
>>> Office Live!
>>> http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>> For additional commands, e-mail: user-help@ant.apache.org
>>>
>>> _________________________________________________________________
>>> Need a break? Find your escape route with Live Search Maps.
>>> http://maps.live.com/?icid=hmtag3
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>> For additional commands, e-mail: user-help@ant.apache.org
>>>
>>>
>>
>> --
>> Scot P. Floess
>> 27 Lake Royale
>> Louisburg, NC 27549
>>
>> 252-478-8087 (Home)
>> 919-392-6730 (Work)
>>
>> Chief Architect JPlate http://sourceforge.net/projects/jplate
>> Chief Architect JavaPIM http://sourceforge.net/projects/javapim
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>> For additional commands, e-mail: user-help@ant.apache.org
>>
>> _________________________________________________________________
>> Get a FREE Web site, company branded e-mail and more from Microsoft
>> Office Live!
>> http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>> For additional commands, e-mail: user-help@ant.apache.org
>>
>>
>
> --
> Scot P. Floess
> 27 Lake Royale
> Louisburg, NC 27549
>
> 252-478-8087 (Home)
> 919-392-6730 (Work)
>
> Chief Architect JPlate http://sourceforge.net/projects/jplate
> Chief Architect JavaPIM http://sourceforge.net/projects/javapim
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
> _________________________________________________________________
> Need a break? Find your escape route with Live Search Maps.
> http://maps.live.com/?icid=hmtag3
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by Res Pons <po...@hotmail.com>.
Thanks for all your help. Be it in Dos/Batch or Linux/Shell, it looks like
you have to traverse through dirs and subdirs as javadoc clearly does not
understand recursing by itself. One of our engineers had confused me by
saying that java doc should be able to recurse by itself w/o me telling it
to.
Looking at your scripts I see that I was basically doing the same thing in
DOS.
Thanks again
----Original Message Follows----
From: "Scot P. Floess" <fl...@mindspring.com>
Reply-To: floess@mindspring.com
To: Ant Users List <us...@ant.apache.org>
Subject: Re: javadoc
Date: Mon, 09 Apr 2007 20:27:26 -0400
Res:
I have very little experience writing Windows batch files - much better
versed at Linux/Unix. With that said, here is how I would do javadoc where
I want to output to a directory entitled "foo," and source code that exists
in the current directory within a directory entitled "java":
javadoc -d foo -sourcepath java `find . -type f -name \*.java`
Regarding your additional requirement in which you wish to javadoc against 3
directories, I'd probably do something like so:
allDirs="proj1/src proj2/src proj3/src"
for aDir in ${allDirs}
do
javadoc -d foo -sourcepath ${aDir} `find ${aDir} -type f -name \*.java`
done
Or something like it...clearly you can get as fancy as you want :)
Scot
Res Pons wrote:
>Scot
>
>Thanks for your reply. I would like to do this in Ant eventually but I
>think it would be easier for me to understand it in dos/batch before I
>tackle it in Ant. I was originally doing a for-loop but one of our
>engineers told me it's wrong:
>
>c:\masterproject>for /r %i in (*.java) do javadoc.exe %i -d mydocs
>
>Basically I'm starting at the root and looping/recursing down every path
>and looking for all .java files. Is this not correct?
>
>
>
>----Original Message Follows----
>From: "Scot P. Floess" <fl...@mindspring.com>
>Reply-To: floess@mindspring.com
>To: Ant Users List <us...@ant.apache.org>
>Subject: Re: javadoc
>Date: Mon, 09 Apr 2007 18:04:57 -0400
>
>Res:
>
>You are gonna need to specify all the java files to javadoc against...
>
>Type javadoc at the command line and it will tell you so :)
>
>If you were on a *nix environment you could do something with find...
>
>Curious...why don't you want to do this with Ant in your experimentation?
>Clearly it does so much for you (for instance iterating down in the
>dirs)...
>
>
>Res Pons wrote:
>>Reposting again.
>>
>>Shouldn't javadoc automatically recurse through directories? It doesn't
>>for me. I would like to run javadoc at the root of all my projects w/o
>>telling it it each .java file. We have a multi-project platform all
>>residing within a master project and each having their own src subfolder
>>and many .java source files:
>>
>>MasterProject
>> proj1
>> -src
>> proj2
>> -src
>> proj3
>> -src
>>
>>The command below, in my original email, does not work for me. But if I
>>generate a for-loop at the DOS prompt from the root of all the projects, I
>>get it to work but the result is is not correct. All the examples out
>>there are geared toward a single project. How can I get javadoc to
>>recurse automatically? I do not see a command line option. Once I
>>successfully run this at the command prompt or from a batch file, I will
>>then convert it to Ant/xml.
>>
>>Thanks
>>
>>----Original Message Follows----
>>From: "Res Pons" <po...@hotmail.com>
>>Reply-To: "Ant Users List" <us...@ant.apache.org>
>>To: user@ant.apache.org
>>Subject: javadoc
>>Date: Thu, 05 Apr 2007 21:28:18 -0700
>>
>>Almost wrong forum, I know...but...
>>
>>I would like to test and run javadoc at a DOS prompt before writing ant
>>code for it but the problem is that when I cd into my project and execute
>>the following, I get an error1 and nothing happens.
>>
>>c:\>cd Builds\project1
>>C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
>>javadocs
>>
>>javadoc: error - File not found: "*.java"
>>1 error
>>
>>How come javadoc is not recursing through my subfolders?
>>
>>_________________________________________________________________
>>Get a FREE Web site, company branded e-mail and more from Microsoft Office
>>Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>For additional commands, e-mail: user-help@ant.apache.org
>>
>>_________________________________________________________________
>>Need a break? Find your escape route with Live Search Maps.
>>http://maps.live.com/?icid=hmtag3
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>>For additional commands, e-mail: user-help@ant.apache.org
>>
>>
>
>--
>Scot P. Floess
>27 Lake Royale
>Louisburg, NC 27549
>
>252-478-8087 (Home)
>919-392-6730 (Work)
>
>Chief Architect JPlate http://sourceforge.net/projects/jplate
>Chief Architect JavaPIM http://sourceforge.net/projects/javapim
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>For additional commands, e-mail: user-help@ant.apache.org
>
>_________________________________________________________________
>Get a FREE Web site, company branded e-mail and more from Microsoft Office
>Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
_________________________________________________________________
Need a break? Find your escape route with Live Search Maps.
http://maps.live.com/?icid=hmtag3
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by "Scot P. Floess" <fl...@mindspring.com>.
Res:
I have very little experience writing Windows batch files - much better
versed at Linux/Unix. With that said, here is how I would do javadoc
where I want to output to a directory entitled "foo," and source code
that exists in the current directory within a directory entitled "java":
javadoc -d foo -sourcepath java `find . -type f -name \*.java`
Regarding your additional requirement in which you wish to javadoc
against 3 directories, I'd probably do something like so:
allDirs="proj1/src proj2/src proj3/src"
for aDir in ${allDirs}
do
javadoc -d foo -sourcepath ${aDir} `find ${aDir} -type f -name \*.java`
done
Or something like it...clearly you can get as fancy as you want :)
Scot
Res Pons wrote:
> Scot
>
> Thanks for your reply. I would like to do this in Ant eventually but
> I think it would be easier for me to understand it in dos/batch before
> I tackle it in Ant. I was originally doing a for-loop but one of our
> engineers told me it's wrong:
>
> c:\masterproject>for /r %i in (*.java) do javadoc.exe %i -d mydocs
>
> Basically I'm starting at the root and looping/recursing down every
> path and looking for all .java files. Is this not correct?
>
>
>
> ----Original Message Follows----
> From: "Scot P. Floess" <fl...@mindspring.com>
> Reply-To: floess@mindspring.com
> To: Ant Users List <us...@ant.apache.org>
> Subject: Re: javadoc
> Date: Mon, 09 Apr 2007 18:04:57 -0400
>
> Res:
>
> You are gonna need to specify all the java files to javadoc against...
>
> Type javadoc at the command line and it will tell you so :)
>
> If you were on a *nix environment you could do something with find...
>
> Curious...why don't you want to do this with Ant in your
> experimentation? Clearly it does so much for you (for instance
> iterating down in the dirs)...
>
>
> Res Pons wrote:
>> Reposting again.
>>
>> Shouldn't javadoc automatically recurse through directories? It
>> doesn't for me. I would like to run javadoc at the root of all my
>> projects w/o telling it it each .java file. We have a multi-project
>> platform all residing within a master project and each having their
>> own src subfolder and many .java source files:
>>
>> MasterProject
>> proj1
>> -src
>> proj2
>> -src
>> proj3
>> -src
>>
>> The command below, in my original email, does not work for me. But
>> if I generate a for-loop at the DOS prompt from the root of all the
>> projects, I get it to work but the result is is not correct. All the
>> examples out there are geared toward a single project. How can I get
>> javadoc to recurse automatically? I do not see a command line
>> option. Once I successfully run this at the command prompt or from a
>> batch file, I will then convert it to Ant/xml.
>>
>> Thanks
>>
>> ----Original Message Follows----
>> From: "Res Pons" <po...@hotmail.com>
>> Reply-To: "Ant Users List" <us...@ant.apache.org>
>> To: user@ant.apache.org
>> Subject: javadoc
>> Date: Thu, 05 Apr 2007 21:28:18 -0700
>>
>> Almost wrong forum, I know...but...
>>
>> I would like to test and run javadoc at a DOS prompt before writing
>> ant code for it but the problem is that when I cd into my project and
>> execute the following, I get an error1 and nothing happens.
>>
>> c:\>cd Builds\project1
>> C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr
>> *.java -d javadocs
>>
>> javadoc: error - File not found: "*.java"
>> 1 error
>>
>> How come javadoc is not recursing through my subfolders?
>>
>> _________________________________________________________________
>> Get a FREE Web site, company branded e-mail and more from Microsoft
>> Office Live!
>> http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>> For additional commands, e-mail: user-help@ant.apache.org
>>
>> _________________________________________________________________
>> Need a break? Find your escape route with Live Search Maps.
>> http://maps.live.com/?icid=hmtag3
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>> For additional commands, e-mail: user-help@ant.apache.org
>>
>>
>
> --
> Scot P. Floess
> 27 Lake Royale
> Louisburg, NC 27549
>
> 252-478-8087 (Home)
> 919-392-6730 (Work)
>
> Chief Architect JPlate http://sourceforge.net/projects/jplate
> Chief Architect JavaPIM http://sourceforge.net/projects/javapim
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
> _________________________________________________________________
> Get a FREE Web site, company branded e-mail and more from Microsoft
> Office Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by Res Pons <po...@hotmail.com>.
Scot
Thanks for your reply. I would like to do this in Ant eventually but I
think it would be easier for me to understand it in dos/batch before I
tackle it in Ant. I was originally doing a for-loop but one of our
engineers told me it's wrong:
c:\masterproject>for /r %i in (*.java) do javadoc.exe %i -d mydocs
Basically I'm starting at the root and looping/recursing down every path and
looking for all .java files. Is this not correct?
----Original Message Follows----
From: "Scot P. Floess" <fl...@mindspring.com>
Reply-To: floess@mindspring.com
To: Ant Users List <us...@ant.apache.org>
Subject: Re: javadoc
Date: Mon, 09 Apr 2007 18:04:57 -0400
Res:
You are gonna need to specify all the java files to javadoc against...
Type javadoc at the command line and it will tell you so :)
If you were on a *nix environment you could do something with find...
Curious...why don't you want to do this with Ant in your experimentation?
Clearly it does so much for you (for instance iterating down in the dirs)...
Res Pons wrote:
>Reposting again.
>
>Shouldn't javadoc automatically recurse through directories? It doesn't
>for me. I would like to run javadoc at the root of all my projects w/o
>telling it it each .java file. We have a multi-project platform all
>residing within a master project and each having their own src subfolder
>and many .java source files:
>
>MasterProject
> proj1
> -src
> proj2
> -src
> proj3
> -src
>
>The command below, in my original email, does not work for me. But if I
>generate a for-loop at the DOS prompt from the root of all the projects, I
>get it to work but the result is is not correct. All the examples out
>there are geared toward a single project. How can I get javadoc to recurse
>automatically? I do not see a command line option. Once I successfully run
>this at the command prompt or from a batch file, I will then convert it to
>Ant/xml.
>
>Thanks
>
>----Original Message Follows----
>From: "Res Pons" <po...@hotmail.com>
>Reply-To: "Ant Users List" <us...@ant.apache.org>
>To: user@ant.apache.org
>Subject: javadoc
>Date: Thu, 05 Apr 2007 21:28:18 -0700
>
>Almost wrong forum, I know...but...
>
>I would like to test and run javadoc at a DOS prompt before writing ant
>code for it but the problem is that when I cd into my project and execute
>the following, I get an error1 and nothing happens.
>
>c:\>cd Builds\project1
>C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
>javadocs
>
>javadoc: error - File not found: "*.java"
>1 error
>
>How come javadoc is not recursing through my subfolders?
>
>_________________________________________________________________
>Get a FREE Web site, company branded e-mail and more from Microsoft Office
>Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>For additional commands, e-mail: user-help@ant.apache.org
>
>_________________________________________________________________
>Need a break? Find your escape route with Live Search Maps.
>http://maps.live.com/?icid=hmtag3
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
>For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
_________________________________________________________________
Get a FREE Web site, company branded e-mail and more from Microsoft Office
Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by "Scot P. Floess" <fl...@mindspring.com>.
Res:
You are gonna need to specify all the java files to javadoc against...
Type javadoc at the command line and it will tell you so :)
If you were on a *nix environment you could do something with find...
Curious...why don't you want to do this with Ant in your
experimentation? Clearly it does so much for you (for instance
iterating down in the dirs)...
Res Pons wrote:
> Reposting again.
>
> Shouldn't javadoc automatically recurse through directories? It
> doesn't for me. I would like to run javadoc at the root of all my
> projects w/o telling it it each .java file. We have a multi-project
> platform all residing within a master project and each having their
> own src subfolder and many .java source files:
>
> MasterProject
> proj1
> -src
> proj2
> -src
> proj3
> -src
>
> The command below, in my original email, does not work for me. But if
> I generate a for-loop at the DOS prompt from the root of all the
> projects, I get it to work but the result is is not correct. All the
> examples out there are geared toward a single project. How can I get
> javadoc to recurse automatically? I do not see a command line option.
> Once I successfully run this at the command prompt or from a batch
> file, I will then convert it to Ant/xml.
>
> Thanks
>
> ----Original Message Follows----
> From: "Res Pons" <po...@hotmail.com>
> Reply-To: "Ant Users List" <us...@ant.apache.org>
> To: user@ant.apache.org
> Subject: javadoc
> Date: Thu, 05 Apr 2007 21:28:18 -0700
>
> Almost wrong forum, I know...but...
>
> I would like to test and run javadoc at a DOS prompt before writing
> ant code for it but the problem is that when I cd into my project and
> execute the following, I get an error1 and nothing happens.
>
> c:\>cd Builds\project1
> C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java
> -d javadocs
>
> javadoc: error - File not found: "*.java"
> 1 error
>
> How come javadoc is not recursing through my subfolders?
>
> _________________________________________________________________
> Get a FREE Web site, company branded e-mail and more from Microsoft
> Office Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
> _________________________________________________________________
> Need a break? Find your escape route with Live Search Maps.
> http://maps.live.com/?icid=hmtag3
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by Res Pons <po...@hotmail.com>.
Thanks. I was reading the javadocs on Sun, they're not very easy to
understand and most of the examples don't apply to my case. I'll google
some more. Thanks.
----Original Message Follows----
From: "Jack J. Woehr" <jw...@absolute-performance.com>
Reply-To: "Ant Users List" <us...@ant.apache.org>
To: "Ant Users List" <us...@ant.apache.org>
Subject: Re: javadoc
Date: Mon, 9 Apr 2007 15:59:06 -0600
In your installation of Java SDK documentation read carefully
tooldocs/windows/javadoc.html#runningjavadoc
Specifically, don't think you can put a -d switch after *.java
On Apr 9, 2007, at 3:41 PM, Res Pons wrote:
>
>I would like to test and run javadoc at a DOS prompt before writing ant
>code for it but the problem is that when I cd into my project and execute
>the following, I get an error1 and nothing happens.
>
>c:\>cd Builds\project1
>C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
>javadocs
>
>javadoc: error - File not found: "*.java"
>1 error
>
>How come javadoc is not recursing through my subfolders?
--
Jack J. Woehr
Director of Development
Absolute Performance, Inc.
jwoehr@absolute-performance.com
303-443-7000 ext. 527
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
_________________________________________________________________
Interest Rates Fall Again! $430,000 Mortgage for $1,399/mo - Calculate new
payment
http://www.lowermybills.com/lre/index.jsp?sourceid=lmb-9632-18679&moid=7581
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by "Jack J. Woehr" <jw...@absolute-performance.com>.
In your installation of Java SDK documentation read carefully
tooldocs/windows/javadoc.html#runningjavadoc
Specifically, don't think you can put a -d switch after *.java
On Apr 9, 2007, at 3:41 PM, Res Pons wrote:
>
> I would like to test and run javadoc at a DOS prompt before writing
> ant code for it but the problem is that when I cd into my project
> and execute the following, I get an error1 and nothing happens.
>
> c:\>cd Builds\project1
> C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr
> *.java -d javadocs
>
> javadoc: error - File not found: "*.java"
> 1 error
>
> How come javadoc is not recursing through my subfolders?
--
Jack J. Woehr
Director of Development
Absolute Performance, Inc.
jwoehr@absolute-performance.com
303-443-7000 ext. 527
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by Antoine Levy Lambert <an...@gmx.de>.
Hi,
no, javadoc is not able out of the box to generate documentation for
several projects in one go.
It will on the command line do this for you if you enumerate the list of
source directories like in this example [1]:
C:> javadoc -sourcepath C:\user1\src;C:\user2\src com.mypackage
Ant has also a sourcepathref attribute for the javadoc task [2]
so you can define your source path like that :
<path id="allmysources">
<pathelement location="C:\user1\src"/>
<pathelement location="C:\user2\src"/>
</path>
<javadoc sourcepathref="allmysources" ....
My guess is the hard part for you will be to create the <path type
definition. To make it on the fly dynamically, you could have a script
generating the path in its own file. Of course the file created on the
fly has to be done before it is needed. Maybe someone has a better idea
about that.
Regards,
Antoine
[1]
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#javadocoptions
[2] http://ant.apache.org/manual/CoreTasks/javadoc.html
Res Pons wrote:
> Reposting again.
>
> Shouldn't javadoc automatically recurse through directories? It
> doesn't for me. I would like to run javadoc at the root of all my
> projects w/o telling it it each .java file. We have a multi-project
> platform all residing within a master project and each having their
> own src subfolder and many .java source files:
>
> MasterProject
> proj1
> -src
> proj2
> -src
> proj3
> -src
>
> The command below, in my original email, does not work for me. But if
> I generate a for-loop at the DOS prompt from the root of all the
> projects, I get it to work but the result is is not correct. All the
> examples out there are geared toward a single project. How can I get
> javadoc to recurse automatically? I do not see a command line option.
> Once I successfully run this at the command prompt or from a batch
> file, I will then convert it to Ant/xml.
>
> Thanks
>
> ----Original Message Follows----
> From: "Res Pons" <po...@hotmail.com>
> Reply-To: "Ant Users List" <us...@ant.apache.org>
> To: user@ant.apache.org
> Subject: javadoc
> Date: Thu, 05 Apr 2007 21:28:18 -0700
>
> Almost wrong forum, I know...but...
>
> I would like to test and run javadoc at a DOS prompt before writing
> ant code for it but the problem is that when I cd into my project and
> execute the following, I get an error1 and nothing happens.
>
> c:\>cd Builds\project1
> C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java
> -d javadocs
>
> javadoc: error - File not found: "*.java"
> 1 error
>
> How come javadoc is not recursing through my subfolders?
>
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
Re: javadoc
Posted by "Scot P. Floess" <fl...@mindspring.com>.
Let me elaborate:
javadoc: error - No packages or classes specified.
usage: javadoc [options] [packagenames] [sourcefiles] [@files]
Notice the [sourcefiles] option?
So in some fashion you need to specify which files you wish to run
javadoc against... Personally I would just use the <javadoc> task
myself for experimentation
Res Pons wrote:
> Reposting again.
>
> Shouldn't javadoc automatically recurse through directories? It
> doesn't for me. I would like to run javadoc at the root of all my
> projects w/o telling it it each .java file. We have a multi-project
> platform all residing within a master project and each having their
> own src subfolder and many .java source files:
>
> MasterProject
> proj1
> -src
> proj2
> -src
> proj3
> -src
>
> The command below, in my original email, does not work for me. But if
> I generate a for-loop at the DOS prompt from the root of all the
> projects, I get it to work but the result is is not correct. All the
> examples out there are geared toward a single project. How can I get
> javadoc to recurse automatically? I do not see a command line option.
> Once I successfully run this at the command prompt or from a batch
> file, I will then convert it to Ant/xml.
>
> Thanks
>
> ----Original Message Follows----
> From: "Res Pons" <po...@hotmail.com>
> Reply-To: "Ant Users List" <us...@ant.apache.org>
> To: user@ant.apache.org
> Subject: javadoc
> Date: Thu, 05 Apr 2007 21:28:18 -0700
>
> Almost wrong forum, I know...but...
>
> I would like to test and run javadoc at a DOS prompt before writing
> ant code for it but the problem is that when I cd into my project and
> execute the following, I get an error1 and nothing happens.
>
> c:\>cd Builds\project1
> C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java
> -d javadocs
>
> javadoc: error - File not found: "*.java"
> 1 error
>
> How come javadoc is not recursing through my subfolders?
>
> _________________________________________________________________
> Get a FREE Web site, company branded e-mail and more from Microsoft
> Office Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
> _________________________________________________________________
> Need a break? Find your escape route with Live Search Maps.
> http://maps.live.com/?icid=hmtag3
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
> For additional commands, e-mail: user-help@ant.apache.org
>
>
--
Scot P. Floess
27 Lake Royale
Louisburg, NC 27549
252-478-8087 (Home)
919-392-6730 (Work)
Chief Architect JPlate http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
RE: javadoc
Posted by Res Pons <po...@hotmail.com>.
Reposting again.
Shouldn't javadoc automatically recurse through directories? It doesn't for
me. I would like to run javadoc at the root of all my projects w/o telling
it it each .java file. We have a multi-project platform all residing within
a master project and each having their own src subfolder and many .java
source files:
MasterProject
proj1
-src
proj2
-src
proj3
-src
The command below, in my original email, does not work for me. But if I
generate a for-loop at the DOS prompt from the root of all the projects, I
get it to work but the result is is not correct. All the examples out there
are geared toward a single project. How can I get javadoc to recurse
automatically? I do not see a command line option. Once I successfully run
this at the command prompt or from a batch file, I will then convert it to
Ant/xml.
Thanks
----Original Message Follows----
From: "Res Pons" <po...@hotmail.com>
Reply-To: "Ant Users List" <us...@ant.apache.org>
To: user@ant.apache.org
Subject: javadoc
Date: Thu, 05 Apr 2007 21:28:18 -0700
Almost wrong forum, I know...but...
I would like to test and run javadoc at a DOS prompt before writing ant code
for it but the problem is that when I cd into my project and execute the
following, I get an error1 and nothing happens.
c:\>cd Builds\project1
C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
javadocs
javadoc: error - File not found: "*.java"
1 error
How come javadoc is not recursing through my subfolders?
_________________________________________________________________
Get a FREE Web site, company branded e-mail and more from Microsoft Office
Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
_________________________________________________________________
Need a break? Find your escape route with Live Search Maps.
http://maps.live.com/?icid=hmtag3
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
RE: javadoc
Posted by Res Pons <po...@hotmail.com>.
correction: that's src and not src and just a typo in this email and not at
the DOS prompt
----Original Message Follows----
From: "Res Pons" <po...@hotmail.com>
Reply-To: "Ant Users List" <us...@ant.apache.org>
To: user@ant.apache.org
Subject: javadoc
Date: Thu, 05 Apr 2007 21:28:18 -0700
Almost wrong forum, I know...but...
I would like to test and run javadoc at a DOS prompt before writing ant code
for it but the problem is that when I cd into my project and execute the
following, I get an error1 and nothing happens.
c:\>cd Builds\project1
C:\Builds\project1>javadoc -sourcepath widgegts\src:3rdpary\scr *.java -d
javadocs
javadoc: error - File not found: "*.java"
1 error
How come javadoc is not recursing through my subfolders?
_________________________________________________________________
Get a FREE Web site, company branded e-mail and more from Microsoft Office
Live! http://clk.atdmt.com/MRT/go/mcrssaub0050001411mrt/direct/01/
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org
_________________________________________________________________
Cant afford to quit your job? Earn your AS, BS, or MS degree online in 1
year.
http://www.classesusa.com/clickcount.cfm?id=866145&goto=http%3A%2F%2Fwww.classesusa.com%2Ffeaturedschools%2Fonlinedegreesmp%2Fform-dyn1.html%3Fsplovr%3D866143
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org