This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlhack.pod: invoke git-format-patch with --attach
authorJim Cromie <jim.cromie@gmail.com>
Tue, 31 May 2011 16:47:29 +0000 (10:47 -0600)
committerFather Chrysostomos <sprout@cpan.org>
Wed, 1 Jun 2011 13:35:08 +0000 (06:35 -0700)
As George Greer noted on p5p, --attach causes the message to be
written using MIME-attach syntax, so when perlbug sends it,
rt.perl.org detaches the file and adds it to the ticket.

While tradtional inline patches appear to survive without whitespace
mangling, attachments are more in keeping with RTs design and use.

Signed-off-by: Jim Cromie <jim.cromie@gmail.com>
pod/perlhack.pod

index f8f8bdd..6f5ea73 100644 (file)
@@ -56,10 +56,11 @@ sentence. For example, "Fixed spelling errors in perlhack.pod".
 The next step is to submit your patch to the Perl core ticket system
 via email.
 
-Assuming your patch consists of a single git commit, you can send it to
-perlbug with this command line:
+Assuming your patch consists of a single git commit, the following
+writes the file as a MIME attachment, and sends it with a meaningful
+subject:
 
-  % git format-patch -1
+  % git format-patch -1 --attach
   % perlbug -s "[PATCH] $(git log -1 --oneline HEAD)" -f 0001-*.patch
 
 The perlbug program will ask you a few questions about your email