summaryrefslogtreecommitdiff
path: root/textproc/lua-luaexpat/pkg-descr
diff options
context:
space:
mode:
Diffstat (limited to 'textproc/lua-luaexpat/pkg-descr')
-rw-r--r--textproc/lua-luaexpat/pkg-descr12
1 files changed, 12 insertions, 0 deletions
diff --git a/textproc/lua-luaexpat/pkg-descr b/textproc/lua-luaexpat/pkg-descr
new file mode 100644
index 000000000000..8109063588e0
--- /dev/null
+++ b/textproc/lua-luaexpat/pkg-descr
@@ -0,0 +1,12 @@
+LuaExpat is a SAX XML parser based on the Expat library. SAX is the Simple API
+for XML and allows programs to:
+- process a XML document incrementally, thus being able to handle huge documents
+ without memory penalties;
+- register handler functions which are called by the parser during the
+ processing of the document, handling the document elements or text.
+
+With an event-based API like SAX the XML document can be fed to the parser in
+chunks, and the parsing begins as soon as the parser receives the first document
+chunk. LuaExpat reports parsing events (such as the start and end of elements)
+directly to the application through callbacks. The parsing of huge documents can
+benefit from this piecemeal operation.