Address PR comments

12 files changed, 15 insertions, 17 deletions

diff --git a/examples/images_contours_and_fields/contourf_demo.py b/examples/images_contours_and_fields/contourf_demo.py
index 4a89bf775..e719a2655 100644
--- a/examples/images_contours_and_fields/contourf_demo.py
+++ b/examples/images_contours_and_fields/contourf_demo.py
@@ -3,7 +3,7 @@
 Contourf Demo
 =============
 
-Example use of the `contourf` function to create filled contour plots.
+How to use the ``contourf`` function to create filled contour plots.
 """
 import numpy as np
 import matplotlib.pyplot as plt
diff --git a/examples/images_contours_and_fields/contourf_hatching.py b/examples/images_contours_and_fields/contourf_hatching.py
index 05bcab765..ef1fc109c 100644
--- a/examples/images_contours_and_fields/contourf_hatching.py
+++ b/examples/images_contours_and_fields/contourf_hatching.py
@@ -3,7 +3,7 @@
 Contourf Hatching
 =================
 
-Demo of filled contour plots with of hatched patterns.
+Demo filled contour plots with of hatched patterns.
 """
 import matplotlib.pyplot as plt
 import numpy as np
@@ -30,8 +30,6 @@ cs = plt.contourf(x, y, z, hatches=['-', '/', '\\', '//'],
                   )
 plt.colorbar()
 
-###############################################################################
-
 # ---------------------------------------------
 # |                 Plot #2                   |
 # ---------------------------------------------
diff --git a/examples/pylab_examples/axes_demo.py b/examples/pylab_examples/axes_demo.py
index f200b7f4e..36b23d2c7 100644
--- a/examples/pylab_examples/axes_demo.py
+++ b/examples/pylab_examples/axes_demo.py
@@ -3,7 +3,7 @@
 Axes Demo
 =========
 
-Example use of `plt.axes` to create inset axes within the main plot axes.
+Example use of ``plt.axes`` to create inset axes within the main plot axes.
 """
 import matplotlib.pyplot as plt
 import numpy as np
diff --git a/examples/pylab_examples/axhspan_demo.py b/examples/pylab_examples/axhspan_demo.py
index 02ddb7e48..8e9eac28c 100644
--- a/examples/pylab_examples/axhspan_demo.py
+++ b/examples/pylab_examples/axhspan_demo.py
@@ -3,7 +3,7 @@
 Axhspan Demo
 ============
 
-The example shows how to create lines or rectangles that span the axes in either the horizontal or vertical direction.
+Create lines or rectangles that span the axes in either the horizontal or vertical direction.
 """
 import numpy as np
 import matplotlib.pyplot as plt
diff --git a/examples/pylab_examples/axis_equal_demo.py b/examples/pylab_examples/axis_equal_demo.py
index ec77b0817..568b89966 100644
--- a/examples/pylab_examples/axis_equal_demo.py
+++ b/examples/pylab_examples/axis_equal_demo.py
@@ -3,7 +3,7 @@
 Axis Equal Demo
 ===============
 
-This example how to set and adjust plots with equal axis ratios.
+How to set and adjust plots with equal axis ratios.
 """
 
 import matplotlib.pyplot as plt
diff --git a/examples/pylab_examples/figure_title.py b/examples/pylab_examples/figure_title.py
index 575681cea..c4c2408b9 100644
--- a/examples/pylab_examples/figure_title.py
+++ b/examples/pylab_examples/figure_title.py
@@ -3,7 +3,7 @@
 Figure Title
 ============
 
-Example use of `title` and `suptitle` to create subplot titles and a centered figure title, respectively.
+Create a figure with separate subplot titles and a centered figure title.
 """
 from matplotlib.font_manager import FontProperties
 import matplotlib.pyplot as plt
diff --git a/examples/pylab_examples/fill_betweenx_demo.py b/examples/pylab_examples/fill_betweenx_demo.py
index 0958e260a..660cdc155 100644
--- a/examples/pylab_examples/fill_betweenx_demo.py
+++ b/examples/pylab_examples/fill_betweenx_demo.py
@@ -3,7 +3,7 @@
 Fill Betweenx Demo
 ==================
 
-This example shows how to use `fill_betweenx` to color between two horizontal curves.
+Using ``fill_betweenx`` to color between two horizontal curves.
 """
 import matplotlib.mlab as mlab
 from matplotlib.pyplot import figure, show
diff --git a/examples/pylab_examples/plotfile_demo.py b/examples/pylab_examples/plotfile_demo.py
index 3252835ed..b927b4870 100644
--- a/examples/pylab_examples/plotfile_demo.py
+++ b/examples/pylab_examples/plotfile_demo.py
@@ -3,7 +3,7 @@
 Plotfile Demo
 =============
 
-Example use of `plotfile` to plot data directly from a file.
+Example use of ``plotfile`` to plot data directly from a file.
 """
 import matplotlib.pyplot as plt
 import numpy as np
diff --git a/examples/pylab_examples/simple_plot.py b/examples/pylab_examples/simple_plot.py
index 8ea7bce5f..6a375ebbe 100644
--- a/examples/pylab_examples/simple_plot.py
+++ b/examples/pylab_examples/simple_plot.py
@@ -3,7 +3,7 @@
 Simple Plot
 ===========
 
-Simple example of a simple plot.
+Create a simple plot.
 """
 import matplotlib.pyplot as plt
 import numpy as np
diff --git a/examples/pylab_examples/specgram_demo.py b/examples/pylab_examples/specgram_demo.py
index b252c551b..4c0a45098 100644
--- a/examples/pylab_examples/specgram_demo.py
+++ b/examples/pylab_examples/specgram_demo.py
@@ -1,7 +1,7 @@
 """
-=============
-Specgram Demo
-=============
+================
+Spectrogram Demo
+================
 
 Demo of a spectrogram plot.
 """
diff --git a/examples/pylab_examples/symlog_demo.py b/examples/pylab_examples/symlog_demo.py
index d2d077443..c655e6347 100644
--- a/examples/pylab_examples/symlog_demo.py
+++ b/examples/pylab_examples/symlog_demo.py
@@ -3,7 +3,7 @@
 Symlog Demo
 ===========
 
-Example use of symlog (symmetrical log) axis scaling.
+Example use of symlog (symmetric log) axis scaling.
 """
 import matplotlib.pyplot as plt
 import numpy as np
diff --git a/examples/pylab_examples/xcorr_demo.py b/examples/pylab_examples/xcorr_demo.py
index 5f48c74a2..21ec82b44 100644
--- a/examples/pylab_examples/xcorr_demo.py
+++ b/examples/pylab_examples/xcorr_demo.py
@@ -1,9 +1,9 @@
 """
 ==========
-Xcorr Demo
+Cross-correlation Demo
 ==========
 
-Example use of cross-correlation (`xcorr`) and auto-correlation (`acorr`) plots.
+Example use of cross-correlation (``xcorr``) and auto-correlation (``acorr``) plots.
 """
 import matplotlib.pyplot as plt
 import numpy as np