make the documentation right and kill a warning about undefined vars