[Bug classpath/22940] please document which parts are not implemented

[gcc-bugzilla at gcc dot gnu dot org]

I am using classpath via gcj 3.4.  I just wrote some code according to the
classpath documentation (http://developer.classpath.org/doc/) linked from the
gcj site, and was quite aggrevated when I got a "not implemented" message. 
Since the documentation for the java.util.regex classes was complete, I
naturally assumed that they were implemented!  Please make it more clear which
parts work so that users don't waste time writing code that won't run.


------- Comment #1 from from-classpath at savannah dot gnu dot org  2005-05-10 
03:48 -------
Hmm...  I see that the regex classes have been implemented by now, however the
point stands that the version included in gcj 3.4 is documented with javadoc
but does not indicate that it is not implemented.  So even if I had been
looking at the right version of the documentation, it wouldn't have helped!


------- Comment #2 from from-classpath at savannah dot gnu dot org  2005-05-11 
19:20 -------
Thanks for the report. Sorry for your experience. 

In general we try to avoid having stub methods for things which aren't
implemented. (And just give a compile error and not a runtime like this)

This wasn't always the case, and looking back at the GCJ 3.4 code, it was one
of the things which was stubbed then.

Things which aren't implemented now are *not* stubbed except for in special
circumstances. You are right that the documentation should clearly say so when
this is the case.


------- Comment #3 from from-classpath at savannah dot gnu dot org  2005-05-11 
19:59 -------
Thanks, and I think your policy is the best one.  It would have been great if I
had gotten the error the first time I tried to compile.  As far as I'm
concerned, you can close this.


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=22940