Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl-Sensitive Sunglasses
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??
The next thing to do is to go and download all of my modules and fix them ;-)

Seriously though, if the module has a mailing list, use that.

If the bugs are open on it's http://rt.cpan.org page, send patches there.

In all other cases send the patch directly to the author.

I don't think there is any code for communication, just be polite and good natured, and be sure to explain exactly what problem you're fixing, and how you're fixing it.

When sending patches try to follow the coding style of the author, like tabs vs. spaces, or my $self = shift vs my ($self, $param) = @_, and so on. This saves the author some time fixing it up, and the code is readable to them without any work.

Also be sure to use the project's version control system if it has one. svk and darcs have the capability to submit patches via email, and it just works. Other VCSs have their own diff formats, which can be easily applied. When in doubt, send a unified diff, and no other format.

Keep in mind that your work should be appreciated, because it counts. In fact, I think that by simply submitting you've already done your part.

If you feel that the author isn't paying attention, post the patch on your website, and remind them a bit. If the patch is not a specific case, but one that applies to everyone, especially a bug fix, then it should be applied, but do keep in mind that sometimes for reasons of bloat or feature creep your patch might be rejected. If you feel it appropriate, a fork of the project (like Catalyst / Maypole, for example) might be in order.

That's all I've got to say. Thank you for helping out!

-nuffin
zz zZ Z Z #!perl

In reply to Re: Helping with CPAN modules by nothingmuch
in thread Helping with CPAN modules by shemp

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 sharing their wisdom with the Monastery: (7)
As of 2024-04-19 20:35 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found