develooper Front page | perl.perl5.porters | Postings from July 2013

Re: The value of a good perldelta (was Fwd: upcoming release of 5.18.1)

Thread Previous | Thread Next
From:
Darin McBride
Date:
July 25, 2013 21:44
Subject:
Re: The value of a good perldelta (was Fwd: upcoming release of 5.18.1)
Message ID:
3158791.ajpvjq6KC2@naboo
On Thursday July 25 2013 3:27:02 PM David Golden wrote:
> Tom Hukins sent me a very nice note off-list thanking me for
> assembling a list of bug fixes for possible backporting.
> 
> I'm copying it back to the list to make a bigger point about perldelta 
hygiene:

All sorts of good points elided.

Might I suggest a patch, with a good perldelta-style commit message :), to 
somewhere that other people who don't contribute regularly and might otherwise 
miss (or forget about) this email might be reasonably expected to look?

For example, I'm slowly trying to come up with a patch for one of my old bug 
reports.  I don't do this very often.  So, I need to find a pod file with 
advice.  The best I've found is perlgit, so that's where I'm looking.  Adding 
this recommendation for commit messages, especially if it includes _how_ to 
submit those commit changes as part of the patch email (I didn't realise at 
first that some would take my patch email as-is and make that the commit 
message), would be highly welcomed by those with short memories like me :)

Also, I think there are references to commit messages in perlgit already that 
don't necessarily live up to this standard.  And that may make sense for 
examples, but linking to a section that describes rules for commit messages 
and how this is just an example... may be a nice change, too.

Thanks,
Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About