Document minor API changes

jkseppan · jkseppan · commit 10135bf13d88 · 2017-02-12T21:47:48.000+02:00
And add an underscore in the beginning of the method whose signature
changes.
diff --git a/doc/api/api_changes/2017-02-12-JKS.rst b/doc/api/api_changes/2017-02-12-JKS.rst
@@ -0,0 +1,8 @@
+Changes to PDF backend methods
+``````````````````````````````
+
+The methods `embedTeXFont` and `tex_font_mapping` of
+`matplotlib.backend_pdf.PdfFile` have been removed.
+It is unlikely that external users would have called
+these methods, which are related to the font system
+internal to the PDF backend.
diff --git a/lib/matplotlib/backends/backend_pdf.py b/lib/matplotlib/backends/backend_pdf.py
@@ -711,7 +711,7 @@ def writeFonts(self):
             Fx = info.pdfname
             matplotlib.verbose.report('Embedding Type-1 font %s from dvi'
                                       % dviname, 'debug')
-            fonts[Fx] = self.embedTeXFont(info)
+            fonts[Fx] = self._embedTeXFont(info)
         for filename in sorted(self.fontNames):
             Fx = self.fontNames[filename]
             matplotlib.verbose.report('Embedding font %s' % filename, 'debug')
@@ -740,7 +740,7 @@ def _write_afm_font(self, filename):
         self.writeObject(fontdictObject, fontdict)
         return fontdictObject
 
-    def embedTeXFont(self, fontinfo):
+    def _embedTeXFont(self, fontinfo):
         msg = ('Embedding TeX font {0} - fontinfo={1}'
                .format(fontinfo.dvifont.texname, fontinfo.__dict__))
         matplotlib.verbose.report(msg, 'debug')
