NAME

    XML::Twig - Tree interface to XML documents allowing processing chunk
                by chunk of huge documents.

WARNING

  If you are upgrading from XML::Twig 2.02 please look at the Changes file
  for important information about potential incompatibilities between the 2 
  versions.
                

SUMMARY (see perldoc XML::Twig for full details)


    single-tree mode    
        my $t= XML::Twig->new();
        $t->parsefile( 'doc.xml');
        $t->print;

    chunk mode 
        my $t= XML::Twig->new( TwigHandlers => { section => \&flush});
        $t->parsefile( 'doc.xml');
        $t->flush;
        sub flush { $_[0]->flush; }
    
    sub-tree mode 
        # print all title's in the document
        my $t= XML::Twig->new( TwigRoots => { title => 1 },
                               TwigHandlers => { title => \&list});
        $t->parsefile( 'doc.xml');
        sub list { print $_->print . "\n"; }
    
INSTALLATION

    perl Makefile.PL
    make
    make test
    make install

DEPENDANCIES

    XML::Twig needs XML::Parser (and the expat library) installed
   
    Modules that can enhanced XML::Twig are

    Scalar::Util or WeakRef 
      to avoid memory leaks
    Encode or Text::Iconv or Unicode::Map8i and Unicode::Strings 
      to do encoding conversions
    Tie::IxHash 
      to use the keep_atts_order option
    XML::XPath 
      to use XML::Twig::XPath
    LWP 
      to use parseurl
    HTML::Entities
      to use the html_encode filter

CHANGES

    $Id: README,v 1.3 2004/01/09 23:15:20 mrodrigu Exp $

    See the Changes file    

AUTHOR

    Michel Rodriguez (mirod@xmltwig.com)
    The Twig page is at http://www.xmltwig.com/ 
    See the XML::Twig tutorial at http://www.xmltwig.com/xmltwig/tutorial/index.html

COPYRIGHT

       Copyright (c) 1999-2002, Michel Rodriguez. All Rights Reserved.
     This module is free software. It may be used, redistributed
     and/or modified under the terms of the Perl Artistic License
          (see http://www.perl.com/perl/misc/Artistic.html)
