Index: doc/dom.html
==================================================================
--- doc/dom.html
+++ doc/dom.html
@@ -1,22 +1,22 @@
-
-
+
dom -
Create an in-memory DOM tree from XML
-
package require tdom
+ package require tdom
dom method ?arg arg ...?
- This command provides the creation of complete DOM trees in memory. In
+
This command provides the creation of complete DOM trees in memory. In
the usual case a string containing a XML information is parsed and converted
into a DOM tree. method indicates a specific subcommand.
The valid methods are:
-
dom parse ?options? ?data?
@@ -416,20 +416,74 @@
- Returns 1, if string is
valid according to production 16 of the XML 1.0
recommendation. Otherwise it returns 0.
-
+
+
+dom featureinfo
+ feature
+
+
This method provides information about the used
+ build options and the expat version. The valid values for
+ the feature argument are:
+
+
+ - expatversion
+ - Returns the version of the underlyling expat
+ version as string, something like
+ "exapt_2.1.0". This is. what the expat API
+ function XML_ExpatVersion() returns.
+
+
+ - expatmajorversion
+ - Returns the major version of the underlyling
+ expat version as integer.
+
+
+ - expatminorversion
+ - Returns the minor version of the underlyling
+ expat version as integer.
+
+
+ - expatmicroversion
+ - Returns the micro version of the underlyling
+ expat version as integer.
+
+
+ - dtd
+ - Returns as boolean, if build with
+ --enable-dtd.
+
+
+ - ns
+ - Returns as boolean, if build with
+ --enable-ns.
+
+
+ - unknown
+ - Returns as boolean, if build with
+ --enable-unknown.
+
+
+ - tdomalloc
+ - Returns as boolean, if build with
+ --enable-tdomalloc.
+
+
+ - lessns
+ - Returns as boolean, if build with
+ --enable-lessns.
+
+
+
+
+
-
+
XML, DOM, document, node, parsing
-
-
+
domDoc -
Manipulates an instance of a DOM document object
-
+
domDocObjCmd method ?arg arg ...?
- This command manipulates one particular instance of a document
+
This command manipulates one particular instance of a document
object. method indicates a specific method of the document class. These
methods should closely conform to the W3C recommendation "Document Object Model
(Core) Level 1" (http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html). Look
at these documents for a deeper understanding of the functionality.
The valid methods are:
@@ -178,12 +178,13 @@
given to the method, the system identifier of the document is set to this
value.
- - internalSubset ?internalSubset?
-
+ -
+internalSubset ?internalSubset?
+
- Returns the internal subset of the doctype declaration of the
document, if there is one, otherwise the empty string. If there is a value
given to the method, the internal subset of the document is set to this
value. Note, that none of the parsing methods preserve the internal subset
of a document; a freshly parsed document will always have an empty internal
@@ -504,12 +505,13 @@
- - baseURI ?URI?
-
+ -
+baseURI ?URI?
+
- Returns the present baseURI of the document. If the optional
argument URI is given, sets the base URI of the document to the given URI.
@@ -547,16 +549,16 @@
same name as the given metho within the namespace ::dom::domDoc is
tried to be executed. This allows quick method additions on Tcl level.Newly created nodes are appended to a hidden fragment list. If they
are not moved into the tree they are automaticaly deleted, when the whole
document gets deleted.
- dom, domNode
+ dom, domNode
-
+
DOM node creation, document element
-
+
domNode -
Manipulates an instance of a DOM node object
-
$nodeObject method arg arg ...
+ $nodeObject method arg arg ...
- This command manipulates one particular instance of a DOM node object.
+
This command manipulates one particular instance of a DOM node object.
method indicates a specific method of the node class. These methods
should closely conform to the W3C recommendation "Document Object Model
(Core) Level 1" (http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html)
as well to parts of the W3C draft "XML Pointer Language (XPointer)"
(http://www.w3.org/TR/1998/WD-xptr-19980303).
@@ -560,12 +560,13 @@
variable outputVar . The translation is very similar to Cost Simple
mode.
-
toXPath ?-legacy?
-
+
+toXPath ?-legacy?
+
Returns an XPath, which exactly addresses the given
node in its document. This XPath is only valid as there are no changes to DOM
tree made later one. With the -legacy option, other XPath expressions
are returnd, which doesn't work in all cases.
@@ -575,12 +576,13 @@
Returns the baseURI of the node. This method is deprecated in
favor of the baseURI method.
-
baseURI ?URI?
-
+
+baseURI ?URI?
+
Returns the present baseURI of the node. If the optional
argument URI is given, sets the base URI of the node and of all of its child
nodes out of the same enitity as node to the given URI.
@@ -665,16 +667,16 @@
Otherwise, if an unknown method name is given, the command with the same
name as the given method within the namespace ::dom::domNode is tried to
be executed. This allows quick method additions on Tcl level.
-
dom, domDoc
+
dom, domDoc
-
+
XML, DOM, document, node, parsing