{"thread":{"id":"23374","subject":"[PATCH v2] Documentation/SubmittingPatches: Clarify Gmail section","startedAt":"2010-04-07T19:33:12Z","lastAt":"2010-04-07T22:59:17Z","messageCount":7,"participants":["Ramkumar Ramachandra","Junio C Hamano","Jacob Helwig","Jon Seymour"],"isPatch":true,"patchVersion":2,"patchTotal":null},"messages":[{"id":"138882","messageId":"1270668793-2187-1-git-send-email-artagnon@gmail.com","threadId":"23374","inReplyTo":null,"subject":"[PATCH v2] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Ramkumar Ramachandra","fromEmail":"artagnon@gmail.com","sentAt":"2010-04-07T19:33:12Z","receivedAt":"2010-04-07T19:33:12Z","isPatch":true,"sender":{"key":"r@artagnon.com","avatar":"https://avatars.githubusercontent.com/u/37226?v=4"},"body":"I made a mistake. Junio pointed out that the Gmail web interface wraps\nlines no matter what. Using \"git imap-send\" doesn't help.\n"},{"id":"138883","messageId":"1270668793-2187-2-git-send-email-artagnon@gmail.com","threadId":"23374","inReplyTo":"1270668793-2187-1-git-send-email-artagnon@gmail.com","subject":"[PATCH] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Ramkumar Ramachandra","fromEmail":"artagnon@gmail.com","sentAt":"2010-04-07T19:33:13Z","receivedAt":"2010-04-07T19:33:13Z","isPatch":true,"sender":{"key":"r@artagnon.com","avatar":"https://avatars.githubusercontent.com/u/37226?v=4"},"body":"The web interface mangles patches no matter what. Replace paragraph\nabout \"git imap-send\" with another one about \"git send-email\".\n\nSigned-off-by: Ramkumar Ramachandra <artagnon@gmail.com>\n---\n Documentation/SubmittingPatches |   53 +++++++++++++++-----------------------\n 1 files changed, 21 insertions(+), 32 deletions(-)\n\ndiff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\nindex c686f86..8193a5b 100644\n--- a/Documentation/SubmittingPatches\n+++ b/Documentation/SubmittingPatches\n@@ -517,35 +517,24 @@ message, complete the addressing and subject fields, and press send.\n Gmail\n -----\n \n-GMail does not appear to have any way to turn off line wrapping in the web\n-interface, so this will mangle any emails that you send.  You can however\n-use any IMAP email client to connect to the google imap server, and forward\n-the emails through that.  Just make sure to disable line wrapping in that\n-email client.  Alternatively, use \"git send-email\" instead.\n-\n-Submitting properly formatted patches via Gmail is simple now that\n-IMAP support is available. First, edit your ~/.gitconfig to specify your\n-account settings:\n-\n-[imap]\n-\tfolder = \"[Gmail]/Drafts\"\n-\thost = imaps://imap.gmail.com\n-\tuser = user@gmail.com\n-\tpass = p4ssw0rd\n-\tport = 993\n-\tsslverify = false\n-\n-You might need to instead use: folder = \"[Google Mail]/Drafts\" if you get an error\n-that the \"Folder doesn't exist\".\n-\n-Next, ensure that your Gmail settings are correct. In \"Settings\" the\n-\"Use Unicode (UTF-8) encoding for outgoing messages\" should be checked.\n-\n-Once your commits are ready to send to the mailing list, run the following\n-command to send the patch emails to your Gmail Drafts folder.\n-\n-\t$ git format-patch -M --stdout origin/master | git imap-send\n-\n-Go to your Gmail account, open the Drafts folder, find the patch email, fill\n-in the To: and CC: fields and send away!\n-\n+GMail does not have any way to turn off line wrapping in the web\n+interface, so this will mangle any emails that you send.  You can\n+either configure an email client that that doesn't break lines to use\n+the GMail SMTP server, or use \"git send-email\" to achieve the same\n+effect.\n+\n+To use \"git send-email\", edit ~/.gitconfig to specify your account\n+settings:\n+\n+[sendemail]\n+\tsmtpencryption = tls\n+\tsmtpserver = smtp.gmail.com\n+\tsmtpuser = user@gmail.com\n+\tsmtppass = p4ssw0rd\n+\tsmtpserverport = 587\n+\n+Once your commits are ready to send to the mailing list, run the\n+following commands:\n+\n+\t$ git format-patch --no-color -C -M origin/master -o outgoing/\n+\t$ git send-email --compose outgoing/*\n-- \n1.7.0.3\n"},{"id":"138887","messageId":"7vwrwjav4h.fsf@alter.siamese.dyndns.org","threadId":"23374","inReplyTo":"1270668793-2187-2-git-send-email-artagnon@gmail.com","subject":"Re: [PATCH] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2010-04-07T20:02:54Z","receivedAt":"2010-04-07T20:02:54Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Ramkumar Ramachandra <artagnon@gmail.com> writes:\n\n> The web interface mangles patches no matter what. Replace paragraph\n> about \"git imap-send\" with another one about \"git send-email\".\n\nMy impression has been that people are using MUAs that do not corrupt\npatches and are capable of using IMAP drafts folders with Gmail, without\never touching their patch-breaking web interface, and the description you\nremoved was meant for them.\n\nIs the web interface the _only_ way to interact with IMAP drafts on Gmail?\nIf that is the case, your patch (or Aaron's earlier attempt) to make the\ndocument not to talk about imap-send in the context of Gmail makes sense.\n\nEven if it were not the case, as long as only very few people use IMAP\ndrafts on Gmail via MUAs not their web interface, I am fine with your\nchange to add send-email recipe to help Gmail users.\n\n> +GMail does not have any way to turn off line wrapping in the web\n> +interface, so this will mangle any emails that you send.  You can\n> +either configure an email client that that doesn't break lines to use\n> +the GMail SMTP server, or use \"git send-email\" to achieve the same\n> +effect.\n> +\n> +To use \"git send-email\", edit ~/.gitconfig to specify your account\n> +settings:\n> +\n> +[sendemail]\n> +\tsmtpencryption = tls\n> +\tsmtpserver = smtp.gmail.com\n> +\tsmtpuser = user@gmail.com\n> +\tsmtppass = p4ssw0rd\n> +\tsmtpserverport = 587\n> +\n> +Once your commits are ready to send to the mailing list, run the\n> +following commands:\n> +\n> +\t$ git format-patch --no-color -C -M origin/master -o outgoing/\n> +\t$ git send-email --compose outgoing/*\n"},{"id":"138888","messageId":"x2m8c9a061004071306n807b8010i12983bb2d6a144f9@mail.gmail.com","threadId":"23374","inReplyTo":"7vwrwjav4h.fsf@alter.siamese.dyndns.org","subject":"Re: [PATCH] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Jacob Helwig","fromEmail":"jacob.helwig@gmail.com","sentAt":"2010-04-07T20:06:42Z","receivedAt":"2010-04-07T20:06:42Z","isPatch":true,"sender":{"key":"jacob.helwig@gmail.com","avatar":"https://avatars.githubusercontent.com/u/14557?v=4"},"body":"On Wed, Apr 7, 2010 at 13:02, Junio C Hamano <gitster@pobox.com> wrote:\n> My impression has been that people are using MUAs that do not corrupt\n> patches and are capable of using IMAP drafts folders with Gmail, without\n> ever touching their patch-breaking web interface, and the description you\n> removed was meant for them.\n>\n> Is the web interface the _only_ way to interact with IMAP drafts on Gmail?\n> If that is the case, your patch (or Aaron's earlier attempt) to make the\n> document not to talk about imap-send in the context of Gmail makes sense.\n>\n\nThe web interface isn't the only way.  I use the IMAP drafs all the\ntime with mutt, and most mutt + gmail instructions I've seen online\nsetup this behavior.\n\n> Even if it were not the case, as long as only very few people use IMAP\n> drafts on Gmail via MUAs not their web interface, I am fine with your\n> change to add send-email recipe to help Gmail users.\n>\n"},{"id":"138889","messageId":"y2gf3271551004071318zb4ed7ef6o93a6c98c6009d8df@mail.gmail.com","threadId":"23374","inReplyTo":"7vwrwjav4h.fsf@alter.siamese.dyndns.org","subject":"Re: [PATCH] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Ramkumar Ramachandra","fromEmail":"artagnon@gmail.com","sentAt":"2010-04-07T20:18:33Z","receivedAt":"2010-04-07T20:18:33Z","isPatch":true,"sender":{"key":"r@artagnon.com","avatar":"https://avatars.githubusercontent.com/u/37226?v=4"},"body":"> Is the web interface the _only_ way to interact with IMAP drafts on Gmail?\n> If that is the case, your patch (or Aaron's earlier attempt) to make the\n> document not to talk about imap-send in the context of Gmail makes sense.\n\nNo. An email client can sync with the drafts folder in GMail over\nIMAP. However, sending the final email has to be done over SMTP.\nThe effect of \"git imap-send\" can be replicated by copy-pasting text\ninto the email client's compose interface. So, using \"git imap-send\"\nseems like a bit of a roundabout way to me. There are some usecases\nthough (like queuing up patches as drafts before sending): so I'll add\na paragraph about this in my next revision.\n\n-- Ram\n"},{"id":"138899","messageId":"k2m2cfc40321004071523z8c036cccs12302a70f25bb413@mail.gmail.com","threadId":"23374","inReplyTo":"y2gf3271551004071318zb4ed7ef6o93a6c98c6009d8df@mail.gmail.com","subject":"Re: [PATCH] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Jon Seymour","fromEmail":"jon.seymour@gmail.com","sentAt":"2010-04-07T22:23:22Z","receivedAt":"2010-04-07T22:23:22Z","isPatch":true,"sender":{"key":"jon.seymour@gmail.com","avatar":"https://avatars.githubusercontent.com/u/207131?v=4"},"body":"On Thu, Apr 8, 2010 at 6:18 AM, Ramkumar Ramachandra <artagnon@gmail.com> wrote:\n>> Is the web interface the _only_ way to interact with IMAP drafts on Gmail?\n>> If that is the case, your patch (or Aaron's earlier attempt) to make the\n>> document not to talk about imap-send in the context of Gmail makes sense.\n>\n> No. An email client can sync with the drafts folder in GMail over\n> IMAP. However, sending the final email has to be done over SMTP.\n> The effect of \"git imap-send\" can be replicated by copy-pasting text\n> into the email client's compose interface. So, using \"git imap-send\"\n> seems like a bit of a roundabout way to me. There are some usecases\n> though (like queuing up patches as drafts before sending): so I'll add\n> a paragraph about this in my next revision.\n>\n> -- Ram\n> --\n\ngit imap-send has far less manual steps than cut and pasting into an\ne-mail client, so it is certainly preferable to cut-and-paste which\nseems particularly error prone.\n\nPerhaps the words could be changed to something like:\n\nIf you do want to use the imap-send option with Gmail you MUST use an\nIMAP client that does not line wrap to do any final polishing of the\npatch e-mails prior to submitting them to the list. If you use the\ngmail web interface to edit the draft  messages in any way, line\nwrapping WILL occur.\n\njon.\n"},{"id":"138902","messageId":"7v4ojmc1iy.fsf@alter.siamese.dyndns.org","threadId":"23374","inReplyTo":"k2m2cfc40321004071523z8c036cccs12302a70f25bb413@mail.gmail.com","subject":"Re: [PATCH] Documentation/SubmittingPatches: Clarify Gmail section","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2010-04-07T22:59:17Z","receivedAt":"2010-04-07T22:59:17Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jon Seymour <jon.seymour@gmail.com> writes:\n\n> Perhaps the words could be changed to something like:\n>\n> If you do want to use the imap-send option with Gmail you MUST use an\n> IMAP client that does not line wrap to do any final polishing of the\n> patch e-mails prior to submitting them to the list. If you use the\n> gmail web interface to edit the draft  messages in any way, line\n> wrapping WILL occur.\n\nMuch better, but my understanding is that \"in any way\" includes not\ntouching anything but just specifying the addressee.  So perhaps something\nlike this is needed:\n\n-- >8 --\nSubject: SubmittingPatches: update GMail section\n\nEven if you use imap-send to throw your drafts in the outbox, using their\nweb interface will mangle your patches.  Clarify that the imap-send is\nmeant to be used together with a real MUA that can use IMAP drafts, and\nremove instructions related to the web interface, which is irrelevant.\n\nAdd description of send-email as an alternative.\n\nUse --cover-letter, and do not use -C nor --no-color, on the example\ncommand line for format-patch.\n\nSigned-off-by: Junio C Hamano <gitster@pobox.com>\n---\n Documentation/SubmittingPatches |   35 ++++++++++++++++++++++++-----------\n 1 files changed, 24 insertions(+), 11 deletions(-)\n\ndiff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\nindex c686f86..abc65de 100644\n--- a/Documentation/SubmittingPatches\n+++ b/Documentation/SubmittingPatches\n@@ -520,11 +520,9 @@ Gmail\n GMail does not appear to have any way to turn off line wrapping in the web\n interface, so this will mangle any emails that you send.  You can however\n use any IMAP email client to connect to the google imap server, and forward\n-the emails through that.  Just make sure to disable line wrapping in that\n-email client.  Alternatively, use \"git send-email\" instead.\n+the emails through that.\n \n-Submitting properly formatted patches via Gmail is simple now that\n-IMAP support is available. First, edit your ~/.gitconfig to specify your\n+To submit using the IMAP interface, first, edit your ~/.gitconfig to specify your\n account settings:\n \n [imap]\n@@ -538,14 +536,29 @@ account settings:\n You might need to instead use: folder = \"[Google Mail]/Drafts\" if you get an error\n that the \"Folder doesn't exist\".\n \n-Next, ensure that your Gmail settings are correct. In \"Settings\" the\n-\"Use Unicode (UTF-8) encoding for outgoing messages\" should be checked.\n+Once your commits are ready to be sent to the mailing list, run the\n+following command to send the patch emails to your Gmail Drafts\n+folder.\n \n-Once your commits are ready to send to the mailing list, run the following\n-command to send the patch emails to your Gmail Drafts folder.\n+  $ git format-patch --cover-letter -M --stdout origin/master | git imap-send\n \n-\t$ git format-patch -M --stdout origin/master | git imap-send\n+Just make sure to disable line wrapping in the email client (GMail web\n+interface will line wrap no matter what, so you need to use a real\n+IMAP client).\n \n-Go to your Gmail account, open the Drafts folder, find the patch email, fill\n-in the To: and CC: fields and send away!\n+Alternatively, you can use \"git send-email\" and send your patches\n+through the GMail SMTP server.  edit ~/.gitconfig to specify your\n+account settings:\n+\n+[sendemail]\n+\tsmtpencryption = tls\n+\tsmtpserver = smtp.gmail.com\n+\tsmtpuser = user@gmail.com\n+\tsmtppass = p4ssw0rd\n+\tsmtpserverport = 587\n+\n+Once your commits are ready to be sent to the mailing list, run the\n+following commands:\n \n+  $ git format-patch --cover-letter -M origin/master -o outgoing/\n+  $ git send-email outgoing/*\n"}]}