From ce322c95d2394c502c2f1e5bd858dc3bc9f49f21 Mon Sep 17 00:00:00 2001 From: dsiders Date: Sun, 21 Aug 2022 02:47:49 +0100 Subject: [PATCH] Docs: LazUtils/laz2_xmlread. Adds missing content in TDOMParserOptions and TGetDecoderProc topics. --- docs/xml/lazutils/laz2_xmlread.xml | 100 +++++++++++++++++++++++------ 1 file changed, 82 insertions(+), 18 deletions(-) diff --git a/docs/xml/lazutils/laz2_xmlread.xml b/docs/xml/lazutils/laz2_xmlread.xml index 044aaab90e..698675542e 100644 --- a/docs/xml/lazutils/laz2_xmlread.xml +++ b/docs/xml/lazutils/laz2_xmlread.xml @@ -485,14 +485,67 @@ Maximum number of characters allowed in expanded entity references. - - - - + +Indicates whether XML Canonical Form is used for parsed XML content. + + +

+CanonicalForm is a Boolean property which indicates +whether an XML parser should convert XML content to Canonical XML form. This +is also referred to as Normal form, and means that the following are used in +the parsed XML document: +

+
    +
  • UTF-8 encoding is used.
    • +
  • An End-of-line is represented using the newline character (#10).
    • +
  • Whitespace in attribute values is normalized.
    • +
  • Entity references and non-special character references are expanded.
    • +
  • CDATA sections are replaced with their character content.
    • +
  • +Empty elements are encoded as start and end element tag pairs, not using the +special empty element syntax. +
    • +
  • Default attributes are explicitly declared.
    • +
  • Superfluous namespace declarations are deleted.
    • +
+

+The property value is True when all of the following properties are +True: +

+
    +
  • CanonicalForm
    • +
  • ExpandEntities
    • +
  • CDSectionsAsText
    • +
  • Namespaces
    • +
  • PreserveWhitespace
    • +
+

+Changing the property value to True causes the following properties to +be set to True: +

+
    +
  • ExpandEntities
    • +
  • CDSectionsAsText
    • +
  • Namespaces
    • +
  • PreserveWhitespace
    • +
+

+The value in CanonicalForm is used in the constructor for a TXMLReader class +instance which uses an XML parser with these parse options. +

+ + + + + + + + + + - Values that control how XML content is stored in a DOM sub-tree. @@ -1040,26 +1093,37 @@ the decoder Context. - - - - + +Function type used to get a decoder routine for the specified target encoding. + + +

+TGetDecoderProc is a Boolean function type used to get +the Decoder routine used to convert value in an arbitrary encoding to the encoding specified in AEncoding. +

+

+TGetDecoderProc is the type passed as an argument to the RegisterDecoder routine. +

+ + + + - - - + +True if a decoder routine is found for the specified target encoding. + - - - + +Encoding name for the converted values from the decoder routine. + - - - + +Returns a record with the decode and clean-up routines for a given context. +