* Jim Cromie <[EMAIL PROTECTED]> [2003-12-01 00:04]: > attached is 8k of module code (small enough to just send ?)
Please don't. The list probably has a lot of subscribers, and it's not likely that all of them were going to download your module and look at it. You have just wasted the list's mail hub's bandwidth. And the fact that the code you posted has compilation errors turns a nuisance into an offense. Put it up somewhere on the web and just post a link instead. > with the candidate name; > > Data::Dumper::Functor It didn't make the purpose of the module any clearer to me. I had to read the docs to find out. > This is a structural name, but other candidates are too > ambiguous, and somewhat presumptuous; > > DD::Easy, DD::Auto, DD::Lazy, DD::Brief They're undescriptive indeed. ::Easy probably fits your goals better than any of the other suggestions though, including ::Functor. You probably want ::SimpleAPI or something along these lines. > BTW - it has a package main section at bottom, you can just run > it to see a simple sanity-test. This is not a good idea, even with the ugly $0-check hack. Learn how to build a proper module distribution (it isn't hard at all) and then provide a regular test suite. I don't think the rather long IMPLEMENTATION section belongs in your docs. Most of it should be obvious from the code, and the rest should be squirreled away in a handful of short comments. -- Regards, Aristotle "If you can't laugh at yourself, you don't take life seriously enough."
