Remove experimental JRuby-compatible Java interop

Author: chrisseaton

CHANGELOG.md

@@ -4,6 +4,11 @@ New features:
 
 * `Process.clock_getres` has been implemented.
 
+Changes:
+
+* Our experimental JRuby-compatible Java interop has been removed - use
+  `Polyglot` and `Java` instead.
+
 # 1.0 RC 14
 
 Updated to Ruby 2.6.2.

doc/contributor/interop.md

@@ -27,9 +27,6 @@ details.
 * [Notes on coercion](#notes-on-coercion)
 * [Notes on source encoding](#notes-on-source-encoding)
 
-Also see the separate document on
-[JRuby-compatible Java interop](../user/jruby-java-interop.md).
-
 ## How Ruby responds to messages
 
 ### `IS_EXECUTABLE`

doc/user/compatibility.md

@@ -233,9 +233,9 @@ understand. The process should behave identically to MRI.
 
 #### Ruby to Java interop
 
-JRuby's Java interop API is not implemented far enough to be used. We provide an
-alternate polyglot API for interoperating with multiple languages, including
-Java, instead.
+TruffleRuby does not support the same interop to Java interface as JRuby does.
+We provide [an alternate polyglot API](polyglot.md) for interoperating with
+multiple languages, including Java, instead.
 
 #### Java to Ruby interop
 

doc/user/jruby-java-interop.md

@@ -351,10 +351,6 @@ TruffleRuby provides its own scheme for Java interop that is consistent for
 use from any GraalVM language, to any other GraalVM language. This isn't
 compatible with existing JRuby Java interop, so you will need to migrate.
 
-TruffleRuby does [experimentally support](jruby-java-interop.md) some of JRuby's
-approach to Java interop, but we aren't sure how complete this will be so we do
-not recommend using it at the moment. `require 'java'` to use it.
-
 Polyglot programming in general is [documented elsewhere](polyglot.md) - this
 section describes it relative to JRuby.
 
@@ -400,9 +396,9 @@ notation.
 
 ### Require Java
 
-There is no need to `require 'java'` in TruffleRuby. However, you do need to run
-in `--jvm` mode. This is only available in GraalVM - not in the standalone
-distribution installed by Ruby version managers and installers.
+Do not `require 'java'` in TruffleRuby. However, you do need to run in `--jvm`
+mode. This is only available in GraalVM - not in the standalone distribution
+installed by Ruby version managers and installers.
 
 ### Referring to classes
 
@@ -444,7 +440,7 @@ TruffleRuby at the moment you use the `-classpath` JVM flag as normal.
 
 ### Additional Java-specific methods
 
-JRuby defines these methods on Java objects.
+JRuby defines these methods on Java objects, use these equivalents instead.
 
 `java_class` - use `class`.
 

doc/user/jruby-migration.md

@@ -26,9 +26,6 @@ using the Truffle interop API, and exactly how Ruby is matched to this API.
 * [Threading and interop](#threading-and-interop)
 * [Embedded configuration](#embedded-configuration)
 
-Also see the separate document on
-[JRuby-compatible Java interop](jruby-java-interop.md).
-
 ## Loading code written in foreign languages
 
 `Polyglot.eval(id, string)` executes code in a foreign language identified by