These are used to create internal `libxml' nodes
and top-level document objects
that are used to write XML trees.
While the functions are available,
their direct use is not encouraged.
Instead, use
as the functions need to be
used within a strict regime
to avoid corrupting C level structures.
a named character vector
with each element specifying a name space identifier and the
corresponding URI for that namespace
that are to be declared and used in the XML document, \
e.g.
c(shelp = "http://www.omegahat.org/XML/SHelp")
name
the tag/element name for the XML node
...
the children of this node. These can be other nodes created
earlier or Splus strings that are converted to text nodes and added as children
to this newly created node.
attrs
a named list of name-value pairs to be used as
attributes for the XML node.
namespace
the short or alias for the namespace to use for
this XML node
doc
the
XMLInternalDocument object created with
newXMLDoc that is used to root the node.
DETAILS:
These create internal C level objects/structure instances
that can be added to a libxml DOM and subsequently
inserted into other document objects or "serialized"
to textual form.
VALUE:
Each function returns an Splus object that points to the
C-level structure instance.
These are of class
XMLInternalDocument
and
XMLInternalNode, respectively
NOTE:
These functions are used to build up an internal XML tree.
This can be used in the Sxslt package (
http://www.omegahat.org/Sxslt)
when creating content in Splus that is to be dynamically inserted into an XML
document.