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

[Mark Wielaard <mark at klomp dot org>]

Hi Gerald,

On Sun, 2006-02-12 at 00:37 +0100, Gerald Pfeifer wrote:
> 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)?

It could of course, but if I can avoid that work...
There seem to be about 10 duplicate names and the sorting order is
different in the lists. But if you insist.

> 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.

Yes, that was my plan. Mainly because for each GNU Classpath snapshot
this is how contributors are mentioned. And the main contributor list
doesn't contain what people worked on (and isn't as up to date...).
Maybe that should also be fixed "upstream". But correctly listing all
main contributions for everybody since 1998 is quite some work.

> (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 corrected most things you pointed out. New patch attached.
> ========================
> +@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. ;-)

Changed to OS X.

> ...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.

Added @code{} and @option{} all over.

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

Nope. It is Kaffe (www.kaffe.org).

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

Yes that looks better. Although the Cairo/cairo project documentation
isn't that consistent on this matter.

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

I changed them all to bugfix. Although contrib.texi as a whole isn't
consistent and uses both with and without a space.

> Wow, that's really impressive a list!

Yes :) Lots of people worked hard on lots of things this last year. That
was why I wanted them properly credited here.

Cheers,

Mark

Index: gcc/doc/contrib.texi
===================================================================
--- gcc/doc/contrib.texi	(revision 110888)
+++ gcc/doc/contrib.texi	(working copy)
@@ -1,5 +1,5 @@
 @c Copyright (C) 1988,1989,1992,1993,1994,1995,1996,1997,1998,1999,2000,
-@c 2001,2002,2003,2004,2005 Free Software Foundation, Inc.
+@c 2001,2002,2003,2004,2005,2006 Free Software Foundation, Inc.
 @c This is part of the GCC manual.
 @c For copying conditions, see the file gcc.texi.
 
@@ -1145,6 +1145,209 @@
 @end itemize
 
 
+The following people are recognized for their contributions of new
+features, bug reports, testing and integration of classpath/libgcj for
+GCC version 4.1:
+@itemize @bullet
+@item
+Aaron Luchko for JDWP updates and documentation fixes.
+
+@item
+Andreas Jaeger for mprec updates.
+
+@item
+Andreas Tobler for Darwin and Solaris testing and fixing, @code{Qt4}
+support for Darwin/OS X, @code{Graphics2D} support, @code{gtk+}
+updates.
+
+@item
+Andrew Haley for @code{Serialization} and @code{URLClassLoader} fixes,
+gcj build speedups.
+
+@item
+Andrew John Hughes for @code{Locale} and net fixes, URI RFC2986
+updates, @code{Serialization} fixes, @code{Properties} XML support and
+generic branch work, VMIntegration guide update.
+
+@item
+Andrew Overholt for @code{File} locking fixes.
+
+@item
+Anthony Balkissoon for @code{JList}, Free Swing 1.5 updates and mouse event
+fixes, lots of Free Swing work including @code{JTable} editing.
+
+@item
+Anthony Green for @code{MIDI} framework, @code{ALSA} and @code{DSSI}
+providers.
+
+@item
+Archie Cobbs for build fixes, VM interface updates,
+@code{URLClassLoader} updates.
+
+@item
+Audrius Meskauskas for lots of Free Corba, RMI and HTML work plus
+testing and documenting.
+
+@item
+Bastiaan Huisman for @code{TimeZone} bugfixing.
+
+@item
+Bryce McKinlay for RMI work.
+
+@item
+Casey Marshall for crypto algorithm fixes, @code{FileChannel} lock,
+@code{SystemLogger} and @code{FileHandler} rotate implementations, NIO
+@code{FileChannel.map} support, security and policy updates.
+
+@item
+Chris Burdess for lots of gnu.xml and http protocol fixes, @code{StAX}
+and @code{DOM xml:id} support.
+
+@item
+Christian Schlichtherle for zip fixes and cleanups.
+
+@item
+Christian Thalinger for 64-bit cleanups, Configuration and VM
+interface fixes and @code{CACAO} integration, @code{fdlibm} updates.
+
+@item
+Dalibor Topic for better @code{DEBUG} support, build cleanups and
+Kaffe integration. @code{Qt4} build infrastructure, @code{SHA1PRNG}
+and @code{GdkPixbugDecoder} updates.
+
+@item
+Daniel Bonniot for @code{Serialization} fixes.
+
+@item
+David Daney for @code{BitSet} bugfixes, @code{HttpURLConnection}
+rewrite and improvements.
+
+@item
+David Gilbert for @code{basic} and @code{metal} icon and plaf support
+and lots of documenting, Lots of Free Swing and metal theme
+additions. @code{MetalIconFactory} implementation.
+
+@item
+David Lichteblau for JCL support library global/local reference
+cleanups.
+
+@item
+Gael Thomas for @code{VMClassLoader} boot packages support sugestions.
+
+@item
+Gary Benson for @code{MessageFormat} fixes.
+
+@item
+Goffredo Baroncelli for @code{HTTPURLConnection} fixes.
+
+@item
+Guilhem Lavaux for configuration, thread and channel fixes and Kaffe
+integration. JCL native @code{Pointer} updates. Logger bugfixes.
+
+@item
+Ingo Proetel for @code{Image}, @code{Logger} and @code{URLClassLoader}
+updates.
+
+@item
+Ito Kazumitsu for @code{NetworkInterface} implementation and updates.
+
+@item
+Jan Roehrich for @code{BasicTreeUI} and @code{JTree} fixes.
+
+@item
+Jeroen Frijters for @code{ClassLoader} and nio cleanups, serialization fixes,
+better @code{Proxy} support, bugfixes and IKVM integration.
+
+@item
+Julian Scheid for documentation updates and gjdoc support.
+
+@item
+Ka-Hing Cheung for @code{TreePath} and @code{TreeSelection} fixes.
+
+@item
+Kalle Olavi Niemitalo for build fixes.
+
+@item
+Keith Seitz for lots of JDWP work.
+
+@item
+Kelley Cook for build fixes.
+
+@item
+Kim Ho for @code{JFileChooser} implementation.
+
+@item
+Lillian Angel for @code{JTree} implementation and lots Free Swing
+additions and bugfixes.
+
+@item
+Mark Wielaard for bugfixes, packaging and release management,
+@code{Clipboard} implementation, system call interrupts and network
+timeouts and @code{GdkPixpufDecoder} fixes.
+
+@item
+Martin Cordova for Suggestions for better @code{SocketTimeoutException}.
+
+@item
+Michael Koch for configuration fixes, @code{Locale} updates, bug and
+build fixes.
+
+@item
+Nicolas Geoffray for @code{VMClassLoader} and @code{AccessController}
+improvements.
+
+@item
+Olga Rodimina for @code{MenuSelectionManager} implemenation.
+
+@item
+Paul Jenner for better @option{-Werror} support.
+
+@item
+Rainer Orth for build fixes.
+
+@item
+Robert Schuster for documentation updates and beans fixes,
+@code{TreeNode} enumerations and @code{ActionCommand} and various
+fixes, XML and URL, AWT and Free Swing bugfixes.
+
+@item
+Roman Kennke for @code{BoxLayout}, @code{GrayFilter} and
+@code{SplitPane}, plus bugfixes all over. Lots of Free Swing work
+including styled text.
+
+@item
+Santiago Gala for @code{AccessControlContext} fixes.
+
+@item
+Simon Kitching for @code{String} cleanups and optimization suggestions.
+
+@item
+Stuart Ballard for RMI constant fixes.
+
+@item
+Sven de Marothy for BMP imageio support, CSS and @code{TextLayout}
+fixes. @code{GtkImage} rewrite, 2D, awt, free swing and date/time fixes and
+implementing the Qt4 peers.
+
+@item
+Thomas Fitzsimmons for lots of upgrades to the gtk+ AWT and Cairo 2D
+support. Lots of imageio framework additions, lots of AWT and Free
+Swing bugfixes.
+
+@item
+Tom Tromey for Eclipse integration, generics work, lots of bugfixes
+and gcj integration including coordinating The Big Merge.
+
+@item
+Wolfgang Baer for @code{GapContent} bugfixes.
+
+@item
+Ziga Mahkovec for @code{Graphics2D} upgraded to Cairo 0.5 and new regex
+features.
+
+@end itemize
+
+
 In addition to the above, all of which also contributed time and energy in
 testing GCC, we would like to thank the following for their contributions
 to testing:

Attachment: signature.asc
Description: This is a digitally signed message part