Name: krT82822 Date: 11/20/99


The class descrption of java.util.ConcurrentModificationException says:
  ...
  For example, it is not permssible [sic] for one thread to modify a
  Collection while another thread is iterating over it.
  ...

That implies that multi-threaded access is the problem.

That implication is false, evidently. (My single-threaded program
triggers this exception.)

Apparently, modifying while iterating on a different thread is not the
problem, modifying while iterating is (regardless of threading).

If that is indeed the case, document it! Don't imply that multiple
threads have to be involved.

Also, note that ConcurrentModificationException doesn't say anything
about how to apply synchronizing wrappers or point the reader to them.


> 11/20/99 eval1127@eng -- checked against 1.2.2 docs at http://java.sun.com/products/jdk/1.2/docs/api/java/util/ConcurrentModificationException.html
> The key phrase is "for example". What follows describes ONE way the exception can occur, not the ONLY way. The first paragraph (summary) seems to
> cover all other possible case(s). However, we'll file a doc bug to see if additional clarification might be helpful.

--------------

Why can't I submit this bug-report page without a version number?

I'm trying to report a documentation problem. There is no
(system-beep)ING "java -version" command to run on it. The documentation web page
says "Java Platform 1.2" (even though it's 1.2.1, of course).

java version "1.2"
Classic VM (build Linux_JDK_1.2_pre-release-v2, native threads, sunwjit)

----------------
> 11/20/99 eval1127@eng -- re. version #, the docs at java.sun.com always have a version # in them. For example, the latest 1.2.x production version (for Sol/win32)
> is 1.2.2, so the docs at http://java.sun.com/products/jdk/1.2/docs/api note "1.2.2" as part of the header. You're correct that there's no "java -version" to run.
> The reason that request is there is because we get a lot of reports with no version info, which makes them "underspecified". Since the docs DO have a version,
> it's important to include it.

(Review ID: 98100)
======================================================================