diff options
author | Boris Kolpackov <boris@codesynthesis.com> | 2014-05-10 18:54:25 -0700 |
---|---|---|
committer | Boris Kolpackov <boris@codesynthesis.com> | 2014-05-10 18:54:25 -0700 |
commit | e28bfc09f230ed00e94a79efaa6fafd0d07eaf12 (patch) | |
tree | 144ad19c2aa30382cead7856751aedff246c0176 /xml/serializer.hxx | |
parent | fbdab3ec236aeed8d8e31535d998df556dd54943 (diff) |
Clarify stream exceptions and parser/serializer behavior
Diffstat (limited to 'xml/serializer.hxx')
-rw-r--r-- | xml/serializer.hxx | 12 |
1 files changed, 7 insertions, 5 deletions
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, |