some docblock stuff as suggested by scrutinizer