...i'm just dumping info that should be in the docs (but isn't) at this point