You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Tim O'Brien <to...@discursive.com> on 2003/05/22 18:43:53 UTC

[math] Re: [patch] developer documentation

Please conform to the commons practice of prefixing all email with the
particular project name.

Thanks

Tim


On Thu, 2003-05-22 at 11:40, Mark R. Diggory wrote:
> You got it boss! ;-)
> 
> -Mark
> 
> robert burrell donkin wrote:
> 
> > then submit a patch!
> >
> > - robert
> >
> > On Thursday, May 22, 2003, at 04:48 PM, Mark R. Diggory wrote:
> >
> >> I suspect these should be *required reading* for every Commons Math 
> >> developer, nice references Tim!
> >>
> >> -Mark
> >>
> >> O'brien, Tim wrote:
> >>
> >>>> OK.  You guys have convinced me.  We just need to carefully 
> >>>> document "Nan semantics" in interface specifications.  thx
> >>>>
> >>>
> >>> Phil,
> >>>
> >>> I was convinced by the sections regarding NaN and IEEE 754 in these two
> >>> documents.
> >>>
> >>> http://www.validlab.com/goldberg/paper.ps
> >>>
> >>> http://www.cs.berkeley.edu/~wkahan/ieee754status/ieee754.ps
> >>>
> >>> Tim
> >>>
> >>>
> >>>
> >>> ---------------------------------------------------------------------
> >>> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> >>> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >>>
> >>>
> >>
> >>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> >> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >>
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
> 
> ----
> 

> Index: developers.xml
> ===================================================================
> RCS file: /home/cvspublic/jakarta-commons-sandbox/math/xdocs/developers.xml,v
> retrieving revision 1.1
> diff -u -r1.1 developers.xml
> --- developers.xml	20 May 2003 10:27:25 -0000	1.1
> +++ developers.xml	22 May 2003 16:37:48 -0000
> @@ -18,6 +18,34 @@
>          <section name='Guidelines'>
>  Still under development...!
>      </section>
> +    <section name='Recommended Readings'>
> +		<p>Here is a list of recommended reading and worthy sites for link within JavaDoc comments for Math Developers</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>
> -
> +</document>
> \ No newline at end of file
> 
> ----
> 

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



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


Re: [math] Re: [patch] developer documentation

Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
Sorry, my bad...I didn't proof read before I sent it.

-Mark

Tim O'Brien wrote:

>Please conform to the commons practice of prefixing all email with the
>particular project name.
>
>Thanks
>
>Tim
>
>
>On Thu, 2003-05-22 at 11:40, Mark R. Diggory wrote:
>  
>
>>You got it boss! ;-)
>>
>>-Mark
>>
>>robert burrell donkin wrote:
>>
>>    
>>
>>>then submit a patch!
>>>
>>>- robert
>>>
>>>On Thursday, May 22, 2003, at 04:48 PM, Mark R. Diggory wrote:
>>>
>>>      
>>>
>>>>I suspect these should be *required reading* for every Commons Math 
>>>>developer, nice references Tim!
>>>>
>>>>-Mark
>>>>
>>>>O'brien, Tim wrote:
>>>>
>>>>        
>>>>
>>>>>>OK.  You guys have convinced me.  We just need to carefully 
>>>>>>document "Nan semantics" in interface specifications.  thx
>>>>>>
>>>>>>            
>>>>>>
>>>>>Phil,
>>>>>
>>>>>I was convinced by the sections regarding NaN and IEEE 754 in these two
>>>>>documents.
>>>>>
>>>>>http://www.validlab.com/goldberg/paper.ps
>>>>>
>>>>>http://www.cs.berkeley.edu/~wkahan/ieee754status/ieee754.ps
>>>>>
>>>>>Tim
>>>>>
>>>>>
>>>>>
>>>>>---------------------------------------------------------------------
>>>>>To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>>>>>For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>>>>>
>>>>>
>>>>>          
>>>>>
>>>>
>>>>---------------------------------------------------------------------
>>>>To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>>>>For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>>>>
>>>>        
>>>>
>>>---------------------------------------------------------------------
>>>To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>>>For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>>>
>>>      
>>>
>>----
>>
>>    
>>
>
>  
>
>>Index: developers.xml
>>===================================================================
>>RCS file: /home/cvspublic/jakarta-commons-sandbox/math/xdocs/developers.xml,v
>>retrieving revision 1.1
>>diff -u -r1.1 developers.xml
>>--- developers.xml	20 May 2003 10:27:25 -0000	1.1
>>+++ developers.xml	22 May 2003 16:37:48 -0000
>>@@ -18,6 +18,34 @@
>>         <section name='Guidelines'>
>> Still under development...!
>>     </section>
>>+    <section name='Recommended Readings'>
>>+		<p>Here is a list of recommended reading and worthy sites for link within JavaDoc comments for Math Developers</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>
>>-
>>+</document>
>>\ No newline at end of file
>>
>>----
>>
>>    
>>
>
>  
>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>>For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>>    
>>
>
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
>  
>



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