While reading the git-format-patch manpages [1], I discovered the existence
of the "Toggle Line Wrap" extension for Thunderbird which I found rather
convenient.

Looking at the history, the ancestor of this extension was added to the
documentation in commit e0e34e977a7c ("Documentation/email-clients.txt:
update Thunderbird docs with wordwrap plugin") but then removed in commit
f9a0974d3f70 ("Documentation: update thunderbird email client settings").

Extend the paragraph on Thunderbird's mailnews.wraplength register to
mention the existence of the "Toggle Line Wrap" extension. The goal is not
to create a war on what is the best option so make it clear that this is
just an alternative.

[1] man git-format-patch -- §Thunderbird
Link: https://git-scm.com/docs/git-format-patch#_thunderbird

Signed-off-by: Vincent Mailhol <mailhol@kernel.org>
---
Changes in v2:

  - Use the international URL (remove "fr/")

Link to v1: https://lore.kernel.org/r/20251225-docs_thunderbird-toggle-line-wrap-v1-1-24794afa4abf@kernel.org
---
 Documentation/process/email-clients.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/Documentation/process/email-clients.rst b/Documentation/process/email-clients.rst
index 84a2450bb6ec..b5377630a648 100644
--- a/Documentation/process/email-clients.rst
+++ b/Documentation/process/email-clients.rst
@@ -324,7 +324,14 @@ To beat some sense out of the internal editor, do this:
 
   - Set ``mailnews.send_plaintext_flowed`` to ``false``
 
-  - Set ``mailnews.wraplength`` from ``72`` to ``0``
+  - Set ``mailnews.wraplength`` from ``72`` to ``0`` **or** install the
+    "Toggle Line Wrap" extension
+
+    https://github.com/jan-kiszka/togglelinewrap
+
+    https://addons.thunderbird.net/thunderbird/addon/toggle-line-wrap
+
+    to control this registry on the fly.
 
 - Don't write HTML messages! Go to the main window
   :menuselection:`Main Menu-->Account Settings-->youracc@server.something-->Composition & Addressing`!

---
base-commit: 9448598b22c50c8a5bb77a9103e2d49f134c9578
change-id: 20251225-docs_thunderbird-toggle-line-wrap-dbe39bcb650b

Best regards,
-- 
Vincent Mailhol <mailhol@kernel.org>

Vincent Mailhol <mailhol@kernel.org> writes:

> While reading the git-format-patch manpages [1], I discovered the existence
> of the "Toggle Line Wrap" extension for Thunderbird which I found rather
> convenient.
>
> Looking at the history, the ancestor of this extension was added to the
> documentation in commit e0e34e977a7c ("Documentation/email-clients.txt:
> update Thunderbird docs with wordwrap plugin") but then removed in commit
> f9a0974d3f70 ("Documentation: update thunderbird email client settings").
>
> Extend the paragraph on Thunderbird's mailnews.wraplength register to
> mention the existence of the "Toggle Line Wrap" extension. The goal is not
> to create a war on what is the best option so make it clear that this is
> just an alternative.
>
> [1] man git-format-patch -- §Thunderbird
> Link: https://git-scm.com/docs/git-format-patch#_thunderbird
>
> Signed-off-by: Vincent Mailhol <mailhol@kernel.org>
> ---
> Changes in v2:
>
>   - Use the international URL (remove "fr/")
>
> Link to v1: https://lore.kernel.org/r/20251225-docs_thunderbird-toggle-line-wrap-v1-1-24794afa4abf@kernel.org
> ---
>  Documentation/process/email-clients.rst | 9 ++++++++-
>  1 file changed, 8 insertions(+), 1 deletion(-)

Applied, thanks.

jon

On 26/12/2025 1:46, Vincent Mailhol wrote:
> While reading the git-format-patch manpages [1], I discovered the existence
> of the "Toggle Line Wrap" extension for Thunderbird which I found rather
> convenient.
> 
> Looking at the history, the ancestor of this extension was added to the
> documentation in commit e0e34e977a7c ("Documentation/email-clients.txt:
> update Thunderbird docs with wordwrap plugin") but then removed in commit
> f9a0974d3f70 ("Documentation: update thunderbird email client settings").
> 
> Extend the paragraph on Thunderbird's mailnews.wraplength register to
> mention the existence of the "Toggle Line Wrap" extension. The goal is not
> to create a war on what is the best option so make it clear that this is
> just an alternative.
> 
> [1] man git-format-patch -- §Thunderbird
> Link: https://git-scm.com/docs/git-format-patch#_thunderbird
> 
> Signed-off-by: Vincent Mailhol <mailhol@kernel.org>

I also use this extension and find it useful, good to have it documented.
Reviewed-by: Gal Pressman <gal@nvidia.com>

Btw, there are some tricks for when you want to wrap parts of the mail,
and leave other parts unwrapped. Useful when drafting a reply that
contains code snippets.

I don't remember the exact steps, but if you know it then it's good to
have it in here as well :).

On 06.01.26 17:42, Gal Pressman wrote:
> On 26/12/2025 1:46, Vincent Mailhol wrote:
>> While reading the git-format-patch manpages [1], I discovered the existence
>> of the "Toggle Line Wrap" extension for Thunderbird which I found rather
>> convenient.
>>
>> Looking at the history, the ancestor of this extension was added to the
>> documentation in commit e0e34e977a7c ("Documentation/email-clients.txt:
>> update Thunderbird docs with wordwrap plugin") but then removed in commit
>> f9a0974d3f70 ("Documentation: update thunderbird email client settings").
>>
>> Extend the paragraph on Thunderbird's mailnews.wraplength register to
>> mention the existence of the "Toggle Line Wrap" extension. The goal is not
>> to create a war on what is the best option so make it clear that this is
>> just an alternative.
>>
>> [1] man git-format-patch -- §Thunderbird
>> Link: https://git-scm.com/docs/git-format-patch#_thunderbird
>>
>> Signed-off-by: Vincent Mailhol <mailhol@kernel.org>
> 
> I also use this extension and find it useful, good to have it documented.
> Reviewed-by: Gal Pressman <gal@nvidia.com>
> 
> Btw, there are some tricks for when you want to wrap parts of the mail,
> and leave other parts unwrapped. Useful when drafting a reply that
> contains code snippets.
> 
> I don't remember the exact steps, but if you know it then it's good to
> have it in here as well :).

This got broken quite a while ago: You could enable line wrapping, mark
the paragraph you wanted to have wrapped, select "rewrap" from the edit
menu, and then disable wrapping again. The used to leave the marked
paragraph wrapped-around behind, but not anymore. If there is a
different trick by now, I would be all ears as I used that very often in
the past.

BTW, if you want TB to have better wrapping support natively, please
jump on https://bugzilla.mozilla.org/show_bug.cgi?id=1587153. We either
need to convince them of that or at least finally get an add-on API so
that I do not need to permanently bump the supported TB versions (see
https://github.com/jan-kiszka/togglelinewrap/commits/master/). With the
API Experiment that is still needed for toggling, I'm not allowed to
declare the add-on as compatible with future TB versions.

Jan

On Fri, Dec 26, 2025 at 12:47 AM Vincent Mailhol <mailhol@kernel.org> wrote:
>
> [1] man git-format-patch -- §Thunderbird
> Link: https://git-scm.com/docs/git-format-patch#_thunderbird
>
> Signed-off-by: Vincent Mailhol <mailhol@kernel.org>
> ---
> Changes in v2:
>
>   - Use the international URL (remove "fr/")
>
> Link to v1: https://lore.kernel.org/r/20251225-docs_thunderbird-toggle-line-wrap-v1-1-24794afa4abf@kernel.org
> ---
>  Documentation/process/email-clients.rst | 9 ++++++++-
>  1 file changed, 8 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/process/email-clients.rst b/Documentation/process/email-clients.rst
> index 84a2450bb6ec..b5377630a648 100644
> --- a/Documentation/process/email-clients.rst
> +++ b/Documentation/process/email-clients.rst
> @@ -324,7 +324,14 @@ To beat some sense out of the internal editor, do this:
>
>    - Set ``mailnews.send_plaintext_flowed`` to ``false``
>
> -  - Set ``mailnews.wraplength`` from ``72`` to ``0``
> +  - Set ``mailnews.wraplength`` from ``72`` to ``0`` **or** install the
> +    "Toggle Line Wrap" extension
> +
> +    https://github.com/jan-kiszka/togglelinewrap
> +
> +    https://addons.thunderbird.net/thunderbird/addon/toggle-line-wrap
> +
> +    to control this registry on the fly.
>
>  - Don't write HTML messages! Go to the main window
>    :menuselection:`Main Menu-->Account Settings-->youracc@server.something-->Composition & Addressing`!
>
> ---
> base-commit: 9448598b22c50c8a5bb77a9103e2d49f134c9578
> change-id: 20251225-docs_thunderbird-toggle-line-wrap-dbe39bcb650b

It's a practical alternative, I see no issue.

Acked-by: Sotir Danailov <sndanailov@gmail.com>  # As past commit author

On 12/25/25 3:46 PM, Vincent Mailhol wrote:
> While reading the git-format-patch manpages [1], I discovered the existence
> of the "Toggle Line Wrap" extension for Thunderbird which I found rather
> convenient.
> 
> Looking at the history, the ancestor of this extension was added to the
> documentation in commit e0e34e977a7c ("Documentation/email-clients.txt:
> update Thunderbird docs with wordwrap plugin") but then removed in commit
> f9a0974d3f70 ("Documentation: update thunderbird email client settings").
> 
> Extend the paragraph on Thunderbird's mailnews.wraplength register to
> mention the existence of the "Toggle Line Wrap" extension. The goal is not
> to create a war on what is the best option so make it clear that this is
> just an alternative.
> 
> [1] man git-format-patch -- §Thunderbird
> Link: https://git-scm.com/docs/git-format-patch#_thunderbird
> 
> Signed-off-by: Vincent Mailhol <mailhol@kernel.org>

Acked-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>

Thanks.

> ---
> Changes in v2:
> 
>   - Use the international URL (remove "fr/")
> 
> Link to v1: https://lore.kernel.org/r/20251225-docs_thunderbird-toggle-line-wrap-v1-1-24794afa4abf@kernel.org
> ---
>  Documentation/process/email-clients.rst | 9 ++++++++-
>  1 file changed, 8 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/process/email-clients.rst b/Documentation/process/email-clients.rst
> index 84a2450bb6ec..b5377630a648 100644
> --- a/Documentation/process/email-clients.rst
> +++ b/Documentation/process/email-clients.rst
> @@ -324,7 +324,14 @@ To beat some sense out of the internal editor, do this:
>  
>    - Set ``mailnews.send_plaintext_flowed`` to ``false``
>  
> -  - Set ``mailnews.wraplength`` from ``72`` to ``0``
> +  - Set ``mailnews.wraplength`` from ``72`` to ``0`` **or** install the
> +    "Toggle Line Wrap" extension
> +
> +    https://github.com/jan-kiszka/togglelinewrap
> +
> +    https://addons.thunderbird.net/thunderbird/addon/toggle-line-wrap
> +
> +    to control this registry on the fly.
>  
>  - Don't write HTML messages! Go to the main window
>    :menuselection:`Main Menu-->Account Settings-->youracc@server.something-->Composition & Addressing`!
> 
> ---
> base-commit: 9448598b22c50c8a5bb77a9103e2d49f134c9578
> change-id: 20251225-docs_thunderbird-toggle-line-wrap-dbe39bcb650b
> 
> Best regards,

-- 
~Randy