diff mbox

[wwwdocs] darwin additions to gcc-4.6/changes.html

Message ID 5F8C2073-7A47-4151-9F9B-4C0786EAA409@sandoe-acoustics.co.uk
State New
Headers show

Commit Message

Iain Sandoe Feb. 7, 2011, 10:02 a.m. UTC 
Hi Gerald,

On 7 Feb 2011, at 02:07, Gerald Pfeifer wrote:

> On Thu, 3 Feb 2011, IainS wrote:
>> Here is an initial stab at a changes entry for Darwin.
>> comments?
>
> I was going to make some tweaks and commit the patch with you, but
> somehow I'm struggling with a number of overly long lines which break
> the patch. :-(
>
> Do you mind reformatting to avoid lines longer than some 76 columns?
>
>> Index: htdocs/gcc-4.6/changes.html
>> ===================================================================
>> +      'toll-free bridged' as per the Mac OSX system tools.
>
> Is there a specific reason to use single quotes? Otherwise I suggest
> to use double quotes.
>
> Is Mac OSX really the proper spelling or is there a blink before X
> missing?
indeed, in a couple of places, fixed.
>
>> +      <li>The <code>-mdynamic-no-pic</code> option has been  
>> enabled</li>
>
> Full stop?
done
>
>> +      Code supporting <code>-mdynamic-no-pic</code> optimization  
>> has been
>> added
>
> Something's wrong in terms of markup.  You have a closing </li> and  
> then
> a new sentence without an opening <li>?
>
>> +      <li>The default value for <code>-mtune=</code> has been  
>> changed</li>
>> +      Since Darwin systems are primarily Xeon, Core-2 or similar  
>> the default
>> tuning
>> +      has been changed to <code>-mtune=core2</code>.
>
> Same here.
>
> In case you want to force a line break, use <br />, but put the </li>
> at the end of the itme.
>
>> +      Several significant bugs have been fixed, such that GCC now  
>> produces
>> code
>> +      compatible with the Darwin64 PowerPC ABI.
>
> </li>
>
>> +      <li>libffi and boehm-gc</li>
>> +      The Darwin ports of the <code>libffi</code> and <code>boehm- 
>> gc</code>
>> +      libraries have been upgraded to include a Darwin64  
>> implementation.
>> +      This means that powerpc*-*-darwin9 platforms may now, for  
>> example,
>> build
>> +      Java applications with <code>-m64</code> enabled.
>
> Same as above re </li>.

sorted out that generic mis-pattern, hopefully..

> When refering to the libraries, I don't think we need <code>...</ 
> code>.
OK, done.

> The patch looks fine with this changes, and Mike already nodded.  When
> committing just watch out for messages from my validator script; it is
> possible I missed one or two details.


Thanks very much for the review - as you can see, I'm not familiar  
with markup ;)
This is what I committed, hopefully taking account of all your points  
above.
thanks
Iain
diff mbox

Patch

Index: htdocs/gcc-4.6/changes.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-4.6/changes.html,v
retrieving revision 1.104
diff -u -r1.104 changes.html
--- htdocs/gcc-4.6/changes.html	4 Feb 2011 17:09:23 -0000	1.104
+++ htdocs/gcc-4.6/changes.html	7 Feb 2011 09:54:38 -0000
@@ -817,6 +817,53 @@ 
       At the moment, Android support is enabled only for ARM.</li>
   </ul>
 
+<h3 id="darwin">Darwin/Mac OS X</h3>
+  <ul>
+      <li>General 
+       <ul>
+	<li>Initial support for <code>CFString</code> types has been
+	added.<br /> This allows GCC to build projects including the system
+	<em>Core Foundation</em> frameworks. The GCC Objective-C family
+	supports <code>CFString</code> "toll-free bridged" as per the Mac 
+	OS X system tools. <code>CFString</code> is also recognized in the
+	context of <code>format</code> attributes and arguments (see the
+	documentation for <code>format</code> attributes for limitations).
+	At present, 8-bit character types are supported.</li>
+	<li>LTO-support.<br />Darwin has benefited from ongoing work on
+	LTO; support for this is now stable and enabled by default.</li>
+	<li>Object file size reduction.<br /> The Darwin zeroed memory
+	allocators have been re-written to make more use of
+	<code>.zerofill</code> sections.  For non-debug code, this can
+	reduce object file size significantly.</li>
+       </ul></li>
+      <li>x86 Architecture 
+       <ul>
+	<li>The <code>-mdynamic-no-pic</code> option has been 
+	enabled.<br />Code supporting <code>-mdynamic-no-pic</code>
+	optimization has been added and is applicable to <code>-m32</code>
+	builds. The compiler bootstrap uses the option where 
+	appropriate.</li>
+	<li>The default value for <code>-mtune=</code> has been 
+	changed.<br />Since Darwin systems are primarily Xeon, Core-2 or
+	similar the default tuning has been changed to 
+	<code>-mtune=core2</code>.</li>
+      </ul></li>
+    <li>PPC Architecture
+      <ul>
+       <li>Darwin64 ABI.<br />Several significant bugs have been fixed,
+	such that GCC now produces code compatible with the Darwin64
+	PowerPC ABI.</li>
+	<li>libffi and boehm-gc.<br />The Darwin ports of the libffi and
+	boehm-gc libraries have been upgraded to include a Darwin64
+	implementation. This means that powerpc*-*-darwin9 platforms may
+	now, for example, build Java applications with <code>-m64</code>
+	enabled.</li>
+	<li>Plug-in support has been enabled.</li>
+	<li>The <code>-fsection-anchors</code> option is now available
+	although, presently, not heavily tested.</li>
+      </ul></li>
+  </ul>
+
 <h3 id="solaris">Solaris 2</h3>
     <h4>New Features</h4>
     <ul>