New submission from era <era+pyt...@iki.fi>:

Several of the examples in the email module documentation modify the preamble.

This is not good practice. The email MIME preamble is really only useful for 
communicating information about MIME itself, not for general human-readable 
content like 'Our family reunion'.

The MIME preamble is problematic because it typically only supports ASCII and 
often defaults to an English-language message, even when applications are used 
in locales where English is not widely understood.  For this reason, it is 
moderately useful to be able to override the preamble from Python code; but 
this should by no means be done routinely, and the documentation should 
certainly not demonstrate this in basic examples.

----------
components: email
messages: 337657
nosy: barry, era, r.david.murray
priority: normal
severity: normal
status: open
title: email examples should not gratuitously mess with preamble
type: behavior
versions: Python 3.7

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue36261>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to