Skip to content

[Doc]: Document that rcParams['font.family'] can be a list #22746

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
timhoffm opened this issue Mar 31, 2022 · 0 comments · Fixed by #23605
Closed

[Doc]: Document that rcParams['font.family'] can be a list #22746

timhoffm opened this issue Mar 31, 2022 · 0 comments · Fixed by #23605
Labels
Documentation
Milestone
v3.6.0

Comments

@timhoffm
Copy link
Member

Documentation Link

No response

Problem

Looking at

matplotlib/lib/matplotlib/mpl-data/matplotlibrc

Line 219 in f670fe7

## The font.family property can take either a concrete font name (not supported

and

matplotlib/lib/matplotlib/mpl-data/matplotlibrc

Line 262 in f670fe7

#font.family: sans-serif

gives the impression thatfont.family must be a single string.

However, the validator can take a list of strings:

matplotlib/lib/matplotlib/rcsetup.py

Line 914 in f670fe7

"font.family": validate_stringlist, # used by text object

Suggested improvement

  • Document that font.family can be a list in matplotlibrc
  • validate_stringlist turns a single string into a one-element list. API-wise that's quite permissive. Do we want to change that (which might be some effort)? Or are we ok with that.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
Documentation
Projects
None yet
Milestone
v3.6.0
Development

Successfully merging a pull request may close this issue.

Fix issues in examples, docs, and tutorials oscargus/matplotlib
2 participants
@QuLogic @timhoffm