More README tweaks

Show non-optional vs. optional return values.

Signed-off-by: Stephen Celis <stephen@stephencelis.com>