(DISTFILES): Comment out a few missing files.
[mono-project.git] / mcs / class / Mono.Xml.Ext / README
blobcf9aa9a546fd3d4e3409f82cfd4a96079983ad1c
1 * Mono.Xml.Ext.dll readme
3 ** Introduction
5         Mono.Xml.Ext.dll holds those features listed below:
7         <ul>
8                 * XQuery implementation
9                 * custom XmlResolver
10                 * DTMXPathNavigator (exactly the same one as XPathNavigator)
11         </ul>
13 ** XQuery implementations
15         XQuery is implemented in Mono.Xml.XPath2 namespace. The entry point
16         of XQuery command is Mono.Xml.XPath2.XQueryCommandImpl class. Below
17         is a simple example:
19         private void ExecuteXQuery (string xqueryString,
20                 XPathNavigator input, XmlWriter output)
21         {
22                 XQueryCommandImpl cmd = new XQueryCommandImpl ();
23                 cmd.Load (new StringReader (xqueryString), null, null);
24                 cmd.Execute (input, null, null, output);
25         }
27         It is designed to implement the latest working draft of W3C XQuery
28         specification (as of now 2004/07/24 version), while it keeps some
29         URI as old XQuery one (for example, http://www.w3.org/2003/11/xquery).
30         It is just for testing convenience; XQuery Use Cases is still based
31         on an old version).
33         Currently only XQueryCommandImpl and XmlArgumentList are intended
34         to be public (originally XQueryCommandImpl is not intended to be
35         public).
37         Note that it is highly unstable, buggy, subject to many changes.
39 ** DTMXPathNavigator
41         DTMXPathNavigator is an implementation of XPathNavigator which is
42         based on document table model aka DTM.
44         Actually DTMXPathNavigator is exactly the same as Mono's XPathDocument
45         implementation, so basically this means nothing for Mono users.