adopt documentation to implementation

 - besides, let's see if a push starts travis' build