A well-intentioned response, I am quite sure, but ... obviously “I've seen this.” :-/

In fact, “this” is what I was referring-to as being deficient.

In the example-section that you quoted, each one of those examples stand alone. They're not in any sort of a sequence. And this is relevant, because the path-adding calls always extend the path:   therefore, when do you extend it? I have not yet stumbled-upon an existing CPAN module that uses it nor its predecessor, which would simplify my task of putting this object to work in the manner that its designer intended.

Alas, an example of “well, it's clear to me, the author...” ‘documentation.’ A short working example of a controller that uses it would be perfect, if I can very-quickly find one.

Thanks for your help.