[FIX] corrected a word in a comment

closes #3423
[FIX] doc: fit code example to new API

When using this code as is, the 'ids' variable throws an exception for not
being defined. In the new API, 'ids' is no longer given as a function variable
but as a variable within 'self'.

close #3406
Merge branch '8.0' of https://github.com/odoo/odoo into 8.0-win32