API Documentation touchups

Other than allowing 'format' to be in any case for output(), most of the
changes here are in documentation comments.