diff --git a/Doc/library/email.generator.rst b/Doc/library/email.generator.rst
index 1e64e1066c..eab7d17178 100644
--- a/Doc/library/email.generator.rst
+++ b/Doc/library/email.generator.rst
@@ -36,6 +36,9 @@ something that contains only ASCII characters, using the standard email RFC
 Content Transfer Encoding techniques for encoding email messages for transport
 over channels that are not "8 bit clean".
 
+To accomodate reproducible processing of SMIME-signed messages 
+`Generator` disables header folding for message parts of type ``multipart/signed``
+and all subparts.
 
 .. class:: BytesGenerator(outfp, mangle_from_=None, maxheaderlen=None, *, \
                           policy=None)