parse (input handler)
The return value of this function is determined by the handler argument; see below.
Parse the HTML document given as an argument, or referred to using a pathname.
input can have one of the following types:
If handler is nil, the parser's internal representation of the document is returned. The result is equivalent to that returned using a PT builder as returned by make-pt-builder, but avoids creating the same representation twice.
Alternatively, handler can be a HAX handler (see hax:abstract-handler) or a SAX handler (see the SAX protocol in cxml). In this case, the document will be serialized to the specified handler, and the result of hax:end-document will be returned from this function. Note that the parser will currently always process the entire document before sending the first HAX event.