ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Peter Nordlund <peter.nordl...@lentus.se>
Subject Re: Exclude attribute to javadoc
Date Fri, 20 Oct 2000 14:00:15 GMT
Hi Glenn,

Thanks for your workaround,
Maybe this could be fixed in a further release....
/Peter

glennm@ca.ibm.com wrote:
> 
> The way the current implementation of the <javadoc> task works is to assume
> the the package names you specify correspond to directory names.  If you
> have extraneous directories and use the * wildcard, you will pick up those
> directories and pass them on to Javadoc as if they were valid package
> names.
> 
> Hmm... just took a peek at our own stuff and realized that the build for
> Ant can have the same problem if any of the CVS directories include .java
> files.
> 
> Well, there are two ways we can fix this.  Either add a matching task like
> functionality to javadoc (which I'm not really willing to do with being so
> close to a release) or copy the source tree into a clean directory and then
> build the Javadoc.  I'm leaning towards the latter becuase doing the
> Javadoc is a farily infrequent event.
> 
> So in your case, you may need to do
> 
> <copy todir="${doc.src.dir}">
>   <fileset dir="../Util/java">
>     <include name="**/*.java" />
>     <exclude name="**/SCCS" />
>   </fileset>
> </copy>
> 
> <javadoc packagenames="se.lentus.util.*"
>          sourcepath="${doc.src.dir}"
>          destdir="${javadoc}"
>          author="true"
>          version="true"
>          use="true"
>          windowtitle="Test API"
>          doctitle="Test"
>          bottom="&lt;i>Copyright &#169; 2000 Dummy Corp. All Rights
> Reserved.&lt;/i>">
> </javadoc>
> 
> <delete dir="${doc.src.dir}" />
> 
> Not elegant, but it does get us around the problem.  Comments?
>

Mime
View raw message