Compiler Name Mangling

From JRubyWiki

Name mangling specification for JRuby compiler

Given the packaging specification...

• each element of the package must be cleansed to contain only valid Java package characters
• each element of the resulting class name must be cleansed to contain only valid Java classname characters
• the resulting filename should match the class name, to allow Java classloading to be used to load it in more traditional scenarios
• the class name (matching file name) must be reversable, consistent, and predictable for all automatic cases, to allow the Ruby load process to accurately locate the class files in every case.
• the package name does not have to match the eventual location in the load path, and since it must be examined for every compiled .class load it must only be valid for Java's purposes (not necessarily reversable or predictable for ours)

Methods on java.lang.Character can be used to clean up the package and class name on a character-by-character basis.

• method names must conform to Java method naming. This primarily impacts methods names containing characters Java does not support, such as arithmetic operators, question marks, bangs, equality/comparison symbols. Below is a complete list of such names and what they should translate to:

+ will be "op_plus"
- will be "op_minus"
* will be "op_times"
/ will be "op_divide"
** will be "op_pow"
== will be "op_equal"
=== will be "op_eqq"
eq? will be "eq_p"
< will be "op_lt"
<= will be "op_le"
> will be "op_gt"
>= will be "op_ge"
<=> will be "op_cmp"
something! will be "something_bang"
[] will be "op_aref"
something= will be "something_set"
[]= will be "op_aset"