[Patch,wwwdocs] libquadmath: Mention in the news, add to changes.html

[Patch,wwwdocs] libquadmath: Mention in the news, add to changes.html

[Tobias Burnus]

[-- Attachment #1: Type: text/plain, Size: 304 bytes --]

Hi all, hello Gerald,

the patch adds the libquadmath support to the news section on the main 
GCC page and to the GCC 4.6 release notes.

Do you have comments or suggestions before I install it?

Regarding the library itself: I am currently doing a final bootstrapping 
and will then commit it.

Tobias

[-- Attachment #2: wwwdoc.diff --]
[-- Type: text/x-patch, Size: 2545 bytes --]

Index: index.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/index.html,v
retrieving revision 1.765
diff -u -r1.765 index.html
--- index.html	8 Nov 2010 00:44:28 -0000	1.765
+++ index.html	16 Nov 2010 20:30:46 -0000
@@ -50,6 +50,13 @@
 <h2 style="margin-top:0pt;" id="news">News</h2>
 
 <dl class="news">
+<dt>November 16, 2010</dt>
+<dd><a href="gcc-4.6/changes.html">GCC 4.6.0</a> will include the
+<tt>libquadmath</tt> library, which provides quad-precision mathematical
+functions on targets supporting the <tt>__float128</tt> datatype. The
+library is used to provide on such targets the <tt>REAL(16)</tt> type in GNU
+Fortran compiler. The library has been contributed by Fran&ccedil;ois-Xavier
+Coudert.</dd>
 
 <dt>October 1, 2010</dt>
 <dd><a href="gcc-4.4/">GCC 4.4.5</a> has been released.</dd>
Index: gcc-4.6/changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-4.6/changes.html,v
retrieving revision 1.58
diff -u -r1.58 changes.html
--- gcc-4.6/changes.html	7 Nov 2010 13:48:21 -0000	1.58
+++ gcc-4.6/changes.html	16 Nov 2010 20:30:46 -0000
@@ -38,6 +38,13 @@
     generic link-time optimization framework (LTO) introduced
     in <a href="../gcc-4.5/changes.html">GCC 4.5.0</a>.</li>
 
+    <li>GCC now ships with the LGPL-licensed <tt>libquadmath</tt> library,
+    which provides for targets with a <tt>__float128</tt> datatype
+    quad-precision mathematical functions. <tt>__float128</tt> is available
+    for targets on 32-bit x86, x86-64 and Itanium architectures. The
+    <tt>libquadmath</tt> library is automatically build on such targets
+    when building the Fortran compiler.</tt>
+
 </ul>
 
 <h2>General Optimizer Improvements</h2>
@@ -181,6 +188,13 @@
 
 <h3 id="fortran">Fortran</h3>
   <ul>
+    <li>On systems supporting the <tt>libquadmath</tt> library, GNU Fortran
+    now also supports a quad-precision, <tt>kind=16</tt> floating-point 
+    data type (<tt>REAL(16)</tt>, <tt>COMPLEX(16)</tt>). As the data type is not
+    fully supported in hardware, calculations might be one to two orders
+    of magnitute slower than with the 4, 8 or 10 bytes floating-point data types.
+    This change does not affect systems which support <tt>REAL(16)</tt> in
+    hardware nor those which do not support  <tt>libquadmath</tt>.</li>
     <li>Much improved compile time for large array constructors.</li>
     <li>Improved diagnostics, especially with
       <code>-fwhole-file</code>.</li>

Re: [Patch,wwwdocs] libquadmath: Mention in the news, add to changes.html

[Gerald Pfeifer]

Hi Tobias,

I like this!

On Tue, 16 Nov 2010, Tobias Burnus wrote:
> Do you have comments or suggestions before I install it?

Index: index.html
===================================================================
+<dt>November 16, 2010</dt>
+<dd><a href="gcc-4.6/changes.html">GCC 4.6.0</a> will include the
+<tt>libquadmath</tt> library, which provides quad-precision mathematical
+functions on targets supporting the <tt>__float128</tt> datatype. The
+library is used to provide on such targets the <tt>REAL(16)</tt> type in GNU
+Fortran compiler. The library has been contributed by Fran&ccedil;ois-Xavier
+Coudert.</dd>

Would you mind using <code>...</code> instead of <tt>...</tt> and
making this a link to gcc-4.6/changes.html#libquadmath (adding that
as an id="libquadmath" at the changes.html page)?

How about changing the last two sentences

  The library is used to provide on such targets the <tt>REAL(16)</tt> 
  type in GNU Fortran compiler. The library has been contributed by 
  Fran&ccedil;ois-Xavier Coudert.

to 

  The library is used to provide the <code>REAL(16)</code> type on
  such targets.  It has been contributed by Fran&ccedil;ois-Xavier 
  Coudert. 
 
?


Index: gcc-4.6/changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-4.6/changes.html,v
retrieving revision 1.58
diff -u -r1.58 changes.html
--- gcc-4.6/changes.html	7 Nov 2010 13:48:21 -0000	1.58
+++ gcc-4.6/changes.html	16 Nov 2010 20:30:46 -0000
@@ -38,6 +38,13 @@
     generic link-time optimization framework (LTO) introduced
     in <a href="../gcc-4.5/changes.html">GCC 4.5.0</a>.</li>
 
+    <li>GCC now ships with the LGPL-licensed <tt>libquadmath</tt> library,
+    which provides for targets with a <tt>__float128</tt> datatype
+    quad-precision mathematical functions. <tt>__float128</tt> is available
+    for targets on 32-bit x86, x86-64 and Itanium architectures. The
+    <tt>libquadmath</tt> library is automatically build on such targets
+    when building the Fortran compiler.</tt>

"build" -> "built"

And <li id="libquadmath"> should give you the target for the link from
the main page.

And <tt>...</tt> -> <code>...</code> throughout.

+    of magnitute slower than with the 4, 8 or 10 bytes floating-point data types.

magnitude

Thanks!

Gerald

Re: [Patch,wwwdocs] libquadmath: Mention in the news, add to changes.html

[Tobias Burnus]

Hi Gerald,

thanks for the review.

On 11/18/2010 09:25 PM, Gerald Pfeifer wrote:
> Index: index.html
> ===================================================================
> +<dt>November 16, 2010</dt>
> +<dd><a href="gcc-4.6/changes.html">GCC 4.6.0</a>  will include the
> +<tt>libquadmath</tt>  library, which provides quad-precision mathematical
> +functions on targets supporting the<tt>__float128</tt>  datatype. The
> +library is used to provide on such targets the<tt>REAL(16)</tt>  type in GNU
> +Fortran compiler. The library has been contributed by Fran&ccedil;ois-Xavier
> +Coudert.</dd>
>
> How about changing the last two sentences
>
>    The library is used to provide on such targets the<tt>REAL(16)</tt>
>    type in GNU Fortran compiler. The library has been contributed by
>    Fran&ccedil;ois-Xavier Coudert.
> to
>    The library is used to provide the<code>REAL(16)</code>  type on
>    such targets.  It has been contributed by Fran&ccedil;ois-Xavier
>    Coudert.

I like the "on such targets", however, I think one should mention 
Fortran there; for instance: "The library is used to provide the 
<code>REAL(16)</code> type in GNU Fortran on such targets."

I think without mentioning Fortran, not only half of the message is lost 
but it also looks redundant and talking about "REAL(16)" might be 
unclear to non-Fortran users.

I have now committed gcc-4.6/changes.html with your proposed changes and 
index.html with your changes - except for the added "in GNU Fortran".

Tobias