Corrected docs according to WouterJ comments