tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 44759] New: can' t run ant task dist-javadoc as described in BUILDING.txt
Date Sat, 05 Apr 2008 16:11:33 GMT
https://issues.apache.org/bugzilla/show_bug.cgi?id=44759

           Summary: can't run ant task dist-javadoc as described in
                    BUILDING.txt
           Product: Tomcat 6
           Version: 6.0.16
          Platform: Macintosh
        OS/Version: other
            Status: NEW
          Keywords: PatchAvailable
          Severity: minor
          Priority: P2
         Component: Documentation
        AssignedTo: tomcat-dev@jakarta.apache.org
        ReportedBy: stephen.bannasch@gmail.com


After a svn checkout of:

  http://svn.apache.org/repos/asf/tomcat/tc6.0.x/tags/TOMCAT_6_0_16

and a successful build I tried following the instruction in BUILDING.txt for
generating the javadoc however running:

  ant -f dist.xml dist-javadoc

produced this error:

BUILD FAILED
/Users/stephen/dev/java/src/tomcat_6_0_16/dist.xml:368: No source files and no
packages have been specified.

I needed to run this first to produce the documentation:

  ant -f dist.xml dist-source

You could either add a statement about this to this section of the instructions
in: BUILDING.txt

(5) Building the servlet and jsp API documentation

The documentation can be easly built:

    cd ${tomcat.source}
    ant -f dist.xml dist-javadoc

Or apply this patch which adds dist-source as a dependency to the dist-javadoc
ant task:

Index: dist.xml
===================================================================
--- dist.xml    (revision 645027)
+++ dist.xml    (working copy)
@@ -356,7 +356,7 @@

   </target>

-  <target name="dist-javadoc" description="Create the Tomcat javadoc" >
+  <target name="dist-javadoc" depends="dist-source" description="Create the
Tomcat javadoc" >
     <javadoc packagenames="org.apache.*"
       sourcepath="${tomcat.dist}/src/java"
       destdir="${tomcat.dist}/webapps/docs/api"


fyI: regarding OS: I'm running MacOS 10.5.2 -- Mac OS X 10.5 should be added to
your bugzilla list of OS types.


-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message