diff mbox

[wwwdocs] : Updated gcc-4.6/changes.html for Objective-C/Objective-C++

Message ID 1294694797.201916903@192.168.4.58
State New
Headers show

Commit Message

Nicola Pero Jan. 10, 2011, 9:26 p.m. UTC 
> This is quite long compared to the length of your usual entries.  It
> is fine, just would be good to shorten it a bit.

Ok - here are two options - one which is short, and the other
one which is extremely short.  You tell me which one you prefer. :-)

But, let me argue for just one email about why I wouldn't (personally)
go for the extremely short one.  I'll stop arguing after this email. ;-)

As a user looking at the GCC home page I always found the news very
laconic - few, sparse and very short entries - making you feel that
there isn't much going on (which, I have to say, is completely
the opposite of what really happens!).

So I'd suggest we include a bit more information in news entries (not just
this one, but all of them ;-) ... all other GCC maintainers and contributors
should write a few more words too when they write news entries!). ;-)

Anyway, here is the short version --

If you (still) prefer this second version, it's not a problem - let me know
and I'll commit this one.  It certainly is more consistent with previous news
entries. ;-)

Thanks

Comments

Gerald Pfeifer Jan. 10, 2011, 11:55 p.m. UTC | #1 
On Mon, 10 Jan 2011, Nicola Pero wrote:
> As a user looking at the GCC home page I always found the news very
> laconic - few, sparse and very short entries - making you feel that
> there isn't much going on (which, I have to say, is completely
> the opposite of what really happens!).

That's a fair comment -- as you (and Mike) have argued, we should
be more aggressive.

> Anyway, here is the short version --

Okay, I'm sold. :-)

> +<dd><a href="gcc-4.6/changes.html#objective-c">GCC 4.6</a> will
> +  support many new Objective-C features, such as declared and

I suggest to make the link on "Objective-C features", but you're
welcome to leave things as they are in this patch.

> If you (still) prefer this second version, it's not a problem - let
> me know and I'll commit this one.  It certainly is more consistent
> with previous news entries. ;-)

As long as we don't move towards entries with epic length such that
only one fits on the page, let's give it a try.

Cheers,
Gerald
diff mbox

Patch

Index: index.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/index.html,v
retrieving revision 1.774
diff -u -r1.774 index.html
--- index.html  4 Jan 2011 11:46:24 -0000       1.774
+++ index.html  10 Jan 2011 20:50:44 -0000
@@ -50,6 +50,15 @@ 
 <h2 style="margin-top:0pt;" id="news">News</h2>
 
 <dl class="news">
+<dt>January 10, 2011</dt>
+
+<dd><a href="gcc-4.6/changes.html#objective-c">GCC 4.6</a> will
+  support many new Objective-C features, such as declared and
+  synthesized properties, dot syntax, fast enumeration, optional
+  protocol methods, method/protocol/class attributes, class extensions
+  and a new GNU Objective-C runtime API.  This was contributed by
+  Nicola Pero and Iain Sandoe, with support from Mike Stump.</dd>
+
 <dt>December 16, 2010</dt>
 <dd><a href="gcc-4.5/">GCC 4.5.2</a> has been released.</dd>

This is a reworked version of the one I sent before, and I shrinked it,
but still has the same structure.  I think it's appropriate for
the news, as the first half sentence clearly summarizes everything (and could
be turned into a title ?), and the rest contains a more detailed summary for
the readers who will actually read beyond the first few words.  It
provides an intermediate level of information between just knowing that
"there are new Objective-C features" and the full, detailed and explained
list of features in the release notes.

But - if I didn't convince you :-), here is the alternative "very short one"
that more closely matches what you requested/expect --

Index: index.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/index.html,v
retrieving revision 1.774
diff -u -r1.774 index.html
--- index.html  4 Jan 2011 11:46:24 -0000       1.774
+++ index.html  10 Jan 2011 21:00:45 -0000
@@ -50,6 +50,13 @@ 
 <h2 style="margin-top:0pt;" id="news">News</h2>
 
 <dl class="news">
+<dt>January 10, 2011</dt>
+
+<dd><a href="gcc-4.6/changes.html#objective-c">GCC 4.6</a> will
+  support many new Objective-C features and a new GNU Objective-C
+  runtime API.  This was contributed by Nicola Pero and Iain Sandoe,
+  with support from Mike Stump.</dd>
+
 <dt>December 16, 2010</dt>
 <dd><a href="gcc-4.5/">GCC 4.5.2</a> has been released.</dd>