Cleaned up EmailMultiAlternatives docs.

1 files changed, 21 insertions, 23 deletions

diff --git a/docs/topics/email.txt b/docs/topics/email.txt
index 1a283bdbb4..635864a95e 100644
--- a/docs/topics/email.txt
+++ b/docs/topics/email.txt
@@ -397,11 +397,27 @@ Django's email library, you can do this using the
 
 .. class:: EmailMultiAlternatives
 
-    A subclass of :class:`~django.core.mail.EmailMessage` that allows
-    additional versions of the message body in the email via the
-    ``attach_alternative()`` method. This directly inherits all methods
-    (including the class initialization) from
-    :class:`~django.core.mail.EmailMessage`.
+    A subclass of :class:`EmailMessage` that allows additional versions of the
+    message body in the email via the :meth:`attach_alternative` method. This
+    directly inherits all methods (including the class initialization) from
+    :class:`EmailMessage`.
+
+    .. attribute:: alternatives
+
+        A list of named tuples with attributes ``(content, mimetype)``. This is
+        particularly useful in tests::
+
+            self.assertEqual(len(msg.alternatives), 1)
+            self.assertEqual(msg.alternatives[0].content, html_content)
+            self.assertEqual(msg.alternatives[0].mimetype, "text/html")
+
+        Alternatives should only be added using the :meth:`attach_alternative`
+        method.
+
+        .. versionchanged:: 5.2
+
+            In older versions, ``alternatives`` was a list of regular tuples,
+            as opposed to named tuples.
 
     .. method:: attach_alternative(content, mimetype)
 
@@ -420,24 +436,6 @@ Django's email library, you can do this using the
             msg.attach_alternative(html_content, "text/html")
             msg.send()
 
-    .. attribute:: alternatives
-
-        A list of named tuples with attributes ``(content, mimetype)``. This is
-        particularly useful in tests::
-
-            self.assertEqual(len(msg.alternatives), 1)
-            self.assertEqual(msg.alternatives[0].content, html_content)
-            self.assertEqual(msg.alternatives[0].mimetype, "text/html")
-
-        Alternatives should only be added using the
-        :meth:`~django.core.mail.EmailMultiAlternatives.attach_alternative`
-        method.
-
-        .. versionchanged:: 5.2
-
-            In older versions, ``alternatives`` was a list of regular tuples, as opposed
-            to named tuples.
-
 Updating the default content type
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~