doc: describe *what* is returned

Return type only description is useless.

TODO: update .po