DOC: update tight layout guide with set_in_layout

jklymak · jklymak · commit 192f329555fd · 2020-07-28T15:44:09.000-07:00
diff --git a/tutorials/intermediate/tight_layout_guide.py b/tutorials/intermediate/tight_layout_guide.py
@@ -152,18 +152,17 @@ def example_plot(ax, fontsize=12):
 # Caveats
 # =======
 #
-#  * :func:`~matplotlib.pyplot.tight_layout` by default considers all artists
-#    on the axes.  To remove an artist from the layout calculation you can call
-#    `~.Artist.set_in_layout`.
+# * `~matplotlib.pyplot.tight_layout` considers all artists on the axes by
+#   default.  To remove an artist from the layout calculation you can call
+#   `.Artist.set_in_layout`.
 #
-#  * It assumes that the extra space needed for artists is independent of
-#    original location of axes. This is often true, but there are rare cases
-#    where it is not.
+# * ``tight_layout`` assumes that the extra space needed for artists is
+#   independent of the original location of axes. This is often true, but there
+#   are rare cases where it is not.
 #
-#  * pad=0 clips some of the texts by a few pixels. This may be a bug or
-#    a limitation of the current algorithm and it is not clear why it
-#    happens. Meanwhile, use of pad at least larger than 0.3 is
-#    recommended.
+# * ``pad=0`` can clip some texts by a few pixels. This may be a bug or
+#   a limitation of the current algorithm and it is not clear why it
+#   happens. Meanwhile, use of pad larger than 0.3 is recommended.
 #
 # Use with GridSpec
 # =================
