fix FTBFS introduced in last commit
improve doc