or a function you're supposed to write it yourself.

XML::Rules does show read_chunk_of_data() in documentation for parse_chunk()

I've got no idea why you wrote that. There is no suggestion by anyone that it doesn't appear in the documentation. Perhaps you could elaborate on what you meant.

I have changed "write it yourself" to "write yourself" which is what I originally intended; however, I can't see that either form changes the meaning with respect to what appears in the documentation.

I don't remember :) I guess it seems obvious its a function you're supposed to write yourself -- so yeah, what you said is pretty much spot on , except the appear that's poorly documented portion, because that seems like pretty good documentation to me

I don't remember :) I guess it seems obvious its a function you're supposed to write yourself -- so yeah, what you said is pretty much spot on ,

No worries - we appear to be on the same page as far as that goes.

except the appear that's poorly documented portion, because that seems like pretty good documentation to me

Just to clarify, "It would appear that's poorly documented" (by me) only referred to the sample code under parse_chunk and was in response to the OP's "I copied the 'example' straight out of CPAN ...". The function read_chunk_of_data() appears amidst two other functions, parse_chunk() and last_chunk(), with no clear distinction between those last two being provided by the module and the first not being so provided. [read_chunk_of_data() also appears under filter_chunk in much the same context.]

Overall, I personally have no problem with the documentation. The example code I wrote in my original response was purely from the documentation and only took a minute or two despite never having used XML::Rules.

-- Ken