Re: Documenting what changed since 4.0 (gcj core libraries)

[Gerald Pfeifer <gp at suse dot de>]

On Tue, 31 Jan 2006, Mark Wielaard wrote:
> Is this OK? It is modeled after the Ada section.
> 
> 2006-01-31  Mark Wielaard  <mark@klomp.org>
> 
>     * doc/contrib.texi (Contributors): Add classpath/libgcj hackers
>     who added new 4.1 features, bug fixes and integration support.

Uh, umm.  If I remember correctly, the one concern I had, back when the 
Ada entries were added, is that we should avoid contrib.texi become a list 
of lists of contributions per project.

That is, ideally I'd prefer one list of contributors, listing each of
the achievements/contributions for the various subprojects that constitute 
GCC.

Do you think that would be possible in this case, for example by referring 
to "contributions to libgcj (contribution a, contribution b)?

The current patch submissions handles libgcj 4.1 nicely; did you plan to 
add a separate one for 4.2 and subsequent releases?  That's one of the 
reasons I'd be more in favor of one consolidated list, but I'd be 
interested in your thoughts on this.

(Orthogonally to this question, below I include some minor suggestion
for the current patch, which should be reusable even if we decide to
merge the lists.)

> I'll try making a complete list for all classpath contributors ever.
> If that is added and published I'll add a link in contrib.texi to it.

Consider an addition of such a link, somewhere close to the end of
contrib.texi preapproved.  Thanks!

Gerald

Index: gcc/doc/contrib.texi
===================================================================
+@item
+Andreas Tobler for Darwin and Solaris testing and fixing, Qt4 support
+for Darwin/OSX, Graphics2D support, gtk+ updates.

Is "OSX" the preferred spelling?  Just a question, I'm not sure. ;-)

Assuming Graphics2D...

+@item
+Andrew Haley for Serialization and URLClassLoader fixes, gcj build
+speedups.

...and Serialization are class names, I assume we want to mark them
up similarly to what we (well, you ;-) did for the gcc-4.1/changes.html
pages.

+@item
+Anthony Balkissoon for JList, Free Swing 1.5 updates and mouse event
+fixes, Lots of Free Swing work including JTable editing.

"lots of"

+@item
+Archie Cobbs for Build fixes, VM interface updates, URLClassLoader
+updates.

"build fixes"?

+@item
+Chris Burdess for Lots of gnu.xml and http protocol fixes, StAX and
+dom xml:id support.

"lots of"

+Dalibor Topic for Better DEBUG support, Build cleanups and Kaffe
+integration. Qt4 build infrastructure, SHA1PRNG and GdkPixbugDecoder
+updates.

"better", "build cleanups"

Isn't "Kaffe" spelt with an extra e?

+@item
+Jeroen Frijters for ClassLoader and nio cleanups, Serialization fixes,
+better Proxy support, bug fixes and IKVM integration.

"proxy", unless its's a class, of course.

+@item
+Julian Scheid for Documentation updates and gjdoc support.

"documentation"

+@item
+Keith Seitz for Lots of JDWP work.

"lots of"

+@item
+Lillian Angel for JTree implementation and lots Free Swing additions
+and bug fixes.

"lots of Free Swing"?

+@item
+Mark Wielaard for bug fixes, packaging and release management,
+Clipboard implementation, System call interrupts and network timeouts
+and GdkPixpufDecoder fixes.

"system call"?

+@item
+Martin Cordova for Suggestions for better SocketTimeoutException.

"suggestions"

+@item
+Paul Jenner for better -Werror support.

@option{-Werror}

+@item
+Thomas Fitzsimmons for Lot of upgrades to the gtk+ AWT and cairo 2D
+support. Lots of imageio framework additions, lots of AWT and Free
+Swing bug fixes.

"Lot of" -> "lots of"

"Cairo" with an uppercase c, perhaps?  (Also a bit later in the text?)

Finally, I noticed that once we have "bug fix", and once "bugfix".

Wow, that's really impressive a list!