Add 'what is new' entry for metadata kwarg in matplotlib.pyplot.savefig

Xarthisius · Xarthisius · commit 98408058d308 · 2016-11-16T21:36:14.000-06:00
diff --git a/doc/users/whats_new/metadata_savefig_kwarg.rst b/doc/users/whats_new/metadata_savefig_kwarg.rst
@@ -0,0 +1,20 @@
+Metadata savefig kwarg
+----------------------
+
+:func:`~matplotlib.pyplot.savefig` now accepts `metadata` as a keyword argument.
+It can be used to store key/value pairs in the image metadata.
+
+Supported formats and backends
+``````````````````````````````
+* 'png' with Agg backend
+* 'pdf' with PDF backend (see
+  :func:`~matplotlib.backends.backend_pdf.PdfFile.writeInfoDict` for a list of
+  supported keywords)
+* 'eps' and 'ps' with PS backend (only 'Creator' key is accepted)
+
+Example
+```````
+::
+
+    plt.savefig('test.png', metadata={'Software': 'My awesome software'})
+
