git: 577aeec410 - main - Handbook: Internet resources: text/html reality

From: Graham Perrin <grahamperrin_at_FreeBSD.org>
Date: Sat, 15 Jul 2023 17:44:06 UTC
The branch main has been updated by grahamperrin:

URL: https://cgit.FreeBSD.org/doc/commit/?id=577aeec41099703a861aaf8747387ca0d4d9cb39

commit 577aeec41099703a861aaf8747387ca0d4d9cb39
Author:     Graham Perrin <grahamperrin@FreeBSD.org>
AuthorDate: 2023-07-15 17:32:02 +0000
Commit:     Graham Perrin <grahamperrin@FreeBSD.org>
CommitDate: 2023-07-15 17:32:02 +0000

    Handbook: Internet resources: text/html reality
    
    Make what's stated closer to the reality of what happens when a
    multi-part email message includes text/plain and text/html parts.
    
    Opening comment 0 at
    https://bugs.freebsd.org/264754#c0
    
    PR: 264754
---
 documentation/content/en/books/handbook/eresources/_index.adoc | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/documentation/content/en/books/handbook/eresources/_index.adoc b/documentation/content/en/books/handbook/eresources/_index.adoc
index 923af2a12d..77e2841332 100644
--- a/documentation/content/en/books/handbook/eresources/_index.adoc
+++ b/documentation/content/en/books/handbook/eresources/_index.adoc
@@ -162,8 +162,14 @@ All attachments with a MIME content type not found in the list below will be str
 Some of the mailing lists might allow attachments of other MIME content types, but the above list should be applicable for most of the mailing lists.
 ====
 
-If an email contains both an HTML and a plain text version, the HTML version will be removed.
-If an email contains only an HTML version, it will be converted to plain text.
+If a multi-part message includes text/plain and text/html parts:
+
+- addressees will receive both parts
+- lists.freebsd.org will present text/plain with an option to view original text (source, with raw HTML amongst the parts).
+
+If text/plain does not accompany text/html:
+
+- there will be conversion from HTML to plain text.
 
 [[eresources-news]]
 == Usenet Newsgroups