revised documentation