commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Phil Steitz <stei...@yahoo.com>
Subject Re: cvs commit: jakarta-commons-sandbox/math/xdocs developers.xml
Date Thu, 22 May 2003 18:17:00 GMT
At this point, I don't think that it is best to designate a
fixed set of references for mathematical defintions.  I
don't think that either of the references below are a)
comprehensive or b) fully specified (i.e. correct) for all
of the things that they define.  What I propose is that
each submission should include full references and each
definition should be open to discussion/debate on a case
basis. Submitters should be allowed to choose their own
definition sources and in some cases even write their own
defintions.  I am OK with maintaining a list of all of the
sources that have been used, and more importantly a master
list of defintions; but I think that we will run into
problems if we try to say that *all* definitions come from
a single list of references -- if only because the
references may overlap and/or be inconsistent.

One more nit: I would reference the pdf versions of the
docs below instead of the .ps files.

Strong +(whatever my opionion is worth) on following the
IEEE standard regarding NaNs (and other things). The
standard itself should be referenced somewhere and we
should pull out some explicit guidelines.  I will work on
this.

Phil

--- tobrien@apache.org wrote:
> tobrien     2003/05/22 09:55:22
> 
>   Modified:    math/xdocs developers.xml
>   Log:
>   Added mdiggory patch for developer resources
>   
>   Revision  Changes    Path
>   1.2       +52 -18   
> jakarta-commons-sandbox/math/xdocs/developers.xml
>   
>   Index: developers.xml
>  
>
===================================================================
>   RCS file:
>
/home/cvs/jakarta-commons-sandbox/math/xdocs/developers.xml,v
>   retrieving revision 1.1
>   retrieving revision 1.2
>   diff -u -r1.1 -r1.2
>   --- developers.xml	20 May 2003 10:27:25 -0000	1.1
>   +++ developers.xml	22 May 2003 16:55:22 -0000	1.2
>   @@ -1,23 +1,57 @@
>    <?xml version="1.0"?>
>    
>    <document>
>   -  <properties>
>   -    <title>Developers Guide</title>
>   -    <author email="rdonkin@apache.org">Robert Burrell
> Donkin</author>
>   -  </properties>
>   + <properties>
>   +  <title>Developers Guide</title>
>   +  <author email="rdonkin@apache.org">Robert Burrell
> Donkin</author>
>   + </properties>
>    
>   -  <body>
>   -        <section name="Aims">
>   -            <p>
>   -Creating and maintaining a mathematical and
> statistical library that is accurate requires a greater
>   -degree of communication than might be the case for
> other components. It is important that developers
>   -follow guidelines laid down by the community to ensure
> that the code they create can be successfully
>   -maintained by others.
>   -      </p>
>   -    </section>
>   -        <section name='Guidelines'>
>   -Still under development...!
>   -    </section>
>   -</body>
>   + <body>
>   +  <section name="Aims">
>   +   <p>
>   +    Creating and maintaining a mathematical and
> statistical library that is 
>   +    accurate requires a greater degree of
> communication than might be the 
>   +    case for other components. It is important that
> developers follow 
>   +    guidelines laid down by the community to ensure
> that the code they create 
>   +    can be successfully maintained by others.
>   +   </p>
>   +  </section>
>   +  <section name='Guidelines'>
>   +   Still under development...!
>   +  </section>
>   +  <section name='Recommended Readings'>
>   +   <p>
>   +    Here is a list of relevant materials.  Much of the
> discussion surrounding
>   +    the development of this component will refer to
> the various sources 
>   +    listed below, and frequently the Javadoc for a
> particular class or 
>   +    interface will link to a definition contained in
> these documents. 
>   +   </p>
>   +   <subsection name='Recommended Readings'>
>   +    <dl>
>   +     <dt>Concerning floating point arithmetic.</dt>
>   +     <dd>
>   +      <a
> href="http://www.validlab.com/goldberg/paper.ps">
>   +       http://www.validlab.com/goldberg/paper.ps
>   +      </a><br/>
>   +      <a
>
href="http://www.cs.berkeley.edu/~wkahan/ieee754status/ieee754.ps">
>   +      
>
http://www.cs.berkeley.edu/~wkahan/ieee754status/ieee754.ps
>   +      </a><br/>
>   +     </dd>
>   +    </dl>
>   +   </subsection>
>   +   <subsection name='Javadoc Comment Resources'>
>   +    <dl>
>   +     <dt>References for mathematical definitions.</dt>
>   +     <dd>
>   +      <a
> href="http://rd11.web.cern.ch/RD11/rkb/titleA.html">
>   +       http://rd11.web.cern.ch/RD11/rkb/titleA.html
>   +      </a><br/>
>   +      <a href="http://mathworld.wolfram.com">
>   +       http://mathworld.wolfram.com
>   +      </a><br/>
>   +     </dd>
>   +    </dl>
>   +   </subsection>
>   +  </section>
>   + </body>
>    </document>
>   -
>   
>   
>   
> 
>
---------------------------------------------------------------------
> To unsubscribe, e-mail:
> commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail:
> commons-dev-help@jakarta.apache.org
> 


__________________________________
Do you Yahoo!?
The New Yahoo! Search - Faster. Easier. Bingo.
http://search.yahoo.com

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message