NAME

SGML::Parser::OpenSP - Parse SGML Using the OpenSP Generic API

SYNOPSIS

use SGML::Parser::OpenSP;

my $Parser = SGML::Parser::OpenSP->new('example.html');
my $Result = $Parser->parse();

# $Result now contains a data structure representing the
# document tree (nothing so fancy as a DOM, just a tree).

ABSTRACT

SGML::Parser::OpenSP is a Perl XS interface to the OpenSP "generic"
API. This is a limited interface to the OpenSP SGML and XML Parser
from <http://openjade.sf.net/>.

DESCRIPTION

This isn't even alpha quality code yet. Released only in the hopes of
garnering patches to actually make it do something usefull. :-)

In fact, this was my project to learn a little C++ and XS so you can
pretty much imagine what the code looks like. So when I say patches
are welcome, I mean patches are *welcome*! :-)

LIMITATIONS

This code is pretty much all non-functional as yet!

For one thing it will only parse XML (which is weird since OpenSP is
mainly an SGML Parser) and has very few facilities for managing SGML
Declarations, DTDs, and Catalogs.

As it stands there is very little chance that you will be able to
actually use this module in a program; it passes its own tests (in
the t/ directory) but that is pretty much all it's usefull for.

You shouldn't bother looking at this module unless you want to help
improve it to the point where it can actually be used for something.

If you want a module like this but cannot help developing it, please
drop me a note (email is below) and let me know! I need this module
for my own projects but it has low priority for me; if others were to
express an interest it might make me spend more time on improving it.

EXPORT

None by default.

SEE ALSO

The OpenJade project - <http://openjade.sf.net/>

The "onsgmls" man page.

AUTHOR

Terje Bless <link@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2003 by Terje Bless

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.