"John Keiser" <[EMAIL PROTECTED]> writes:

>      Actually, I hadn't looked there yet.
>      At least it's a source of information.  I'll check out the code we
> wrote, and I'll look at the JavaDocs to confirm the information, and then
> I'll write the docs for these methods.
>      Remember, two different books can say the same information in different
> ways, especially in the case of reference books.  I'm not stealing from the
> JLS, I am documenting a process that the JLS also documents.
> --John

Okay, I'll go further here and say that our methods don't conform
exactly to the JLS.  We'd need an IEEE guru to do that.  More
important to document what they should do and note what they don't do
or currently do.

Brian

> > -----Original Message-----
> > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]On Behalf Of
> > Brian Jones
> > Sent: Monday, February 08, 1999 11:54 AM
> > To: John Keiser
> > Cc: Classpath
> > Subject: Re: java.lang.Float fields
> >
> >
> > "John Keiser" <[EMAIL PROTECTED]> writes:
> >
> > > Finally, in both Float and Double, the toString() method needs a little
> > > elaboration.  It would be nice to know what format the
> > resulting String will
> > > be in.  Will it be in exponential notation?  Will it ever be in regular
> > > notation, and under what circumstances?  Stuff people reading this could
> > > use.  parseFloat() needs the same elaboration.  It would be nice to have
> > > full specification of what the methods do inside the docs.
> >
> > Big pain here is documenting in a way that doesn't steal directly from
> > the JLS.  If you can think of a way, go for it.  The JLS and Javadoc
> > generally say the exact same thing for these two methods.
> >
> > Brian
> > --
> > |-------------------------------|Software Engineer
> > |Brian Jones                        |[EMAIL PROTECTED]
> > |[EMAIL PROTECTED]                        |http://www.nortel.net
> > |http://www.classpath.org/      |-------------------------------
> >
> >

-- 
|-------------------------------|Software Engineer
|Brian Jones                    |[EMAIL PROTECTED]
|[EMAIL PROTECTED]                    |http://www.nortel.net
|http://www.classpath.org/      |-------------------------------

Reply via email to