From c225b722cf154e1697f4ee15e7710f8c53ab5df6 Mon Sep 17 00:00:00 2001 From: Arseny Kapoulkine Date: Wed, 9 Nov 2016 09:19:19 -0800 Subject: docs: Add documentation for format_no_empty_element_tags Also add it to the changelog for 1.8 --- docs/manual.adoc | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs/manual.adoc') diff --git a/docs/manual.adoc b/docs/manual.adoc index cb1b764..81812cb 100644 --- a/docs/manual.adoc +++ b/docs/manual.adoc @@ -1702,6 +1702,8 @@ These flags control the resulting tree contents: * [[format_no_escapes]]`format_no_escapes` disables output escaping for attribute values and PCDATA contents. If this flag is off, special symbols (`"`, `&`, `<`, `>`) and all non-printable characters (those with codepoint values less than 32) are converted to XML escape sequences (i.e. `&amp;`) during output. If this flag is on, no text processing is performed; therefore, output XML can be malformed if output contents contains invalid symbols (i.e. having a stray `<` in the PCDATA will make the output malformed). This flag is *off* by default. +* [[format_no_empty_element_tags]]`format_no_empty_element_tags` determines if start/end tags should be output instead of empty element tags for empty elements (that is, elements with no children). This flag is *off* by default. + These flags control the additional output information: * [[format_no_declaration]]`format_no_declaration` disables default node declaration output. By default, if the document is saved via `save` or `save_file` function, and it does not have any document declaration, a default declaration is output before the document contents. Enabling this flag disables this declaration. This flag has no effect in `xml_node::print` functions: they never output the default declaration. This flag is *off* by default. @@ -2136,6 +2138,7 @@ Maintenance release. Changes: * New features: . Added parse_embed_pcdata parsing mode in which PCDATA value is stored in the element node if possible (significantly reducing memory consumption for some documents) . Added auto-detection support for Latin-1 (ISO-8859-1) encoding during parsing + . Added format_no_empty_element_tags formatting flag that outputs start/end tags instead of empty element tags for empty elements * Performance improvements: . Minor memory allocation improvements (yielding up to 1% memory savings in some cases) @@ -2623,6 +2626,7 @@ const unsigned int +++format_default+++ const unsigned int +++format_indent+++ const unsigned int +++format_indent_attributes+++ const unsigned int +++format_no_declaration+++ +const unsigned int +++format_no_empty_element_tags+++ const unsigned int +++format_no_escapes+++ const unsigned int +++format_raw+++ const unsigned int +++format_save_file_text+++ -- cgit v1.2.3