| Subject: | Documentation for tree/element traversal is conflicting/confusing |
From HTML::Element:
`The most straightforward way to look over a tree is to "traverse" it;
an HTML::Element method ($h->traverse) is provided for this purpose; and
several other HTML::Element methods are based on it.`
A little below:
`Lengthy discussion of HTML::Element's unnecessary and confusing
traverse method has been moved to a separate file: HTML::Element::traverse`
HTML::Element::traverse itself mentions that it's deprecated.
Would be great to deprecate "traverse" everywhere and perhaps have a
piece of sample code for traversing.