Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??

As far as I can tell, the key difference between previous ones (eg: Sex, DNA, Bleach, Buffy) and mine was that XML::Simpler did not contain obfuscated Perl code.

That's not the point. "Sex" is obviously not serious, DNA is useable, and the synopsis makes clear it's just for fun. Both Bleach and Buffy are in the Acme:: namespace, home of useless, but fun modules.

XML::Simpler is in the XML:: namespace, and will be found when anyone searches for XML or XML::Simple. A lot of people want ease of use, and will install XML::Simpler before trying XML::Simple. They'll find out it's useless and might give up on trying other modules, because even the simplest doesn't work.

Had you named it Acme::XML::Simpler, there would be no problem.

As modules can't be deleted easily, I urge you to add a very verbose and clear statement at the top of your POD, add a warning to the code itself, and release version 1.01. Then, request it to be deleted, and if you like, re-submit it under the Acme:: namespace.

I would argue that mine is no more or less useful than the other packages. It does work exactly as the documentation describes.

Have you seen my latest module?

package Null; use v5.6.0 use strict; our $VERSION = '1.00'; __END__ =head1 NAME Null - Does absolutely nothing =head1 SYNOPSIS use Null; =head1 DESCRIPTION This module only sets $Null::VERSION, but does nothing else. =head1 COPYRIGHT None is claimed. This module is released into the public domain. =cut
This module (though untested) does _EXACTLY_ that what is documented. But it should NOT be in CPAN.

U28geW91IGNhbiBhbGwgcm90MTMgY
W5kIHBhY2soKS4gQnV0IGRvIHlvdS
ByZWNvZ25pc2UgQmFzZTY0IHdoZW4
geW91IHNlZSBpdD8gIC0tIEp1ZXJk


In reply to Re: Re: (crazyinsomniac: oh i'm excited) Re: new XML module by Juerd
in thread new XML module by gav^

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others studying the Monastery: (7)
As of 2024-03-28 16:12 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found