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/parser.hxx | 7 +++++-- xml/serializer.hxx | 12 +++++++----- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/xml/parser.hxx b/xml/parser.hxx index 1d45e8c..6f90522 100644 --- a/xml/parser.hxx +++ b/xml/parser.hxx @@ -99,8 +99,11 @@ namespace xml receive_attributes_map; // Parse std::istream. Input name is used in diagnostics to identify - // the document being parsed. std::ios_base::failure exception is - // used to report io errors (badbit and failbit). + // the document being parsed. + // + // 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 parsing exception. // parser (std::istream&, const std::string& input_name, 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