cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Marc Jeffrey Driftmeyer <...@reanimality.com>
Subject Re: Missing API Docs in Cocoon 2.0.2 and latest CVS
Date Mon, 15 Apr 2002 04:59:55 GMT
Perry,

Thanks for the workaround.  I'll give it a try in the morning.

-Marc

Faulkner, Perry wrote:

>Seems as though it might be an issue with the change in the javadoc options
>for 1.4
>In the build log, it has an error with:
>
>org.apache.cocoon.components.language.programming.java
>
>Tried playing with javadoc outside of build & ant.
>Build invokes javadoc, with a list of o.a.c.xxx for each package, but I
>think the new javadoc expects those to be actual files and doesn't find them
>so produces nothing! The only one that looks like a file in the list,
>o.a.c.c.l.programming.java, doesn't exist!
>
>javadoc 1.4 has introduced an option -subpackages, which probably makes the
>list of o.a.c.xxx's redundant. I finally got it to work, manually, with
>"-subpackages org.apache.cocoon", but the current Cocoon version of ant
>won't take the subpackages option, so I can't see a proper fix at this
>stage. In the end, I suppose ant would need to be modified to account for
>these differences between 1.3 and 1.4 javadoc.
>
>But to do it manually, run "build javadocs -verbose" and redirect output to
>a log file. Edit the log file to find and extract the very long javadoc
>command line into a separate file. You now need to reduce this to just the
>parameters and options, so remove the leading ...javadoc.exe and replace all
>the package names at the end, i.e everything after -version -author, with
>-subpackages org.apache.cocoon
>
>Now execute: javadoc @file (where file is the one you just created,
>containing the javadoc parameters and options). The above assumes your under
>Windoze.
>
>Sorry this is a bit involved, I tried to fake out the ant build, but
>couldn't get around it's checks!
>
>HTH
>
>Perry
>
>-----Original Message-----
>From: Marc Jeffrey Driftmeyer [mailto:mjd@reanimality.com]
>Sent: Monday, 15 April 2002 10:47
>To: cocoon-users@xml.apache.org
>Subject: Re: Missing API Docs in Cocoon 2.0.2 and latest CVS
>
>
>I completely agree and that sort of Wonderful SQA bugs should not go 
>unnoticed.
>
>-Marc
>
>Andrew C. Oliver wrote:
>
>>Not sure what all the issues are...all I know is what works on 1.3.1
>>buildwise often doesn't work on 1.4.0.  
>>
>>The horrible bug is that the doc build can be "SUCCESSFUL" even if it
>>fails.  (thats bad)
>>
>>On Sun, 2002-04-14 at 20:09, Marc Jeffrey Driftmeyer wrote:
>>
>>>I have a hard time believing that this permissions issue of reading into 
>>>that path is the fault of Sun's JDK.  I have a greater suspicion it has 
>>>to do with some build issues within Cocoon, since we already know that 
>>>Cocoon 2.0.2 build SDK of choice is 1.3.1.
>>>
>>>-Marc
>>>
>>>Andrew C. Oliver wrote:
>>>
>>>>Yeah, I can't get the javadoc to generate under 1.4.0 either.  What's
>>>>worse is it fails and then says "BUILD SUCCESSFUL".  I regard the first
>>>>problem as a small glitch that can probably even be resolved by waiting
>>>>for 1.4.0_01...  The second is a horrible evil bug. ;-)
>>>>
>>>>-Andy
>>>>
>>>>On Sun, 2002-04-14 at 02:23, Marc Jeffrey Driftmeyer wrote:
>>>>
>>>>>Bruce,
>>>>>
>>>>>I'm running Windows XP Professional, Java SDK 1.4.0 and Tomcat 4.0.4b2.
>>>>>
>>>>>-Marc
>>>>>
>>>>>Bruce Krautbauer wrote:
>>>>>
>>>>>>I just did a cvs checkout -r HEAD xml-cocoon2 to a new directory,
>>>>>>
>copied xercesImpl-2.0.0.jar, xalan-2.3.1.jar, and the xml-apis.jar from the
>.\lib\core\ to the %JAVA_HOME%\jre\lib\endorsed\ directory and my build
>javadocs gives the same result as Marc's.  Everything else seems to build
>and run fine.  It must be an environment issue.  I'm running Win 2KSP2, JDK
>1.4.0, Tomcat 4.0.4b2.  Marc and Vadim, what are you running?
>
>>>>>>Bruce
>>>>>>
>>>>>>>>>vadim.gritsenko@verizon.net 04/11/02 11:34AM >>>
>>>>>>>>>
>>>>>>>From: Marc Jeffrey Driftmeyer [mailto:mjd@reanimality.com] 
>>>>>>>
>>>>>>>Of course that is the command..
>>>>>>>
>>>>>>>
>>>>>>>And as run the latest snapshot or even the cocoon 2.0.2 release
here
>>>>>>>
>>>>>>is
>>>>>>
>>>>>>>the error log for the javadocs.
>>>>>>>
>>>>>>>javadocs:
>>>>>>>[javadoc] Generating Javadoc
>>>>>>>[javadoc] Javadoc execution
>>>>>>>[javadoc] Loading source file
>>>>>>>org.apache.cocoon.components.language.programming.java...
>>>>>>>[javadoc] error: cannot read:
>>>>>>>org.apache.cocoon.components.language.programming.java
>>>>>>>
>>>>>>...
>>>>>>
>>>>>>>[javadoc] 1 error
>>>>>>>
>>>>>>I just tried "build javadocs":
>>>>>>
>>>>>>[javadoc] Generating
>>>>>>C:\Apache\xml-cocoon2\build\cocoon\javadocs\help-doc.html...
>>>>>>[javadoc] 116 warnings
>>>>>>
>>>>>>Result is 842 files in the cocoon/build/cocoon/javadocs.
>>>>>>
>>>>>>
>>>>>>Vadim
>>>>>>
>>>>>>
>>>>>>
>>>>>>---------------------------------------------------------------------
>>>>>>Please check that your question has not already been answered in the
>>>>>>FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>>>>>>
>>>>>>To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
>>>>>>For additional commands, e-mail: <cocoon-users-help@xml.apache.org>
>>>>>>
>>>>>//
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>---------------------------------------------------------------------
>>>>>Please check that your question has not already been answered in the
>>>>>FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>>>>>
>>>>>To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
>>>>>For additional commands, e-mail: <cocoon-users-help@xml.apache.org>
>>>>>
>>>//
>>>
>>>
>>>
>>>
>>>---------------------------------------------------------------------
>>>Please check that your question has not already been answered in the
>>>FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>>>
>>>To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
>>>For additional commands, e-mail: <cocoon-users-help@xml.apache.org>
>>>
>
>
>---------------------------------------------------------------------
>Please check that your question has not already been answered in the
>FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>
>To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
>For additional commands, e-mail: <cocoon-users-help@xml.apache.org>
>
>---------------------------------------------------------------------
>Please check that your question has not already been answered in the
>FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>
>To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
>For additional commands, e-mail: <cocoon-users-help@xml.apache.org>
>
//




---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>

To unsubscribe, e-mail: <cocoon-users-unsubscribe@xml.apache.org>
For additional commands, e-mail: <cocoon-users-help@xml.apache.org>


Mime
View raw message