improved doc even though no one is ever going to look at this stuff