Clarify API for error handling with the show() function

Make the API clearer in terms of returning errors from the show()
function.
Fix minor typo.

Change-Id: I035a553337baf7cd486a09672b54269bf3daf72b
Signed-off-by: Manuel Bachmann <manuel.bachmann@open.eurogiciel.org>