From e28bfc09f230ed00e94a79efaa6fafd0d07eaf12 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Sat, 10 May 2014 18:54:25 -0700 Subject: Clarify stream exceptions and parser/serializer behavior --- xml/serializer.hxx | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) (limited to 'xml/serializer.hxx') diff --git a/xml/serializer.hxx b/xml/serializer.hxx index 376eeb1..4f57e48 100644 --- a/xml/serializer.hxx +++ b/xml/serializer.hxx @@ -58,11 +58,13 @@ namespace xml typedef xml::qname qname_type; // Serialize to std::ostream. Output name is used in diagnostics to - // identify the document being serialized. std::ios_base::failure - // exception is used to report io errors (badbit and failbit). The - // indentation argument specifies the number of indentation spaces - // that should be used for pretty-printing. If 0 is passed, no - // pretty-printing is performed. + // identify the document being serialized. The indentation argument + // specifies the number of indentation spaces that should be used for + // pretty-printing. If 0 is passed, no pretty-printing is performed. + // + // If stream exceptions are enabled then std::ios_base::failure + // exception is used to report io errors (badbit and failbit). + // Otherwise, those are reported as the serialization exception. // serializer (std::ostream&, const std::string& output_name, -- cgit v1.1