You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by bu...@apache.org on 2008/04/05 18:11:33 UTC

DO NOT REPLY [Bug 44759] New: can' t run ant task dist-javadoc as described in BUILDING.txt

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


DO NOT REPLY [Bug 44759] can' t run ant task dist-javadoc as described in BUILDING.txt

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=44759





--- Comment #1 from Mark Thomas <ma...@apache.org>  2008-04-05 13:10:46 PST ---
Many thanks for the patch. It has been applied to trunk and proposed for 6.0.x.


-- 
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


DO NOT REPLY [Bug 44759] can' t run ant task dist-javadoc as described in BUILDING.txt

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=44759


Mark Thomas <ma...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |FIXED




--- Comment #2 from Mark Thomas <ma...@apache.org>  2008-04-16 14:37:23 PST ---
This has been fixed in svn for 6.0.x and will be in 6.0.17 onwards.


-- 
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