XML::LibXML has plenty of buzz around it, but frankly, when I had some free time, I reached for XML::Twig. The docs for XML::LibXML are really not user-level on CPAN.. did I miss something somewhere? In comparison mirod has a full website with years of documentation and code samples for Twig. Twig may be slower, but it has years of real-world problem-solving behind it.

Not only that but mirod is very responsive. So, I think I will just take the speed hit that I have to suffer with Twig but gain the benefits of copious docs and responsive author.

  • Comment on XML::LibXML seems to be under-documented

Replies are listed 'Best First'.
Re: XML::LibXML seems to be under-documented
by merlyn (Sage) on Mar 29, 2007 at 15:10 UTC
    Ahh, princepawn, you haven't changed at all! Welcome back.

    You've even started with a complaint! How fitting!

    The biggest problem I've found with the docs for XML::LibXML is that I have to keep in mind the @ISA hierarchy, and remember that a Document @ISA Node, for example. But I've never actually found the docs lacking any essential information that I couldn't quickly test to confirm.

    If you're happy with Twig, stay with it. Don't use XML::LibXML. You might not even know what to do with all that speed increase or additional features. But a post like this one you just made just shows more about your ignorance and drama-queen nature than anything else. It's not a constructive complaint. More of a whine.

    For example, here's a post that might have covered the same ground, and got you somewhere:

    Hi, I like some of the features I'm seeing in XML::LibXML, but I find the documentation lacking. Are there places where I can ask more questions, or see more examples, to help me understand better? Oh, and is the author available for comments about the docs? Thank you.
    And you would have been offered help here, and been pointed to the perl-xml mailing list, where the author frequently answers questions and does indeed update the docs when given specific pointers. You might also have been pointed to a few of my columns where I use XML::LibXML.

    But that's not what you did. Welcome back, princepawn. :)

    -- Randal L. Schwartz, Perl hacker

[reply]

      The biggest problem I've found with the docs for XML::LibXML is that I have to keep in mind the @ISA hierarchy, and remember that a Document @ISA Node, for example. But I've never actually found the docs lacking any essential information that I couldn't quickly test to confirm.

      IMHO, that's a problem with the DOM specification, not LibXML itself. Too much junk in there trying to be language-agnostic. And yet you still can't get a BF implementation . . .

      "There is no shame in being self-taught, only in not trying to learn in the first place." -- Atrus, Myst: The Book of D'ni.

[reply]

Back to Meditations