updated doco; more to come