Add documentation for what we've done with error()

Signed-off-by: Ronald G. Minnich <rminnich@gmail.com>