Java VM black magic

This makes for some interesting reading. My question to Sun is - why the heck dont you document some of these things ? Would help some of us when dealing with esoteric issues and searching for solutions.