Skip to content

Commit 17fac2e

Browse files
committed
DOC: add behavior change note for only considering fonts in registry
1 parent f1beb1d commit 17fac2e

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
On windows only fonts known to the registry will be discovered
2+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3+
4+
Previously, Matplotlib would recursively walk user and system font directories
5+
to discover fonts, however this lead to a number of undesirable behaviors
6+
including finding deleted fonts. Now Matplotlib will only find fonts that are
7+
known to the Windows.
8+
9+
This means that any user installed fonts must got through the Windows font
10+
installer rather than simply being copied to the correct folder.
11+
12+
This only impacts the set of fonts Matplotlib will consider when using
13+
`matplotlib.font_manager.find_font`, directly pass the path to a font to use an
14+
arbitrary font (see :doc:`/gallery/text_labels_and_annotations/fonts_file`).

0 commit comments

Comments
 (0)