| Javadoc | Javadoc 2007-04-10 - By Scot P. Floess
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@(protected)>
> Reply-To: floess@(protected)
> To: Ant Users List <user@(protected)>
> 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@(protected)>
>> Reply-To: floess@(protected)
>> To: Ant Users List <user@(protected)>
>> 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@(protected)>
>>> Reply-To: "Ant Users List" <user@(protected)>
>>> To: user@(protected)
>>> 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@(protected)
>>> For additional commands, e-mail: user-help@(protected)
>>>
>>> _________________________________________________________________
>>> Need a break? Find your escape route with Live Search Maps.
>>> http://maps.live.com/?icid=hmtag3
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: user-unsubscribe@(protected)
>>> For additional commands, e-mail: user-help@(protected)
>>>
>>>
>>
>> --
>> 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@(protected)
>> For additional commands, e-mail: user-help@(protected)
>>
>> _________________________________________________________________
>> 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@(protected)
>> For additional commands, e-mail: user-help@(protected)
>>
>>
>
> --
> 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@(protected)
> For additional commands, e-mail: user-help@(protected)
>
> _________________________________________________________________
> Need a break? Find your escape route with Live Search Maps.
> http://maps.live.com/?icid=hmtag3
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: user-unsubscribe@(protected)
> For additional commands, e-mail: user-help@(protected)
>
>
--
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@(protected)
For additional commands, e-mail: user-help@(protected)
|
|
 |
