futher docblock tidying