Fixed stupid comment error (Shane's fault), and updated documentation

As the title says, Shane broke the code. He later fixed it, thus
restoring Yin and Yang to the world. He also updated the documentation,
and thereby upset over 4 million years of programmer convention.