Trac #32950: add pictures to ellipse.py docstring

Docstring lacks a PLOT section to illustrate the examples

URL: https://trac.sagemath.org/32950
Reported by: jhonrubia6
Ticket author(s): Javier Honrubia González
Reviewer(s): Eric Gourgoulhon

Author: Release Manager

src/sage/plot/ellipse.py

@@ -272,23 +272,51 @@ def ellipse(center, r1, r2, angle=0, **options):
         sage: ellipse((0,0),2,1)
         Graphics object consisting of 1 graphics primitive
 
+    .. PLOT::
+    
+        E=ellipse((0,0),2,1)
+        sphinx_plot(E)
+        
     More complicated examples with tilted axes and drawing options::
 
         sage: ellipse((0,0),3,1,pi/6,fill=True,alpha=0.3,linestyle="dashed")
         Graphics object consisting of 1 graphics primitive
+        
+    .. PLOT::
+
+        E = ellipse((0,0),3,1,pi/6,fill=True,alpha=0.3,linestyle="dashed")
+        sphinx_plot(E)
+        
+    other way to indicate dashed linestyle::
+    
         sage: ellipse((0,0),3,1,pi/6,fill=True,alpha=0.3,linestyle="--")
         Graphics object consisting of 1 graphics primitive
 
-    ::
+    .. PLOT::
+    
+        E =ellipse((0,0),3,1,pi/6,fill=True,alpha=0.3,linestyle='--')
+        sphinx_plot(E)
+
+    with colors ::
 
         sage: ellipse((0,0),3,1,pi/6,fill=True,edgecolor='black',facecolor='red')
         Graphics object consisting of 1 graphics primitive
+        
+    .. PLOT::
+    
+        E=ellipse((0,0),3,1,pi/6,fill=True,edgecolor='black',facecolor='red')
+        sphinx_plot(E)
 
     We see that ``rgbcolor`` overrides these other options, as this plot
     is green::
 
         sage: ellipse((0,0),3,1,pi/6,fill=True,edgecolor='black',facecolor='red',rgbcolor='green')
         Graphics object consisting of 1 graphics primitive
+        
+    .. PLOT::
+    
+        E=ellipse((0,0),3,1,pi/6,fill=True,edgecolor='black',facecolor='red',rgbcolor='green')
+        sphinx_plot(E)
 
     The default aspect ratio for ellipses is 1.0::
 
@@ -306,6 +334,12 @@ def ellipse(center, r1, r2, angle=0, **options):
 
         sage: ellipse((0,0),2,1,legend_label="My ellipse", legend_color='green')
         Graphics object consisting of 1 graphics primitive
+        
+    .. PLOT::
+    
+        E=ellipse((0,0),2,1,legend_label="My ellipse", legend_color='green')
+        sphinx_plot(E)
+        
     """
     from sage.plot.all import Graphics
     g = Graphics()