Some of it is documented in the perldeltas — anyone wanting to learn more about how Perl operates can gain some insight by reading them, starting with perl5004delta. Some of it is reasonably well commented in the code, and of course RTFS is another way to learn. A good source for places to start looking in the source is the section "Compiled Code" of perlguts, another doc worth reading.
Some, but by no means all, of it is documented in Chapter 18, "Compiling", of Programming Perl (yes, the 3rd edition really is 10 years old and covers 5.6.0 and/or 5.6.1, but the 4th edition is finally in the works!)
A lot of it, however, is documented nowhere, except possibly the mailing list threads where the feature was being discussed while it was under development. If you're interested in learning more about perl internals and maybe contributing a bit to the documentation, I'd suggest bringing questions up on the perl5-porters mailing list or the #p5p IRC channel, since that's where most of the perl-guts tribal knowledge resides.