expanded docstr
doc update
massage tests