Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.

Bad docs 10 Comments More | Login | Reply /

 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.

  • be brave! (Score:1)

    by gav (2710) on 2002.10.28 15:27 (#14308) Homepage Journal
    Name that module!

    My vote for bad module of the day is Ananke::Template [cpan.org] which is just a bad imitation of TT.

    • But that's not the only bad imitation of TT. Look at HTML::KTemplate [cpan.org] as well. Like most of the worst of TT mixed with HTML::Template. Ick.
      --
      • Randal L. Schwartz
      • Stonehenge
      • Ick. The only thing worse than inventing the wheel is doing it badly.

        I may have to start scouring the depths of CPAN for a "bad module of the week". This may help the Schwartz factor a bit :)

        • It would probably be nice to give the authors a chance
          to clean up their module before announcing their shame.

          Otherwise you'll just become loathed =)
          --
            ---ict / Spoon
        • Along these lines, I nominate Text::Macros. It has documentation more or less sufficient for what it does, but what it does is crummy. I think the author released it (four versions!) without ever bothering to finish it.

    • No can do. The module itself appears to be useful and some checking around reveals that others are using it (though not very widely). If it was a bad module, I don't mind calling a spade a spade. I just want to be sure that I'm being decent and not trashing a good module just because someone didn't do a good job of communicating. Let's face it, programmers who write great code are often known for being less than diligent about their docs :)

      Amusingly, I found a tutorial for using this module that was e

      • I don't feel too bad about rewriting it (it only took me about 3 hours)

        Yeah, the great thing about Perl is how easy it is to write stuff. I think that is an important reason for the success of CPAN -- it is easy to add stuff, because it's easy to write in the first place! Syntax *is* important (take that, lisp fans)!
      • Is this, by any chance, NetAddr::IP?

        Not being a native english speaker, and having a tutorial online at The Perl Monastery [perlmonks.org], it would not surprise me.

        If it is indeed one of my modules, I would want to know.

        Regards.

        -lem

        --

        -lem [cantv.net]

    • Hi, Yeah, is one imitation of TT, but, Ananke::Template use only 200k of memory and TT use 2M, imagine 100 modperl using with persistent connection... Anake::Template is very very very speedy and small. Now i have other module, NTS::Template (Ananke::Template rewrite), is more stable, speedy and use less memory... but documentation is bad my english is bad ;) bye
Stories, comments, journals, and other submissions on use Perl; are Copyright 1998-2006, their respective owners.