added further documentation in header