Document Puavo constructor

and fix method return types