Here is my findings from Perry's instructions. On XP.
c:\JavaDevCenter\CocoonCVS\xml-cocoon2\>build -verbose javadocs >> mylog Opened in WordPad and did a Find & Replace -version -author with -subpackages Saved the source starting with -d C:\JavaDevCenter\CocoonCVS\..... as javaDocsTextBuild.txt My idiocy for the following command failing: c:\JavaDevCenter\CocoonCVS\xml-cocoon2\>javadoc @javaDocsTextBuild.txt so I said what the hell.. Copy Paste always works well. c:\JavaDevCenter\CocoonCVS\xml-cocoon2\>javadoc -d C:\JavaDevCenter\CocoonCVS\xml-cocoon2\build\cocoon\javadocs -noindex -windowtitle "Cocoon API" -stylesheetfile C:\JavaDevCenter\CocoonCVS\xml-cocoon2\src\resources\javadoc.css -doctitle Cocoon -bottom "Copyright © 1999-2002 Apache Software Foundation. All Rights Reserved." -classpath C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\avalon-excalibur-20020419.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\avalon-excalibur-scratchpad-20020419.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\avalon-framework-4.1.2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\commons-collections-1.0.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\commons-httpclient-20011012.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\jakarta-regexp-1.2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\logkit-1.0.1.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\xalan-2.3.1.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\xercesImpl-2.0.0.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\core\xml-apis.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\batik-all-1.5b1.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\bsf-2.2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\commons-logging-1.0.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\deli-0.50.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\fop-0.20.3.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\hsqldb-1.61.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\jakarta-poi-1.5.0-dev-20020412.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\jena-1.3.0.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\jimi-1.0.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\jisp_1_0_2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\jstyle.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\jtidy-04aug2000r7-dev.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\lucene-1.2-rc2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\maybeupload_1-0-5pre3.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\pizza-1.1.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\rdffilter.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\resolver-20020130.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\rhino-1.5r3.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\servlet_2_2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\velocity-1.2.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\xmldb-api-20011111.jar;C:\JavaDevCenter\CocoonCVS\xml-cocoon2\lib\optional\xt-19991105.jar -sourcepath C:\JavaDevCenter\CocoonCVS\xml-cocoon2\build\cocoon\src -subpackages org.apache.cocoon org.apache.cocoon.acting org.apache.cocoon.caching org.apache.cocoon.components org.apache.cocoon.components.browser org.apache.cocoon.components.classloader org.apache.cocoon.components.crawler org.apache.cocoon.components.deli org.apache.cocoon.components.elementprocessor org.apache.cocoon.components.elementprocessor.impl And yes presto it works.. Not elegant but works.. Now I have the luxury of PDFing a copy of all the javadocs for my own personal consumption, thanks to Acrobat Writer 5. And yes I am sure I'm missing something stupid with the command and like shitcanning the .txt extension, etc.. Thanks for the suggestion Perry! Sincerely Yours, Marc J. Driftmeyer 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:[EMAIL PROTECTED]] >Sent: Monday, 15 April 2002 10:47 >To: [EMAIL PROTECTED] >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 >>>>>> >>>>>>>>>[EMAIL PROTECTED] 04/11/02 11:34AM >>> >>>>>>>>> >>>>>>>From: Marc Jeffrey Driftmeyer [mailto:[EMAIL PROTECTED]] >>>>>>> >>>>>>>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: <[EMAIL PROTECTED]> >>>>>>For additional commands, e-mail: <[EMAIL PROTECTED]> >>>>>> >>>>>// >>>>> >>>>> >>>>> >>>>> >>>>>--------------------------------------------------------------------- >>>>>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: <[EMAIL PROTECTED]> >>>>>For additional commands, e-mail: <[EMAIL PROTECTED]> >>>>> >>>// >>> >>> >>> >>> >>>--------------------------------------------------------------------- >>>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: <[EMAIL PROTECTED]> >>>For additional commands, e-mail: <[EMAIL PROTECTED]> >>> > > >--------------------------------------------------------------------- >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: <[EMAIL PROTECTED]> >For additional commands, e-mail: <[EMAIL PROTECTED]> > >--------------------------------------------------------------------- >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: <[EMAIL PROTECTED]> >For additional commands, e-mail: <[EMAIL PROTECTED]> > // --------------------------------------------------------------------- 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: <[EMAIL PROTECTED]> For additional commands, e-mail: <[EMAIL PROTECTED]>
