Starting to treat mixins seriously: documentation & some bomb-proofing.

No unit tests yet.