OK, I have added the link to xmltwig.com both at the beginning and at the end of the module, and made more apparent on the web site that twig_dev.html is the best way to view the docs.

I like your ideas about deprecation, I'll try to nudge users more towards some of the synonyms. gi will stay though ;--) It might be called XML::Twig, but I use it a lot to process SGML, after a quick osx pass.

set_name... you got me there, I had forgotten about that one. Which is not a good sign I guess, when even the author can't remember about an option.

And finally, _you_ don't look half as stupid as the guy who wrote a tutorial but did not make it visible enough and thus spent his time answering questions which answer is in the tutorial...