piranha: a couple of bits of internal doc.