doc: Complete API doc for should.

Signed-off-by: Draltan Marin <draltan.marin@gmail.com>