Skip to content

DOC: do not suggest to sudo pip install Matplotlib #23024

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.

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

Merged
merged 1 commit into from
May 10, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions doc/users/installing/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -291,8 +291,6 @@ from the Terminal.app command line::

python3 -m pip install matplotlib

(``sudo python3.6 ...`` on Macports).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we just drop this altogether? We don't give instructions for apt or other package managers, do we? I think we should doc pip and conda and if someone wants to install with macports they can ask macports how to do it.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We give basic installation commands (like sudo apt install python-matplotlib) for some package managers, but little package-manager specific setup instructions.

https://github.com/matplotlib/matplotlib/blob/main/doc/users/installing/index.rst#linux-package-manager

This does seem to be a common problem for OSX users, so maybe it might be worth leaving in the installation guide and adding @oscargus suggestion.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I somewhat disagree, or at the least we need to rephrase the docs here. If I was a naive user who had not really heard of conda I'd skip the conda section (what's that?) and go to the MacOS section. Then I would be using crazy macports or brew installs, or worse trying to use the system python, when really by far the easiest solution on a Mac (or most other platforms) is to use conda. All this stuff should be hidden behind links that say "manual OS-specific installs, not recommended".


You might also want to install IPython or the Jupyter notebook (``python3 -m pip
install ipython notebook``).

Expand Down