diff options
Diffstat (limited to 'Master/tlpkg/tlperl.straw/lib/XML/LibXML/Dtd.pod')
-rwxr-xr-x | Master/tlpkg/tlperl.straw/lib/XML/LibXML/Dtd.pod | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/Master/tlpkg/tlperl.straw/lib/XML/LibXML/Dtd.pod b/Master/tlpkg/tlperl.straw/lib/XML/LibXML/Dtd.pod new file mode 100755 index 00000000000..d0b29904c23 --- /dev/null +++ b/Master/tlpkg/tlperl.straw/lib/XML/LibXML/Dtd.pod @@ -0,0 +1,102 @@ +=head1 NAME + +XML::LibXML::Dtd - XML::LibXML DTD Handling + +=head1 SYNOPSIS + + + + use XML::LibXML; + + $dtd = XML::LibXML::Dtd->new($public_id, $system_id); + $dtd = XML::LibXML::Dtd->parse_string($dtd_str); + $publicId = $dtd->getName(); + $publicId = $dtd->publicId(); + $systemId = $dtd->systemId(); + +=head1 DESCRIPTION + +This class holds a DTD. You may parse a DTD from either a string, or from an +external SYSTEM identifier. + +No support is available as yet for parsing from a filehandle. + +XML::LibXML::Dtd is a sub-class of L<<<<<< XML::LibXML::Node >>>>>>, so all the methods available to nodes (particularly toString()) are available +to Dtd objects. + + +=head1 METHODS + +=over 4 + +=item new + + $dtd = XML::LibXML::Dtd->new($public_id, $system_id); + +Parse a DTD from the system identifier, and return a DTD object that you can +pass to $doc->is_valid() or $doc->validate(). + + + + my $dtd = XML::LibXML::Dtd->new( + "SOME // Public / ID / 1.0", + "test.dtd" + ); + my $doc = XML::LibXML->new->parse_file("test.xml"); + $doc->validate($dtd); + + +=item parse_string + + $dtd = XML::LibXML::Dtd->parse_string($dtd_str); + +The same as new() above, except you can parse a DTD from a string. Note that +parsing from string may fail if the DTD contains external parametric-entity +references with relative URLs. + + +=item getName + + $publicId = $dtd->getName(); + +Returns the name of DTD; i.e., the name immediately following the DOCTYPE +keyword. + + +=item publicId + + $publicId = $dtd->publicId(); + +Returns the public identifier of the external subset. + + +=item systemId + + $systemId = $dtd->systemId(); + +Returns the system identifier of the external subset. + + + +=back + +=head1 AUTHORS + +Matt Sergeant, +Christian Glahn, +Petr Pajas + + +=head1 VERSION + +1.70 + +=head1 COPYRIGHT + +2001-2007, AxKit.com Ltd. + +2002-2006, Christian Glahn. + +2006-2009, Petr Pajas. + +=cut |