Doc::Perlish::DOM - Represent a Perldoc document, DOM-style

 $kwoc = new Doc::Perlish::DOM();

 my $body = $kwoc->root();
 my @next = $body->daughters();

 my $node = $kwoc->klink("S09#//para/");  # KLINK lookup

A Doc::Perlish::DOM is a directed acyclic graph, which is a Computer Scientist's way of saying "tree" (cue: the Fast Show "aliens that say 'tree' skit").

Doc::Perlish::DOM trees are seldom created using the Tree::DAG_Node interface.

Normally, they will be constructed as a series of events fired in by a Doc::Perlish::Sender, such as another Perldoc::DOM, a Doc::Perlish::Preprocessor, or a Perldoc::Parser.

$dom->receiver($object)

$dom->send_one()

$dom->send_all()

Doc::Perlish::DOM supports the Perldoc::Sender API.

$dom->restart()

>Clear the state of the Doc::Perlish::Sender, useful for guaranteeing that you don't get a partial tree out of your DOM object.

$dom->start_document()

$dom->end_document()

$dom->start_element($name, \%o)

$dom->end_element([$name])

$dom->characters($data, [\%o])

$dom->processing_instruction([\%o])

$dom->ignorable_whitespace([\%o])

Supports the Doc::Perlish::Receiver API.

$dom->make_element($name, \%o)

$dom->make_text($data, [\%o])

$dom->make_pi(\%o)

$dom->make_ws(\%o)

Sub-classes of Doc::Perlish::DOM may wish to override these methods, which are called when creating nodes during DOM tree construction.