Return-Path: 
 <ant-user-return-20823-qmlist-jakarta-archive-ant-user=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-ant-user-archive@apache.org
Received: (qmail 60553 invoked from network); 22 May 2002 12:50:33 -0000
Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131)
  by daedalus.apache.org with SMTP; 22 May 2002 12:50:33 -0000
Received: (qmail 8965 invoked by uid 97); 22 May 2002 12:50:22 -0000
Delivered-To: qmlist-jakarta-archive-ant-user@jakarta.apache.org
Received: (qmail 8929 invoked by uid 97); 22 May 2002 12:50:21 -0000
Mailing-List: contact ant-user-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:ant-user-unsubscribe@jakarta.apache.org>
List-Subscribe: <mailto:ant-user-subscribe@jakarta.apache.org>
List-Help: <mailto:ant-user-help@jakarta.apache.org>
List-Post: <mailto:ant-user@jakarta.apache.org>
List-Id: "Ant Users List" <ant-user.jakarta.apache.org>
Reply-To: "Ant Users List" <ant-user@jakarta.apache.org>
Delivered-To: mailing list ant-user@jakarta.apache.org
Received: (qmail 8917 invoked by uid 98); 22 May 2002 12:50:21 -0000
X-Antivirus: nagoya (v4198 created Apr 24 2002)
Message-ID: <3CEB93A4.1030706@blueyonder.co.uk>
Date: Wed, 22 May 2002 13:48:36 +0100
From: Ian Atkin <ianatkin@blueyonder.co.uk>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
 rv:1.0rc2) Gecko/20020510
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Ant Users List <ant-user@jakarta.apache.org>
Subject: Re: javadoc, package comments
References: <OFC09E37D2.57A5030B-ONC1256BC1.0043008D@arthurandersen.com>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

my mistake, here's what i think is going on:-

use="true" means that "use pages" will be written by javadoc for each 
package and class, it has nothing to do with this, sorry

javadocs default behaviour is to treat every package.html file in a dir 
with java sources as a "package comment" and write it into the package 
page (this happens without any attribs on <javadoc>), just as it will 
copy anything in a "doc-files" sub-dir

if you want your top-level package (that often has no sources in it) to 
have such a package comment use the "overview file", ie 
overview="[FILENAME]"

hope this helps,

ian

frankie.bollaert@be.andersen.com wrote:
> Hey,
> 
> First of all, i would like to thank for all the reply i got so far,
> like the idea that there is some place to go with these questions,
> I have been struggeling with ant many times before.
> 
> But, listing my packages as you suggest is not really an option.
> There are too many of them ..  it would take me all day to
> write a command like that.
> 
> I will show you my ant command,
> 
> <javadoc packagenames="com.*" defaultexcludes="yes" destdir="../docs/api"
> author="true" version="true" use="true">
>       <sourcepath>
>                        <pathelement path="../client-src"/>
>                 </sourcepath>
> </javadoc>
> 
> 
> I have given up hope a little bit, I think I will just start debugging the
> task this evening ..
> 
> Thank you,
> Frankie
> 
> ____________
> 
> 
>>Hello frankie,
> 
> ..
> I have a similar problem.
> As I understood this is because no need to put package.html
> to sourcepath.
> 
> <javadoc
>         sourcepath="${src_dir}"
>         destdir="${out_dir}/${generated_doc_dir}"
>         classpathref="classpath_id"
>         access="package"
>         author="true"
>         version="true"
>         use="true"
> 
>         <!-- lists your packages -->
>         <package name="com.<rest_packagename1>"/>
>         <package name="com.<rest_packagename2>"/>
> 
>         <!-- lists additional standalone source file -->
>         <!-- (if you don't want to generate docs for the whole package) -->
>         <source file="${src_dir}/com/<rest_path>/A.java"/>
> </javadoc>
> 
> 
> 
> 
> 
> 
> *******************Internet Email Confidentiality Footer*******************
> 
> 
> Privileged/Confidential Information may be contained in this message.  If
> you are not the addressee indicated in this message (or responsible for
> delivery of the message to such person), you may not copy or deliver this
> message to anyone. In such case, you should destroy this message and kindly
> notify the sender by reply email. Please advise immediately if you or your
> employer do not consent to Internet email for messages of this kind.
> Opinions, conclusions and other information in this message that do not
> relate to the official business of my firm shall be understood as neither
> given nor endorsed by it.
> 
> 
> --
> To unsubscribe, e-mail:   <mailto:ant-user-unsubscribe@jakarta.apache.org>
> For additional commands, e-mail: <mailto:ant-user-help@jakarta.apache.org>
> 
> 



--
To unsubscribe, e-mail:   <mailto:ant-user-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-user-help@jakarta.apache.org>