{"thread":{"id":"66880","subject":"[PATCH] doc: wrap emailed text near 70 columns","startedAt":"2026-11-19T10:53:00Z","lastAt":"2026-11-20T05:59:08Z","messageCount":4,"participants":["Okhuomon Ajayi","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"558817","messageId":"20261119105300.95746-1-okhuomonajayi54@gmail.com","threadId":"66880","inReplyTo":null,"subject":"[PATCH] doc: wrap emailed text near 70 columns","fromName":"Okhuomon Ajayi","fromEmail":"okhuomonajayi54@gmail.com","sentAt":"2026-11-19T10:53:00Z","receivedAt":"2026-11-19T10:53:00Z","isPatch":true,"sender":{"key":"okhuomonajayi54@gmail.com","avatar":null},"body":"CodingGuidelines, SubmittingPatches, and ReviewingGuidelines do\nnot say how long an emailed line should be. State the limit in\neach: keep the text near 70 columns so it still fits on an\n80-column terminal after a few levels of quoting.\n\nSigned-off-by: Okhuomon Ajayi <okhuomonajayi54@gmail.com>\n---\n Documentation/CodingGuidelines         | 4 ++++\n Documentation/ReviewingGuidelines.adoc | 3 +++\n Documentation/SubmittingPatches        | 4 ++++\n 3 files changed, 11 insertions(+)\n\ndiff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines\nindex 23a4d2186a..a0cc5a050d 100644\n--- a/Documentation/CodingGuidelines\n+++ b/Documentation/CodingGuidelines\n@@ -33,6 +33,10 @@ Git in general, a few rough rules are:\n    achieve and why the changes were necessary (more on this in the\n    accompanying SubmittingPatches document).\n \n+ - E-mailed text, including a patch message and a review reply, is\n+   kept near 70 columns, so it still fits on an 80-column terminal\n+   after being quoted a few times.\n+\n  - A label \"NEEDSWORK:\" followed by a description of the things to\n    be done is a way to leave in-code comments to document design\n    decisions yet to be made. 80% of the work to resolve a NEEDSWORK\ndiff --git a/Documentation/ReviewingGuidelines.adoc b/Documentation/ReviewingGuidelines.adoc\nindex 6534643cff..8770f0597c 100644\n--- a/Documentation/ReviewingGuidelines.adoc\n+++ b/Documentation/ReviewingGuidelines.adoc\n@@ -116,6 +116,9 @@ guidance, and concrete tips for interacting with patches on the mailing list.\n   unrelated to your review from the email reply. Make sure to leave enough\n   context for readers to understand your comments!\n \n+- Wrap a review reply so it still fits on an 80-column terminal after\n+  being quoted a few times. Around 70 columns is a comfortable limit.\n+\n - If you cannot complete a full review of a series all at once, consider letting\n   the author know (on- or off-list) if/when you plan to review the rest of the\n   series.\ndiff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\nindex c60855f706..2525cc7e20 100644\n--- a/Documentation/SubmittingPatches\n+++ b/Documentation/SubmittingPatches\n@@ -700,6 +700,10 @@ WARNING: Be wary of your MUAs word-wrap\n corrupting your patch.  Do not cut-n-paste your patch; you can\n lose tabs that way if you are not careful.\n \n+Wrap the prose you send so it still fits on an 80-column terminal\n+after being quoted a few times.  Around 70 columns is a comfortable\n+limit.\n+\n It is a common convention to prefix your subject line with\n [PATCH].  This lets people easily distinguish patches from other\n e-mail discussions.  Use of markers in addition to PATCH within\n\nbase-commit: 7fb6055e678f800320d8ab8cd8f201d9493d1ba0\n-- \n2.56.0\n\n\n"},{"id":"558896","messageId":"xmqqik1sv4y7.fsf@gitster.g","threadId":"66880","inReplyTo":"20261119105300.95746-1-okhuomonajayi54@gmail.com","subject":"Re: [PATCH] doc: wrap emailed text near 70 columns","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2026-11-19T22:20:32Z","receivedAt":"2026-11-19T22:20:32Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Okhuomon Ajayi <okhuomonajayi54@gmail.com> writes:\n\n> CodingGuidelines, SubmittingPatches, and ReviewingGuidelines do\n> not say how long an emailed line should be. State the limit in\n> each: keep the text near 70 columns so it still fits on an\n> 80-column terminal after a few levels of quoting.\n\nThanks, but then why not also suggest to use these inter-paragraph\nblank lines?\n\n>\n> Signed-off-by: Okhuomon Ajayi <okhuomonajayi54@gmail.com>\n> ---\n>  Documentation/CodingGuidelines         | 4 ++++\n>  Documentation/ReviewingGuidelines.adoc | 3 +++\n>  Documentation/SubmittingPatches        | 4 ++++\n>  3 files changed, 11 insertions(+)\n>\n> diff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines\n> index 23a4d2186a..a0cc5a050d 100644\n> --- a/Documentation/CodingGuidelines\n> +++ b/Documentation/CodingGuidelines\n> @@ -33,6 +33,10 @@ Git in general, a few rough rules are:\n>     achieve and why the changes were necessary (more on this in the\n>     accompanying SubmittingPatches document).\n>  \n> + - E-mailed text, including a patch message and a review reply, is\n> +   kept near 70 columns, so it still fits on an 80-column terminal\n> +   after being quoted a few times.\n> +\n>   - A label \"NEEDSWORK:\" followed by a description of the things to\n>     be done is a way to leave in-code comments to document design\n>     decisions yet to be made. 80% of the work to resolve a NEEDSWORK\n> diff --git a/Documentation/ReviewingGuidelines.adoc b/Documentation/ReviewingGuidelines.adoc\n> index 6534643cff..8770f0597c 100644\n> --- a/Documentation/ReviewingGuidelines.adoc\n> +++ b/Documentation/ReviewingGuidelines.adoc\n> @@ -116,6 +116,9 @@ guidance, and concrete tips for interacting with patches on the mailing list.\n>    unrelated to your review from the email reply. Make sure to leave enough\n>    context for readers to understand your comments!\n>  \n> +- Wrap a review reply so it still fits on an 80-column terminal after\n> +  being quoted a few times. Around 70 columns is a comfortable limit.\n> +\n>  - If you cannot complete a full review of a series all at once, consider letting\n>    the author know (on- or off-list) if/when you plan to review the rest of the\n>    series.\n> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\n> index c60855f706..2525cc7e20 100644\n> --- a/Documentation/SubmittingPatches\n> +++ b/Documentation/SubmittingPatches\n> @@ -700,6 +700,10 @@ WARNING: Be wary of your MUAs word-wrap\n>  corrupting your patch.  Do not cut-n-paste your patch; you can\n>  lose tabs that way if you are not careful.\n>  \n> +Wrap the prose you send so it still fits on an 80-column terminal\n> +after being quoted a few times.  Around 70 columns is a comfortable\n> +limit.\n> +\n>  It is a common convention to prefix your subject line with\n>  [PATCH].  This lets people easily distinguish patches from other\n>  e-mail discussions.  Use of markers in addition to PATCH within\n>\n> base-commit: 7fb6055e678f800320d8ab8cd8f201d9493d1ba0\n\n"},{"id":"558897","messageId":"CAFpMFfD=7B7jqQG2eZPxLEJx8Rq2z1fH_7TdUaU4+bFoDWS=Cg@mail.gmail.com","threadId":"66880","inReplyTo":"xmqqik1sv4y7.fsf@gitster.g","subject":"Re: [PATCH] doc: wrap emailed text near 70 columns","fromName":"Okhuomon Ajayi","fromEmail":"okhuomonajayi54@gmail.com","sentAt":"2026-11-19T22:26:30Z","receivedAt":"2026-11-19T22:26:30Z","isPatch":true,"sender":{"key":"okhuomonajayi54@gmail.com","avatar":null},"body":"On Thu, Nov 19, 2026 at 11:20 PM Junio C Hamano <gitster@pobox.com> wrote:\n\n> Thanks, but then why not also suggest to use these inter-paragraph\n> blank lines?\n\nThe blank-line rule is already in the MyFirstContribution patch\nyou queued, so I left it out of this one to avoid repeating it.\nI'll add it next to the line-length limit in these three\ndocuments and resend.\n\nThanks,\n\nOkhuomon\n\n"},{"id":"558908","messageId":"20261120055908.83043-1-okhuomonajayi54@gmail.com","threadId":"66880","inReplyTo":"20261119105300.95746-1-okhuomonajayi54@gmail.com","subject":"[PATCH v2] doc: wrap emailed text near 70 columns","fromName":"Okhuomon Ajayi","fromEmail":"okhuomonajayi54@gmail.com","sentAt":"2026-11-20T05:59:08Z","receivedAt":"2026-11-20T05:59:08Z","isPatch":true,"sender":{"key":"okhuomonajayi54@gmail.com","avatar":null},"body":"CodingGuidelines, SubmittingPatches, and ReviewingGuidelines do\nnot say how long an emailed line should be. State the limit in\neach: keep the text near 70 columns so it still fits on an\n80-column terminal after a few levels of quoting. Leave a blank\nline between paragraphs. A block of quoted text counts as a\nparagraph.\n\nSigned-off-by: Okhuomon Ajayi <okhuomonajayi54@gmail.com>\n---\nChanges since v1:\n- Also say to leave a blank line between paragraphs. A block of\n  quoted text counts as a paragraph.\n\n Documentation/CodingGuidelines         | 6 ++++++\n Documentation/ReviewingGuidelines.adoc | 5 +++++\n Documentation/SubmittingPatches        | 6 ++++++\n 3 files changed, 17 insertions(+)\n\ndiff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines\nindex 23a4d2186a..414ecc444d 100644\n--- a/Documentation/CodingGuidelines\n+++ b/Documentation/CodingGuidelines\n@@ -33,6 +33,12 @@ Git in general, a few rough rules are:\n    achieve and why the changes were necessary (more on this in the\n    accompanying SubmittingPatches document).\n \n+ - E-mailed text, including a patch message and a review reply, is\n+   kept near 70 columns, so it still fits on an 80-column terminal\n+   after being quoted a few times.  Leave a blank line between\n+   paragraphs.  A block of quoted text counts as a paragraph, so\n+   leave a blank line before and after it.\n+\n  - A label \"NEEDSWORK:\" followed by a description of the things to\n    be done is a way to leave in-code comments to document design\n    decisions yet to be made. 80% of the work to resolve a NEEDSWORK\ndiff --git a/Documentation/ReviewingGuidelines.adoc b/Documentation/ReviewingGuidelines.adoc\nindex 6534643cff..51da873840 100644\n--- a/Documentation/ReviewingGuidelines.adoc\n+++ b/Documentation/ReviewingGuidelines.adoc\n@@ -116,6 +116,11 @@ guidance, and concrete tips for interacting with patches on the mailing list.\n   unrelated to your review from the email reply. Make sure to leave enough\n   context for readers to understand your comments!\n \n+- Wrap a review reply so it still fits on an 80-column terminal after\n+  being quoted a few times. Around 70 columns is a comfortable limit.\n+  Leave a blank line between paragraphs. A block of quoted text counts\n+  as a paragraph, so leave a blank line before and after it.\n+\n - If you cannot complete a full review of a series all at once, consider letting\n   the author know (on- or off-list) if/when you plan to review the rest of the\n   series.\ndiff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\nindex c60855f706..9313349bdd 100644\n--- a/Documentation/SubmittingPatches\n+++ b/Documentation/SubmittingPatches\n@@ -700,6 +700,12 @@ WARNING: Be wary of your MUAs word-wrap\n corrupting your patch.  Do not cut-n-paste your patch; you can\n lose tabs that way if you are not careful.\n \n+Wrap the prose you send so it still fits on an 80-column terminal\n+after being quoted a few times.  Around 70 columns is a comfortable\n+limit.  Leave a blank line between paragraphs.  A block of quoted\n+text counts as a paragraph, so leave a blank line before and after\n+it.\n+\n It is a common convention to prefix your subject line with\n [PATCH].  This lets people easily distinguish patches from other\n e-mail discussions.  Use of markers in addition to PATCH within\n\nbase-commit: 7fb6055e678f800320d8ab8cd8f201d9493d1ba0\n-- \n2.56.0\n\n\n"}]}