I think part of the problem is that baffled, frustrated people who are just getting started with XML see something called XML::Simple and think it's the answer to all their prayers.

Hoping that something will be both simple and the "answer to all their prayers" is surely a bit naiive. Take for example LWP::Simple. It certainly provides a simple API for retrieving web-based objects but if the "answer to all your prayers" requires cookie, proxy and authentication support then you've just outgrown the simple API and you have to learn a whole new one. Similarly if/when you outgrow XML::Simple, you need to move up to something offering more fine-grained control, such as XML::LibXML.

Maybe I could/should suggest putting this one particular issue in the POD?

The most common complaint I get about the XML::Simple documentation is that there is too much of it. Seriously. People email me with a question that they strongly suspect is answered in the POD but there is so much POD that it's quicker to email me (or post on PM) than sit down and read it.

But you're right, I could improve the POD's coverage of round-tripping.

And you know what? I just clicked on the link to the XML::Simple::FAQ on search.cpan.org and it's a 404

That is odd. If I go to the main screen for the XML::Simple distribution then the link works. But that's a little bit of a red-herring - why search the web for documentation that's already on your hard drive? Especially when the one you find on the web might be for a different version than the software you have installed

OK I was being facetious about the "answer to all their prayers" thing.

The 404 comes when I use search.cpan.org, find this page http://search.cpan.org/~grantm/XML-Simple-2.09/lib/XML/Simple.pm and then see this link at the bottom http://search.cpan.org/perldoc?XML%3A%3ASimple%3A%3AFAQ.

And the FAQ isn't on my hard drive, it may or may not be on a web server someone else owns and which I don't have command-line access to. Lots of people code that way, like it or not.

Here's a question for the ages -- why isn't XML::Simple the top hit when I search CPAN for "XML::Simple"?

But I'm going to stop being facetious now and say thank you for responding and having written the module. It was the answer to a good 80% of my prayers, right out of the box!

---




($_='kkvvttuubbooppuuiiffssqqffssmmiibbddllffss')
 =~y~b-v~a-z~s;                             print
[download]