cleanup documentation, raise error if RUBY_PLATFORM =~ /java/