From jleuner@elandtech.com Tue Apr 02 10:29:32 2002
Received: from spamisevil.test.ie.vianw.net ([212.17.60.214] helo=lenny.elandtech.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16sQDz-0004g9-00
	for <classpath@gnu.org>; Tue, 02 Apr 2002 10:29:31 -0500
Received: from [192.168.100.211] (helo=bapli ident=mail)
	by lenny.elandtech.com with esmtp (Exim 3.34 #1 (Debian))
	id 16sQ8k-0003O4-00; Tue, 02 Apr 2002 15:24:06 +0000
Received: from jleuner by bapli with local (Exim 3.34 #1 (Debian))
	id 16sQ8m-0006BF-00; Tue, 02 Apr 2002 16:24:08 +0100
Date: Tue, 2 Apr 2002 16:24:08 +0100
From: John Leuner <jewel@pixie.co.za>
To: classpath@gnu.org, Eric Blake <ebb9@email.byu.edu>
Cc: kissme-general@lists.sourceforge.net
Subject: Re: [Kissme-general] SystemClassLoader fix
Message-ID: <20020402152408.GF28538@bapli>
References: <200203212304.g2LN49h20238@piglet.dstc.edu.au> <200203221402.g2ME2ah09886@piglet.dstc.edu.au> <20020323174231.GI29537@bapli> <20020328204304.GD28538@bapli> <3CA38CD3.A2A1838C@email.byu.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3CA38CD3.A2A1838C@email.byu.edu>
User-Agent: Mutt/1.3.27i
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> I cleaned your patch up a bit, and once I get it to compile, I'm
> committing it. Thanks for the catch - I documented that the class
> specified by java.system.class.loader must now have a constructor which
> accepts a parent class loader.

It wasn't really a patch, just a demonstration of the problem. 

Any reason why it wouldn't compile?

John Leuner


> John Leuner wrote:
> > 
> > I tracked this down to the ClassLoader class.
> > 
> > 
> > Otherwise getSystemClassLoader gets in an infinite loop where the Constructor for SystemClassLoader calls the ClassLoader() constructor which tries to use the system class loader as the parent classloader and round and round it goes ...
> > 
> > John Leuner
> > 
> 
> 2002-03-28  John Leuner  <jewel@debian.org>
> 
> 	* java/lang/ClassLoader.java (getSystemClassLoader): Break
> 	infinite loop by specifying parent classloader.
> 	* gnu/java/lang/SystemClassLoader.java (SystemClassLoader): Add
> 	proper constructor.
> 
> -- 
> This signature intentionally left boring.
> 
> Eric Blake             ebb9@email.byu.edu
>   BYU student, free software programmer
> Index: gnu/java/lang/SystemClassLoader.java
> ===================================================================
> RCS file: /cvsroot/classpath/classpath/gnu/java/lang/SystemClassLoader.java,v
> retrieving revision 1.1
> diff -u -r1.1 SystemClassLoader.java
> --- gnu/java/lang/SystemClassLoader.java	22 Mar 2002 21:25:20 -0000	1.1
> +++ gnu/java/lang/SystemClassLoader.java	28 Mar 2002 21:36:04 -0000
> @@ -64,6 +64,17 @@
>  
>    /** Flag to avoid infinite loops. */
>    private static boolean is_trying;
> +
> +  /**
> +   * Creates a class loader. Note that the parent may be null, when this is
> +   * created as the system class loader by ClassLoader.getSystemClassLoader.
> +   *
> +   * @param parent the parent class loader
> +   */
> +  public SystemClassLoader(ClassLoader parent)
> +  {
> +    super(parent);
> +  }
>      
>    /**
>     * Get the URL to a resource.
> Index: java/lang/ClassLoader.java
> ===================================================================
> RCS file: /cvsroot/classpath/classpath/java/lang/ClassLoader.java,v
> retrieving revision 1.16
> diff -u -r1.16 ClassLoader.java
> --- java/lang/ClassLoader.java	22 Mar 2002 21:25:20 -0000	1.16
> +++ java/lang/ClassLoader.java	28 Mar 2002 21:36:05 -0000
> @@ -48,6 +48,7 @@
>  import java.util.Enumeration;
>  import java.util.HashMap;
>  import java.util.Map;
> +import gnu.java.lang.SystemClassLoader;
>  import gnu.java.util.DoubleEnumeration;
>  import gnu.java.util.EmptyEnumeration;
>  
> @@ -685,7 +686,8 @@
>     * property <code>java.class.path</code>. This is set as the context
>     * class loader for a thread. The system property
>     * <code>java.system.class.loader</code>, if defined, is taken to be the
> -   * name of the class to use as the system class loader, otherwise this
> +   * name of the class to use as the system class loader, which must have
> +   * a public constructor which takes a ClassLoader as a parent; otherwise this
>     * uses gnu.java.lang.SystemClassLoader.
>     *
>     * <p>Note that this is different from the bootstrap classloader that
> @@ -713,12 +715,28 @@
>                                             "gnu.java.lang.SystemClassLoader");
>          try
>            {
> -            return (ClassLoader) Class.forName(loader).newInstance();
> +            // Give the new system class loader a null parent.
> +            Constructor c = Class.forName(loader).getConstructor
> +              ( new Class[] { ClassLoader.class } );
> +            return (ClassLoader) c.newInstance(new Object[1]);
>            }
>          catch (Exception e)
>            {
> -            throw (Error) new InternalError
> -              ("System class loader could not be found: " + e).initCause(e);
> +            try
> +              {
> +                System.err.println("Requested system classloader "
> +                                   + loader + " failed, trying "
> +                                   + "gnu.java.lang.SystemClassLoader");
> +                e.printStackTrace();
> +                // Fallback to gnu.java.lang.SystemClassLoader.
> +                return new SystemClassLoader(null);
> +              }
> +            catch (Exception e1)
> +              {
> +                throw (Error) new InternalError
> +                  ("System class loader could not be found: " + e)
> +                  .initCause(e);
> +              }
>            }
>        }
>      // Check if we may return the system classloader



From ebb9@email.byu.edu Tue Apr 02 10:49:54 2002
Received: from rwcrmhc54.attbi.com ([216.148.227.87])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16sQXh-0000G7-00
	for <classpath@gnu.org>; Tue, 02 Apr 2002 10:49:53 -0500
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc54.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020402154944.EPVD2974.rwcrmhc54.attbi.com@email.byu.edu>;
          Tue, 2 Apr 2002 15:49:44 +0000
Message-ID: <3CA9D2D8.75FDF9A9@email.byu.edu>
Date: Tue, 02 Apr 2002 08:48:40 -0700
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: John Leuner <jewel@pixie.co.za>
CC: classpath@gnu.org, kissme-general@lists.sourceforge.net
Subject: Re: [Kissme-general] SystemClassLoader fix
References: <200203212304.g2LN49h20238@piglet.dstc.edu.au>
	 <200203221402.g2ME2ah09886@piglet.dstc.edu.au> <20020323174231.GI29537@bapli>
	 <20020328204304.GD28538@bapli> <3CA38CD3.A2A1838C@email.byu.edu> <20020402152408.GF28538@bapli>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

John Leuner wrote:
> 
> > I cleaned your patch up a bit, and once I get it to compile, I'm
> > committing it. Thanks for the catch - I documented that the class
> > specified by java.system.class.loader must now have a constructor which
> > accepts a parent class loader.
> 
> It wasn't really a patch, just a demonstration of the problem.
> 
> Any reason why it wouldn't compile?

Yes - the patch as it appeared in my reply to your email was hastily
written and untested (ie. I wrote the patch and replied to your email
before starting the time-consuming compilation and regression testing
process).  I think the only change I had to make before committing it,
however, was adding an import statement.  And it has been in CVS for
nearly a week now.

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From tromey@creche.cygnus.com Tue Apr 02 17:17:58 2002
Received: from mail.peakpeak.com ([207.174.178.17] helo=gash2.peakpeak.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16sWbG-0004aH-00
	for <classpath@gnu.org>; Tue, 02 Apr 2002 17:17:58 -0500
Received: from creche.cygnus.com (ta0195.peakpeak.com [204.144.244.195])
	by gash2.peakpeak.com (8.9.3/8.9.3) with ESMTP id PAA27832;
	Tue, 2 Apr 2002 15:17:45 -0700
Received: (from tromey@localhost)
	by creche (8.9.3/8.9.3) id PAA21814;
	Tue, 2 Apr 2002 15:04:17 -0700
To: Per Bothner <per@bothner.com>
Cc: java@gcc.gnu.org, classpath@gnu.org, Warren Levy <warrenl@cruzio.com>
Subject: Re: debug output problem in ObjectInputStream
References: <3CAA232C.40109@bothner.com>
From: Tom Tromey <tromey@redhat.com>
Reply-To: tromey@redhat.com
X-Attribution:  Tom
X-Zippy:  Did YOU find a DIGITAL WATCH in YOUR box of VELVEETA?
Date: 02 Apr 2002 15:03:17 -0700
In-Reply-To: Per Bothner's message of "Tue, 02 Apr 2002 13:31:24 -0800"
Message-ID: <87r8lxg3mi.fsf@creche.redhat.com>
Lines: 13
X-Mailer: Gnus v5.7/Emacs 20.5
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

>>>>> "Per" == Per Bothner <per@bothner.com> writes:

Per> So if we want to keep the debugging printout, I suggest:

Per>    if (Configuration.DEBUG && dump)
Per>      for (int i=0, len=Array.getLength(array); i < len; i++)
Per>        System.out.println("  ELEMENT[" + i + "]=" + Array.get(array, i));

As I recall, Warren wrote all the debugging code.  He's probably in
the best position to say how useful it really is.  I've CC'd him.
(Warren, I'll forward you Per's note separately.)

Tom


From per@bothner.com Tue Apr 02 17:21:57 2002
Received: from adsl-216-102-199-253.dsl.snfc21.pacbell.net ([216.102.199.253] helo=bothner.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16sVqx-00053p-00
	for <classpath@gnu.org>; Tue, 02 Apr 2002 16:30:07 -0500
Received: from bothner.com (eureka.bothner.com [192.168.1.9])
	by bothner.com (8.11.6/8.11.6) with ESMTP id g32LcIR09934;
	Tue, 2 Apr 2002 13:38:18 -0800
Message-ID: <3CAA232C.40109@bothner.com>
Date: Tue, 02 Apr 2002 13:31:24 -0800
From: Per Bothner <per@bothner.com>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.9+) Gecko/20020328
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: java@gcc.gnu.org, classpath@gnu.org
Subject: debug output problem in ObjectInputStream
Content-Type: multipart/mixed;
 boundary="------------040303030201050301090009"
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

This is a multi-part message in MIME format.
--------------040303030201050301090009
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

(This problem was reported to me by L. Peter Deutsch.)

The class java/io/ObjectInputStream.java contains a lot
of calls to dumpElement and dumpElementln, which prints
the argument is debugging is enabled. By default the
DEBUG flag is false, so debugging is disabled.  Ideally
a compiler will be able to inline and eliminate the
calls to dumpElement[ln].

The problem is that the argument to dumpElement[ln] is
still evaluated, even when DEBUG is false.  In many cases
these arguments are non-trivial string concatenation expressions,
so we will get a temporary StringBuffer allocated, appended
to and thrown away.  A smart compiler might be able to
figure out that the result of the concatenation is unused,
and so avoid it.  Even worse though is that it calls
toString for each element of an array (and also for exceptions).
Since toString of an unknown class can do anything, the
compiler can't eliminate the call to toString.  It is even
possible that toString for a large (or cyclic) data structure
could do a large(or even an infinite) amount of work.

I've appended one fix, but I'm not sure what the best approach is.
The simplest would be to just rip out all the dumpElement code.
Next simplest is to move all the Configuration.DEBUG && dump
tests out of dumpElement[ln] and to the call sites.  One could
even do what my patches does, and convert the string concatenations
to multiple print calls.  Having dumpElement[ln] as separate
methods has the advantage that it could over overridden, but
it seems like poinles generality.  So if we want to keep the
debugging printout, I suggest:

   if (Configuration.DEBUG && dump)
     for (int i=0, len=Array.getLength(array); i < len; i++)
       System.out.println("  ELEMENT[" + i + "]=" + Array.get(array, i));

This makes it possible for a compiler to do the optimization to
multiple print calls that my patch does.

Alteratively, I suggest just removing all the dumpElement calls.
-- 
	--Per Bothner
per@bothner.com   http://www.bothner.com/per/

--------------040303030201050301090009
Content-Type: text/plain;
 name="OIS.patch"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="OIS.patch"

Index: ObjectInputStream.java
===================================================================
RCS file: /cvs/gcc/gcc/libjava/java/io/ObjectInputStream.java,v
retrieving revision 1.11
diff -u -r1.11 ObjectInputStream.java
--- ObjectInputStream.java	2002/01/22 22:40:14	1.11
+++ ObjectInputStream.java	2002/04/02 20:45:49
@@ -243,8 +243,16 @@
 	Object array = Array.newInstance (componentType, length);
 	int handle = assignNewHandle (array);
 	readArrayElements (array, componentType);
-	for (int i=0, len=Array.getLength(array); i < len; i++)
-	  dumpElementln ("  ELEMENT[" + i + "]=" + Array.get(array, i).toString());
+	if (Configuration.DEBUG && dump)
+	  {
+	    for (int i=0, len=Array.getLength(array); i < len; i++)
+	      {
+		System.out.print("  ELEMENT[");
+		System.out.print(i);
+		System.out.print("]=");
+		System.out.println(Array.get(array, i));
+	      }
+	  }
 	ret_val = processResolution (array, handle);
 	break;
       }

--------------040303030201050301090009--



From bryce@waitaki.otago.ac.nz Wed Apr 03 01:43:59 2002
Received: from mailhub1.otago.ac.nz ([139.80.64.218])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16seUw-0007iX-00
	for <classpath@gnu.org>; Wed, 03 Apr 2002 01:43:58 -0500
Received: (from root@localhost)
	by mailhub1.otago.ac.nz (8.10.1/8.10.1) id g336hsD09619;
	Wed, 3 Apr 2002 18:43:54 +1200
Received: from waitaki.otago.ac.nz (waitaki.otago.ac.nz [139.80.75.140])
	by mailhub1.otago.ac.nz (8.10.1/8.10.1) with ESMTP id g336hsD09581;
	Wed, 3 Apr 2002 18:43:54 +1200
Received: from waitaki.otago.ac.nz (IDENT:bryce@reason.otago.ac.nz [139.80.119.17])
	by waitaki.otago.ac.nz (8.11.6/8.11.6) with ESMTP id g336lxe13844;
	Wed, 3 Apr 2002 18:47:59 +1200
Message-ID: <3CAAA455.50908@waitaki.otago.ac.nz>
Date: Wed, 03 Apr 2002 18:42:29 +1200
From: Bryce McKinlay <bryce@waitaki.otago.ac.nz>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.7) Gecko/20011221
X-Accept-Language: en-us
MIME-Version: 1.0
To: Per Bothner <per@bothner.com>
CC: java@gcc.gnu.org, classpath@gnu.org
Subject: Re: debug output problem in ObjectInputStream
References: <3CAA232C.40109@bothner.com>
X-scanner: scanned by Inflex 1.0.9 - (http://pldaniels.com/inflex/)
Content-Type: multipart/mixed;
 boundary="------------050509010801090203010407"
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

This is a multi-part message in MIME format.
--------------050509010801090203010407
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

Per Bothner wrote:

> Having dumpElement[ln] as separate
> methods has the advantage that it could over overridden, but
> it seems like poinles generality.  So if we want to keep the
> debugging printout, I suggest:
>
>   if (Configuration.DEBUG && dump)
>     for (int i=0, len=Array.getLength(array); i < len; i++)
>       System.out.println("  ELEMENT[" + i + "]=" + Array.get(array, i));
>
> This makes it possible for a compiler to do the optimization to
> multiple print calls that my patch does. 


I was originally hoping that the dumpElement() methods would get inlined 
and the compiler would figure out that the code could be removed, but 
you're right in that even if inlining worked properly the arguments 
would still have to be evaluated unless it could also figure out that 
the StringBuffer methods etc had no side-effects.

I agree that we should put the "if (Configuration.DEBUG ..." at the call 
site to fix this. However, fixing this doesn't really help our extremely 
crap serialization performance. eg the attached test runs more than 45X 
slower with GCJ than JDK 1.4! Serialization needs some work...

regards

Bryce.


--------------050509010801090203010407
Content-Type: text/plain;
 name="SerTest3.java"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="SerTest3.java"

import java.util.*;
import java.io.*;

public class SerTest3
{
  static void showUsage()
  {
    System.err.println("Usage: SerTest3 <read|write>");
    System.exit(1);  
  }
  
  public static void main(String[] args) 
    throws IOException, FileNotFoundException, ClassNotFoundException
  {
    if (args.length == 0)
      showUsage();
    
    HashMap hm = null;    
    long start = System.currentTimeMillis();
    
    if (args[0].equals("write"))
      {
        hm = makeHugeHashMap();
	System.out.println ("map created, writing it out...");
	ObjectOutputStream out = 
	  new ObjectOutputStream(new FileOutputStream("test.ser"));

	out.writeObject(hm);
	out.close();
      }
    else if (args[0].equals("read"))
      {      
	ObjectInputStream in = 
	  new ObjectInputStream(new FileInputStream("test.ser"));

	hm = (HashMap) in.readObject();
      }
    else
      showUsage();
      
    System.out.println(hm.hashCode());
    System.out.println(System.currentTimeMillis() - start + "ms elapsed.");
  }
  
  static HashMap makeHugeHashMap()
  {
    HashMap hm = new HashMap();
    for (int i=0; i < 200; i++)
    {
      ArrayList al = new ArrayList();
      for (int j=0; j < 1000; j++)
      {
        al.add (Integer.toString(i - j));
      }
      Integer integer = new Integer(i);
      hm.put(integer, al);
    }
    return hm;
  }
}

--------------050509010801090203010407--



From nferrier@tapsellferrier.co.uk Thu Apr 04 11:03:47 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16t9iF-0006Mx-00
	for <classpath@gnu.org>; Thu, 04 Apr 2002 11:03:47 -0500
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 16tA6q-0005Dv-00; Thu, 04 Apr 2002 16:29:12 +0000
To: classpath@gnu.org
Subject: Any comments on Patch 197?
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 04 Apr 2002 17:02:21 +0100
Message-ID: <876637e9ki.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 7
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I submitted this a while ago... there was some discussion about it
with a few people not liking the idea.

Should I withdraw this or check it in?


Nic



From WarrenL@cruzio.com Tue Apr 02 21:02:52 2002
Received: from mail.cruzio.com ([63.249.95.37])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16sZmi-0001Rc-00
	for <classpath@gnu.org>; Tue, 02 Apr 2002 20:42:01 -0500
Received: from cruzio.com (dsl3-63-249-87-116.cruzio.com [63.249.87.116])
	by mail.cruzio.com with ESMTP id RAA12967;
	Tue, 2 Apr 2002 17:49:23 -0800 (PST)
Message-ID: <3CAA5E3F.26FA260D@cruzio.com>
Date: Tue, 02 Apr 2002 17:43:27 -0800
From: Warren Levy <WarrenL@cruzio.com>
X-Mailer: Mozilla 4.79 [en] (Win95; U)
X-Accept-Language: en,Hebrew
MIME-Version: 1.0
To: Per Bothner <per@bothner.com>
CC: java@gcc.gnu.org, classpath@gnu.org
Subject: Re: debug output problem in ObjectInputStream
References: <3CAA232C.40109@bothner.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Per Bothner wrote:
> I've appended one fix, but I'm not sure what the best approach is.
> The simplest would be to just rip out all the dumpElement code.

Well, I'd hesitate to just rip it out.  The dumping code is extremely
helpful when dealing with serialization issues.

> Next simplest is to move all the Configuration.DEBUG && dump
> tests out of dumpElement[ln] and to the call sites.

I'd rather go with this approach than losing the capability to dump.

> Having dumpElement[ln] as separate
> methods has the advantage that it could over overridden, but
> it seems like poinles generality.

It wasn't so much an issue of it being overridden, as it seemed like
a much cleaner approach than having separate conditionals and println's
spread throughout the code.  I found it very helpful when debugging to
just set a breakpoint for dumpElement; if we get rid of the method and
sprinkle the code with the conditional and prints, we'll lose that ease
in debugging.  Having a separate dumpElement method also certainly improved 
readability of the code (at least IMO).  I'm fine though with readability 
and ease of debugging suffering a little bit, if it avoids needless 
processing in the typical case.

> So if we want to keep the
> debugging printout, I suggest:
> 
>    if (Configuration.DEBUG && dump)
>      for (int i=0, len=Array.getLength(array); i < len; i++)
>        System.out.println("  ELEMENT[" + i + "]=" + Array.get(array, i));

This seems cleaner than also breaking it out into multiple print calls.

I'd offer to make the changes myself but I'm not in a position to get
them in on the 3.1 branch at this time (nor the trunk for that matter).
I'm updating my paperwork with the GNU Project and then I'll be able to 
get my cvs access updated to allow me to commit changes to both gcj and 
Classpath.
--warrenl


From Thomas.hergenhahn@web.de Wed Apr 03 12:24:48 2002
Received: from smtp01.web.de ([194.45.170.210] helo=smtp.web.de)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16soV5-0005Yu-00
	for <classpath@gnu.org>; Wed, 03 Apr 2002 12:24:47 -0500
Received: from [213.7.164.134] (helo=pandora)
	by smtp.web.de with smtp (WEB.DE(Exim) 4.43 #48)
	id 16soUz-0005iv-00
	for classpath@gnu.org; Wed, 03 Apr 2002 19:24:42 +0200
Content-Type: Multipart/Mixed;
  charset="iso-8859-1";
  boundary="------------Boundary-00=_I06051YJDR9Q5ZU6ZCA5"
From: Thomas Hergenhahn <Thomas.hergenhahn@web.de>
To: classpath@gnu.org
Subject: bug in strtod?
Date: Wed, 3 Apr 2002 18:31:30 +0100
X-Mailer: KMail [version 1.2]
MIME-Version: 1.0
Message-Id: <02040319313000.04644@pandora>
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

--------------Boundary-00=_I06051YJDR9Q5ZU6ZCA5
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 8bit

Dear all,
I hope this is the right place to post a patch fo libjava.
I'm using libjava from GCC-3.0.4 on Linux i386.
I tried to convert a string of the form 1.234E+000 to a double using 
Double.doubleValue(). The result was allways zero (no NumberFormatException). 
IMHO, this is a bug. I traced that down until finding the responsible lines 
of code in java/lang/strtod.c. The following patch works for me, but better 
take a deeper look on it. 
BTW, why must libjava implement all this itself? Is it to achieve platform 
independency down to the last bit? Does it take advantage of FPU, if one is 
present ?

Yours sincerely

Thomas Hergenhahn
--------------Boundary-00=_I06051YJDR9Q5ZU6ZCA5
Content-Type: text/x-c;
  charset="iso-8859-1";
  name="strtod.diff"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="strtod.diff"

LS0tIHN0cnRvZC5jCVdlZCBBcHIgIDcgMTY6NTI6MzkgMTk5OQorKysgc3RydG9kLmMubmV3CVdl
ZCBBcHIgIDMgMTk6MTQ6MTggMjAwMgpAQCAtMjQ1LDEzICsyNDUsMzIgQEAKIAkgIGVsc2UKIAkg
ICAgewogCSAgICAgIC8qIE5vIGV4cG9uZW50IGFmdGVyIGFuICdFJyA6IHRoYXQncyBhbiBlcnJv
ci4gKi8KLQkgICAgICBwdHItPl9lcnJubyA9IEVJTlZBTDsKKwkgICAgICAvKiBUaGlzIHNlZW1z
IG5vdCB0byBiZSB0cnVlLiBXZSBjYW4gYXJyaXZlIGhlcmUgcGFyc2luZyBhIAorCSAgICAgICAq
IG51bWJlciBzdHJpbmcgb2YgdGhlIGZvcm0gLi4uLkUwMDAwLi4gQW5kIHRvIG15IHVuZGVyc3Rh
bmRpbmcsCisJICAgICAgICogdGhpcyBpcyBhIG51bWJlciB0aW1lcyAxIGFuZCBwZXJmZWN0bHkg
bGVnYWwuPyBTbyBJIHByb3Bvc2UKKwkgICAgICAgKiB0byBzaW1wbHkgc2V0IGUgdG8gMCBhbmQg
Y29udGludWUuIElmIHRoZXJlIGlzICpyZWFsbHkqCisJICAgICAgICogbm8gZGlnaXQgYWZ0ZXIg
dGhlICdFJyB3ZSB3aWxsIGZpbmQgb3Vyc2VsdmVzIGJlaGluZCBuZXh0CisJICAgICAgICogImVs
c2UiLgorCSAgICAgICAqIFRob21hcy5IZXJnZW5oYWhuQG5leGFucy5jb20KKwkgICAgICAgKi8K
KwkgICAgICAvL3B0ci0+X2Vycm5vID0gRUlOVkFMOwogCSAgICAgIGUgPSAwOwotCSAgICAgIGdv
dG8gcmV0OworCSAgICAgIC8vZ290byByZXQ7CiAJICAgIH0KIAl9Ci0gICAgICBlbHNlCisgICAg
ICBlbHNlIAorICAgICAgIHsKKwkvKiBObyBleHBvbmVudCBhZnRlciBhbiAnRScgOiB0aGF0J3Mg
YW4gZXJyb3IuICovCisJLyogSSB0aGltayB0aGlzIGlzIG5vdCB0cnVlIGJlZm9yZSBoZXJlLiBT
byB3ZSBjb3VsZCBwbGFjZSB0aGUgCisJICogdGhlIGVycm9yIGV4aXQgY29kZSBoZXJlOiAKKwkg
Ki8gCisJcHRyLT5fZXJybm8gPSBFSU5WQUw7CisJZSA9IDA7CisJZ290byByZXQ7CisJCisJLyog
SSBkbyBub3Qgc2VlIHdoYXQgdGhpcyBsaW5lIG1lYW5zLi4uICovCiAJcyA9IHMwMDsKKyAgICAg
IH0KICAgICB9CiAgIGlmICghbmQpCiAgICAgewo=

--------------Boundary-00=_I06051YJDR9Q5ZU6ZCA5--


From poornima.ramarao@oracle.com Fri Apr 05 16:27:27 2002
Received: from rgminet1.oracle.com ([148.87.122.30])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16tbF1-0004oB-00
	for <classpath@gnu.org>; Fri, 05 Apr 2002 16:27:27 -0500
Received: from rgmgw4.us.oracle.com (rgmgw4.us.oracle.com [138.1.191.13])
	by rgminet1.oracle.com (Switch-2.1.4/Switch-2.1.0) with ESMTP id g35LVNF21470
	for <classpath@gnu.org>; Fri, 5 Apr 2002 14:31:23 -0700 (MST)
Received: from oracle.com (pramarao-pc.us.oracle.com [144.25.140.208])
	by rgmgw4.us.oracle.com (Switch-2.1.3/Switch-2.1.0) with ESMTP id g35LRPU13130
	for <classpath@gnu.org>; Fri, 5 Apr 2002 14:27:26 -0700 (MST)
Message-ID: <3CAE165B.BDA052FE@oracle.com>
Date: Fri, 05 Apr 2002 13:25:47 -0800
From: Poornima Ramarao <poornima.ramarao@oracle.com>
X-Mailer: Mozilla 4.7 [en] (WinNT; I)
X-Accept-Language: en
MIME-Version: 1.0
To: classpath@gnu.org
Subject: Bug in JVM ?
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I am implementing an Iterator and wish to throw the
concurrentMoficationException when the underlying list is modified. I do

this by keeping track of modCount variable in the iterator
implementation and throw the exception if         the modcount has
changed after the iterator is created. It works fine on NT and gives
runtime"        Exception in thread "main" java.lang.IllegalAccessError:

try to access field java.util.AbstractList.modCount from class
oracle.tip.repos.core.driver.AssociationList$Itr

Here AssociationList is my implementation of ArrayList.

 In the iterator
 private class Itr implements Iterator {
     int firstModCount = modCount;
     public Object next() throws ConcurrentModificationException {
     // after the iterator is created list has been modified, throw
     // concurrent modified exception
      int newModCount = modCount;

    if (firstModCount != newModCount)
    {
        throw new ConcurrentModificationException();
      }
 }
   This code executes in NT 4.0 without any problem only on solaris I
get the above runtime exception.

Could this be a bug ?  Any pointers on troubleshooting this problem ?

 thanks
       Poornima



From cbj@gnu.org Mon Apr 08 01:04:53 2002
Received: from fe8.southeast.rr.com ([24.93.67.55] helo=mail8.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16uQ9g-00010y-00
	for <classpath@gnu.org>; Sun, 07 Apr 2002 23:49:20 -0400
Received: from lyta.haphazard.org ([66.57.11.149]) by mail8.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.687.68);
	 Sun, 7 Apr 2002 23:49:19 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g383gnS18025;
	Sun, 7 Apr 2002 23:42:49 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Poornima Ramarao <poornima.ramarao@oracle.com>
Cc: classpath@gnu.org
Subject: Re: Bug in JVM ?
References: <3CAE165B.BDA052FE@oracle.com>
From: Brian Jones <cbj@gnu.org>
Date: 07 Apr 2002 23:42:49 -0400
In-Reply-To: <3CAE165B.BDA052FE@oracle.com>
Message-ID: <m38z7yhn46.fsf@lyta.haphazard.org>
Lines: 10
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Poornima Ramarao <poornima.ramarao@oracle.com> writes:

>    This code executes in NT 4.0 without any problem only on solaris I
> get the above runtime exception.
> 
> Could this be a bug ?  Any pointers on troubleshooting this problem ?

Are you using GNU Classpath?  What JVM are you using?
-- 
Brian Jones <cbj@gnu.org>


From rveldema@cs.vu.nl Mon Apr 08 07:00:18 2002
Received: from star.cs.vu.nl ([192.31.231.42])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16uWjt-0001EA-00
	for <classpath@gnu.org>; Mon, 08 Apr 2002 06:51:09 -0400
Received: from cs.vu.nl (neptune.cs.vu.nl [130.37.30.87])
	by star.cs.vu.nl with esmtp
	(Smail #74) id m16uWjs-000C4QC; Mon, 8 Apr 2002 12:51 +0200
Message-ID: <3CB1761B.4050108@cs.vu.nl>
Date: Mon, 08 Apr 2002 12:51:07 +0200
From: "R.S. Veldema" <rveldema@cs.vu.nl>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.7+) Gecko/20020123
X-Accept-Language: en-us
MIME-Version: 1.0
To: classpath@gnu.org
Subject: basic nio up
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi all,
    I've gotten basic nio tests to work properly
with orp and classpath.
(mapping a file and reading some bytes from it,
and opening a SocketChannel to httpd,
ServerSocketChannel stuff not patched yet, also
still missing some natives for buffer conversions)
Does anyone have some more tests for java.nio ?
R.

=================================
Ps,  I've got two compile errors after my cvs update just now.
I guess somebody forgot to commit java.lang.Character.
R.


Found 2 semantic errors compiling "../java/lang/String.java":

  1628.     return Character.direction[Character.readChar(ch) >> 7] & 3;
                             <------->
*** Error: No field named "direction" was found in type 
"java/lang/Character". However, there is an accessible field 
"DIRECTIONALITY_UNDEFINED" whose name closely matches the name "direction".


  1628.     return Character.direction[Character.readChar(ch) >> 7] & 3;
                                       <-------------------->
*** Error: The method "char readChar(char ch);" in type 
"java/lang/Character" with private access is not accessible here.





From ebb9@email.byu.edu Mon Apr 08 12:36:43 2002
Received: from rwcrmhc54.attbi.com ([216.148.227.87])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16uc8J-0000Rn-00
	for <classpath@gnu.org>; Mon, 08 Apr 2002 12:36:43 -0400
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc54.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020408163634.TYQU15826.rwcrmhc54.attbi.com@email.byu.edu>;
          Mon, 8 Apr 2002 16:36:34 +0000
Message-ID: <3CB1B8F8.83C5ED1@email.byu.edu>
Date: Mon, 08 Apr 2002 09:36:26 -0600
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: "R.S. Veldema" <rveldema@cs.vu.nl>
CC: classpath@gnu.org
Subject: Re: basic nio up
References: <3CB1761B.4050108@cs.vu.nl>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

"R.S. Veldema" wrote:
> Ps,  I've got two compile errors after my cvs update just now.
> I guess somebody forgot to commit java.lang.Character.
> R.

Mark was overzealous on fixing Character to match gcj, as the Classpath
version SHOULD have differences. I reverted his over-commit.

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From ebb9@email.byu.edu Mon Apr 08 12:57:14 2002
Received: from rwcrmhc52.attbi.com ([216.148.227.88])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16ucS9-000293-00
	for <classpath@gnu.org>; Mon, 08 Apr 2002 12:57:13 -0400
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc52.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020408165711.FHQB3676.rwcrmhc52.attbi.com@email.byu.edu>;
          Mon, 8 Apr 2002 16:57:11 +0000
Message-ID: <3CB1BDD3.736F36B7@email.byu.edu>
Date: Mon, 08 Apr 2002 09:57:07 -0600
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: Thomas Hergenhahn <Thomas.hergenhahn@web.de>
CC: classpath@gnu.org
Subject: Re: bug in strtod?
References: <02040319313000.04644@pandora>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

strtod has an upstream source, which has been updated since the version
included in Classpath.  I have not yet had the time to look at updating
this, but it is on my TODO list (although not very high priority). 
Having done floating point work on the Jikes compiler, I am aware of
several (minor) bugs in the current Classpath implementation of
string/fp and fp/string conversions.  The upstream source does use the
underlying architecture's floating point unit, where possible, in
performing the conversions.

And yes, the Java library must implement string conversions itself, to
be platform independent to the last bit.  In particular, not all
platforms are IEEE 754 compliant (let alone compliant to the slight
modifications to IEEE 754 required by Java), and not all operating
systems/C libraries have bit accurate conversions.  Even the x86
architecture has problems - by using 80-bit registers for internal
computation instead of 64-bit, there are some off-by-one rounding errors
in extreme corner cases.

Thomas Hergenhahn wrote:
> 
> Dear all,
> I hope this is the right place to post a patch fo libjava.
> I'm using libjava from GCC-3.0.4 on Linux i386.
> I tried to convert a string of the form 1.234E+000 to a double using
> Double.doubleValue(). The result was allways zero (no NumberFormatException).
> IMHO, this is a bug. I traced that down until finding the responsible lines
> of code in java/lang/strtod.c. The following patch works for me, but better
> take a deeper look on it.
> BTW, why must libjava implement all this itself? Is it to achieve platform
> independency down to the last bit? Does it take advantage of FPU, if one is
> present ?
> 
> Yours sincerely
> 
> Thomas Hergenhahn

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From mark@wildebeest.org Mon Apr 08 13:48:59 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16udGF-0000Zx-00
	for <classpath@gnu.org>; Mon, 08 Apr 2002 13:48:59 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 16udFr-0007ZW-00; Mon, 08 Apr 2002 19:48:35 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 16udFw-00018r-00; Mon, 08 Apr 2002 19:48:40 +0200
Subject: Mea Culpa (Was: basic nio up)
From: Mark Wielaard <mark@klomp.org>
To: Eric Blake <ebb9@email.byu.edu>
Cc: "R.S. Veldema" <rveldema@cs.vu.nl>, classpath@gnu.org
In-Reply-To: <3CB1B8F8.83C5ED1@email.byu.edu>
References: <3CB1761B.4050108@cs.vu.nl>  <3CB1B8F8.83C5ED1@email.byu.edu>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 08 Apr 2002 19:48:40 +0200
Message-Id: <1018288120.4079.12.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.8
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

On Mon, 2002-04-08 at 17:36, Eric Blake wrote:
> "R.S. Veldema" wrote:
> > Ps,  I've got two compile errors after my cvs update just now.
> > I guess somebody forgot to commit java.lang.Character.
> 
> Mark was overzealous on fixing Character to match gcj, as the Classpath
> version SHOULD have differences. I reverted his over-commit.

Argh. Sorry about that. I had already reverted it in my local tree when
I noticed that I had done the same thing with Hashtable. Somehow I did
revert the mistake I made with Hashtable and then forgot about Character
again. Duh... I will be more careful.

Sorry,

Mark


From sballard@netreach.com Tue Apr 09 09:57:22 2002
Received: from rawaki.netreach.net ([207.29.195.114])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16uw7e-0001nm-00
	for <classpath@gnu.org>; Tue, 09 Apr 2002 09:57:22 -0400
Received: from netreach.com (sballard@rainbow.netreach.net [209.152.221.64]) by rawaki.netreach.net (n1/$Revision: 1.6 $) with ESMTP id JAA03181; Tue, 9 Apr 2002 09:57:51 -0400 (EDT)
Message-ID: <3CB2F337.33464842@netreach.com>
Date: Tue, 09 Apr 2002 09:57:11 -0400
From: Stuart Ballard <sballard@netreach.com>
X-Mailer: Mozilla 4.77 [en] (X11; U; Linux 2.2.17 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: classpath@gnu.org
Subject: Re: debug output problem in ObjectInputStream
References: <3CAA232C.40109@bothner.com> <3CAA5E3F.26FA260D@cruzio.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Sorry for the late response to this thread.

Warren Levy wrote:
> 
> It wasn't so much an issue of it being overridden, as it seemed like
> a much cleaner approach than having separate conditionals and println's
> spread throughout the code.  I found it very helpful when debugging to
> just set a breakpoint for dumpElement; if we get rid of the method and
> sprinkle the code with the conditional and prints, we'll lose that ease
> in debugging.  Having a separate dumpElement method also certainly improved
> readability of the code (at least IMO).  I'm fine though with readability
> and ease of debugging suffering a little bit, if it avoids needless
> processing in the typical case.

Why not get the best of both?

if (Configuration.DEBUG) dumpElement(whatever);

The only check that needs to be outside the dumpElement call is the bit
that's a compiletime constant. As I understand it, that's
Configuration.DEBUG (not sure what "dump" is - I haven't read the code).

The code for dumpElement should also include a test for
Configuration.DEBUG. That way when debugging is off it will compile to
an empty method, saving some code size.

Now the code is readable, you can still set a breakpoint in dumpElement
(as long as debugging is enabled) and nothing at all gets compiled into
the code if debugging is disabled.

This style of code has been my standard debugging practice for ages. I
use a debug method to encapsulate my output, but I only invoke it if
some compiletime-constant is true to indicate that debugging is enabled.

Stuart.

-- 
Stuart Ballard, Programmer
NetReach - Internet Solutions
(215) 283-2300, ext. 126
http://www.netreach.com/


From gilead@yellow.dyndns.org Fri Apr 19 10:23:20 2002
Received: from [217.97.152.207] (helo=big-hedgehog)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16yZIF-0002UI-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 10:23:20 -0400
Received: from max-desktop ([192.168.0.2] helo=yellow.dyndns.org)
	by big-hedgehog with esmtp (Exim 3.35 #1 (Debian))
	id 16yaHA-0005wU-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 17:26:16 +0200
Message-ID: <3CC02814.6060802@yellow.dyndns.org>
Date: Fri, 19 Apr 2002 16:22:12 +0200
From: Max Gilead <gilead@yellow.dyndns.org>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.9+) Gecko/20020308
X-Accept-Language: pl, en-us
MIME-Version: 1.0
To:  classpath@gnu.org
Subject: Bug in java.lang.Double(String)
Content-Type: multipart/related;
 boundary="------------010000070001050105060504"
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

--------------010000070001050105060504
Content-Type: text/plain; charset=ISO-8859-2; format=flowed
Content-Transfer-Encoding: 7bit

Hello!

There is a bug in java.lang.Double class. The problem is that string 
".3" is not recognized as a valid floating point value. According to 
Java language spec it should be.


Here is test class:
public class DoubleBug
   {
   public static void main(String[] args)
       {
       System.out.println(".3 -> "+ new Double(".3").doubleValue());
       }
   }

Sun's implementation prints:
.3 -> 0.3

Classpath 0.03 + ORP 1.0.9 prints:
No Java handlers found
Uncaught exception:
java.lang.NumberFormatException: from Java_java_lang_Double_doubleValueOf
   at DoubleBug.main


If it was in Java code I would have fixed it myself, but it is native 
code problem. Any chances to fix it soon? My project would run 100% on 
ORP/Classpath if not this one bug :-(

Bye,
Max


--------------010000070001050105060504--



From tromey@creche.cygnus.com Fri Apr 19 13:46:22 2002
Received: from mail.peakpeak.com ([207.174.178.17] helo=gash2.peakpeak.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16ycSd-00016i-00; Fri, 19 Apr 2002 13:46:15 -0400
Received: from creche.cygnus.com (ta0200.peakpeak.com [204.144.244.200])
	by gash2.peakpeak.com (8.9.3/8.9.3) with ESMTP id LAA08615;
	Fri, 19 Apr 2002 11:46:11 -0600
Received: (from tromey@localhost)
	by creche.cygnus.com (8.9.3/8.9.3) id LAA02672;
	Fri, 19 Apr 2002 11:51:03 -0600
To: "James Williams" <james_williams@optusnet.com.au>
Cc: Richard Stallman <rms@gnu.org>, Classpath Project <classpath@gnu.org>
Subject: Re: Attention GCJ devel team
References: <001e01c1e797$c91c2f30$c47831d2@computer>
From: Tom Tromey <tromey@redhat.com>
Reply-To: tromey@redhat.com
X-Attribution:  Tom
X-Zippy:  Why are these athletic shoe salesmen following me??
Date: 19 Apr 2002 11:51:03 -0600
In-Reply-To: "James Williams"'s message of "Fri, 19 Apr 2002 21:46:02 +1000"
Message-ID: <87znzz8tmg.fsf@creche.redhat.com>
Lines: 45
X-Mailer: Gnus v5.7/Emacs 20.5
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

>>>>> "James" == James Williams <james_williams@optusnet.com.au> writes:

James> I am currently working on a tool that will generate class stubs
James> complete with javadoc from javadoc specifications.  In your FAQ
James> a person mentioned that "Considering that new Java APIs come
James> out every week, it's going to be impossible to track
James> everything."  I believe the tool I am developing may reduce
James> this development challenge for you substantially.

James> Effectively this tool can generate class stubs (and
James> automatically implement setters and getters, assign final
James> variable values (using reflection) for the entire J2SE api in
James> about 20 minutes.  As near as I can tell this tool does not
James> violate the SUN license (that I accepted when downloading the
James> spec) because effectively the software does exactly what people
James> would do were they implementing a clean room version of the
James> api.

Hi James.

First, most of the gcj discussion happens on the java@gcc.gnu.org
mailing list.  For this tool, the classpath@gnu.org list might be even
more appropriate.  I've moved this to the latter.

We'll probably need someone at the FSF, maybe RMS, to look at the
legality of this approach.  I agree on principle it seems like it
should be legal, but my experience is that such principles rarely hold
where the law is concerned.

I've CC'd RMS so he can tell us what the next step might be.  It may
take him a while to reply, as he gets a lot of email, so please be
patient.

James> After the Test Writer I plan on adding a code intergrator.
James> From my perspective the value of this would be that when a new
James> specification came out, the api converter could be run
James> providing a clean framework complete with all the new and
James> deprecated api's and then the intergrator could copy the
James> existing code from the current libgcj implementation into the
James> new framework.

For existing classes, I think it would be more useful if the tool just
generated a stub for every new method or field.

Tom


From nferrier@tapsellferrier.co.uk Fri Apr 19 13:55:22 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16ycbL-0001eU-00; Fri, 19 Apr 2002 13:55:15 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 16yd1S-0002ro-00; Fri, 19 Apr 2002 19:22:14 +0100
To: tromey@redhat.com
Cc: "James Williams" <james_williams@optusnet.com.au>,
	  Richard Stallman <rms@gnu.org>,
	  Classpath Project <classpath@gnu.org>
Subject: Re: Attention GCJ devel team
References: <001e01c1e797$c91c2f30$c47831d2@computer>
	<87znzz8tmg.fsf@creche.redhat.com>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 19 Apr 2002 19:17:16 +0100
In-Reply-To: <87znzz8tmg.fsf@creche.redhat.com>
Message-ID: <87adrzo8nn.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 50
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Tom Tromey <tromey@redhat.com> writes:

> >>>>> "James" == James Williams <james_williams@optusnet.com.au> writes: 
>  
> James> I am currently working on a tool that will generate class stubs 
> James> complete with javadoc from javadoc specifications.  In your FAQ 
> James> a person mentioned that "Considering that new Java APIs come 
> James> out every week, it's going to be impossible to track 
> James> everything."  I believe the tool I am developing may reduce 
> James> this development challenge for you substantially. 
>  
> James> Effectively this tool can generate class stubs (and 
> James> automatically implement setters and getters, assign final 
> James> variable values (using reflection) for the entire J2SE api in 
> James> about 20 minutes.  As near as I can tell this tool does not 
> James> violate the SUN license (that I accepted when downloading the 
> James> spec) because effectively the software does exactly what people 
> James> would do were they implementing a clean room version of the 
> James> api. 
>  
> Hi James. 
>  
> First, most of the gcj discussion happens on the java@gcc.gnu.org 
> mailing list.  For this tool, the classpath@gnu.org list might be even 
> more appropriate.  I've moved this to the latter. 
>  
> We'll probably need someone at the FSF, maybe RMS, to look at the 
> legality of this approach.  I agree on principle it seems like it 
> should be legal, but my experience is that such principles rarely hold 
> where the law is concerned. 
>  
> I've CC'd RMS so he can tell us what the next step might be.  It may 
> take him a while to reply, as he gets a lot of email, so please be 
> patient. 
>  
> James> After the Test Writer I plan on adding a code intergrator. 
> James> From my perspective the value of this would be that when a new 
> James> specification came out, the api converter could be run 
> James> providing a clean framework complete with all the new and 
> James> deprecated api's and then the intergrator could copy the 
> James> existing code from the current libgcj implementation into the 
> James> new framework. 
>  
> For existing classes, I think it would be more useful if the tool just 
> generated a stub for every new method or field. 

If we could just get an accurate list of changes it would be useful.


Nic



From gilead@linart.pl Fri Apr 19 09:17:26 2002
Received: from [217.97.152.207] (helo=big-hedgehog)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16yYGS-0003kK-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 09:17:26 -0400
Received: from max-desktop ([192.168.0.2] helo=linart.pl)
	by big-hedgehog with esmtp (Exim 3.35 #1 (Debian))
	id 16yZFY-0005py-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 16:20:32 +0200
Message-ID: <3CC018AD.6020102@linart.pl>
Date: Fri, 19 Apr 2002 15:16:29 +0200
From: Max Gilead <gilead@linart.pl>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.9+) Gecko/20020308
X-Accept-Language: pl, en-us
MIME-Version: 1.0
To:  classpath@gnu.org
Subject: Bug in java.lang.Double
Content-Type: text/plain; charset=ISO-8859-2; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hello!

There is a bug in java.lang.Double class. The problem is that string 
".3" is not recognized as a valid floating point value. According to 
Java language spec it should be.


Here is test class:
public class DoubleBug
    {
    public static void main(String[] args)
        {
        System.out.println(".3 -> "+ new Double(".3").doubleValue());
        }
    }

Sun's implementation prints:
.3 -> 0.3

Classpath 0.03 + ORP 1.0.9 prints:
No Java handlers found
Uncaught exception:
java.lang.NumberFormatException: from Java_java_lang_Double_doubleValueOf
    at DoubleBug.main


It if was in Java code I would have fixed it myself, but it is native 
code problem. Any chances to fix it soon? My project would run 100% on 
ORP/Classpath if not this one bug :-(

Bye,
Max




From eblake@ee.byu.edu Fri Apr 19 10:54:26 2002
Received: from rwcrmhc51.attbi.com ([204.127.198.38])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16yZmL-0006Im-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 10:54:25 -0400
Received: from ee.byu.edu ([12.254.140.134]) by rwcrmhc51.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020419145423.YGOU1143.rwcrmhc51.attbi.com@ee.byu.edu>;
          Fri, 19 Apr 2002 14:54:23 +0000
Message-ID: <3CC02F8F.C020F9@ee.byu.edu>
Date: Fri, 19 Apr 2002 08:54:07 -0600
From: Eric Blake <eblake@ee.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: Max Gilead <gilead@yellow.dyndns.org>
CC: classpath@gnu.org
Subject: Re: Bug in java.lang.Double(String)
References: <3CC02814.6060802@yellow.dyndns.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I still haven't had time to look at the native code, but it is on my
todo list.  There is an updated upstream source, and I did the native
code for the jikes compiler, so I'm familiar with what needs to happen -
it is just time-consuming, and I am in the middle of final exams.

Max Gilead wrote:
> 
> Hello!
> 
> There is a bug in java.lang.Double class. The problem is that string
> ".3" is not recognized as a valid floating point value. According to
> Java language spec it should be.
> 

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From sballard@netreach.com Fri Apr 19 14:21:05 2002
Received: from rawaki.netreach.net ([207.29.195.114])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16yd0L-0002xe-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 14:21:05 -0400
Received: from netreach.com (sballard@rainbow.netreach.net [209.152.221.64]) by rawaki.netreach.net (n1/$Revision: 1.7 $) with ESMTP id OAA26991; Fri, 19 Apr 2002 14:21:37 -0400 (EDT)
Message-ID: <3CC0600A.B9E202A6@netreach.com>
Date: Fri, 19 Apr 2002 14:20:58 -0400
From: Stuart Ballard <sballard@netreach.com>
X-Mailer: Mozilla 4.77 [en] (X11; U; Linux 2.2.17 i686)
X-Accept-Language: en
MIME-Version: 1.0
To: Nic Ferrier <nferrier@tapsellferrier.co.uk>
CC: tromey@redhat.com, James Williams <james_williams@optusnet.com.au>,
        Classpath Project <classpath@gnu.org>
Subject: Re: Attention GCJ devel team
References: <001e01c1e797$c91c2f30$c47831d2@computer>
		<87znzz8tmg.fsf@creche.redhat.com> <87adrzo8nn.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> > James> Effectively this tool can generate class stubs (and
> > James> automatically implement setters and getters, assign final
> > James> variable values (using reflection) for the entire J2SE api in
> > James> about 20 minutes.  As near as I can tell this tool does not
> > James> violate the SUN license (that I accepted when downloading the
> > James> spec) because effectively the software does exactly what people
> > James> would do were they implementing a clean room version of the
> > James> api.

Can I take this opportunity to plug japitools
<http://stuart.wuffies.net/japi>? It doesn't generate stubs, but it does
tell you when you're missing required member variables or methods, and
it also points out things like incorrect thrown exceptions, incorrect
superclasses, and basically anything that might violate binary
compatibility. A japi2java program would be absolutely trivial to write,
and I've almost done so a couple of times just "because I can".

Last time I updated the website I hadn't touched it in 2 years and
thought that it would probably benefit from a new maintainer, but in
fact just making that update caused me to be more motivated and I've
been working on an updated version on my laptop for the past couple of
weeks. The new version should eliminate the memory-usage problems and
make it possible to operate on very large APIs (like JDK1.2 and up)
without needing to have a supercomputer to do it.

It'll also add the capability to ask for all errors against JDK1.1 that
*don't* also occur with JDK1.2 - so we can test our compatibility with
1.1 without getting a whole bunch of false positives for the cases we're
already up to 1.2 compatibility (and where 1.2 wasn't backward
compatible with 1.1 - which is in quite a few places, as japitools will
happily point out for you).

The one thing to beware with your approach is that if you include
javadoc comments you are definitely violating copyright, because the
content of the comments is copyrighted. I don't think that you are doing
that, but if you are, well, you need to stop.

Stuart.

-- 
Stuart Ballard, Programmer
NetReach - Internet Solutions
(215) 283-2300, ext. 126
http://www.netreach.com/


From cbj@gnu.org Fri Apr 19 16:56:55 2002
Received: from fe4.southeast.rr.com ([24.93.67.51] helo=mail4.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16yfR9-0005cC-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 16:56:55 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail4.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.687.68);
	 Fri, 19 Apr 2002 16:56:51 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3JJr9i22147;
	Fri, 19 Apr 2002 15:53:09 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: GNU Classpath <classpath@gnu.org>
Subject: mailman
From: Brian Jones <cbj@gnu.org>
Date: 19 Apr 2002 15:53:09 -0400
Message-ID: <m3g01ro47u.fsf@lyta.haphazard.org>
Lines: 6
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Anyone familiar with MailMan know if it is possible to immediately
discard any non-subscriber email containing an HTML part?

Brian
-- 
Brian Jones <cbj@gnu.org>


From mcb54@columbia.edu Fri Apr 19 20:57:23 2002
Received: from marionberry.cc.columbia.edu ([128.59.59.100])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16yjBq-0006Zd-00
	for <classpath@gnu.org>; Fri, 19 Apr 2002 20:57:22 -0400
Received: (from root@localhost)
	by marionberry.cc.columbia.edu (8.9.3/8.9.3) id UAA03267
	for classpath@gnu.org.procmail; Fri, 19 Apr 2002 20:57:22 -0400 (EDT)
Received: from sniffles.schap.rhno.columbia.edu (sniffles.schap.rhno.columbia.edu [160.39.224.54])
	by marionberry.cc.columbia.edu (8.9.3/8.9.3) with ESMTP id UAA03259;
	Fri, 19 Apr 2002 20:57:21 -0400 (EDT)
Subject: Re: mailman
From: Mark Benvenuto <mcb54@columbia.edu>
To: Brian Jones <cbj@gnu.org>
Cc: GNU Classpath <classpath@gnu.org>
In-Reply-To: <m3g01ro47u.fsf@lyta.haphazard.org>
References: <m3g01ro47u.fsf@lyta.haphazard.org>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 19 Apr 2002 20:57:21 -0400
Message-Id: <1019264241.1834.4.camel@sniffles>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Unless, I am mistaken, you cannot restrict mailman lists like that or
even deny users in general if they use html email (I checked Mailman
2.0.9). You may have to modify an Handler to get the functionality you
want.

Mark

On Fri, 2002-04-19 at 15:53, Brian Jones wrote:
> Anyone familiar with MailMan know if it is possible to immediately
> discard any non-subscriber email containing an HTML part?
> 
> Brian
> -- 
> Brian Jones <cbj@gnu.org>
> 
> _______________________________________________
> Classpath mailing list
> Classpath@gnu.org
> http://mail.gnu.org/mailman/listinfo/classpath




From mark@wildebeest.org Sun Apr 21 12:32:53 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 16zKGi-0000BR-00
	for <classpath@gnu.org>; Sun, 21 Apr 2002 12:32:53 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 16zKGT-0001kg-00
	for <classpath@gnu.org>; Sun, 21 Apr 2002 18:32:37 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 16zKGh-0006pw-00
	for <classpath@gnu.org>; Sun, 21 Apr 2002 18:32:51 +0200
Subject: Workarounds for gcj 3.1
From: Mark Wielaard <mark@klomp.org>
To: classpath@gnu.org
Content-Type: multipart/mixed; boundary="=-eC5o8Ks6whrXjt3Ctxtc"
X-Mailer: Ximian Evolution 1.0.3 
Date: 21 Apr 2002 18:32:50 +0200
Message-Id: <1019406770.1419.153.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

--=-eC5o8Ks6whrXjt3Ctxtc
Content-Type: text/plain
Content-Transfer-Encoding: 7bit

Hi,

Since gcj 3.1 is about to be released and gcj 3.0 can no longer compile
the current Classpath from CVS I am going to commit the following
workarounds.

2002-04-21  Mark Wielaard  <mark@klomp.org>

  * java/awt/AWTKeyStroke.java (removeEldestEntry): Use fully qualified
  Map.Entry as argument (gcj 3.1 workaround).
  * java/awt/im/InputSubset.java: extends fully qualified
  Character.Subset (likewise).
  * java/util/AbstractMap.java (BasicMapEntry): implements fully
  qualified Map.Entry (likewise).
  * javax/swing/JList.java (setListData): Rename innerclass AL to ALData
  to avoid name clash (likewise).

Together with the patch provided in PR java/2791 for gcj this makes it
possible to compile classpath with gcj again (jikes still works with
this applied). For more background information see:
<http://gcc.gnu.org/ml/java/2002-04/msg00292.html>

Cheers,

Mark

--=-eC5o8Ks6whrXjt3Ctxtc
Content-Disposition: inline; filename=workarounds.diff
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; name=workarounds.diff; charset=ISO-8859-15

? java/awt/dnd/Makefile
? java/awt/im/Makefile
? java/awt/im/spi/Makefile
? java/rmi/Makefile
? java/rmi/activation/Makefile
? java/rmi/dgc/Makefile
? java/rmi/registry/Makefile
? java/rmi/server/Makefile
Index: java/awt/AWTKeyStroke.java
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvsroot/classpath/classpath/java/awt/AWTKeyStroke.java,v
retrieving revision 1.1
diff -u -r1.1 AWTKeyStroke.java
--- java/awt/AWTKeyStroke.java	31 Mar 2002 02:05:37 -0000	1.1
+++ java/awt/AWTKeyStroke.java	21 Apr 2002 16:11:34 -0000
@@ -48,6 +48,7 @@
 import java.security.PrivilegedAction;
 import java.security.PrivilegedActionException;
 import java.security.PrivilegedExceptionAction;
+import java.util.Map;
 import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.StringTokenizer;
@@ -89,7 +90,7 @@
     private static final int MAX_CACHE_SIZE =3D 2048;
=20
     /** Prune stale entries. */
-    protected boolean removeEldestEntry(Entry eldest)
+    protected boolean removeEldestEntry(Map.Entry eldest)
     {
       return size() > MAX_CACHE_SIZE;
     }
Index: java/awt/im/InputSubset.java
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvsroot/classpath/classpath/java/awt/im/InputSubset.java,v
retrieving revision 1.1
diff -u -r1.1 InputSubset.java
--- java/awt/im/InputSubset.java	29 Mar 2002 05:53:18 -0000	1.1
+++ java/awt/im/InputSubset.java	21 Apr 2002 16:11:34 -0000
@@ -46,7 +46,7 @@
  * @since 1.2
  * @status updated to 1.4
  */
-public final class InputSubset extends Character.Subset
+public final class InputSubset extends java.lang.Character.Subset
 {
   /**
    * Constant for all Latin characters, including the characters in the
Index: java/util/AbstractMap.java
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvsroot/classpath/classpath/java/util/AbstractMap.java,v
retrieving revision 1.22
diff -u -r1.22 AbstractMap.java
--- java/util/AbstractMap.java	8 Apr 2002 00:20:00 -0000	1.22
+++ java/util/AbstractMap.java	21 Apr 2002 16:11:34 -0000
@@ -527,7 +527,7 @@
    * @author Jon Zeppieri
    * @author Eric Blake <ebb9@email.byu.edu>
    */
-  static class BasicMapEntry implements Entry
+  static class BasicMapEntry implements Map.Entry
   {
     /**
      * The key. Package visible for direct manipulation.
? javax/accessibility/Makefile
Index: javax/swing/JList.java
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvsroot/classpath/classpath/javax/swing/JList.java,v
retrieving revision 1.3
diff -u -r1.3 JList.java
--- javax/swing/JList.java	8 Apr 2002 10:14:49 -0000	1.3
+++ javax/swing/JList.java	21 Apr 2002 16:16:51 -0000
@@ -106,13 +106,13 @@
    =20
     public void setListData(final Vector listData)
     {
-	class AL extends AbstractListModel=20
+	class ALData extends AbstractListModel=20
 	{
 	    public int getSize()              { return listData.size(); }
 	    public Object getElementAt(int i) { return listData.elementAt(i); }
 	};
 =09
-        setModel (new AL());
+        setModel (new ALData());
     }
    =20
    =20

--=-eC5o8Ks6whrXjt3Ctxtc--


From tromey@creche.cygnus.com Sun Apr 21 15:26:57 2002
Received: from mail.peakpeak.com ([207.174.178.17] helo=gash2.peakpeak.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 16zMzB-0008Ti-00
	for <classpath@gnu.org>; Sun, 21 Apr 2002 15:26:57 -0400
Received: from creche.cygnus.com (ta0194.peakpeak.com [204.144.244.194])
	by gash2.peakpeak.com (8.9.3/8.9.3) with ESMTP id NAA18919;
	Sun, 21 Apr 2002 13:26:45 -0600
Received: (from tromey@localhost)
	by creche.cygnus.com (8.9.3/8.9.3) id NAA09074;
	Sun, 21 Apr 2002 13:32:06 -0600
To: Mark Wielaard <mark@klomp.org>
Cc: classpath@gnu.org
Subject: Re: Workarounds for gcj 3.1
References: <1019406770.1419.153.camel@elsschot>
From: Tom Tromey <tromey@redhat.com>
Reply-To: tromey@redhat.com
X-Attribution:  Tom
X-Zippy:  Look DEEP into the OPENINGS!!  Do you see any ELVES or EDSELS...
 or a HIGHBALL??...
Date: 21 Apr 2002 13:32:06 -0600
In-Reply-To: Mark Wielaard's message of "21 Apr 2002 18:32:50 +0200"
Message-ID: <87u1q4rgp5.fsf@creche.redhat.com>
Lines: 17
X-Mailer: Gnus v5.7/Emacs 20.5
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

>>>>> "Mark" == Mark Wielaard <mark@klomp.org> writes:

Mark> Since gcj 3.1 is about to be released and gcj 3.0 can no longer
Mark> compile the current Classpath from CVS I am going to commit the
Mark> following workarounds.

Thanks, Mark.  I think it would make sense to mark the workarounds
with a comment explaining they are needed for gcj 3.1.  That way when
gcj is fixed we can remove them, and when someone sees the code they
will know why it is written in a strange way.

Mark> Together with the patch provided in PR java/2791 for gcj this
Mark> makes it possible to compile classpath with gcj again

I'll try to get this approved asap.

Tom


From jy.sun@usa.com Wed Apr 24 23:28:15 2002
Received: from 205-158-62-55.outblaze.com ([205.158.62.55] helo=ws1-3.us4.outblaze.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 170Zva-0007ys-00
	for <classpath@gnu.org>; Wed, 24 Apr 2002 23:28:14 -0400
Received: (qmail 21677 invoked by uid 1001); 25 Apr 2002 03:28:13 -0000
Message-ID: <20020425032813.21676.qmail@mail.com>
Content-Type: text/plain; charset="iso-8859-1"
Content-Disposition: inline
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-Mailer: MIME-tools 5.41 (Entity 5.404)
Received: from [211.162.16.236] by ws1-3.us4.outblaze.com with http for
    jy.sun@usa.com; Wed, 24 Apr 2002 22:28:13 -0500
From: "jiang yong" <jy.sun@usa.com>
To: classpath@gnu.org
Date: Wed, 24 Apr 2002 22:28:13 -0500
Subject: about jni
X-Originating-Ip: 211.162.16.236
X-Originating-Server: ws1-3.us4.outblaze.com
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

about jni:
when i use System.loadLibrary("XXXX") , got a error "can not find XXXX" ; when i add the all path on my dll , got an annother error "can not add the path" .when i use System.load("path\XXXX") , all right .
why ?

-- 

_______________________________________________
Sign-up for your own FREE Personalized E-mail at Mail.com
http://www.mail.com/?sr=signup



From ebb9@email.byu.edu Thu Apr 25 01:58:33 2002
Received: from rwcrmhc53.attbi.com ([204.127.198.39])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 170cH3-0003Qq-00; Thu, 25 Apr 2002 01:58:33 -0400
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc53.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020425055826.YNJB29911.rwcrmhc53.attbi.com@email.byu.edu>;
          Thu, 25 Apr 2002 05:58:26 +0000
Message-ID: <3CC79B05.AC8A0B38@email.byu.edu>
Date: Wed, 24 Apr 2002 23:58:29 -0600
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: aselkirk@sympatico.ca
CC: commit-classpath@gnu.org, Classpath list <classpath@gnu.org>
Subject: Re: classpath/javax/swing/plaf/basic BasicLookAndFe...
References: <E170c6F-0002ss-00@subversions.gnu.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Are you remembering to make a ChangeLog entry for all your merges
today?  Also, are you enabling the build in the appropriate places, such
as configure.in?  And one more thing to remember - the .cvsignore files.

Andrew Selkirk wrote:
> 
> CVSROOT:        /cvsroot/classpath
> Module name:    class	path
> Changes by:     Andrew Selkirk <aselkirk@sympatico.ca>  02/04/25 01:47:23
> 
> Added files:
>         javax/swing/plaf/basic: BasicLookAndFeel.java
> 
-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From subscriptions@phillipmorelock.com Thu Apr 25 02:57:17 2002
Received: from host20.cedant.com ([209.239.38.116])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170dBs-0008Re-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 02:57:16 -0400
Received: from c-24-126-77-31.we.client2.attbi.com (localhost [127.0.0.1])
	by host20.cedant.com (8.10.2/8.10.2) with ESMTP id g3P6vG701321
	for <classpath@gnu.org>; Thu, 25 Apr 2002 02:57:16 -0400
To: classpath@gnu.org
From: Phillip Morelock <subscriptions@phillipmorelock.com>
Subject: getting started with classpath
Reply-To: subscriptions@phillipmorelock.com
Date: Wed, 24 Apr 2002 22:16:40 -0700
X-Sender: subscriptions@phillipmorelock.com
X-Originating-Host: c-24-126-77-31.we.client2.attbi.com [24.126.77.31]; Thu, 25 Apr 2002 06:57:16 GMT
X-Mailer: WebMail Check v2.3.21 (2000-7-19)
X-Browser: Mozilla/4.0 (compatible; MSIE 5.14; Mac_PowerPC), JavaScript: On
Message-ID: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hello I'm seeking "getting started" help.

I have a gnawing interest in hacking on classpath, and I have read 
a couple of times over the guide "hacking.html" that is linked from 
the GNU site.  It's just, I'm having a simultaneous-learning-curve 
experience, and I'm wondering if anyone on this list can push me 
off in the right direction to eventually being able to contribute.


My "problems" or rather questions are as follows:
1.  I only have experience using one JDK/JRE (Sun's), although I 
have used it on many platforms.  I noticed a strong linkage between 
Classpath and (of course) the free JVM / compiler implementations.
That's cool, I get it, I am just not sure which components each 
of these tools replace, and what their level of compliance / implementation 
is.  Is there maybe a best order to learn about these tools in?  
I would like to know Free Java and work on it even, but am not sure 
how to start.

2.  How can I be certain I meet the "clean room" requirement?  I 
have browsed through several of sun's classes several times in source 
code form as included on my Mac OS X machine.  I know that I don't 
remember any specifics, they were just instructive at the time.  
Does this count?

3. If I write "pure java" implementations, do I need to worry much 
about your notes on native code and VM integration?  I have not done 
any JNI programming, but I am okay with learning.  I guess, a better 
question is, what is the view of this project as far as native code,
VM integration, etc.?  I get the feeling by browsing the classes 
that there isn't much native code in the non-GUI components.

Any "getting started" tips would be much appreciated -- it seems 
like there's a lot to learn for someone coming from a pure Sun world 
as far as the raw implementation goes.

Cheers
Phillip








From nferrier@tapsellferrier.co.uk Thu Apr 25 05:02:22 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170f8v-0002Dg-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 05:02:21 -0400
Received: from [194.74.202.254] (helo=DBENNETT2.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 170fZj-00016d-00; Thu, 25 Apr 2002 10:30:03 +0100
To: subscriptions@phillipmorelock.com
Cc: classpath@gnu.org
Subject: Re: getting started with classpath
References: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com>
From: nferrier@tapsellferrier.co.uk
Date: 25 Apr 2002 10:03:15 +0100
In-Reply-To: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com>
Message-ID: <wkpu0ojgks.fsf@tapsellferrier.co.uk>
Lines: 98
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Phillip Morelock <subscriptions@phillipmorelock.com> writes:

> Hello I'm seeking "getting started" help. 
>  
> I have a gnawing interest in hacking on classpath, and I have read  
> a couple of times over the guide "hacking.html" that is linked from  
> the GNU site.  It's just, I'm having a simultaneous-learning-curve  
> experience, and I'm wondering if anyone on this list can push me  
> off in the right direction to eventually being able to contribute. 
>  
>  
> My "problems" or rather questions are as follows: 
> 1.  I only have experience using one JDK/JRE (Sun's), although I  
> have used it on many platforms.  I noticed a strong linkage between  
> Classpath and (of course) the free JVM / compiler implementations. 
> That's cool, I get it, I am just not sure which components each  
> of these tools replace, and what their level of compliance / implementation  
> is.  Is there maybe a best order to learn about these tools in?   
> I would like to know Free Java and work on it even, but am not sure  
> how to start. 

Classpath is the Java library of the GNU project. As such it is used
(pretty much off the shelf) with several VM implementations.

If you're just interested in helping with the librarys (maybe you have
a particular area of interest, such as the networking libs, or
graphics code) then get Classpath + ORP, install them and hack away.

Alternately, Classpath is the library which is used as the foundation
for the GCJ compiler. GCJ is an exciting idea but at the moment
requires uses it's own class library. We are in the process of moving
GCJ to the Classpath library but it's quite a complex process (because
GCJ uses it's own native code implementation).

You could help us in merging Classpath into GCJ, or just by working on
GCJ.

  
> 2.  How can I be certain I meet the "clean room" requirement?  I  
> have browsed through several of sun's classes several times in source  
> code form as included on my Mac OS X machine.  I know that I don't  
> remember any specifics, they were just instructive at the time.   
> Does this count? 

I'm affraid so. It's possible that you might be able to work on
classes that you haven't looked at but even that is sticky ground, if
you've looked at the code at all it's perhaps too risky to accept
your contributions.

The final decision would be for the Classpath maintainers.


If you still want to contribute to free Java and you decide that you
can't help with the core classes you could still help us with
extension classes (with stuff you haven't seen any one else's code).

Check out http://www.gnu.org/software/classpathx

Or maybe the Classpath tools project at savannah here:

   http://savannah.gnu.org/projects/cp-tools

Whatever, you should also check our general java page:

   http://www.gnu.org/software/java

because that gives you a kind of overview. 

Please feel free to make constructive comments about any or all of
these things.

 
> 3. If I write "pure java" implementations, do I need to worry much  
> about your notes on native code and VM integration?  I have not done  
> any JNI programming, but I am okay with learning.  I guess, a better  
> question is, what is the view of this project as far as native code, 
> VM integration, etc.?  I get the feeling by browsing the classes  
> that there isn't much native code in the non-GUI components. 

Native code is required where you can't implement something in Java or
it there is a massive benefit to doing it natively. There are many
core classes that don't need any native code (but many of the more
interesting ones do need native code, networking for example).

  
> Any "getting started" tips would be much appreciated -- it seems  
> like there's a lot to learn for someone coming from a pure Sun world  
> as far as the raw implementation goes. 

We do need more beginner doc. But we are still working hard on getting
stable, usable versions of GCJ, Classpath, etc... out there and
working.

One of the things you could help us with is documentation.


Nic Ferrier
ClasspathX Maintainer



From cbj@gnu.org Thu Apr 25 06:35:13 2002
Received: from fe4.southeast.rr.com ([24.93.67.51] helo=mail4.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170gan-0007zI-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 06:35:13 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail4.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Thu, 25 Apr 2002 06:35:12 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3PAYrI12294;
	Thu, 25 Apr 2002 06:34:53 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: "jiang yong" <jy.sun@usa.com>
Cc: classpath@gnu.org
Subject: Re: about jni
References: <20020425032813.21676.qmail@mail.com>
From: Brian Jones <cbj@gnu.org>
Date: 25 Apr 2002 06:34:53 -0400
In-Reply-To: <20020425032813.21676.qmail@mail.com>
Message-ID: <m3hem0ysky.fsf@lyta.haphazard.org>
Lines: 11
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

"jiang yong" <jy.sun@usa.com> writes:

> about jni: when i use System.loadLibrary("XXXX") , got a error "can
> not find XXXX" ; when i add the all path on my dll , got an annother
> error "can not add the path" .when i use System.load("path\XXXX") ,
> all right .  why ?

What JVM and what version of Classpath?

-- 
Brian Jones <cbj@gnu.org>


From cdcavanna@yahoo.com Thu Apr 25 13:47:53 2002
Received: from smtp012.mail.yahoo.com ([216.136.173.32])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 170nLV-0004RV-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 13:47:53 -0400
Received: from cpe0080c6ee6a89.cpe.net.cable.rogers.com (HELO cr977935a) (cdcavanna@24.114.69.209 with login)
  by smtp.mail.vip.sc5.yahoo.com with SMTP; 25 Apr 2002 17:47:51 -0000
From: "Carlos Cavanna" <cdcavanna@yahoo.com>
To: "Classpath - GNU" <classpath@gnu.org>
Subject: Compilation error
Date: Thu, 25 Apr 2002 13:47:52 -0400
Message-ID: <GBEELMOFAJBBEFHHJEJFIECNDCAA.cdcavanna@yahoo.com>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0)
Importance: Normal
X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4910.0300
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

I have just checked out the latest version of Classpath.

I run:

aclocal
autoheader
automake
autoconf

and

. ./configure --prefix=... --with-gcj --enable-jni

Then, when I run "make" I get:

Making all in lib
make[1]: Entering directory
`/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
top_builddir=.. /bin/sh ./gen-classlist.sh standard
/scr1/cavanna/bin/gcc-3.0.2/bin/gcj -bootclasspath '' -classpath
..:../vm/current:.: -C -d . @classes
gcj: cannot specify -o with -c or -S and multiple compilations
make[1]: *** [compile-classes] Error 1
make[1]: Leaving directory
`/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
make: *** [all-recursive] Error 1

I am using gcj 3.0.2

I did compile previous versions of classpath before, and I am using the same
commands
I always use.

Does anyone know about this error ?

Thanks,
CC



From subscriptions@phillipmorelock.com Thu Apr 25 14:34:40 2002
Received: from host20.cedant.com ([209.239.38.116])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170o4m-0000Bg-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 14:34:40 -0400
Received: from c-24-126-77-31.we.client2.attbi.com (localhost [127.0.0.1])
	by host20.cedant.com (8.10.2/8.10.2) with ESMTP id g3PIYdC00840
	for <classpath@gnu.org>; Thu, 25 Apr 2002 14:34:39 -0400
To: classpath@gnu.org
From: Phillip Morelock <subscriptions@phillipmorelock.com>
Subject: Re: getting started with classpath
Reply-To: subscriptions@phillipmorelock.com
Date: Thu, 25 Apr 2002 11:18:52 -0700
X-Sender: subscriptions@phillipmorelock.com
X-Originating-Host: c-24-126-77-31.we.client2.attbi.com [24.126.77.31]; Thu, 25 Apr 2002 18:34:39 GMT
X-Mailer: WebMail Check v2.3.21 (2000-7-19)
X-Browser: Mozilla/4.0 (compatible; MSIE 5.14; Mac_PowerPC), JavaScript: On
Message-ID: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Thank you so much for your detailed reply.  I have a couple of responses 
/ sub-questions below:

At 25 April 2002, you wrote:
>We do need more beginner doc. But we are still working hard on getting
>stable, usable versions of GCJ, Classpath, etc... out there and
>working.
>
>One of the things you could help us with is documentation.

I would actually really like to help with documentation, as I find 
this pretty lacking in many of even the very best Free projects (not 
slamming anyone, I obviously think that working Free software is 
better than no software or no choice, and i understand the volunteer 
thing, etc., yadda yadda).  

I think my level of experience with coding versus documentation would 
make me a much better contributor as a documenter than coder -- especially 
in light of the fact that the things I could code best would be (coincidentally) 
the things I am probably the least "clean room" on, since those are 
things I've re-implemented before (though i guess not in a clean 
room -- you should see my apartment these days). 

I think I write pretty well (sound of my arm breaking as it reaches 
around to give me a pat on the back).  What would you like help with 
or what do you feel is lacking?  Is it end-user doc, dev-doc, or 
what exactly?  Please, if I'm asking too many questions and this 
is already answered, I can read some stuff if you forward me a pointer 
/ link...don't want to be a brain-drainer.

I have been reading some of the Classpath and GCJ stuff, and am slowly 
getting a little more comfortable, although it's still quite new 
to me. I will continue to study up and read the links you already 
sent, and I will send a new message to the list when I get "ready" 
-- just wanted to respond right now so you knew your comments did 
not fall into a void.

Thanks again for the reply.

phillip 








From nferrier@tapsellferrier.co.uk Thu Apr 25 15:20:55 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170onX-0002zC-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 15:20:55 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 170pEN-0001UI-00; Thu, 25 Apr 2002 20:48:39 +0100
To: subscriptions@phillipmorelock.com
Cc: classpath@gnu.org
Subject: Re: getting started with classpath
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 25 Apr 2002 20:42:56 +0100
In-Reply-To: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
Message-ID: <878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 37
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Phillip Morelock <subscriptions@phillipmorelock.com> writes:

> I have been reading some of the Classpath and GCJ stuff, and am slowly  
> getting a little more comfortable, although it's still quite new  
> to me. I will continue to study up and read the links you already  
> sent, and I will send a new message to the list when I get "ready"  
> -- just wanted to respond right now so you knew your comments did  
> not fall into a void. 

Maybe Brian or Anthony (or one of the other maintaienrs) should chip
in here's a menu of things that are on my list of stuff to do but
that I haven't got round to yet:

- html and texinfo "getting started with Classpath and ORP" guide.

- a very light webpage intro, an edited version of the above

- add lot's of examples to the CNI section of the GCJ manual

- improve the javadoc in the Classpath source code and create a
  texinfo manual using cp-tools texinfo doclet.

And that's just for starters. Ideally our Classpath documentation
would be as good as the glibc documentation is. I don't know if you
the URL for the glibc doc, you can find it at:

   http://www.gnu.org/manual/glibc-2.2.3/libc.html

along with lots of other good quality manuals here:

   http://www.gnu.org/manual/


I'm sure Brian and others will chip in with suggestions.


Nic Ferrier



From green@redhat.com Thu Apr 25 12:12:58 2002
Received: from potter.sfbay.redhat.com ([205.180.83.107])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170ljR-0001vS-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 12:04:29 -0400
Received: from to-dhcp20.toronto.redhat.com (vpn50-17.rdu.redhat.com [172.16.50.17])
	by potter.sfbay.redhat.com (8.11.6/8.11.6) with ESMTP id g3PG3Mv31598;
	Thu, 25 Apr 2002 09:03:22 -0700
Subject: Re: getting started with classpath
From: Anthony Green <green@redhat.com>
To: nferrier@tapsellferrier.co.uk
Cc: subscriptions@phillipmorelock.com, classpath@gnu.org
In-Reply-To: <wkpu0ojgks.fsf@tapsellferrier.co.uk>
References: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com> 
	<wkpu0ojgks.fsf@tapsellferrier.co.uk>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Evolution/1.0.2 (1.0.2-0.7x) 
Date: 25 Apr 2002 09:03:58 -0700
Message-Id: <1019750653.1944.2.camel@dhcppc2>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

On Thu, 2002-04-25 at 02:03, nferrier@tapsellferrier.co.uk wrote:
> One of the things you could help us with is documentation.

And testing. 

I've also found getting 3rd party packages built and running with gcj
very useful in tracking down library/compiler bugs and missing
features.  See http://sources.redhat.com/rhug.  We could always use more
help on that project, and I don't think the fact that you've looked at
Sun source should be a problem there.

AG




From cbj@gnu.org Thu Apr 25 17:49:47 2002
Received: from fe5.southeast.rr.com ([24.93.67.52] helo=mail5.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 170r7b-0000LN-00
	for <classpath@gnu.org>; Thu, 25 Apr 2002 17:49:47 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail5.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Thu, 25 Apr 2002 17:49:46 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3PLnMi14977;
	Thu, 25 Apr 2002 17:49:22 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Cc: subscriptions@phillipmorelock.com, classpath@gnu.org
Subject: Re: getting started with classpath
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
	<878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
From: Brian Jones <cbj@gnu.org>
Date: 25 Apr 2002 17:49:21 -0400
In-Reply-To: <878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Message-ID: <m38z7bcuu6.fsf@lyta.haphazard.org>
Lines: 32
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Nic Ferrier <nferrier@tapsellferrier.co.uk> writes:

> Maybe Brian or Anthony (or one of the other maintaienrs) should chip
> in here's a menu of things that are on my list of stuff to do but
> that I haven't got round to yet:
> 
> - html and texinfo "getting started with Classpath and ORP" guide.
> 
> - a very light webpage intro, an edited version of the above
> 
> - add lot's of examples to the CNI section of the GCJ manual
> 
> - improve the javadoc in the Classpath source code and create a
>   texinfo manual using cp-tools texinfo doclet.

Some good ideas here, but let's not exclude other JVMs such as SableVM
or kissme.  A side question of mine at the moment is whether any of
these support working with the AWT and native peer code other than
GCJ.

If the state of texidoclet is such that it can be used to generate
documentation then work to produce a manual with that would be great.
Work on the Javadoc in general is always welcome.  I've not personally
spent much time looking at it, ever.  I'm certain we're missing
@version or @deprecated tags in places.  I think we also have to go
back and add @serial type stuff.

http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/javadoc.html#@serial

Brian
-- 
Brian Jones <cbj@gnu.org>


From a_rueckert@gmx.net Fri Apr 26 04:44:40 2002
Received: from mail.gmx.net ([213.165.64.20])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 1711LM-0000La-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 04:44:40 -0400
Received: (qmail 5891 invoked by uid 0); 26 Apr 2002 08:44:30 -0000
Received: from krsn-d93363b0.pool.mediaways.net (HELO krsn-d93363b0) (217.51.99.176)
  by mail.gmx.net (mp004-rz3) with SMTP; 26 Apr 2002 08:44:30 -0000
From: Andreas Rueckert <a_rueckert@gmx.net>
Reply-To: classpath@gnu.org
To: classpath@gnu.org
Subject: Re: getting started with classpath
Date: Fri, 26 Apr 2002 09:41:05 +0200
X-Mailer: KMail [version 1.0.28]
Content-Type: text/plain
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com> <878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk> <m38z7bcuu6.fsf@lyta.haphazard.org>
In-Reply-To: <m38z7bcuu6.fsf@lyta.haphazard.org>
MIME-Version: 1.0
Message-Id: <02042609470403.00813@hun.bre.de>
Content-Transfer-Encoding: 8bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi!

On Don, 25 Apr 2002 Brian Jones wrote:
> Nic Ferrier <nferrier@tapsellferrier.co.uk> writes:
> 
> > Maybe Brian or Anthony (or one of the other maintaienrs) should chip
> > in here's a menu of things that are on my list of stuff to do but
> > that I haven't got round to yet:
> > 
> > - html and texinfo "getting started with Classpath and ORP" guide.

I know I'm asking for a lot, but don't you think it would be worth to add some
documentation on how to get started on a specific platform? I recently tried to
get classpath running on a Mandrake 8.1 distro. No luck so far, since compiling
automake, autoconfm glib etc. from scratch was not enough to get it working (I
don't recall the details, but at the moment the gtk libs seem to be the
problem). I don't know how complicated it is to use Windows, but I had quite
some problems with Linux.

> > - a very light webpage intro, an edited version of the above
> > 
> > - add lot's of examples to the CNI section of the GCJ manual
> > 
> > - improve the javadoc in the Classpath source code and create a
> >   texinfo manual using cp-tools texinfo doclet.
> 
> Some good ideas here, but let's not exclude other JVMs such as SableVM
> or kissme.  A side question of mine at the moment is whether any of
> these support working with the AWT and native peer code other than
> GCJ.

Don't you think it would be better to focus on one JVM (at least from the
Classpath side) and get the AWT running there?

Ciao,
Andreas


From cbj@gnu.org Fri Apr 26 07:42:50 2002
Received: from fe6.southeast.rr.com ([24.93.67.53] helo=mail6.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 17147l-0002jh-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 07:42:49 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail6.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Fri, 26 Apr 2002 07:42:41 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3QBg7318188;
	Fri, 26 Apr 2002 07:42:07 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: "Patrik Reali" <reali@acm.org>
Cc: <classpath@gnu.org>
Subject: Re: getting started with classpath
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
	<878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
	<m38z7bcuu6.fsf@lyta.haphazard.org>
	<005301c1ecfb$1b649e90$518310ac@cyclone>
From: Brian Jones <cbj@gnu.org>
Date: 26 Apr 2002 07:42:07 -0400
In-Reply-To: <005301c1ecfb$1b649e90$518310ac@cyclone>
Message-ID: <m3znzqbsa8.fsf@lyta.haphazard.org>
Lines: 17
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

"Patrik Reali" <reali@acm.org> writes:

> From: "Brian Jones" <cbj@gnu.org>
> > Some good ideas here, but let's not exclude other JVMs such as SableVM
> > or kissme.  A side question of mine at the moment is whether any of
> > these support working with the AWT and native peer code other than
> > GCJ.
> 
> Jaos has currently no support for the AWT.
> Whenever this happens, I will have to provide my own native implementation,
> because I'm not running on a *nix system.

I think GTK works on Windows.  Not sure about any other ports.

Brian
-- 
Brian Jones <cbj@gnu.org>


From reali@acm.org Fri Apr 26 04:19:38 2002
Received: from core.inf.ethz.ch ([129.132.178.196])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 1710x8-0005lx-00; Fri, 26 Apr 2002 04:19:38 -0400
Received: from lillian-ics.inf.ethz.ch (root@lillian-ics.inf.ethz.ch [129.132.134.2])
	by core.inf.ethz.ch (8.9.3/8.9.3) with ESMTP id KAA21695;
	Fri, 26 Apr 2002 10:19:33 +0200 (MET DST)
Received: from cyclone (dua131081.dialup800-stat.ethz.ch [172.16.131.81])
	by lillian-ics.inf.ethz.ch (8.9.3/8.9.3) with SMTP id KAA25140;
	Fri, 26 Apr 2002 10:19:34 +0200 (MET DST)
Message-ID: <005301c1ecfb$1b649e90$518310ac@cyclone>
From: "Patrik Reali" <reali@acm.org>
To: "Brian Jones" <cbj@gnu.org>
Cc: <classpath@gnu.org>
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com><878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk> <m38z7bcuu6.fsf@lyta.haphazard.org>
Subject: Re: getting started with classpath
Date: Fri, 26 Apr 2002 10:19:36 +0200
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2600.0000
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2600.0000
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

From: "Brian Jones" <cbj@gnu.org>
> Some good ideas here, but let's not exclude other JVMs such as SableVM
> or kissme.  A side question of mine at the moment is whether any of
> these support working with the AWT and native peer code other than
> GCJ.

Jaos has currently no support for the AWT.
Whenever this happens, I will have to provide my own native implementation,
because I'm not running on a *nix system.


-Patrik



From cbj@gnu.org Fri Apr 26 07:52:03 2002
Received: from fe4.southeast.rr.com ([24.93.67.51] helo=mail4.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 1714Gh-0003Ku-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 07:52:03 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail4.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Fri, 26 Apr 2002 07:51:58 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3QBpO818234;
	Fri, 26 Apr 2002 07:51:24 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: classpath@gnu.org
Subject: Re: getting started with classpath
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
	<878z7b5zun.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
	<m38z7bcuu6.fsf@lyta.haphazard.org> <02042609470403.00813@hun.bre.de>
From: Brian Jones <cbj@gnu.org>
Date: 26 Apr 2002 07:51:24 -0400
In-Reply-To: <02042609470403.00813@hun.bre.de>
Message-ID: <m31yd2ptj7.fsf@lyta.haphazard.org>
Lines: 19
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Andreas Rueckert <a_rueckert@gmx.net> writes:

> > Some good ideas here, but let's not exclude other JVMs such as SableVM
> > or kissme.  A side question of mine at the moment is whether any of
> > these support working with the AWT and native peer code other than
> > GCJ.
> 
> Don't you think it would be better to focus on one JVM (at least from the
> Classpath side) and get the AWT running there?

Yes for development, but I thought we were talking about
documentation?  In the near future we should have support for IBM's
JRVM in CVS (and in a release soon after) and at some point Kaffe may
work with Classpath as well although that depends on people interested
in Kaffe.

Brian
-- 
Brian Jones <cbj@gnu.org>


From cdcavanna@yahoo.com Fri Apr 26 13:23:33 2002
Received: from web10207.mail.yahoo.com ([216.136.130.71])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 1719RV-0007OE-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 13:23:33 -0400
Message-ID: <20020426172332.75421.qmail@web10207.mail.yahoo.com>
Received: from [24.114.69.209] by web10207.mail.yahoo.com via HTTP; Fri, 26 Apr 2002 10:23:32 PDT
Date: Fri, 26 Apr 2002 10:23:32 -0700 (PDT)
From: Carlos Cavanna <cdcavanna@yahoo.com>
Subject: Re: Compilation error - More Info
To: Classpath - GNU <classpath@gnu.org>
In-Reply-To: <GBEELMOFAJBBEFHHJEJFIECNDCAA.cdcavanna@yahoo.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

Continuing with the compilation problem ...

I have installed and usuccessfully tried with 3.0.4
(-bootclasspath '' seems to be invalid but I don't
know what to fix there).
So I installed jikes 1.15b and it seems to go further,
but it doesn't compile either. There seem to be
missing classes in javax.swing (at least they are
not in CVS).

I got:

Found 2 semantic errors compiling
"../javax/swing/event/InternalFrameEvent.java":

    42. import javax.swing.JInternalFrame;
               <------------------------>
*** Error: The import "javax/swing/JInternalFrame" is
not valid, since it does not name a type in a packag
e.

Found 4 semantic errors compiling
"../javax/swing/event/MenuDragMouseEvent.java":

    43. import javax.swing.MenuElement;
               <--------------------->
*** Error: The import "javax/swing/MenuElement" is not
valid, since it does not name a type in a package.

Among others ...

Has anyone had similar problems with the latest
version from CVS ?

CC

--- Carlos Cavanna <cdcavanna@yahoo.com> wrote:
> Hi,
> 
> I have just checked out the latest version of
> Classpath.
> 
> I run:
> 
> aclocal
> autoheader
> automake
> autoconf
> 
> and
> 
> . ./configure --prefix=... --with-gcj --enable-jni
> 
> Then, when I run "make" I get:
> 
> Making all in lib
> make[1]: Entering directory
>
`/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
> top_builddir=.. /bin/sh ./gen-classlist.sh standard
> /scr1/cavanna/bin/gcc-3.0.2/bin/gcj -bootclasspath
> '' -classpath
> ..:../vm/current:.: -C -d . @classes
> gcj: cannot specify -o with -c or -S and multiple
> compilations
> make[1]: *** [compile-classes] Error 1
> make[1]: Leaving directory
>
`/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
> make: *** [all-recursive] Error 1
> 
> I am using gcj 3.0.2
> 
> I did compile previous versions of classpath before,
> and I am using the same
> commands
> I always use.
> 
> Does anyone know about this error ?
> 
> Thanks,
> CC
> 
> 
> _______________________________________________
> Classpath mailing list
> Classpath@gnu.org
> http://mail.gnu.org/mailman/listinfo/classpath


__________________________________________________
Do You Yahoo!?
Yahoo! Games - play chess, backgammon, pool and more
http://games.yahoo.com/


From jleuner@elandtech.com Fri Apr 26 16:19:47 2002
Received: from spamisevil.test.ie.vianw.net ([212.17.60.214] helo=lenny.elandtech.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171CC3-0005fo-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 16:19:47 -0400
Received: from [192.168.100.211] (helo=bapli ident=mail)
	by lenny.elandtech.com with esmtp (Exim 3.34 #1 (Debian))
	id 171C5C-0005Ns-00; Fri, 26 Apr 2002 20:12:42 +0000
Received: from jleuner by bapli with local (Exim 3.35 #1 (Debian))
	id 171C4J-0001ml-00; Fri, 26 Apr 2002 21:11:47 +0100
Date: Fri, 26 Apr 2002 21:11:47 +0100
From: John Leuner <jewel@pixie.co.za>
To: Phillip Morelock <subscriptions@phillipmorelock.com>
Cc: classpath@gnu.org
Subject: Classpath API javadoc
Message-ID: <20020426201147.GA381@bapli>
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
User-Agent: Mutt/1.3.27i
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> Thank you so much for your detailed reply.  I have a couple of responses 
> / sub-questions below:
> 
> At 25 April 2002, you wrote:
> >We do need more beginner doc. But we are still working hard on getting
> >stable, usable versions of GCJ, Classpath, etc... out there and
> >working.
> >
> >One of the things you could help us with is documentation.
> 
> I would actually really like to help with documentation, as I find 
> this pretty lacking in many of even the very best Free projects (not 
> slamming anyone, I obviously think that working Free software is 
> better than no software or no choice, and i understand the volunteer 
> thing, etc., yadda yadda).  
> 
> I think my level of experience with coding versus documentation would 
> make me a much better contributor as a documenter than coder -- especially 
> in light of the fact that the things I could code best would be (coincidentally) 
> the things I am probably the least "clean room" on, since those are 
> things I've re-implemented before (though i guess not in a clean 
> room -- you should see my apartment these days). 
> 
> I think I write pretty well (sound of my arm breaking as it reaches 
> around to give me a pat on the back).  What would you like help with 
> or what do you feel is lacking?  Is it end-user doc, dev-doc, or 
> what exactly?  Please, if I'm asking too many questions and this 
> is already answered, I can read some stuff if you forward me a pointer 
> / link...don't want to be a brain-drainer.

There is an issue I have been meaning to raise lately, but never got round to.

As part of the Classpath effort we are producing a large amount of javadoc documentation for the standard java class libraries. Unlike Sun, we don't have a reference page that people can use for an API reference (at least not that I know of). I think it's a waste of all the effort that has gone into commenting code, this resource should be made available and people should be encouraged to use it. Not only does it bring awareness to the project, but people can point out incorrect documentation (and potentially incorrect implementations) which is good for the project.

On a technical level, all it requires is a daily script to run javadoc against Classpath CVS and a webserver.

John Leuner


From jleuner@elandtech.com Fri Apr 26 16:31:06 2002
Received: from spamisevil.test.ie.vianw.net ([212.17.60.214] helo=lenny.elandtech.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171CMz-0006jY-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 16:31:05 -0400
Received: from [192.168.100.211] (helo=bapli ident=mail)
	by lenny.elandtech.com with esmtp (Exim 3.34 #1 (Debian))
	id 171CGA-0005Q5-00; Fri, 26 Apr 2002 20:24:02 +0000
Received: from jleuner by bapli with local (Exim 3.35 #1 (Debian))
	id 171CFH-0001oG-00; Fri, 26 Apr 2002 21:23:07 +0100
Date: Fri, 26 Apr 2002 21:23:07 +0100
From: John Leuner <jewel@pixie.co.za>
To: Phillip Morelock <subscriptions@phillipmorelock.com>
Cc: classpath@gnu.org
Subject: Re: getting started with classpath
Message-ID: <20020426202307.GB381@bapli>
References: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com>
User-Agent: Mutt/1.3.27i
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> I have a gnawing interest in hacking on classpath, and I have read 
> a couple of times over the guide "hacking.html" that is linked from 
> the GNU site.  It's just, I'm having a simultaneous-learning-curve 
> experience, and I'm wondering if anyone on this list can push me 
> off in the right direction to eventually being able to contribute.
> 
> 
> My "problems" or rather questions are as follows:
> 1.  I only have experience using one JDK/JRE (Sun's), although I 
> have used it on many platforms.  I noticed a strong linkage between 
> Classpath and (of course) the free JVM / compiler implementations.
> That's cool, I get it, I am just not sure which components each 
> of these tools replace, and what their level of compliance / implementation 
> is.  Is there maybe a best order to learn about these tools in?  
> I would like to know Free Java and work on it even, but am not sure 
> how to start.

Well, I suggest you start with compilers. Try out jikes (it's quite similar to javac in behaviour) and move on from there to kjc.

Next try and compile classpath itself.

After that, get one of the free JVMs and try to get it to work with Classpath. 

You can also try out gcj.

If you encounter anything 'surprising' with these tools, it's worthwhile to post the list, because ultimately we would want to provide a similar user-experience to that provided by the SUn software.

> 2.  How can I be certain I meet the "clean room" requirement?  I 
> have browsed through several of sun's classes several times in source 
> code form as included on my Mac OS X machine.  I know that I don't 
> remember any specifics, they were just instructive at the time.  
> Does this count?

Yes
 
> 3. If I write "pure java" implementations, do I need to worry much 
> about your notes on native code and VM integration?  I have not done 
> any JNI programming, but I am okay with learning.  I guess, a better 
> question is, what is the view of this project as far as native code,
> VM integration, etc.?  I get the feeling by browsing the classes 
> that there isn't much native code in the non-GUI components.

Generally we try to minimize use of native code. IMO there are still some classes that could do with pure Java where native code is being used. You don't really need to worry much about native code and VM integration unless you're hacking the 'core' classes. In fact these classes have received the most attention and are probably in the best state. What needs more work is stuff that isn't used so often.
 
> Any "getting started" tips would be much appreciated -- it seems 
> like there's a lot to learn for someone coming from a pure Sun world 
> as far as the raw implementation goes.

Well, in the Sun world you don't have to worry much about the implementation because it's closed :-)

(Ok, maybe the source to the class libraries is available for viewing, but it's not available for potential modification).

You might struggle a bit with the various VMs since they are at various stages of maturity and not always in sync with the ever-changing Classpath. Don't hesitate to ask the VM developers or Classpath developers questions about getting things to work.

John Leuner



From nferrier@tapsellferrier.co.uk Fri Apr 26 16:33:47 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171CPb-00087c-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 16:33:47 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 171CqZ-0002KV-00; Fri, 26 Apr 2002 22:01:39 +0100
To: John Leuner <jewel@pixie.co.za>
Cc: Phillip Morelock <subscriptions@phillipmorelock.com>,  classpath@gnu.org
Subject: Re: Classpath API javadoc
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
	<20020426201147.GA381@bapli>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 26 Apr 2002 21:55:48 +0100
In-Reply-To: <20020426201147.GA381@bapli>
Message-ID: <87wuuu41t7.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 47
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

John Leuner <jewel@pixie.co.za> writes:

> > Thank you so much for your detailed reply.  I have a couple of responses  
> > / sub-questions below: 
> >  
> > At 25 April 2002, you wrote: 
> > >We do need more beginner doc. But we are still working hard on getting 
> > >stable, usable versions of GCJ, Classpath, etc... out there and 
> > >working. 
> > > 
> > >One of the things you could help us with is documentation. 
> >  
> > I would actually really like to help with documentation, as I find  
> > this pretty lacking in many of even the very best Free projects (not  
> > slamming anyone, I obviously think that working Free software is  
> > better than no software or no choice, and i understand the volunteer  
> > thing, etc., yadda yadda).   
> >  
> > I think my level of experience with coding versus documentation would  
> > make me a much better contributor as a documenter than coder -- especially  
> > in light of the fact that the things I could code best would be (coincidentally)  
> > the things I am probably the least "clean room" on, since those are  
> > things I've re-implemented before (though i guess not in a clean  
> > room -- you should see my apartment these days).  
> >  
> > I think I write pretty well (sound of my arm breaking as it reaches  
> > around to give me a pat on the back).  What would you like help with  
> > or what do you feel is lacking?  Is it end-user doc, dev-doc, or  
> > what exactly?  Please, if I'm asking too many questions and this  
> > is already answered, I can read some stuff if you forward me a pointer  
> > / link...don't want to be a brain-drainer. 
>  
> There is an issue I have been meaning to raise lately, but never got round to. 
>  
> As part of the Classpath effort we are producing a large amount of javadoc documentation for the standard java class libraries. Unlike Sun, we don't have a reference page that people can use for an API reference (at least not that I know of). I think it's a waste of all the effort that has gone into commenting code, this resource should be made available and people should be encouraged to use it. Not only does it bring awareness to the project, but people can point out incorrect documentation (and potentially incorrect implementations) which is good for the project. 
>  
> On a technical level, all it requires is a daily script to run javadoc against Classpath CVS and a webserver. 

Personally I think that the javadoc should be done per release, which
I guess is why it hasn't been done yet.

The cp-tools guys are well on the way to having the texinfo doclet
working which will make the javadoc accessible from info and emacs.



Nic



From cbj@gnu.org Fri Apr 26 19:31:08 2002
Received: from fe5.southeast.rr.com ([24.93.67.52] helo=mail5.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171FBE-0000px-00
	for <classpath@gnu.org>; Fri, 26 Apr 2002 19:31:08 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail5.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Fri, 26 Apr 2002 19:31:06 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3QNUQx20818;
	Fri, 26 Apr 2002 19:30:26 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Carlos Cavanna <cdcavanna@yahoo.com>
Cc: Classpath - GNU <classpath@gnu.org>
Subject: Re: Compilation error - More Info
References: <20020426172332.75421.qmail@web10207.mail.yahoo.com>
From: Brian Jones <cbj@gnu.org>
Date: 26 Apr 2002 19:30:26 -0400
In-Reply-To: <20020426172332.75421.qmail@web10207.mail.yahoo.com>
Message-ID: <m3wuuunilp.fsf@lyta.haphazard.org>
Lines: 14
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Carlos Cavanna <cdcavanna@yahoo.com> writes:

> Has anyone had similar problems with the latest
> version from CVS ?
> 
> CC

There were some recent checkins a day or two ago that added or merges
quite a bit of Swing stuff.  It is possible something didn't get
included with that commit.

Brian
-- 
Brian Jones <cbj@gnu.org>


From tromey@creche.cygnus.com Sat Apr 27 15:32:05 2002
Received: from mail.peakpeak.com ([207.174.178.17] helo=gash2.peakpeak.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 171XvR-00089n-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 15:32:05 -0400
Received: from creche.cygnus.com (ta0195.peakpeak.com [204.144.244.195])
	by gash2.peakpeak.com (8.9.3/8.9.3) with ESMTP id NAA22523;
	Sat, 27 Apr 2002 13:31:44 -0600
Received: (from tromey@localhost)
	by creche.cygnus.com (8.9.3/8.9.3) id NAA27923;
	Sat, 27 Apr 2002 13:38:46 -0600
To: John Leuner <jewel@pixie.co.za>
Cc: Phillip Morelock <subscriptions@phillipmorelock.com>, classpath@gnu.org
Subject: Re: Classpath API javadoc
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com> <20020426201147.GA381@bapli>
From: Tom Tromey <tromey@redhat.com>
Reply-To: tromey@redhat.com
X-Attribution:  Tom
X-Zippy:  Are BOTH T.V.S on??
Date: 27 Apr 2002 13:38:45 -0600
In-Reply-To: John Leuner's message of "Fri, 26 Apr 2002 21:11:47 +0100"
Message-ID: <874rhxkk3e.fsf@creche.redhat.com>
Lines: 21
X-Mailer: Gnus v5.7/Emacs 20.5
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

>>>>> "John" == John Leuner <jewel@pixie.co.za> writes:

John> I think it's a waste of all the effort that has gone into
John> commenting code, this resource should be made available and
John> people should be encouraged to use it.

I agree.  Also it will make RMS happy -- he likes it when free
documentation is available so that people don't have to rely on the
proprietary stuff.

About a month ago I ran javadoc on the libgcj tree.  There were tons
of warnings.  Also the output isn't really that good.  For example,
the first line of a description is used on the index pages; for our
docs this line is typically not very informative, so the output is
harder to use.

I think if we ran this regularly it might help us know what needs to
be edited.  It seems to be harder to see these problems in the source
than it is in the output.

Tom


From subscriptions@phillipmorelock.com Sat Apr 27 16:21:35 2002
Received: from adsl-216-103-55-217.dsl.lsan03.pacbell.net ([216.103.55.217] helo=hacksciences.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171YhK-0002TM-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 16:21:35 -0400
Received: from [192.168.1.20] ([192.168.1.20])
	by hacksciences.com (8.11.6/8.11.6) with ESMTP id g3RKG2n04683
	for <classpath@gnu.org>; Sat, 27 Apr 2002 13:16:03 -0700
User-Agent: Microsoft-Entourage/10.0.0.1309
Date: Sat, 27 Apr 2002 13:21:32 -0700
Subject: Re: Classpath API javadoc
From: Phillip Morelock <subscriptions@phillipmorelock.com>
To: <classpath@gnu.org>
Message-ID: <B8F0565C.1712%subscriptions@phillipmorelock.com>
In-Reply-To: <874rhxkk3e.fsf@creche.redhat.com>
Mime-version: 1.0
Content-type: text/plain; charset="US-ASCII"
Content-transfer-encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi

I know I'm still new to this community, but since I'm going to focus my
efforts on documentation because I have been ruled "unclean" ;) ...

Resultant newbie question:  is it still "ok" to use sun's javadoc tool or is
there an appropriate free tool?  How do "they" (or you) generally feel about
using non-free tools in this context?  also, what is the state of such tool?

Forgive me, I'm still pretty new to the whole "GNU" mindset and don't want
to step on toes or whatever.

cheers
Phillip


On 4/27/02 12:38 PM, "Tom Tromey" <tromey@redhat.com> wrote:

>>>>>> "John" == John Leuner <jewel@pixie.co.za> writes:
> 
> John> I think it's a waste of all the effort that has gone into
> John> commenting code, this resource should be made available and
> John> people should be encouraged to use it.
> 
> I agree.  Also it will make RMS happy -- he likes it when free
> documentation is available so that people don't have to rely on the
> proprietary stuff.
> 
> About a month ago I ran javadoc on the libgcj tree.  There were tons
> of warnings.  Also the output isn't really that good.  For example,
> the first line of a description is used on the index pages; for our
> docs this line is typically not very informative, so the output is
> harder to use.
> 
> I think if we ran this regularly it might help us know what needs to
> be edited.  It seems to be harder to see these problems in the source
> than it is in the output.
> 
> Tom
> 



From tromey@creche.cygnus.com Sat Apr 27 17:46:15 2002
Received: from mail.peakpeak.com ([207.174.178.17] helo=gash2.peakpeak.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 171a1G-0003PI-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 17:46:14 -0400
Received: from creche.cygnus.com (ta0195.peakpeak.com [204.144.244.195])
	by gash2.peakpeak.com (8.9.3/8.9.3) with ESMTP id PAA05701;
	Sat, 27 Apr 2002 15:46:11 -0600
Received: (from tromey@localhost)
	by creche.cygnus.com (8.9.3/8.9.3) id PAA28553;
	Sat, 27 Apr 2002 15:53:17 -0600
To: Classpath Project <classpath@gnu.org>
Subject: System.in and buffering
From: Tom Tromey <tromey@redhat.com>
Reply-To: tromey@redhat.com
X-Attribution:  Tom
X-Zippy:  What PROGRAM are they watching?
Date: 27 Apr 2002 15:53:16 -0600
Message-ID: <87elh0kdv7.fsf@creche.redhat.com>
Lines: 10
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Today I looked at merging the Classpath and libgcj System classes.  Is
there a particular reason System.in (and .out and .err) are not
buffered?  The JCL book says that they are by default (this info isn't
in the online docs).  Also I think buffering is important for
performance.

I'm keeping the buffering in the libgcj version.  I just want to know
if there is a reason before applying my patch to the Classpath one.

Tom


From tromey@creche.cygnus.com Sat Apr 27 18:01:21 2002
Received: from mail.peakpeak.com ([207.174.178.17] helo=gash2.peakpeak.com)
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 171aFs-0003vX-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 18:01:21 -0400
Received: from creche.cygnus.com (ta0195.peakpeak.com [204.144.244.195])
	by gash2.peakpeak.com (8.9.3/8.9.3) with ESMTP id QAA07379;
	Sat, 27 Apr 2002 16:01:15 -0600
Received: (from tromey@localhost)
	by creche.cygnus.com (8.9.3/8.9.3) id QAA28611;
	Sat, 27 Apr 2002 16:08:21 -0600
To: Classpath Project <classpath@gnu.org>
Subject: Runtime reference implementation buglet
From: Tom Tromey <tromey@redhat.com>
Reply-To: tromey@redhat.com
X-Attribution:  Tom
X-Zippy:  Excuse me, but didn't I tell you there's NO HOPE for the
 survival of OFFSET PRINTING?
Date: 27 Apr 2002 16:08:20 -0600
Message-ID: <87bsc4kd63.fsf@creche.redhat.com>
Lines: 15
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

In the Runtime reference implementation I see this code:

    if (nativeLoad(filename) == 0)
      throw new UnsatisfiedLinkError("Could not load library " + filename);

Later there is this:

   * @return 0 on success, nonzero on failure
   */
  native int nativeLoad(String filename);

One or the other is wrong.  I don't know which.  Could whoever works
on this class please fix this?  Thanks.

Tom


From nferrier@tapsellferrier.co.uk Sat Apr 27 18:22:12 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171aa4-0004jh-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 18:22:12 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 171b0t-0001qE-00; Sat, 27 Apr 2002 23:49:55 +0100
To: Phillip Morelock <subscriptions@phillipmorelock.com>
Cc: <classpath@gnu.org>
Subject: Re: Classpath API javadoc
References: <B8F0565C.1712%subscriptions@phillipmorelock.com>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 27 Apr 2002 23:43:53 +0100
In-Reply-To: <B8F0565C.1712%subscriptions@phillipmorelock.com>
Message-ID: <87g01g4v9y.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 33
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Phillip Morelock <subscriptions@phillipmorelock.com> writes:

> Hi 
>  
> I know I'm still new to this community, but since I'm going to focus my 
> efforts on documentation because I have been ruled "unclean" ;) ... 
>  
> Resultant newbie question:  is it still "ok" to use sun's javadoc tool or is 
> there an appropriate free tool?  How do "they" (or you) generally feel about 
> using non-free tools in this context?  also, what is the state of
> such tool? 

The classpath-tools project has a javadoc tool underway. AFAIK it is
working at a basic level but isn't bug checked and stuff yet.


It's fine, for now, to use Sun's javadoc tool. When the
classpath-tools javadoc is working we can switch to that.

Note that the classpath-tools javadoc program supports outputing the
javadoc in texinfo instead of html. Texinfo is the GNU documentation
format (it's what "info" files are written in).


> Forgive me, I'm still pretty new to the whole "GNU" mindset and
> don't want to step on toes or whatever. 

Nobody who wants to help will ever step on any ones toes  /8->

If you're confused or lost just ask and we'll help.


Nic



From cbj@gnu.org Sat Apr 27 22:51:29 2002
Received: from fe6.southeast.rr.com ([24.93.67.53] helo=mail6.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171emf-0001RL-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 22:51:29 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail6.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sat, 27 Apr 2002 22:51:28 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3S2oVd00671;
	Sat, 27 Apr 2002 22:50:31 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: tromey@redhat.com
Cc: Classpath Project <classpath@gnu.org>
Subject: Re: System.in and buffering
References: <87elh0kdv7.fsf@creche.redhat.com>
From: Brian Jones <cbj@gnu.org>
Date: 27 Apr 2002 22:50:31 -0400
In-Reply-To: <87elh0kdv7.fsf@creche.redhat.com>
Message-ID: <m3d6wk1qq0.fsf@lyta.haphazard.org>
Lines: 16
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Tom Tromey <tromey@redhat.com> writes:

> Today I looked at merging the Classpath and libgcj System classes.  Is
> there a particular reason System.in (and .out and .err) are not
> buffered?  The JCL book says that they are by default (this info isn't
> in the online docs).  Also I think buffering is important for
> performance.
> 
> I'm keeping the buffering in the libgcj version.  I just want to know
> if there is a reason before applying my patch to the Classpath one.

I'm open to buffering these if the JCL says to do so.

Brian
-- 
Brian Jones <cbj@gnu.org>


From john@johnkeiser.com Sat Apr 27 00:23:09 2002
Received: from r2d2.netscape.com ([205.217.237.47] helo=netscape.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171Jjp-0005sj-00
	for <classpath@gnu.org>; Sat, 27 Apr 2002 00:23:09 -0400
Received: from dredd.mcom.com (dredd.mcom.com [205.217.237.54])
	by netscape.com (8.10.0/8.10.0) with ESMTP id g3R4N1S21660
	for <classpath@gnu.org>; Fri, 26 Apr 2002 21:23:01 -0700 (PDT)
Received: from jkeiser ([10.169.184.59]) by dredd.mcom.com
          (Netscape Messaging Server 4.15) with SMTP id GV7LID00.NWE; Fri,
          26 Apr 2002 21:23:01 -0700 
Message-ID: <01d001c1eda3$381866e0$677f1b42@jkeiser>
From: "John Keiser" <john@johnkeiser.com>
To: "John Leuner" <jewel@pixie.co.za>,
   "Nic Ferrier" <nferrier@tapsellferrier.co.uk>
Cc: "Phillip Morelock" <subscriptions@phillipmorelock.com>,
   <classpath@gnu.org>
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com><20020426201147.GA381@bapli> <87wuuu41t7.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Subject: Re: Classpath API javadoc
Date: Fri, 26 Apr 2002 21:23:00 -0700
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2600.0000
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2600.0000
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

John Leuner <jewel@pixie.co.za> writes:
> There is an issue I have been meaning to raise lately, but never got round
to.
>
> As part of the Classpath effort we are producing a large amount of javadoc
documentation for the standard java class libraries. Unlike Sun, we don't
have a
> reference page that people can use for an API reference (at least not that
I know of). I think it's a waste of all the effort that has gone into
commenting code, this > resource should be made available and people should
be encouraged to use it. Not only does it bring awareness to the project,
but people can point out incorrect
> documentation (and potentially incorrect implementations) which is good
for the project.
>

In a lot of places our JavaDoc is actually better than Sun's, so this would
be a good thing indeed :)

--John



From mark@wildebeest.org Sun Apr 28 08:13:35 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171nYd-000733-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 08:13:35 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 171nYL-0002Q7-00; Sun, 28 Apr 2002 14:13:17 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 171nYO-0002vq-00; Sun, 28 Apr 2002 14:13:20 +0200
Subject: Re: Classpath API javadoc
From: Mark Wielaard <mark@klomp.org>
To: Phillip Morelock <subscriptions@phillipmorelock.com>
Cc: classpath@gnu.org
In-Reply-To: <B8F0565C.1712%subscriptions@phillipmorelock.com>
References: <B8F0565C.1712%subscriptions@phillipmorelock.com>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 28 Apr 2002 14:13:20 +0200
Message-Id: <1019996000.7771.63.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

On Sat, 2002-04-27 at 22:21, Phillip Morelock wrote:
> 
> Resultant newbie question:  is it still "ok" to use sun's javadoc tool or is
> there an appropriate free tool?  How do "they" (or you) generally feel about
> using non-free tools in this context?  also, what is the state of such tool?

We only use proprietary tools to make sure we are compatible or
bootstrapping out of a proprietary environment. And there are some free
tools that can generate very nice documentation so please use them.

Back in October I played a bit with DoxyGen <http://www.doxygen.org/>
which is originally written for C++ but it does handle javadoc quite
nicely. Some results of running it on an old version of GNU Classpath
can be found at <http://www.klomp.org/mark/classpath/html/classes.html>.

Note that the images it generates are gifs which is frowned upon.
But even without the gifs it is nice to have that documentation.

I have not tried out the texidoclet for the Classpath Tools project yet.
Source can be found <http://savannah.gnu.org/cgi-bin/viewcvs/cp-tools/>
I don't know if there has been an official release yet.

Cheers,

Mark


From mark@wildebeest.org Sun Apr 28 08:37:04 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171nvL-0001V4-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 08:37:04 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 171num-0002Qs-00; Sun, 28 Apr 2002 14:36:28 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 171nuq-000314-00; Sun, 28 Apr 2002 14:36:32 +0200
Subject: Re: getting started with classpath
From: Mark Wielaard <mark@klomp.org>
To: Phillip Morelock <subscriptions@phillipmorelock.com>
Cc: classpath@gnu.org
In-Reply-To: <20020426202307.GB381@bapli>
References: <jUsT.aNoTheR.mEsSaGe.iD.10197178361318@phillipmorelock.com> 
	<20020426202307.GB381@bapli>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 28 Apr 2002 14:36:32 +0200
Message-Id: <1019997392.7772.83.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

John already said it all, but let me just second his suggestions and add
some links to more documentation.

On Fri, 2002-04-26 at 22:23, John Leuner wrote:
> > I would like to know Free Java and work on it even, but am not sure 
> > how to start.
> 
> Well, I suggest you start with compilers. Try out jikes (it's quite similar to javac in behaviour)
> and move on from there to kjc.
> 
> Next try and compile classpath itself.
> 
> After that, get one of the free JVMs and try to get it to work with Classpath. 

Yes, please try and read what we have written now and if it is not clear
or doesn't work as advertised please yell. We would be very happy to get
the documentation in a better shape. And we probably don't explain
everything as clearly as could be because it was written when it already
worked for us.

Are the webpages clear enough <http://www.classpath.org/>?
Does the documentation given in the README, INSTALL and HACKING file
explain enough to get it up and running?
http://savannah.gnu.org/cgi-bin/viewcvs/classpath/classpath/README?rev=HEAD
http://savannah.gnu.org/cgi-bin/viewcvs/classpath/classpath/INSTALL?rev=HEAD
http://savannah.gnu.org/cgi-bin/viewcvs/classpath/classpath/HACKING?rev=HEAD

Also note that starting with the latest release (0.03) is easier then
the ever changing CVS version. And most people use a GNU/Linux system.

You can also look at the instructions to get ORP going with classpath
<http://www.gnu.org/software/classpath/doc/orp.html>
Or the JRVM
<http://people.debian.org/~jewel/jikes/jikesport/>
It would be nice to have similar documents for KissMe and SabeleVM
<http://kissme.sf.net/>
<http://sablevm.sf.net/>

> You can also try out gcj.

Note that Nic Ferrier cleaned up the documentation for the (almost
ready, any day/week now) 3.1 release. Which can be found at:
<http://gcc.gnu.org/onlinedocs/gcj/>

> You might struggle a bit with the various VMs since they are
> at various stages of maturity and not always in sync with the
> ever-changing Classpath.
> Don't hesitate to ask the VM developers or Classpath developers
> questions about getting things to work.

Yes, it might be a bumpy ride but we are very interested in helping
getting it more smooth :) And it will be an interesting experience.

Cheers,

Mark


From mark@wildebeest.org Sun Apr 28 08:43:50 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171o1u-0001oA-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 08:43:50 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 171o1n-0002RJ-00; Sun, 28 Apr 2002 14:43:43 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 171o1r-00034I-00; Sun, 28 Apr 2002 14:43:47 +0200
Subject: Re: Compilation error
From: Mark Wielaard <mark@klomp.org>
To: Carlos Cavanna <cdcavanna@yahoo.com>
Cc: Classpath - GNU <classpath@gnu.org>
In-Reply-To: <GBEELMOFAJBBEFHHJEJFIECNDCAA.cdcavanna@yahoo.com>
References: <GBEELMOFAJBBEFHHJEJFIECNDCAA.cdcavanna@yahoo.com>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 28 Apr 2002 14:43:43 +0200
Message-Id: <1019997823.7772.94.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

On Thu, 2002-04-25 at 19:47, Carlos Cavanna wrote:
> . ./configure --prefix=... --with-gcj --enable-jni
> 
> Then, when I run "make" I get:
> 
> Making all in lib
> make[1]: Entering directory
> `/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
> top_builddir=.. /bin/sh ./gen-classlist.sh standard
> /scr1/cavanna/bin/gcc-3.0.2/bin/gcj -bootclasspath '' -classpath
> ..:../vm/current:.: -C -d . @classes
> gcj: cannot specify -o with -c or -S and multiple compilations
> make[1]: *** [compile-classes] Error 1
> make[1]: Leaving directory
> `/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
> make: *** [all-recursive] Error 1
> 
> I am using gcj 3.0.2
> 
> I did compile previous versions of classpath before, and I am using the same
> commands
> I always use.
> 
> Does anyone know about this error ?

Yes, sorry about that. The CVS version can only be used with gcj 3.1
(which has not been released yet, but will be very soon). gcj 3.0.x
doesn't know about the -bootstrap flag. Please try a GCC 3.1 snapshot or
use jikes as compiler for now.

Brian, is there a way to check for the gcj version in the configure
script?

Cheers,

Mark


From mark@wildebeest.org Sun Apr 28 08:48:22 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171o6I-00025j-00; Sun, 28 Apr 2002 08:48:22 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 171o6D-0002RV-00; Sun, 28 Apr 2002 14:48:17 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 171o6H-00035X-00; Sun, 28 Apr 2002 14:48:21 +0200
Subject: Re: Compilation error - More Info
From: Mark Wielaard <mark@klomp.org>
To: Brian Jones <cbj@gnu.org>
Cc: Carlos Cavanna <cdcavanna@yahoo.com>, Classpath - GNU <classpath@gnu.org>
In-Reply-To: <m3wuuunilp.fsf@lyta.haphazard.org>
References: <20020426172332.75421.qmail@web10207.mail.yahoo.com> 
	<m3wuuunilp.fsf@lyta.haphazard.org>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 28 Apr 2002 14:48:21 +0200
Message-Id: <1019998101.7771.100.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

On Sat, 2002-04-27 at 01:30, Brian Jones wrote:
> 
> There were some recent checkins a day or two ago that added or merges
> quite a bit of Swing stuff.  It is possible something didn't get
> included with that commit.

The following classes seem to be missing:
- javax.swing.CellEditor
- javax.swing.JInternalFrame
- javax.swing.JTable
- javax.swing.MenuSelectionManager
- javax.swing.MenuElement

We need to create stubs for them or just disable javax.swing in the
lib/standard.omit file for now.

Cheers,

Mark


From jscheid@sektor37.de Sun Apr 28 11:59:55 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171r5e-0000rH-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 11:59:54 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id RAA05837
	for <classpath@gnu.org>; Sun, 28 Apr 2002 17:55:59 +0200
Message-ID: <3CCC0DA3.9000101@sektor37.de>
Date: Sun, 28 Apr 2002 16:56:35 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: classpath@gnu.org
Subject: Javadoc Comment Formatting
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Some thoughts on the proper formatting of Javadoc comments
in this post.

First, let me point you to the "Sun Doc Check Utilities"
which I just stumbled over. They appear to be brand new:

<http://java.sun.com/j2se/javadoc/doccheck/index.html>

Might be useful for validating Classpath documentation.
Taken from that page:

  > DocCheck is an extension to the Javadoc tool that reviews
  > Javadoc comments in the source code, identifying gaps and
  > irregularities. It produces an HTML report that separates
  > serious problems from trivial ones, and makes "suggestions"
  > in the form of templates that show you what is needed.

Also, Sun seem to have updated their Javadoc style guide at
<http://java.sun.com/j2se/javadoc/writingdoccomments/index.html>
A good read IMO.

Now to the main issue, the formatting of the actual Javadoc
comment contents in Classpath. JLS 18.2 states that

  > Text in a documentation comment may use HTML markers for
  > formatting [...]

While this doesn't require, it certainly suggests that
documentation text basically is HTML code.

Now the Classpath comments do sometimes contain stuff like

   /**
    * ... maintained by <foo@classpath.org>
    * ...
    */

and

   /**
    * ... for example,
    * <pre>
    *   if (a < b) { ... }
    * </pre>
    * ...
    */

That's no well-formed HTML of course, as the less-than signs
are normally interpreted as beginning-of-tag. I agree that

    *   if (a &lt; b) { ... }

isn't as readable as the original shown above (when looking
at the inline comments), but it's more correct in terms of
well-formedness. Gjdoc currently goes to some lengths to
recognize less-than signs that are not beginning-of-tag but
instead meant to stay as a literal character. But I think
in the long term, the proper solution is to adapt the comment
code and not the doclet driver.

  From my point of view, comment code would ideally be 100%
well-formed XHTML: all special characters expressed as XML
entities, all open tags closed, all tag attribute values in
quotes, all tags properly nested.
(For more information, see <http://www.w3.org/TR/xhtml1/#diffs>)

Thinking of the XML doclet described in my other mail, this
approach would ensure that we can generate any format from
the XML code via XSLT. If the HTML code in the comments is not
well-formed, XML doclet has to encapsulate it in CDATA
blocks, which renders the tags contained therein inaccessible
to the XSLT sheet.

For example, if a comment contained a bullet list (<ul>...</ul>),
a plain-text generating XSLT sheet would be able to correctly
transform that - but only if the comment code is a regular XML
node (which implies that it needs to be well-formed) and not
if the code is encapsulated as CDATA (which is necessary if
it isn't well-formed, as otherwise the whole XML file wouldn't
be well-formed).

Therefore I suggest that whoever cares about tidying up the
comments should also ensure that they adhere to the XHTML
standard - and everyone should ensure that all newly written
comments do. To this end, I could extend gjdoc so that it
is able to check comments for well-formedness and generate
warnings it they don't.

Perhaps I should also mention that Nic Ferrier has suggested
(and AFAIK actually started in his Paperclips project) to
use TexInfo formatting instead of HTML formatting in Javadoc
comments, arguing that TexInfo is the de-facto GNU
documentation standard and that TexInfo is better readable
than HTML when looking at the source code.

My opinion is, while TexInfo may be standard for GNU docs in
general, HTML is the standard for Javadoc comments. There are
plenty of tools (partly GPLed) already out there which operate
on Javadoc comments and expect them to be in HTML format
(including XML doclet.)

Also, TexInfo is a decent format but thinking of XSLT sheets,
X(HT)ML is more flexible as it allows generic transformations
to virtually any target format, while there is no
corresponding technology for transforming TexInfo code AFAIK.

For these reasons I don't share Nics point of view on this
issue. I think we (and any other GNU project) should stick
to using HTML in comments, preferrably well-formed XHTML.

--Julian




From jscheid@sektor37.de Sun Apr 28 12:02:05 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171r7k-00013G-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 12:02:04 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id RAA05898
	for <classpath@gnu.org>; Sun, 28 Apr 2002 17:58:09 +0200
Message-ID: <3CCC0E25.8020508@sektor37.de>
Date: Sun, 28 Apr 2002 16:58:45 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: classpath@gnu.org
Subject: Cp-tools Javadoc Overview (was Re: Classpath API javadoc)
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Mark Wielaard wrote:
 >
 > I have not tried out the texidoclet for the Classpath Tools project yet.
 > Source can be found <http://savannah.gnu.org/cgi-bin/viewcvs/cp-tools/>
 > I don't know if there has been an official release yet.
 >



Hi there,

let me take this opportunity and give you a brief overview of
our doings at cp-tools.

We have a couple of javadoc-related tools underway:

- "Gjdoc" is an alternative javadoc driver. That is, it scans
Java source files, extracts all javadoc related information
and provides that to whichever doclet is plugged into it
via the Doclet API.
When finished, it will provide basically the same output
as Sun's javadoc tool does, but currently there are some minor
deviations and also some stuff missing.

- "TexInfo doclet" (formerly TexiDoclet) takes that information
(from either Gjdoc or Sun's Javadoc) and generates TexInfo code
from it, which in turn can be converted to Info pages for viewing
in Emacs or with the Info standalone tool. The TexInfo code is
not intended for converting it into a printable form, though.

- "XML doclet" puts all information into an XML file. I have
written an XSLT style sheet which generates HTML documentation
from that XML file. The generated HTML has a structure similar
to that of Suns "Standard Doclet" output, but is currently
missing a couple of things (for example, a full class tree
page, serialization pages, package overview page)

All three tools still have some quirks, with TexInfo doclet
being the most complete and best tested. While not officially
released by now, it should be complete enough for experimental
usage. So please go ahead and give it a try.

In contrast, whoever works on the documentation should not
primarily rely on Gjdoc and the XML/XSLT solution at this
time, because  when problems occur it will be hard to tell
where they originate (Problems with the inline documentation?
Gjdoc doesn't provide all/provides wrong information? Bugs
in XML doclet? In the XSLT sheet?)

Anyway, it would be great if you'd give all these tools a try
and report any problems back to cp-tools. After all, the
Classpath source is the ideal test case for the tools. And we
are not that far away from a point where we can generate
nice-looking and complete docs in both TexInfo and HTML format.
The more feedback we get, the sooner we can reach this goal.

If there are any build issues with the tools (especially with
Gjdoc and the XML doclet, which are not yet autoconf'ing AFAIK)
I'll be glad to help - just post to <cp-tools-discuss@gnu.org>.

Philip, if you intend to work on the API docs you may want to
consider joining the cp-tools-discuss list.

--Julian




From jleuner@elandtech.com Sun Apr 28 12:20:55 2002
Received: from spamisevil.test.ie.vianw.net ([212.17.60.214] helo=lenny.elandtech.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171rPy-0002Bb-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 12:20:54 -0400
Received: from [192.168.100.211] (helo=bapli ident=mail)
	by lenny.elandtech.com with esmtp (Exim 3.34 #1 (Debian))
	id 171rHw-0003vu-00; Sun, 28 Apr 2002 16:12:36 +0000
Received: from jleuner by bapli with local (Exim 3.35 #1 (Debian))
	id 171rH1-0005Bc-00; Sun, 28 Apr 2002 17:11:39 +0100
Date: Sun, 28 Apr 2002 17:11:39 +0100
From: John Leuner <jewel@pixie.co.za>
To: Tom Tromey <tromey@redhat.com>
Cc: John Leuner <jewel@pixie.co.za>,
	Phillip Morelock <subscriptions@phillipmorelock.com>,
	classpath@gnu.org
Subject: Re: Classpath API javadoc
Message-ID: <20020428161139.GF381@bapli>
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com> <20020426201147.GA381@bapli> <874rhxkk3e.fsf@creche.redhat.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <874rhxkk3e.fsf@creche.redhat.com>
User-Agent: Mutt/1.3.27i
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> John> I think it's a waste of all the effort that has gone into
> John> commenting code, this resource should be made available and
> John> people should be encouraged to use it.
> 
> I agree.  Also it will make RMS happy -- he likes it when free
> documentation is available so that people don't have to rely on the
> proprietary stuff.

Definitely.
 
> About a month ago I ran javadoc on the libgcj tree.  There were tons
> of warnings.  Also the output isn't really that good.  For example,
> the first line of a description is used on the index pages; for our
> docs this line is typically not very informative, so the output is
> harder to use.
> 
> I think if we ran this regularly it might help us know what needs to
> be edited.  It seems to be harder to see these problems in the source
> than it is in the output.

This is my experience too. 

So what do we have to do to get a cron job set up somewhere to produce a daily javadoc run of the Classpath CVS code?

I really think this would be a worthwhile effort.

John Leuner


From jleuner@elandtech.com Sun Apr 28 12:26:27 2002
Received: from spamisevil.test.ie.vianw.net ([212.17.60.214] helo=lenny.elandtech.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171rVK-0002WD-00; Sun, 28 Apr 2002 12:26:26 -0400
Received: from [192.168.100.211] (helo=bapli ident=mail)
	by lenny.elandtech.com with esmtp (Exim 3.34 #1 (Debian))
	id 171rNz-0003wm-00; Sun, 28 Apr 2002 16:18:51 +0000
Received: from jleuner by bapli with local (Exim 3.35 #1 (Debian))
	id 171rN3-0005Cn-00; Sun, 28 Apr 2002 17:17:53 +0100
Date: Sun, 28 Apr 2002 17:17:53 +0100
From: John Leuner <jewel@pixie.co.za>
To: Julian Scheid <jscheid@sektor37.de>
Cc: classpath@gnu.org, cp-tools-discuss@gnu.org
Subject: Re: Cp-tools Javadoc Overview (was Re: Classpath API javadoc)
Message-ID: <20020428161753.GG381@bapli>
References: <3CCC0E25.8020508@sektor37.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3CCC0E25.8020508@sektor37.de>
User-Agent: Mutt/1.3.27i
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> Mark Wielaard wrote:
> >
> > I have not tried out the texidoclet for the Classpath Tools project yet.
> > Source can be found <http://savannah.gnu.org/cgi-bin/viewcvs/cp-tools/>
> > I don't know if there has been an official release yet.
> >

> Hi there,
> 
> let me take this opportunity and give you a brief overview of
> our doings at cp-tools.
> 
> We have a couple of javadoc-related tools underway:
> 
> - "Gjdoc" is an alternative javadoc driver. That is, it scans
> Java source files, extracts all javadoc related information
> and provides that to whichever doclet is plugged into it
> via the Doclet API.
> When finished, it will provide basically the same output
> as Sun's javadoc tool does, but currently there are some minor
> deviations and also some stuff missing.

How do we compile and run this driver?

What are its dependencies (versions too)?
 
> - "TexInfo doclet" (formerly TexiDoclet) takes that information
> (from either Gjdoc or Sun's Javadoc) and generates TexInfo code
> from it, which in turn can be converted to Info pages for viewing
> in Emacs or with the Info standalone tool. The TexInfo code is
> not intended for converting it into a printable form, though.
> 
> - "XML doclet" puts all information into an XML file. I have
> written an XSLT style sheet which generates HTML documentation
> from that XML file. The generated HTML has a structure similar
> to that of Suns "Standard Doclet" output, but is currently
> missing a couple of things (for example, a full class tree
> page, serialization pages, package overview page)

Cool!

John Leuner


From nferrier@tapsellferrier.co.uk Sun Apr 28 12:34:26 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171rd3-0004Xi-00; Sun, 28 Apr 2002 12:34:25 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 171s4J-0002bR-00; Sun, 28 Apr 2002 18:02:35 +0100
To: Julian Scheid <julian.scheid@sektor37.de>
Cc: classpath@gnu.org,  cp-tools-discuss@gnu.org
Subject: Re: Javadoc Comment Formatting
References: <3CCC0A90.8000504@sektor37.de>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 28 Apr 2002 17:56:26 +0100
In-Reply-To: <3CCC0A90.8000504@sektor37.de>
Message-ID: <87adrn4v9h.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 116
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I'm not sure this should be discussed here but...


Julian Scheid <julian.scheid@sektor37.de> writes:
> Now the Classpath comments do sometimes contain stuff like 
>  
>   /** 
>    * ... maintained by <foo@classpath.org> 
>    * ... 
>    */ 
>  
> and 
>  
>   /** 
>    * ... for example, 
>    * <pre> 
>    *   if (a < b) { ... } 
>    * </pre> 
>    * ... 
>    */ 
>  
> That's no well-formed HTML of course, as the less-than signs 
> are normally interpreted as beginning-of-tag. I agree that 
>  
>    *   if (a &lt; b) { ... } 
>  
> isn't as readable as the original shown above (when looking 
> at the inline comments), but it's more correct in terms of 
> well-formedness. Gjdoc currently goes to some lengths to 
> recognize less-than signs that are not beginning-of-tag but 
> instead meant to stay as a literal character. But I think 
> in the long term, the proper solution is to adapt the comment 
> code and not the doclet driver. 

Personally I think that's the wrong way round. Javadoc is really
useful as an inline doc system as well as for producing a bunch of
nicely formatted doc pages.

Can't you intelligently escape such things? for example if they don't
turn out to be valid xml. Given the GNU coding standard you very
rarely see thing like this:

   * <pre>
   *   if (a<b)

which might be more difficult to spot as invalid than when there's a
space between the alphas and the operator.


  
>  From my point of view, comment code would ideally be 100% 
> well-formed XHTML: all special characters expressed as XML 
> entities, all open tags closed, all tag attribute values in 
> quotes, all tags properly nested. 
> (For more information, see <http://www.w3.org/TR/xhtml1/#diffs>) 

But from the point of view of someone wanting to hack code quickly
the comments should be readable. Well-formed XHTML is not necessarily
readable.

  
> Perhaps I should also mention that Nic Ferrier has suggested 
> (and AFAIK actually started in his Paperclips project) to 
> use TexInfo formatting instead of HTML formatting in Javadoc 
> comments, arguing that TexInfo is the de-facto GNU 
> documentation standard and that TexInfo is better readable 
> than HTML when looking at the source code. 
>  
> My opinion is, while TexInfo may be standard for GNU docs in 
> general, HTML is the standard for Javadoc comments. There are 
> plenty of tools (partly GPLed) already out there which operate 
> on Javadoc comments and expect them to be in HTML format 
> (including XML doclet.) 
>  
> Also, TexInfo is a decent format but thinking of XSLT sheets, 
> X(HT)ML is more flexible as it allows generic transformations 
> to virtually any target format, while there is no 
> corresponding technology for transforming TexInfo code AFAIK. 

Except info->SOMETHING drivers are quite easy to write and GNU has
lots of experience at them.


I do agree that XML is the way forward (docbook might make a good
replacement for texinfo when it has widespread support like texinfo)
but the issue of in-source readable comments will need to be solved
before it is a really practical option.

  
> For these reasons I don't share Nics point of view on this 
> issue. I think we (and any other GNU project) should stick 
> to using HTML in comments, preferrably well-formed XHTML. 

I just don't believe it's reasonable, it's hard enough to get people
to write code to the coding standard, let alone the doc comments.

The problem is that XHTML throws such spanners in the works, the
example you cited before is a really good one, so it this:

   /**
     * This is a method that writes some stuff.
     * The outputstream gets something like this:
     * <pre>
     *   this is the concat of a & b
     * </pre>
     

which of course won't work. Using the less than sign, the greater
than sign and other HTML reserved words is quite common in javadoc
comments and having to remember the HTML is a great big pain in the
neck.

The equivalent in texinfo, of course, does not cause such problems.


Nic



From jscheid@sektor37.de Sun Apr 28 13:11:20 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171sCl-0006wP-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 13:11:19 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id TAA07778;
	Sun, 28 Apr 2002 19:06:46 +0200
Message-ID: <3CCC1E3B.7050405@sektor37.de>
Date: Sun, 28 Apr 2002 18:07:23 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Nic Ferrier <nferrier@tapsellferrier.co.uk>
CC: classpath@gnu.org
Subject: Re: Javadoc Comment Formatting
References: <3CCC0A90.8000504@sektor37.de> <87adrn4v9h.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Nic Ferrier wrote:
 > I do agree that XML is the way forward (docbook might make a good
 > replacement for texinfo when it has widespread support like texinfo)
 > but the issue of in-source readable comments will need to be solved
 > before it is a really practical option.

It seems to boil down to inline readability and easy
comment maintenance on one hand, and full XHTML compliance
for enabling arbitrary XSLT conversions on the other.

I agree that strictly applying the XHTML standard will
degrade readability and add an additional burden for
documentation writers/maintainers, but for that you
gain 100% XML compliance with all eventual benefits.

I'll leave that for discussion. My opinion is: make
comments XHTML compliant and ease the task for
writers/maintainers by supplying appropriate (XHTML
checking, and perhaps fixing) tools. Live with degraded
readability, or better: view the documentation generated
by Texinfo doclet instead of consulting inline comments.

(Most of the time, you will be looking up docs for a
method different from that you are currently working on,
so in terms of keystrokes it isn't a big difference
whether you open another file and browse to the method
definition, or you open the info docs for that method
- provided you are using something like jtxd.el for
quick access to generated documentation.)

> Can't you intelligently escape such things? for example if they don't
> turn out to be valid xml.

As I said, XML doclet already does something like this.
It even tries to guess where unclosed tags are ending
and inserts appropriate closing tags, to some extent.
But this is more of a hack and quiet error prone
- after all, it involves a lot of guessing if you have
input whose format is not defined umambigiously.

Julian



From cbj@gnu.org Sun Apr 28 13:19:35 2002
Received: from mail7.southeast.rr.com ([24.93.67.54] helo=mail7.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171sKl-0007HK-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 13:19:35 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail7.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 13:19:30 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3SHIPC11271;
	Sun, 28 Apr 2002 13:18:25 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Mark Wielaard <mark@klomp.org>
Cc: Carlos Cavanna <cdcavanna@yahoo.com>, Classpath - GNU <classpath@gnu.org>
Subject: Re: Compilation error
References: <GBEELMOFAJBBEFHHJEJFIECNDCAA.cdcavanna@yahoo.com>
	<1019997823.7772.94.camel@elsschot>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 13:18:24 -0400
In-Reply-To: <1019997823.7772.94.camel@elsschot>
Message-ID: <m3elgzoi73.fsf@lyta.haphazard.org>
Lines: 44
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Mark Wielaard <mark@klomp.org> writes:

> Hi,
> 
> On Thu, 2002-04-25 at 19:47, Carlos Cavanna wrote:
> > . ./configure --prefix=... --with-gcj --enable-jni
> > 
> > Then, when I run "make" I get:
> > 
> > Making all in lib
> > make[1]: Entering directory
> > `/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
> > top_builddir=.. /bin/sh ./gen-classlist.sh standard
> > /scr1/cavanna/bin/gcc-3.0.2/bin/gcj -bootclasspath '' -classpath
> > ..:../vm/current:.: -C -d . @classes
> > gcj: cannot specify -o with -c or -S and multiple compilations
> > make[1]: *** [compile-classes] Error 1
> > make[1]: Leaving directory
> > `/scr1/cavanna/Thesis/classpath/classpath.cvs/classpath/lib'
> > make: *** [all-recursive] Error 1
> > 
> > I am using gcj 3.0.2
> > 
> > I did compile previous versions of classpath before, and I am using the same
> > commands
> > I always use.
> > 
> > Does anyone know about this error ?
> 
> Yes, sorry about that. The CVS version can only be used with gcj 3.1
> (which has not been released yet, but will be very soon). gcj 3.0.x
> doesn't know about the -bootstrap flag. Please try a GCC 3.1 snapshot or
> use jikes as compiler for now.
> 
> Brian, is there a way to check for the gcj version in the configure
> script?

Sure, I've added it as a warning just now which also removes it from
the list of available choices later in configure so if jikes or kjc is
found things continue.

Brian
-- 
Brian Jones <cbj@gnu.org>


From cbj@gnu.org Sun Apr 28 13:25:45 2002
Received: from mail7.southeast.rr.com ([24.93.67.54] helo=mail7.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171sQi-0007f0-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 13:25:44 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail7.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 13:25:40 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3SHOYi21648;
	Sun, 28 Apr 2002 13:24:34 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Mark Wielaard <mark@klomp.org>
Cc: Carlos Cavanna <cdcavanna@yahoo.com>, Classpath - GNU <classpath@gnu.org>
Subject: Re: Compilation error - More Info
References: <20020426172332.75421.qmail@web10207.mail.yahoo.com>
	<m3wuuunilp.fsf@lyta.haphazard.org>
	<1019998101.7771.100.camel@elsschot>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 13:24:34 -0400
In-Reply-To: <1019998101.7771.100.camel@elsschot>
Message-ID: <m3adrnohwt.fsf@lyta.haphazard.org>
Lines: 26
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Mark Wielaard <mark@klomp.org> writes:

> Hi,
> 
> On Sat, 2002-04-27 at 01:30, Brian Jones wrote:
> > 
> > There were some recent checkins a day or two ago that added or merges
> > quite a bit of Swing stuff.  It is possible something didn't get
> > included with that commit.
> 
> The following classes seem to be missing:
> - javax.swing.CellEditor
> - javax.swing.JInternalFrame
> - javax.swing.JTable
> - javax.swing.MenuSelectionManager
> - javax.swing.MenuElement
> 
> We need to create stubs for them or just disable javax.swing in the
> lib/standard.omit file for now.

I disabled javax.swing in standard.omit.  Having trouble compiling the
java_nio.c recently added as well.

Brian
-- 
Brian Jones <cbj@gnu.org>


From nferrier@tapsellferrier.co.uk Sun Apr 28 13:26:54 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171sRq-0007jh-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 13:26:54 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 171st6-0002cf-00; Sun, 28 Apr 2002 18:55:04 +0100
To: Julian Scheid <jscheid@sektor37.de>
Cc: classpath@gnu.org
Subject: Re: Javadoc Comment Formatting
References: <3CCC0A90.8000504@sektor37.de>
	<87adrn4v9h.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
	<3CCC1E3B.7050405@sektor37.de>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 28 Apr 2002 18:48:55 +0100
In-Reply-To: <3CCC1E3B.7050405@sektor37.de>
Message-ID: <877kmr4su0.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 37
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Julian Scheid <jscheid@sektor37.de> writes:

> I'll leave that for discussion. My opinion is: make 
> comments XHTML compliant and ease the task for 
> writers/maintainers by supplying appropriate (XHTML 
> checking, and perhaps fixing) tools. Live with degraded 
> readability, or better: view the documentation generated 
> by Texinfo doclet instead of consulting inline comments. 
>  
> (Most of the time, you will be looking up docs for a 
> method different from that you are currently working on, 
> so in terms of keystrokes it isn't a big difference 
> whether you open another file and browse to the method 
> definition, or you open the info docs for that method 
> - provided you are using something like jtxd.el for 
> quick access to generated documentation.) 

It depends on what you're doing. If you're the maintainer of some
source code then you're right, whilst you're hacking it you are
probably looking up methods in other places (having said that all the
useful browser tools we have so far deal with source code files, not
a documentation tree).

But that isn't the only audience for source code, it's not even the
main audience (for most GNU code).

Most GNU code has a very long life and is hacked on by many people. I
hate picking up java code where there is XHTML javadoc because it's
so hard to read.


But none of that is really important. The bottom line is: you will
never get all the authors of source code to write well-formed XHTML,
you're always going to miss something. That's why it sucks.


Nic



From cbj@gnu.org Sun Apr 28 13:37:12 2002
Received: from fe5.southeast.rr.com ([24.93.67.52] helo=mail5.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171sbo-0001jv-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 13:37:12 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail5.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 13:37:06 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3SHa1826382;
	Sun, 28 Apr 2002 13:36:01 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: tromey@redhat.com
Cc: Classpath Project <classpath@gnu.org>
Subject: Re: Runtime reference implementation buglet
References: <87bsc4kd63.fsf@creche.redhat.com>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 13:36:01 -0400
In-Reply-To: <87bsc4kd63.fsf@creche.redhat.com>
Message-ID: <m3662bohdq.fsf@lyta.haphazard.org>
Lines: 21
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Tom Tromey <tromey@redhat.com> writes:

> In the Runtime reference implementation I see this code:
> 
>     if (nativeLoad(filename) == 0)
>       throw new UnsatisfiedLinkError("Could not load library " + filename);
> 
> Later there is this:
> 
>    * @return 0 on success, nonzero on failure
>    */
>   native int nativeLoad(String filename);
> 
> One or the other is wrong.  I don't know which.  Could whoever works
> on this class please fix this?  Thanks.

I changed the doc comment since changing the code would break VMs.

Brian
-- 
Brian Jones <cbj@gnu.org>


From cbj@gnu.org Sun Apr 28 13:40:11 2002
Received: from fe4.southeast.rr.com ([24.93.67.51] helo=mail4.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171seh-0001uR-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 13:40:11 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail4.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 13:39:56 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3SHcjr26390;
	Sun, 28 Apr 2002 13:38:45 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: John Leuner <jewel@pixie.co.za>
Cc: Tom Tromey <tromey@redhat.com>,
   Phillip Morelock <subscriptions@phillipmorelock.com>, classpath@gnu.org
Subject: Re: Classpath API javadoc
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
	<20020426201147.GA381@bapli> <874rhxkk3e.fsf@creche.redhat.com>
	<20020428161139.GF381@bapli>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 13:38:45 -0400
In-Reply-To: <20020428161139.GF381@bapli>
Message-ID: <m31yczoh96.fsf@lyta.haphazard.org>
Lines: 14
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

John Leuner <jewel@pixie.co.za> writes:

> So what do we have to do to get a cron job set up somewhere to
> produce a daily javadoc run of the Classpath CVS code?

Javadoc is a non-free tool, so installing and running it
systematically on a FSF server is not possible.  Using one of the free
alternatives that exist or waiting for a working gjdoc is necessary.
Paul Fisher should be contacted about setting something up with those
since he's the FSF's sysadmin.

Brian
-- 
Brian Jones <cbj@gnu.org>


From ebb9@email.byu.edu Sun Apr 28 13:44:24 2002
Received: from rwcrmhc54.attbi.com ([216.148.227.87])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 171sil-000263-00; Sun, 28 Apr 2002 13:44:23 -0400
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc54.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020428174422.PECN20384.rwcrmhc54.attbi.com@email.byu.edu>;
          Sun, 28 Apr 2002 17:44:22 +0000
Message-ID: <3CCC34F3.F9574AF7@email.byu.edu>
Date: Sun, 28 Apr 2002 11:44:19 -0600
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: Brian Jones <cbj@gnu.org>
CC: tromey@redhat.com, Classpath Project <classpath@gnu.org>
Subject: Re: Runtime reference implementation buglet
References: <87bsc4kd63.fsf@creche.redhat.com> <m3662bohdq.fsf@lyta.haphazard.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Which way do VM's do it?  It might be easier to do "if
(nativeLoad(filename) != 0)", so that the native code can just use the
return code from system calls.

Brian Jones wrote:
> 
> Tom Tromey <tromey@redhat.com> writes:
> 
> > In the Runtime reference implementation I see this code:
> >
> >     if (nativeLoad(filename) == 0)
> >       throw new UnsatisfiedLinkError("Could not load library " + filename);
> >
> > Later there is this:
> >
> >    * @return 0 on success, nonzero on failure
> >    */
> >   native int nativeLoad(String filename);
> >
> > One or the other is wrong.  I don't know which.  Could whoever works
> > on this class please fix this?  Thanks.
> 
> I changed the doc comment since changing the code would break VMs.
> 
> Brian

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From jscheid@sektor37.de Sun Apr 28 14:00:47 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171syd-0002zs-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 14:00:47 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id TAA09111;
	Sun, 28 Apr 2002 19:56:37 +0200
Message-ID: <3CCC29EA.9090607@sektor37.de>
Date: Sun, 28 Apr 2002 18:57:14 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: John Leuner <jewel@pixie.co.za>
CC: classpath@gnu.org
Subject: Re: Cp-tools Javadoc Overview (was Re: Classpath API javadoc)
References: <3CCC0E25.8020508@sektor37.de> <20020428161753.GG381@bapli>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

John Leuner wrote:
> >- "Gjdoc" is an alternative javadoc driver. [...]
> 
> How do we compile and run this driver?

It's a bunch of Java classes, jikes path/*.java should
do for now. I think the package also includes a dirty
development Makefile.

It's fairly command line compatible to Sun Javadoc,
so you just do a

   favorite-vm gnu.tools.gjdoc.Main <options> <targets>

Or, with a small shell script prepared, you do

   gjdoc <options> <targets>

instead of

   javadoc <options> <targets>

Nice eh? But don't expect too much. It works, it's
pretty fast, and I already used it to squeeze the docs
out of Classpaths java.lang package ... but there are a
number of known and, as it hasn't been tested on
a large scale, probably millions of unknown bugs :(

> What are its dependencies (versions too)?

Let me answer that in detail after I re-dived back into
the thing. It has been lying around for a couple of weeks
now.

 From the top of my head:

This is a quiet simple, command-line driven 1.2 application,
no rocket science here. Needs java.lang, java.io and
java.util (all 1.2) and not much else. I've not compiled it
with Classpath lately, but there shouldn't be many obstacles.

Originally I wanted to build a parser using some LALR
generator, but it turned out to be way too slow. Then I tried
Regexps, but that was slow either. The current solution is
kind of a naive hand-written parser which assumes that the
source code already has been checked for syntactical
correctness, for example with javac/jikes. This solution
doesn't have any dependencies on third-party products,
it mainly operates on char[] arrays for performance reasons
and barely needs String, StringBuffer and StringTokenizer
working.

HTH

--Julian



From cbj@gnu.org Sun Apr 28 14:17:07 2002
Received: from fe6.southeast.rr.com ([24.93.67.53] helo=mail6.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171tER-0003lq-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 14:17:07 -0400
Received: from lyta.haphazard.org ([66.26.245.105]) by mail6.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 14:16:47 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3SIFf626557;
	Sun, 28 Apr 2002 14:15:41 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Eric Blake <ebb9@email.byu.edu>
Cc: tromey@redhat.com, Classpath Project <classpath@gnu.org>
Subject: Re: Runtime reference implementation buglet
References: <87bsc4kd63.fsf@creche.redhat.com>
	<m3662bohdq.fsf@lyta.haphazard.org> <3CCC34F3.F9574AF7@email.byu.edu>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 14:15:41 -0400
In-Reply-To: <3CCC34F3.F9574AF7@email.byu.edu>
Message-ID: <m3r8kzn0z6.fsf@lyta.haphazard.org>
Lines: 12
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Eric Blake <ebb9@email.byu.edu> writes:

> Which way do VM's do it?  It might be easier to do "if
> (nativeLoad(filename) != 0)", so that the native code can just use the
> return code from system calls.

Changing the code would not match the VMs.  Yes, it would be
conceptually better if the code had followed the doc comments.

Brian
-- 
Brian Jones <cbj@gnu.org>


From subscriptions@phillipmorelock.com Sun Apr 28 15:03:24 2002
Received: from host20.cedant.com ([209.239.38.116])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171txE-00081N-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 15:03:24 -0400
Received: from c-24-126-77-31.we.client2.attbi.com (localhost [127.0.0.1])
	by host20.cedant.com (8.10.2/8.10.2) with ESMTP id g3SJ3AV28699
	for <classpath@gnu.org>; Sun, 28 Apr 2002 15:03:10 -0400
To: classpath@gnu.org
From: Phillip Morelock <subscriptions@phillipmorelock.com>
Subject: Re: Classpath API javadoc
Reply-To: subscriptions@phillipmorelock.com
Date: Sun, 28 Apr 2002 12:02:42 -0700
X-Sender: subscriptions@phillipmorelock.com
X-Originating-Host: c-24-126-77-31.we.client2.attbi.com [24.126.77.31]; Sun, 28 Apr 2002 19:03:10 GMT
X-Mailer: WebMail Check v2.3.21 (2000-7-19)
X-Browser: Mozilla/4.0 (compatible; MSIE 5.14; Mac_PowerPC), JavaScript: On
Message-ID: <jUsT.aNoTheR.mEsSaGe.iD.102002059028696@phillipmorelock.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

of course not!!!  :)


At 27 April 2002, you wrote:

>Do you mind assigning copyright to the FSF for your documentation
>changes to Classpath?
>
>Brian
>
>Phillip Morelock <subscriptions@phillipmorelock.com> writes:
>
>> Hi
>> 
>> I know I'm still new to this community, but since I'm going to 
focus my
>> efforts on documentation because I have been ruled "unclean" ;) ...
>> 
>> Resultant newbie question:  is it still "ok" to use sun's javadoc 
tool or is
>> there an appropriate free tool?  How do "they" (or you) generally 
feel about
>> using non-free tools in this context?  also, what is the state 
of such tool?
>> 
>> Forgive me, I'm still pretty new to the whole "GNU" mindset and 
don't want
>> to step on toes or whatever.
>> 
>> cheers
>> Phillip
>> 
>> 
>> On 4/27/02 12:38 PM, "Tom Tromey" <tromey@redhat.com> wrote:
>> 
>> >>>>>> "John" == John Leuner <jewel@pixie.co.za> writes:
>> > 
>> > John> I think it's a waste of all the effort that has gone into
>> > John> commenting code, this resource should be made available and
>> > John> people should be encouraged to use it.
>> > 
>> > I agree.  Also it will make RMS happy -- he likes it when free
>> > documentation is available so that people don't have to rely on the
>> > proprietary stuff.
>> > 
>> > About a month ago I ran javadoc on the libgcj tree.  There were 
tons
>> > of warnings.  Also the output isn't really that good.  For example,
>> > the first line of a description is used on the index pages; for our
>> > docs this line is typically not very informative, so the output is
>> > harder to use.
>> > 
>> > I think if we ran this regularly it might help us know what 
needs to
>> > be edited.  It seems to be harder to see these problems in the 
source
>> > than it is in the output.
>> > 
>> > Tom
>> > 
>> 
>> 
>> _______________________________________________
>> Classpath mailing list
>> Classpath@gnu.org
>> http://mail.gnu.org/mailman/listinfo/classpath
>> 
>
>-- 
>Brian Jones <cbj@gnu.org>
>









From jscheid@sektor37.de Sun Apr 28 17:41:14 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171wPw-0004ZV-00; Sun, 28 Apr 2002 17:41:13 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id XAA15091;
	Sun, 28 Apr 2002 23:37:14 +0200
Message-ID: <3CCC5DA2.80406@sektor37.de>
Date: Sun, 28 Apr 2002 22:37:54 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Brian Jones <cbj@gnu.org>
CC: John Leuner <jewel@pixie.co.za>, Tom Tromey <tromey@redhat.com>,
        Phillip
 Morelock <subscriptions@phillipmorelock.com>,
        classpath@gnu.org
Subject: Re: Classpath API javadoc
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>	<20020426201147.GA381@bapli> <874rhxkk3e.fsf@creche.redhat.com>	<20020428161139.GF381@bapli> <m31yczoh96.fsf@lyta.haphazard.org>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Brian Jones wrote:
> Javadoc is a non-free tool, so installing and running it
> systematically on a FSF server is not possible.  Using one of the free
> alternatives that exist or waiting for a working gjdoc is necessary.

Why not setup something like this using an early, perhaps incomplete
version of gjdoc, TexInfo doclet and/or XML doclet and then iron out
bugs and add missing functionality over time? One could wait with
linking the docs into the main Classpath web pages, or add a warning
message next to the link until the documentation quality is sufficient.
That's release early - when more eyes look at the output, bugs or
inadequacies will be spotted more quickly.

What I'm going to do next is see that I can run gjdoc on the full
Classpath source code with TexInfo doclet and/or the XML doclet
together with the XSLT sheet - this goal is not far away. I'll then
upload the output somewhere and post a link here so that you can judge
the tools current state. After that, if the quality is sufficient for a
primal online documentation site, we could move on and create the
cron job.

All that may take a couple of days, as I'm quiet occupied at the time,
but I'll see that I get to this soon.

--Julian



From nferrier@tapsellferrier.co.uk Sun Apr 28 17:53:56 2002
Received: from host217-34-135-17.in-addr.btopenworld.com ([217.34.135.17] helo=tf1.tapsellferrier.co.uk)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171wcE-0005Ox-00; Sun, 28 Apr 2002 17:53:55 -0400
Received: from host217-34-135-21.in-addr.btopenworld.com ([217.34.135.21] helo=pooh-sticks-bridge.tapsellferrier.co.uk)
	by tf1.tapsellferrier.co.uk with esmtp (Exim 3.35 #1 (Debian))
	id 171x3V-0005zm-00; Sun, 28 Apr 2002 23:22:05 +0100
To: Julian Scheid <jscheid@sektor37.de>
Cc: Brian Jones <cbj@gnu.org>,  John Leuner <jewel@pixie.co.za>,
	  Tom Tromey <tromey@redhat.com>,
	  Phillip Morelock <subscriptions@phillipmorelock.com>,
	  classpath@gnu.org
Subject: Re: Classpath API javadoc
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>
	<20020426201147.GA381@bapli> <874rhxkk3e.fsf@creche.redhat.com>
	<20020428161139.GF381@bapli> <m31yczoh96.fsf@lyta.haphazard.org>
	<3CCC5DA2.80406@sektor37.de>
From: Nic Ferrier <nferrier@tapsellferrier.co.uk>
Date: 28 Apr 2002 23:15:54 +0100
In-Reply-To: <3CCC5DA2.80406@sektor37.de>
Message-ID: <87vgab31wl.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Lines: 50
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Julian Scheid <jscheid@sektor37.de> writes:

>  
> Brian Jones wrote: 
> > Javadoc is a non-free tool, so installing and running it 
> > systematically on a FSF server is not possible.  Using one of the free 
> > alternatives that exist or waiting for a working gjdoc is necessary. 
>  
> Why not setup something like this using an early, perhaps incomplete 
> version of gjdoc, TexInfo doclet and/or XML doclet and then iron out 
> bugs and add missing functionality over time? One could wait with 
> linking the docs into the main Classpath web pages, or add a warning 
> message next to the link until the documentation quality is sufficient. 
> That's release early - when more eyes look at the output, bugs or 
> inadequacies will be spotted more quickly. 

You don't need a GNU machine to do that.

I will happily give you (or anyone else who will take on this task) an
account on one of my machines (available over ADSL) where you can work
on a daily update of the classpath source tree and where you can check
out the gjdoc stuff.


We want a GNU machine to be doing it in the end because we'll want to
make the doc available across the web - it would be dumb to copy it
up every day from a remote server.

But when you've got things working then we can ask Paul to set it up
on a machine somewhere.


> What I'm going to do next is see that I can run gjdoc on the full 
> Classpath source code with TexInfo doclet and/or the XML doclet 
> together with the XSLT sheet - this goal is not far away. I'll then 
> upload the output somewhere and post a link here so that you can judge 
> the tools current state. After that, if the quality is sufficient for a 
> primal online documentation site, we could move on and create the 
> cron job. 
>  
> All that may take a couple of days, as I'm quiet occupied at the time, 
> but I'll see that I get to this soon. 

Cool. Let me know if you want an account at the ashdown forest.

I am also looking at your gjdoc build file to see what I can do about
automakejar-ing it.


Nic



From etienne.gagnon@uqam.ca Sun Apr 28 18:07:18 2002
Received: from anis.telecom.uqam.ca ([132.208.250.6] helo=uqam.ca)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171wpC-00067R-00; Sun, 28 Apr 2002 18:07:18 -0400
Received: from anis.telecom.uqam.ca (anis.telecom.uqam.ca [132.208.250.6])
	by sortant.uqam.ca (8.11.6/8.11.0) with SMTP id g3SLw2u03503;
	Sun, 28 Apr 2002 17:58:03 -0400 (EDT)
Received: from antivirus.uqam.ca ([127.0.0.1])
 by anis.telecom.uqam.ca (NAVGW 2.5.1.12) with SMTP id M2002042817580221316
 ; Sun, 28 Apr 2002 17:58:02 -0400
Received: from er.uqam.ca (nobel.si.uqam.ca [132.208.219.1])
	by intrant.uqam.ca (8.11.6/8.11.0) with ESMTP id g3SLv5527726;
	Sun, 28 Apr 2002 17:57:05 -0400 (EDT)
Received: from localhost (perseval.info.uqam.ca [132.208.137.96])
	by er.uqam.ca (8.10.0/8.10.0) with ESMTP id g3SLuqa15752;
	Sun, 28 Apr 2002 17:56:53 -0400 (EDT)
Received: from egagnon by localhost with local (Exim 3.35 #1 (Debian))
	id 171wf5-0001qA-00; Sun, 28 Apr 2002 17:56:51 -0400
Date: Sun, 28 Apr 2002 17:56:50 -0400
To: Brian Jones <cbj@gnu.org>
Cc: classpath@gnu.org
Subject: Re: Compilation error - More Info
Message-ID: <20020428215650.GB6929@perseval.info.uqam.ca>
References: <20020426172332.75421.qmail@web10207.mail.yahoo.com> <m3wuuunilp.fsf@lyta.haphazard.org> <1019998101.7771.100.camel@elsschot> <m3adrnohwt.fsf@lyta.haphazard.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <m3adrnohwt.fsf@lyta.haphazard.org>
User-Agent: Mutt/1.3.28i
From: "Etienne M. Gagnon" <etienne.gagnon@uqam.ca>
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

On Sun, Apr 28, 2002 at 01:24:34PM -0400, Brian Jones wrote:
> I disabled javax.swing in standard.omit.  Having trouble compiling the
> java_nio.c recently added as well.

I was planning to submit a bug report about it... java_nio.c contains
invalid C code. (C, unlike C++, does not support declarations between
statements). Maybe the author of java_nio.c was using a C++ compiler?

Personal comment: I do not want to start a discussion thread about
this, but I think we should keep the JNI native part in plain C (as it
already is). Of course, C++ would be encouraged for the CNI stuff. :)

Etienne

-- 
Etienne M. Gagnon                    http://www.info.uqam.ca/~egagnon/
SableVM:                                       http://www.sablevm.org/
SableCC:                                       http://www.sablecc.org/


From jscheid@sektor37.de Sun Apr 28 18:26:41 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171x7x-00078a-00; Sun, 28 Apr 2002 18:26:41 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id AAA16517;
	Mon, 29 Apr 2002 00:21:44 +0200
Message-ID: <3CCC6810.4080202@sektor37.de>
Date: Sun, 28 Apr 2002 23:22:24 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Nic Ferrier <nferrier@tapsellferrier.co.uk>
CC: Julian Scheid <jscheid@sektor37.de>, Brian Jones <cbj@gnu.org>,
        John Leuner
 <jewel@pixie.co.za>, Tom Tromey <tromey@redhat.com>,
        Phillip Morelock
 <subscriptions@phillipmorelock.com>,
        classpath@gnu.org
Subject: Re: Classpath API javadoc
References: <jUsT.aNoTheR.mEsSaGe.iD.1019759679833@phillipmorelock.com>	<20020426201147.GA381@bapli> <874rhxkk3e.fsf@creche.redhat.com>	<20020428161139.GF381@bapli> <m31yczoh96.fsf@lyta.haphazard.org>	<3CCC5DA2.80406@sektor37.de> <87vgab31wl.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Nic Ferrier wrote:
> You don't need a GNU machine to do that.
> 
> I will happily give you (or anyone else who will take on this task) an
> account on one of my machines (available over ADSL) where you can work
> on a daily update of the classpath source tree and where you can check
> out the gjdoc stuff.

I don't care which server, as long as I needn't pay for the GB ;)
Also I don't mind setting up the cron job, that's no big deal anyway.
So... fine, let's do it like this.

> Let me know if you want an account at the ashdown forest.

Sounds good, yes thanks. I got some webspace but I've to pay per volume.

> I am also looking at your gjdoc build file to see what I can do about
> automakejar-ing it.

Great.. that shouldn't be a big deal, it's just a couple of java files.

(Guess we should continue this on the cp-tools list.)

--Julian



From subscriptions@phillipmorelock.com Sun Apr 28 18:30:33 2002
Received: from adsl-216-103-55-217.dsl.lsan03.pacbell.net ([216.103.55.217] helo=hacksciences.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171xBg-0007Qm-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 18:30:33 -0400
Received: from [192.168.1.20] ([192.168.1.20])
	by hacksciences.com (8.11.6/8.11.6) with ESMTP id g3SMOtn14503
	for <classpath@gnu.org>; Sun, 28 Apr 2002 15:24:56 -0700
User-Agent: Microsoft-Entourage/10.0.0.1309
Date: Sun, 28 Apr 2002 15:30:29 -0700
Subject: cp-tools
From: Phillip Morelock <subscriptions@phillipmorelock.com>
To: <classpath@gnu.org>
Message-ID: <B8F1C615.174F%subscriptions@phillipmorelock.com>
In-Reply-To: <3CCC6810.4080202@sektor37.de>
Mime-version: 1.0
Content-type: text/plain; charset="US-ASCII"
Content-transfer-encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

hi,

i'm still kind of new....what is the "cp-tools" list and those of you who've
been reading my messages over the past week can maybe answer: should I join
that list too?

cheers
fillup


On 4/28/02 2:22 PM, "Julian Scheid" <jscheid@sektor37.de> wrote:

> Nic Ferrier wrote:
>> You don't need a GNU machine to do that.
>> 
>> I will happily give you (or anyone else who will take on this task) an
>> account on one of my machines (available over ADSL) where you can work
>> on a daily update of the classpath source tree and where you can check
>> out the gjdoc stuff.
> 
> I don't care which server, as long as I needn't pay for the GB ;)
> Also I don't mind setting up the cron job, that's no big deal anyway.
> So... fine, let's do it like this.
> 
>> Let me know if you want an account at the ashdown forest.
> 
> Sounds good, yes thanks. I got some webspace but I've to pay per volume.
> 
>> I am also looking at your gjdoc build file to see what I can do about
>> automakejar-ing it.
> 
> Great.. that shouldn't be a big deal, it's just a couple of java files.
> 
> (Guess we should continue this on the cp-tools list.)
> 
> --Julian
> 



From jscheid@sektor37.de Sun Apr 28 19:09:14 2002
Received: from p508139f4.dip.t-dialin.net ([80.129.57.244] helo=gate.local.zo)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171xn8-0002Pe-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 19:09:14 -0400
Received: from sektor37.de (block.local.zo [10.0.0.7])
	by gate.local.zo (8.9.3/8.9.3/SuSE Linux 8.9.3-0.1) with ESMTP id BAA17680;
	Mon, 29 Apr 2002 01:04:21 +0200
Message-ID: <3CCC720D.7050709@sektor37.de>
Date: Mon, 29 Apr 2002 00:05:01 +0200
From: Julian Scheid <jscheid@sektor37.de>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Nic Ferrier <nferrier@tapsellferrier.co.uk>
CC: Julian Scheid <jscheid@sektor37.de>, classpath@gnu.org
Subject: Re: Javadoc Comment Formatting
References: <3CCC0A90.8000504@sektor37.de>	<87adrn4v9h.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>	<3CCC1E3B.7050405@sektor37.de> <877kmr4su0.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Nic Ferrier wrote:
> But none of that is really important. The bottom line is: you will
> never get all the authors of source code to write well-formed XHTML,
> you're always going to miss something. That's why it sucks.

OK if this is the problem, let me put it that way:

If we _aim_ towards having 100% well-formed XHTML comments, by
asking developers to close their open tags etc., the XML doclet
would have less trouble outputting valid XML code, which in
turn would lead to a higher-quality HTML documentation (and
other documentation generated via XSLT.)

Besides, as I mentioned before it would be quiet easy to
write a doclet which checks every comment for well-formedness.
Actually, XML doclet is already quiet tolerant and with a
few added out.printlns could provide you with information like
e.g. this:

WARNING: in java.lang.Number.compareTo(Object) comment (near line 123):
   (comment line 5) '<' taken as literal - tag looks like email address.

WARNING: in java.lang.String class comment (near line 42):
   (comment line 7) Unclosed <li> tag
   (comment line 8) Unclosed <li> tag

So "missing something" would only be possible when ignoring
these warnings.

WRT the readability issue: actually, a good deal of Classpath
javadoc comments completely lack any HTML tags and are
only formatted using indentation and line breaks. While this
is of course very legible when looking at the code, and may
produce good-looking (though non-standard) Info output, the
XML/XSLT solution will not be able to produce good-looking
HTML code from this (or any structured output other than plain
text-based formats).

I find this issue not paramount but in order to offer
high-quality documentation in various formats, I think we should
propose some guidelines for contributors, including the advice to
structure comments using (correct) HTML tags where necessary.
Reduces inline readability but enhances output readability,
integrity, portability and transformability. Wow!! ;)

Other opinions are very welcome.



From ebb9@email.byu.edu Sun Apr 28 19:24:22 2002
Received: from rwcrmhc51.attbi.com ([204.127.198.38])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 171y1l-0003QW-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 19:24:21 -0400
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc51.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020428232420.BCDJ8969.rwcrmhc51.attbi.com@email.byu.edu>;
          Sun, 28 Apr 2002 23:24:20 +0000
Message-ID: <3CCC8499.1E46D64B@email.byu.edu>
Date: Sun, 28 Apr 2002 17:24:09 -0600
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: Julian Scheid <jscheid@sektor37.de>
CC: Nic Ferrier <nferrier@tapsellferrier.co.uk>, classpath@gnu.org
Subject: Re: Javadoc Comment Formatting
References: <3CCC0A90.8000504@sektor37.de>
	 <87adrn4v9h.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
	 <3CCC1E3B.7050405@sektor37.de>
	 <877kmr4su0.fsf@pooh-sticks-bridge.tapsellferrier.co.uk> <3CCC720D.7050709@sektor37.de>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I am not opposed to doing better markup of comments in my code.  As I
write doc comments, I have been trying to make formatted lists
correctly, use &lt; instead of <, and other things; but I do not always
get it correct.  Further, I have not tested my documentation work by
running it through any tool, free or from Sun, so I'm sure I have
contributed buggy comments.  When I code, I prefer to consult
well-formatted HTML, XML, or texinfo comments than trying to read
comments inline.  One reason is that a well-done markup version has
hyperlinks that inline code does not, and as nice as etags is for emacs,
it's not perfect.

I agree with the sentiment that the final output is worth the reduced
readability in the source code, but I am willing to go with the majority
on this decision, whichever way it gets decided.

Julian Scheid wrote:
> 
> I find this issue not paramount but in order to offer
> high-quality documentation in various formats, I think we should
> propose some guidelines for contributors, including the advice to
> structure comments using (correct) HTML tags where necessary.
> Reduces inline readability but enhances output readability,
> integrity, portability and transformability. Wow!! ;)
> 
> Other opinions are very welcome.
> 

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From cbj@gnu.org Sun Apr 28 21:26:30 2002
Received: from fe4.southeast.rr.com ([24.93.67.51] helo=mail4.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 171zvy-0004H1-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 21:26:30 -0400
Received: from lyta.haphazard.org ([66.57.8.239]) by mail4.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 21:26:29 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3T1PLZ03915;
	Sun, 28 Apr 2002 21:25:21 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Phillip Morelock <subscriptions@phillipmorelock.com>
Cc: <classpath@gnu.org>
Subject: Re: cp-tools
References: <B8F1C615.174F%subscriptions@phillipmorelock.com>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 21:25:21 -0400
In-Reply-To: <B8F1C615.174F%subscriptions@phillipmorelock.com>
Message-ID: <m3n0vn70u6.fsf@lyta.haphazard.org>
Lines: 19
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Phillip Morelock <subscriptions@phillipmorelock.com> writes:

> hi,
> 
> i'm still kind of new....what is the "cp-tools" list and those of you who've
> been reading my messages over the past week can maybe answer: should I join
> that list too?
> 
> cheers
> fillup

http://savannah.gnu.org/projects/cp-tools/ is essentially a
sub-project of classpath focused specifically on providing the tools
usually provided with Sun's JDK in free software form, except we don't
need another free compiler.  :)

Brian
-- 
Brian Jones <cbj@gnu.org>


From cbj@gnu.org Sun Apr 28 21:33:28 2002
Received: from fe4.southeast.rr.com ([24.93.67.51] helo=mail4.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 17202i-0006Bj-00
	for <classpath@gnu.org>; Sun, 28 Apr 2002 21:33:28 -0400
Received: from lyta.haphazard.org ([66.57.8.239]) by mail4.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Sun, 28 Apr 2002 21:33:09 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3T1W1703940;
	Sun, 28 Apr 2002 21:32:01 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Eric Blake <ebb9@email.byu.edu>
Cc: Julian Scheid <jscheid@sektor37.de>,
   Nic Ferrier <nferrier@tapsellferrier.co.uk>, classpath@gnu.org
Subject: Re: Javadoc Comment Formatting
References: <3CCC0A90.8000504@sektor37.de>
	<87adrn4v9h.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
	<3CCC1E3B.7050405@sektor37.de>
	<877kmr4su0.fsf@pooh-sticks-bridge.tapsellferrier.co.uk>
	<3CCC720D.7050709@sektor37.de> <3CCC8499.1E46D64B@email.byu.edu>
From: Brian Jones <cbj@gnu.org>
Date: 28 Apr 2002 21:32:00 -0400
In-Reply-To: <3CCC8499.1E46D64B@email.byu.edu>
Message-ID: <m3it6b70j3.fsf@lyta.haphazard.org>
Lines: 11
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Eric Blake <ebb9@email.byu.edu> writes:

> I agree with the sentiment that the final output is worth the reduced
> readability in the source code, but I am willing to go with the majority
> on this decision, whichever way it gets decided.

The tool will probably dictate the matter.

Brian
-- 
Brian Jones <cbj@gnu.org>


From crawley@dstc.edu.au Sun Apr 28 22:28:05 2002
Received: from piglet.dstc.edu.au ([130.102.176.1])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 1720tZ-0000mJ-00; Sun, 28 Apr 2002 22:28:05 -0400
Received: from dstc.edu.au (soluble.dstc.edu.au [130.102.176.43])
	by piglet.dstc.edu.au (8.11.3/8.11.3) with ESMTP id g3T2Rvr07236;
	Mon, 29 Apr 2002 12:27:57 +1000 (EST)
Message-Id: <200204290227.g3T2Rvr07236@piglet.dstc.edu.au>
X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4
To: classpath@gnu.org
Cc: Brian Jones <cbj@gnu.org>, Mark Wielaard <mark@klomp.org>,
   Carlos Cavanna <cdcavanna@yahoo.com>, crawley@dstc.edu.au
Subject: Re: Compilation error - More Info 
In-Reply-To: Message from Brian Jones <cbj@gnu.org> 
   of "28 Apr 2002 13:24:34 -0400." <m3adrnohwt.fsf@lyta.haphazard.org> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Mon, 29 Apr 2002 12:27:57 +1000
From: Stephen Crawley <crawley@dstc.edu.au>
X-Scanned-By: MIMEDefang 1.0 (http://www.roaringpenguin.com/mimedefang/)
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Brian Jones <cbj@gnu.org> writes:
> Mark Wielaard <mark@klomp.org> writes:
> > We need to create stubs for them or just disable javax.swing in the
> > lib/standard.omit file for now.
> 
> I disabled javax.swing in standard.omit.  Having trouble compiling the
> java_nio.c recently added as well.

These compilation problems are an ongoing nuisance for Kissme Classpath
builds.  Our build process does a merge of GNU classpath (respecting the
standard.omit file) with the Kissme VM classes.  When someone checks in
incomplete code, the Kissme Classpath compilation gives a bunch of errors
to check.

Unfortunately, we (John Leuner and myself) decided to track the recent
changes to the Classpath VM API changes in the Kissme code base. This
means we can't use the GNU Classpath 0.0.3 snapshot.  At least, not
without lots of back tracking and wasted effort.

Anyhow, I ran into the latest javax.swing compilation problems myself. I
tried leaving out javax.swing, but javax.accessibility depends on it.  I
tried leaving out javax.accessibility as well, but something in java.awt
depends on it. (I can't remember exactly ... but it is a public
interface.)  Then I gave up.

I don't know if Brian's additions to standard.omit fixes this.  But that's
not the point.  

The real point is that people checking in changes need take more care.
It is not that hard to do a cvs update and compile cycle after doing
a batch of commits.

-- Steve




From cbj@gnu.org Mon Apr 29 00:02:37 2002
Received: from fe7.southeast.rr.com ([24.93.67.54] helo=mail7.nc.rr.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 1722N3-0001F5-00
	for <classpath@gnu.org>; Mon, 29 Apr 2002 00:02:37 -0400
Received: from lyta.haphazard.org ([66.57.8.239]) by mail7.nc.rr.com  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Mon, 29 Apr 2002 00:02:05 -0400
Received: (from cbj@localhost)
	by lyta.haphazard.org (8.11.6/8.11.6) id g3T40ub04748;
	Mon, 29 Apr 2002 00:00:56 -0400
X-Authentication-Warning: lyta.haphazard.org: cbj set sender to cbj@gnu.org using -f
To: Stephen Crawley <crawley@dstc.edu.au>
Cc: classpath@gnu.org, Mark Wielaard <mark@klomp.org>,
   Carlos Cavanna <cdcavanna@yahoo.com>
Subject: Re: Compilation error - More Info
References: <200204290227.g3T2Rvr07236@piglet.dstc.edu.au>
From: Brian Jones <cbj@gnu.org>
Date: 29 Apr 2002 00:00:56 -0400
In-Reply-To: <200204290227.g3T2Rvr07236@piglet.dstc.edu.au>
Message-ID: <m34rhv6tmv.fsf@lyta.haphazard.org>
Lines: 42
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Stephen Crawley <crawley@dstc.edu.au> writes:

> These compilation problems are an ongoing nuisance for Kissme Classpath
> builds.  Our build process does a merge of GNU classpath (respecting the
> standard.omit file) with the Kissme VM classes.  When someone checks in
> incomplete code, the Kissme Classpath compilation gives a bunch of errors
> to check.
> 
> Unfortunately, we (John Leuner and myself) decided to track the recent
> changes to the Classpath VM API changes in the Kissme code base. This
> means we can't use the GNU Classpath 0.0.3 snapshot.  At least, not
> without lots of back tracking and wasted effort.

I'm glad you're tracking the recent changes in CVS.  This is a great
sort of sanity check of the ongoing work and allows you to speak up
early when things go bad.

> Anyhow, I ran into the latest javax.swing compilation problems myself. I
> tried leaving out javax.swing, but javax.accessibility depends on it.  I
> tried leaving out javax.accessibility as well, but something in java.awt
> depends on it. (I can't remember exactly ... but it is a public
> interface.)  Then I gave up.
> 
> I don't know if Brian's additions to standard.omit fixes this.  But that's
> not the point.  

Indeed, but since you were on the subject my compile with jikes is
working fine now.

> The real point is that people checking in changes need take more care.
> It is not that hard to do a cvs update and compile cycle after doing
> a batch of commits.

You are correct.  My first assumption has been to trust that
developers working on the project will try to do this.  The fault
however is probably mine with the recent commits from new developers
for not providing these clear instructions first hand and for not
actively following their work.

Brian
-- 
Brian Jones <cbj@gnu.org>


From rveldema@cs.vu.nl Mon Apr 29 06:58:27 2002
Received: from star.cs.vu.nl ([192.31.231.42])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 1728rS-0007YT-00
	for <classpath@gnu.org>; Mon, 29 Apr 2002 06:58:27 -0400
Received: from cs.vu.nl (neptune.cs.vu.nl [130.37.30.87])
	by star.cs.vu.nl with esmtp
	(Smail #74) id m1728rS-000C4cC; Mon, 29 Apr 2002 12:58 +0200
Message-ID: <3CCD2751.4070902@cs.vu.nl>
Date: Mon, 29 Apr 2002 12:58:25 +0200
From: "R.S. Veldema" <rveldema@cs.vu.nl>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.7+) Gecko/20020123
X-Accept-Language: en-us
MIME-Version: 1.0
To: classpath@gnu.org
Subject: Re: Compilation error - More Info
References: <20020426172332.75421.qmail@web10207.mail.yahoo.com> <m3wuuunilp.fsf@lyta.haphazard.org> <1019998101.7771.100.camel@elsschot> <m3adrnohwt.fsf@lyta.haphazard.org> <20020428215650.GB6929@perseval.info.uqam.ca>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I though it was plain old C.
It's simply that I was using gcc 3.0.3 which allows this (I think it 
does C99 ?),
so no error, so I thought it was ok C.
R.


Etienne M. Gagnon wrote:

>On Sun, Apr 28, 2002 at 01:24:34PM -0400, Brian Jones wrote:
>
>>I disabled javax.swing in standard.omit.  Having trouble compiling the
>>java_nio.c recently added as well.
>>
>
>I was planning to submit a bug report about it... java_nio.c contains
>invalid C code. (C, unlike C++, does not support declarations between
>statements). Maybe the author of java_nio.c was using a C++ compiler?
>
>Personal comment: I do not want to start a discussion thread about
>this, but I think we should keep the JNI native part in plain C (as it
>already is). Of course, C++ would be encouraged for the CNI stuff. :)
>
>Etienne
>





From jleuner@elandtech.com Mon Apr 29 07:28:51 2002
Received: from spamisevil.test.ie.vianw.net ([212.17.60.214] helo=lenny.elandtech.com)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 1729Kt-0001f3-00
	for <classpath@gnu.org>; Mon, 29 Apr 2002 07:28:51 -0400
Received: from [192.168.100.211] (helo=bapli ident=mail)
	by lenny.elandtech.com with esmtp (Exim 3.34 #1 (Debian))
	id 1729Dx-00007q-00; Mon, 29 Apr 2002 11:21:41 +0000
Received: from jleuner by bapli with local (Exim 3.35 #1 (Debian))
	id 1729D1-0006oU-00; Mon, 29 Apr 2002 12:20:43 +0100
Date: Mon, 29 Apr 2002 12:20:43 +0100
From: John Leuner <jewel@pixie.co.za>
To: "R.S. Veldema" <rveldema@cs.vu.nl>
Cc: classpath@gnu.org
Subject: Re: Compilation error - More Info
Message-ID: <20020429112043.GI381@bapli>
References: <20020426172332.75421.qmail@web10207.mail.yahoo.com> <m3wuuunilp.fsf@lyta.haphazard.org> <1019998101.7771.100.camel@elsschot> <m3adrnohwt.fsf@lyta.haphazard.org> <20020428215650.GB6929@perseval.info.uqam.ca> <3CCD2751.4070902@cs.vu.nl>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3CCD2751.4070902@cs.vu.nl>
User-Agent: Mutt/1.3.27i
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

> I though it was plain old C.
> It's simply that I was using gcc 3.0.3 which allows this (I think it 
> does C99 ?),
> so no error, so I thought it was ok C.
> R.

Yeah, I ran into this earlier with kissme too. People who are using older compilers, eg 2.95.4 in debian/woody won't be able to compile.

I suspect we'll have to ask everyone who is changing native code to test with the 2.9x compilers before they commit.

John Leuner

> Etienne M. Gagnon wrote:
> 
> >On Sun, Apr 28, 2002 at 01:24:34PM -0400, Brian Jones wrote:
> >
> >>I disabled javax.swing in standard.omit.  Having trouble compiling the
> >>java_nio.c recently added as well.
> >>
> >
> >I was planning to submit a bug report about it... java_nio.c contains
> >invalid C code. (C, unlike C++, does not support declarations between
> >statements). Maybe the author of java_nio.c was using a C++ compiler?
> >
> >Personal comment: I do not want to start a discussion thread about
> >this, but I think we should keep the JNI native part in plain C (as it
> >already is). Of course, C++ would be encouraged for the CNI stuff. :)
> >
> >Etienne
> >
> 
> 
> 
> 
> _______________________________________________
> Classpath mailing list
> Classpath@gnu.org
> http://mail.gnu.org/mailman/listinfo/classpath


From ebb9@email.byu.edu Tue Apr 30 06:19:57 2002
Received: from rwcrmhc54.attbi.com ([216.148.227.87])
	by fencepost.gnu.org with smtp (Exim 3.34 #1 (Debian))
	id 172Ujl-0007QE-00
	for <classpath@gnu.org>; Tue, 30 Apr 2002 06:19:57 -0400
Received: from email.byu.edu ([12.254.140.134]) by rwcrmhc54.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020430101951.HMMS2627.rwcrmhc54.attbi.com@email.byu.edu>;
          Tue, 30 Apr 2002 10:19:51 +0000
Message-ID: <3CCE6FA1.341DDFD5@email.byu.edu>
Date: Tue, 30 Apr 2002 04:19:13 -0600
From: Eric Blake <ebb9@email.byu.edu>
Organization: BYU Student
X-Mailer: Mozilla 4.76 [en] (Win98; U)
X-Accept-Language: en
MIME-Version: 1.0
To: aselkirk@sympatico.ca, Classpath list <classpath@gnu.org>
Subject: Re: classpath/javax/swing/plaf/basic BasicLookAndFe...
References: <E170c6F-0002ss-00@subversions.gnu.org> <3CC79B05.AC8A0B38@email.byu.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

I got tired of the javax.swing tree not compiling, so I touched enough
files to at least allow jikes to compile it.  That does not mean that I
implemented everything, by a long shot, but at least the build doesn't
fail now.

Eric Blake wrote:
> 
> Are you remembering to make a ChangeLog entry for all your merges
> today?  Also, are you enabling the build in the appropriate places, such
> as configure.in?  And one more thing to remember - the .cvsignore files.
> 
> Andrew Selkirk wrote:
> >
> > CVSROOT:        /cvsroot/classpath
> > Module name:    class path
> > Changes by:     Andrew Selkirk <aselkirk@sympatico.ca>  02/04/25 01:47:23
> >
> > Added files:
> >         javax/swing/plaf/basic: BasicLookAndFeel.java
> >

-- 
This signature intentionally left boring.

Eric Blake             ebb9@email.byu.edu
  BYU student, free software programmer


From mark@wildebeest.org Tue Apr 30 07:04:20 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 172VQh-0003dc-00
	for <classpath@gnu.org>; Tue, 30 Apr 2002 07:04:20 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 172VQN-00048m-00; Tue, 30 Apr 2002 13:03:59 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 172VQR-0007kP-00; Tue, 30 Apr 2002 13:04:03 +0200
Subject: Compiling even more classes (Was: classpath/javax/swing/plaf/basic
	BasicLookAndFe...)
From: Mark Wielaard <mark@klomp.org>
To: Eric Blake <ebb9@email.byu.edu>
Cc: aselkirk@sympatico.ca, Classpath list <classpath@gnu.org>
In-Reply-To: <3CCE6FA1.341DDFD5@email.byu.edu>
References: <E170c6F-0002ss-00@subversions.gnu.org>
	<3CC79B05.AC8A0B38@email.byu.edu>  <3CCE6FA1.341DDFD5@email.byu.edu>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 30 Apr 2002 13:04:03 +0200
Message-Id: <1020164643.29663.16.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

On Tue, 2002-04-30 at 12:19, Eric Blake wrote:
> I got tired of the javax.swing tree not compiling, so I touched enough
> files to at least allow jikes to compile it.  That does not mean that I
> implemented everything, by a long shot, but at least the build doesn't
> fail now.

Thanks for doing this Eric. I just made two small fixes to the
java.util.prefs package to get it compiling again and also removed it
from standard.omit to catch compile errors a bit earlier (it used to
compile but some changes to support chained exceptions broke it).

java.util.prefs is not completely functioning but should help anybody
that has to work with code that uses those classes. (The XML file
backend is missing, so it isn't really usefull between runs of a
program, but adding that functionality should not be that much work.)

lib/standard.omit now only contains the following lines for classes that
are really not part of the build:

    ../gnu/test/.*$
    ../gnu/java/awt/peer/gtk/TestAWT.java$
    ../gnu/java/awt/peer/gtk/Test.java$
    ../gnu/javax/swing/plaf/gtk/.*$

When we make a release we might want to add some non-functional packages
again, but for now lets try to keep everything compiling.

Cheers,

Mark


From mark@wildebeest.org Tue Apr 30 17:53:27 2002
Received: from node1c5f.a2000.nl ([62.108.28.95] helo=nescio.wildebeest.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 172fYt-0001op-00
	for <classpath@gnu.org>; Tue, 30 Apr 2002 17:53:27 -0400
Received: from elsschot.wildebeest.org
	([192.168.1.26] helo=elsschot ident=mail)
	by nescio.wildebeest.org with esmtp (Exim 3.35 #1 (Debian))
	id 172fYm-0004Lq-00; Tue, 30 Apr 2002 23:53:20 +0200
Received: from mark by elsschot with local (Exim 3.35 #1 (Debian))
	id 172fYq-00063j-00; Tue, 30 Apr 2002 23:53:24 +0200
Subject: Always add copyright notices
From: Mark Wielaard <mark@klomp.org>
To: classpath@gnu.org
Cc: rveldema@cs.vu.nl, tromey@redhat.com
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.3 
Date: 30 Apr 2002 23:53:24 +0200
Message-Id: <1020203604.6155.213.camel@elsschot>
Mime-Version: 1.0
Sender: classpath-admin@gnu.org
Errors-To: classpath-admin@gnu.org
X-BeenThere: classpath@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:classpath-request@gnu.org?subject=help>
List-Post: <mailto:classpath@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=subscribe>
List-Id: Discussion of the implemenation of the core Java class libraries <classpath.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/classpath>,
	<mailto:classpath-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/classpath/>

Hi,

I just added copyright notices to a lot of classes that were missing
them. Please make sure that all files you check into CVS always have to
correct copyright boilerplate.

Some of the files in gnu.java.nio seemed to be generated by a script.
Ronald, which scripts created those files? Do they ever have to be
recreated by that script? Then we might want to automate adding the
header (and add a warning that the file is auto generated).

Tom, the files in gnu.java.local are generated by your hacked localedef
program. Can that program be changed so that it adds an appropriate
copyright message?

I did not yet add the copyright notice to the files
gnu/java/rmi/dgc/DGCImpl_Skel.java and
gnu/java/rmi/dgc/DGCImpl_Stub.java which also seem to have been
autogenerated. Does anybody know when/how these are regenerated?

Thanks,

Mark



