added some doc, though it seems not yet fully 'rustdoc' compliant