Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 14bec0b

Browse files
story645story645
committed
removed faq folder and added general faq link to user guide index,
moved install related troubleshooting/faq to install docs new troubleshooting page specific to development consolidated information across install, install for dev, and dependencies
1 parent 389a7e8 commit 14bec0b

14 files changed

+617
-685
lines changed

‎doc/conf.py

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -121,8 +121,7 @@ def _parse_skip_subdirs_file():
121121
]
122122

123123
exclude_patterns = [
124-
'api/prev_api_changes/api_changes_*/*'
125-
]
124+
'api/prev_api_changes/api_changes_*/*', '**/*inc.rst']
126125

127126
exclude_patterns += skip_subdirs
128127

‎doc/devel/dependencies.rst

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -240,17 +240,26 @@ Setup dependencies
240240
C++ compiler
241241
------------
242242

243-
Matplotlib requires a C++ compiler that supports C++11.
243+
Matplotlib requires a C++ compiler that supports C++11. Typically, on Linux, you
244+
will need ``gcc``, which should be installed using your distribution's package
245+
manager; on macOS, you will need xcode; on Windows, you will need
246+
Visual Studio 2015 or later. Specifically:
244247

245-
- `gcc 4.8.1 <https://gcc.gnu.org/projects/cxx-status.html#cxx11>`_ or higher. For gcc <6.5 you will
246-
need to set ``$CFLAGS=-std=c++11`` to enable C++11 support.
248+
- `gcc 4.8.1 <https://gcc.gnu.org/projects/cxx-status.html#cxx11>`_ or higher. For gcc <6.5 you will need to set ``$CFLAGS=-std=c++11`` to enable C++11 support.
247249
`Installing GCC: Binaries <https://gcc.gnu.org/install/binaries.html>`_.
248250
- `clang 3.3 <https://clang.llvm.org/cxx_status.html>`_ or higher.
249251
`LLVM Download Page <https://releases.llvm.org/download.html>`_.
250252
- `Visual Studio 2015
251253
<https://docs.microsoft.com/en-us/cpp/overview/visual-cpp-language-conformance?view=msvc-140>`_
252254
(aka VS 14.0) or higher. A free version of Build Tools for Visual Studio is available for
253255
`download <https://visualstudio.microsoft.com/downloads/?q=build+tools>`_.
256+
- `xcode <https://developer.apple.com/xcode/>`_ for Apple platform development
257+
258+
For those using Visual Studio, make sure "Desktop development with C++" is
259+
selected, and that the latest MSVC, "C++ CMake tools for Windows," and a
260+
Windows SDK compatible with your version of Windows are selected and installed.
261+
They should be selected by default under the "Optional" subheading, but are
262+
required to build Matplotlib from source.
254263

255264

256265
.. _test-dependencies:

‎doc/devel/development_setup.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,12 @@ To set up Matplotlib for development follow these steps:
2121
.. contents::
2222
:local:
2323

24+
Install Dependencies
25+
====================
26+
Most Python dependencies will be installed when :ref:`setting up the environment <dev-environment>`
27+
but non-Python dependencies like C++ compilers, LaTeX, and other system applications
28+
must be installed separately. For a full list, see :ref:`dependencies`.
29+
2430
Fork the Matplotlib repository
2531
==============================
2632

‎doc/devel/index.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,7 @@ Development environment
7878
.. grid:: 1 1 2 2
7979

8080
.. grid-item-card::
81+
:shadow: none
8182

8283
**Install**
8384
^^^
@@ -91,9 +92,11 @@ Development environment
9192
:maxdepth: 1
9293

9394
dependencies
95+
../users/installing/environment_variables_faq.rst
9496

9597

9698
.. grid-item-card::
99+
:shadow: none
97100

98101
**Workflow**
99102
^^^^
@@ -103,6 +106,10 @@ Development environment
103106

104107
development_workflow
105108

109+
.. toctree::
110+
:maxdepth: 1
111+
112+
troubleshooting.rst
106113

107114

108115
.. _contribution_guideline:
@@ -115,6 +122,7 @@ Policies and guidelines
115122
:gutter: 2
116123

117124
.. grid-item-card::
125+
:shadow: none
118126

119127
**Code**
120128
^^^
@@ -128,6 +136,7 @@ Policies and guidelines
128136
testing
129137

130138
.. grid-item-card::
139+
:shadow: none
131140

132141
**Documentation**
133142
^^^
@@ -139,6 +148,7 @@ Policies and guidelines
139148
style_guide
140149

141150
.. grid-item-card::
151+
:shadow: none
142152

143153
**Triage**
144154
^^^
@@ -148,6 +158,7 @@ Policies and guidelines
148158
| :ref:`triage_workflow`
149159
150160
.. grid-item-card::
161+
:shadow: none
151162

152163
**Maintenance**
153164
^^^

‎doc/devel/troubleshooting.rst

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
.. _troubleshooting-faq:
2+
3+
.. redirect-from:: /faq/troubleshooting_faq
4+
.. redirect-from:: /users/faq/troubleshooting_faq
5+
6+
===============
7+
Troubleshooting
8+
===============
9+
10+
For guidance on debugging an installation, see :ref:`troubleshooting-install`.
11+
12+
13+
.. _git-trouble:
14+
15+
Problems with git
16+
=================
17+
18+
First, make sure you have a clean build and install (see :ref:`clean-install`),
19+
get the latest git update, install it and run a simple test script in debug
20+
mode::
21+
22+
rm -rf /path/to/site-packages/matplotlib*
23+
git clean -xfd
24+
git pull
25+
python -m pip install -v . > build.out
26+
python -c "from pylab import *; set_loglevel('debug'); plot(); show()" > run.out
27+
28+
and post :file:`build.out` and :file:`run.out` to the `matplotlib-devel
29+
<https://mail.python.org/mailman/listinfo/matplotlib-devel>`_
30+
mailing list (please do not post git problems to the `users list
31+
<https://mail.python.org/mailman/listinfo/matplotlib-users>`_).
32+
33+
Of course, you will want to clearly describe your problem, what you
34+
are expecting and what you are getting, but often a clean build and
35+
install will help. See also :ref:`reporting-problems`.
36+
37+
Unlink of file ``*/_c_internal_utils.cp311-win_amd64.pyd`` failed
38+
============================================================================
39+
40+
The DLL files may be loaded by multiple running instances of Matplotlib; therefore
41+
check that Matplotlib is not running in any other application before trying to
42+
unlink this file. Multiple versions of Matplotlib can be linked to the same DLL,
43+
for example a development version installed in a development conda environment
44+
and a stable version running in a Jupyter notebook. To resolve this error, fully
45+
close all running instances of Matplotlib.

‎doc/index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ Learn
5656
users/explain/quick_start
5757
User guide <users/index.rst>
5858
tutorials/index.rst
59-
users/faq/index.rst
59+
users/faq.rst
6060

6161
.. grid-item-card::
6262
:padding: 2

0 commit comments

Comments
 (0)