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: I88cb57787bf298c4c307e039bd68464e0623a9e2
Signed-off-by: Manuel Bachmann <manuel.bachmann@open.eurogiciel.org>