From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jeremy White Subject: [PATCH] Update documentation to add further information about using Thunderbird with git-imap-send. Date: Thu, 12 Feb 2009 09:51:12 -0600 Message-ID: <49944570.1020805@codeweavers.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Thu Feb 12 16:53:22 2009 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1LXdrm-0004fk-Su for gcvg-git-2@gmane.org; Thu, 12 Feb 2009 16:52:43 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754110AbZBLPvP (ORCPT ); Thu, 12 Feb 2009 10:51:15 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1752143AbZBLPvP (ORCPT ); Thu, 12 Feb 2009 10:51:15 -0500 Received: from mail.codeweavers.com ([216.251.189.131]:46794 "EHLO mail.codeweavers.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751107AbZBLPvO (ORCPT ); Thu, 12 Feb 2009 10:51:14 -0500 Received: from localhost ([127.0.0.1] helo=[216.251.189.140] ident=stunnel4) by mail.codeweavers.com with esmtp (Exim 4.63) (envelope-from ) id 1LXdqL-0002Vn-Se for git@vger.kernel.org; Thu, 12 Feb 2009 09:51:13 -0600 User-Agent: Mozilla-Thunderbird 2.0.0.16 (X11/20080724) X-Enigmail-Version: 0.95.0 Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: Signed-off-by: Jeremy White --- Documentation/SubmittingPatches | 27 +++++++++++++++++++++++++++ Documentation/git-imap-send.txt | 14 ++++++++++++++ 2 files changed, 41 insertions(+), 0 deletions(-) diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches index ba07c8c..add055e 100644 --- a/Documentation/SubmittingPatches +++ b/Documentation/SubmittingPatches @@ -376,9 +376,36 @@ Thunderbird (A Large Angry SCM) +By default, Thunderbird will both wrap emails as well as flag them as +being 'format=flowed', both of which will make the resulting email unusable +by git. + Here are some hints on how to successfully submit patches inline using Thunderbird. +There are two different approaches. One approach is to configure +Thunderbird to not mangle patches. The second approach is to use +an external editor to keep Thunderbird from mangling the patches. + +Approach #1 (configuration): + +This recipe is current as of Thunderbird 2.0.0.19. Three steps: + 1. Configure your mail server composition as plain text + Edit...Account Settings...Composition & Addressing, + uncheck 'Compose Messages in HTML'. + 2. Configure your general composition window to not wrap + Edit..Preferences..Composition, wrap plain text messages at 0 + 3. Disable the use of format=flowed + Edit..Preferences..Advanced..Config Editor. Search for: + mailnews.send_plaintext_flowed + toggle it to make sure it is set to 'true'. + +After that is done, you should be able to compose email as you +otherwise would (cut + paste, git-format-patch | git-imap-send, etc), +and the patches should not be mangled. + +Approach #2 (external editor): + This recipe appears to work with the current [*1*] Thunderbird from Suse. The following Thunderbird extensions are needed: diff --git a/Documentation/git-imap-send.txt b/Documentation/git-imap-send.txt index bd49a0a..1685f04 100644 --- a/Documentation/git-imap-send.txt +++ b/Documentation/git-imap-send.txt @@ -98,6 +98,20 @@ Using direct mode with SSL: .......................... +CAUTION +------- +It is still your responsibility to make sure that the email message +sent by your email program meets the standards of your project. +Many projects do not like patches to be attached. Some mail +agents will transform patches (e.g. wrap lines, send them as +format=flowed) in ways that make them fail. You will get angry +flames ridiculing you if you don't check this. + +Thunderbird in particular is known to be problematic. Thunderbird +users may wish to visit this web page for more information: + http://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email + + BUGS ---- Doesn't handle lines starting with "From " in the message body.