ant-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Scot P. Floess" <flo...@mindspring.com>
Subject Re: javadoc
Date Tue, 10 Apr 2007 21:31:55 GMT
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" <floess@mindspring.com>
> Reply-To: floess@mindspring.com
> To: Ant Users List <user@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" <floess@mindspring.com>
>> Reply-To: floess@mindspring.com
>> To: Ant Users List <user@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" <pons32@hotmail.com>
>>> Reply-To: "Ant Users List" <user@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


Mime
View raw message