You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by Jim Wright <Ji...@quick.cz> on 2002/09/02 12:13:26 UTC
Re: Package overviews
Sorry, that didn't work using Mozilla mailer. Or did
the list server filter out my .htm file for some reason?
I might try another mailer later but I'll wait for some
wise person to tell me what the problem/solution is
first.
Jim
----- Original Message -----
From: Jim Wright <Ji...@quick.cz>
To: Ant Developers List <an...@jakarta.apache.org>
Sent: Monday, September 02, 2002 12:19 PM
Subject: Package overviews
> Hi,
>
> In the process of understanding Ant API's I intend to
> write package overviews. These could form the basis
> of package.html files for feeding into javadoc or I
> may publish them on my website. I don't expect
> to cover more than a few packages myself.
>
> I attach a draft for the root package org.apache.tools.ant.
> Excuse the filename which is a unique fixed ID. Also, the
> header links are broken.
>
> If Ant developers feel they could use this as intended
> then I am willing to make it more suitable, transfer
> copyright etc. It may make a worthwhile read anyway.
>
> I am approaching this from a position of ignorance,
> which does have the advantage that ignorant people
> may understand it ;-) I would like to think I am
> avoiding unnecessary jargon.
>
> But of course it may need correcting by various
> experts. In some cases my descriptions of
> classes/interfaces may reflect the need to modify the
> comments in .java files so that people like me can
> understand them.
>
> OK. Comments gratefully received. My aim has been
> to give each type a brief mention that fits it into the
> big picture and I would prefer to make it shorter.
>
> Jim
>
>
----------------------------------------------------------------------------
----
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Package overviews
Posted by Peter Donald <pe...@apache.org>.
On Mon, 2 Sep 2002 20:13, Jim Wright wrote:
> Sorry, that didn't work using Mozilla mailer. Or did
> the list server filter out my .htm file for some reason?
Thats the reason :) You can chuck it on a website somewhere and send a url or
send it inside a zip/tar.
> I might try another mailer later but I'll wait for some
> wise person to tell me what the problem/solution is
> first.
>
> Jim
>
> ----- Original Message -----
> From: Jim Wright <Ji...@quick.cz>
> To: Ant Developers List <an...@jakarta.apache.org>
> Sent: Monday, September 02, 2002 12:19 PM
> Subject: Package overviews
>
> > Hi,
> >
> > In the process of understanding Ant API's I intend to
> > write package overviews. These could form the basis
> > of package.html files for feeding into javadoc or I
> > may publish them on my website. I don't expect
> > to cover more than a few packages myself.
> >
> > I attach a draft for the root package org.apache.tools.ant.
> > Excuse the filename which is a unique fixed ID. Also, the
> > header links are broken.
> >
> > If Ant developers feel they could use this as intended
> > then I am willing to make it more suitable, transfer
> > copyright etc. It may make a worthwhile read anyway.
> >
> > I am approaching this from a position of ignorance,
> > which does have the advantage that ignorant people
> > may understand it ;-) I would like to think I am
> > avoiding unnecessary jargon.
> >
> > But of course it may need correcting by various
> > experts. In some cases my descriptions of
> > classes/interfaces may reflect the need to modify the
> > comments in .java files so that people like me can
> > understand them.
> >
> > OK. Comments gratefully received. My aim has been
> > to give each type a brief mention that fits it into the
> > big picture and I would prefer to make it shorter.
> >
> > Jim
>
> ---------------------------------------------------------------------------
>- ----
>
> > --
> > To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> > For additional commands, e-mail: <ma...@jakarta.apache.org>
--
Cheers,
Peter Donald
*----------------------------------------------------------*
The phrase "computer literate user" really means the person
has been hurt so many times that the scar tissue is thick
enough so he no longer feels the pain.
-- Alan Cooper, The Inmates are Running the Asylum
*----------------------------------------------------------*
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: Package overviews
Posted by Stefan Bodewig <bo...@apache.org>.
On Mon, 2 Sep 2002, Jim Wright <Ji...@quick.cz> wrote:
> Or did the list server filter out my .htm file for some reason?
Yep. It doesn't like text/html and strips it. ZIP it up and attach
it as an archive.
Stefan
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>