about summary refs log tree commit diff
path: root/format/fastxml/README
diff options
context:
space:
mode:
authorAlexey Yerin <yyp@disroot.org>2023-10-04 21:02:27 +0300
committerAlexey Yerin <yyp@disroot.org>2023-10-04 21:02:27 +0300
commitc98da05caa1c30f42bd5a3615d9cb63b4d590e9f (patch)
treed019e8c1efd4c63ca38700cf16f59f1f8db05407 /format/fastxml/README
parentc137ce659bd2449c430c0a5ac7f932f2286c250c (diff)
Vendor hare-fastxml
Diffstat (limited to 'format/fastxml/README')
-rw-r--r--format/fastxml/README16
1 files changed, 16 insertions, 0 deletions
diff --git a/format/fastxml/README b/format/fastxml/README
new file mode 100644
index 0000000..4913883
--- /dev/null
+++ b/format/fastxml/README
@@ -0,0 +1,16 @@
+format::fastxml provides a simple parser of the useful subset of the XML 1.0
+(Fifth Edition) specification as defined by the W3C. Features omitted are:
+
+- Support for user-defined entities
+- Support for UTF-16 inputs or a UTF-8 BOM
+- Any considerations for the "Namespaces in XML 1.0" specification
+
+Attempting to parse an input file which does not conform to the supported subset
+of XML will return a syntax error. The purpose of this module is to support most
+XML files found in the wild, without supporting the lesser-used features that
+lead to problems like "billion laughs" vulnerabilities. If a fully conformant
+XML parser is required for your application, you will need to use a third-party
+XML implementation. Such an implementation should be able to shadow the standard
+library version and present a compatible API.
+
+The API of this module is compatible with format::xml.