wiki/RedBridgeExamples needs to stress that container.parse() does not support local variables

[AshwinJay]

Local variables do not work here:

    System.out.println("[" + Test1.class.getName() + "]");

    ScriptingContainer container = new ScriptingContainer();

    EmbedEvalUnit unit = container.parse("puts \"#{a} < #{@a} ? #{a < @a}\"");

    for (int i = 0; i < 10; i++) {
        container.put("a", i * 10);
        container.put("@a", i);
        unit.run();
    }

Error:

org.jruby.exceptions.RaiseException: (NameError) undefined local variable or method `a' for #<Object:0x71b58ad1 @a=0>
    at RUBY.(root)(<script>:1)

Local variables work alright here (of course):

    System.out.println("[" + Test1.class.getName() + "]");

    ScriptingContainer container = new ScriptingContainer();

    for (int i = 0; i < 10; i++) {
        container.put("a", i * 10);
        container.put("@a", i);
        container.runScriptlet("puts \"#{a} < #{@a} ? #{a < @a}\"");
    }

[enebo]

We do mention this behavior on the embedding page, but it is quite a ways down. Also you can persist locals if you want to (new ScriptingContainer(LocalVariableBehavior.PERSISTENT)):

https://github.com/jruby/jruby/wiki/RedBridge#wiki-Local_Variable_Behavior_Options

Whenever someone mentions updating documentation I am at a loss in how to address this issue. It clearly tripped you up, but I am unsure what we should update to make this less confusing to others. Tell me if you think we need to change this document or do something else or I will end up closing this issue.

[AshwinJay]

Thanks for the clarification. I guess a line to clarify that might help others - esp the part where vanilla.ScriptingEvalSample prints local, instance, global and constants using runScriptlet instead of eval.

Thanks. It's not really an issue, just a little confusing in the docs/wiki.

[enebo]

If you can review that document and perhaps figure out a better way of phrasing this we can change the document. I will close this as an issue and let you ponder an edit (I am not sure how to make this more clear).