[IMP] openerp.api: improve documentation