@@ -66,7 +66,7 @@ you will also need to install compatible versions of
6666`pyparsing <https://pypi.python.org/pypi/pyparsing/>`_ and
6767`six <https://pypi.python.org/pypi/six>`_
6868in addition to
69- `matplotlib <https ://pypi.python. org/pypi/matplotlib >`_.
69+ `matplotlib <http ://matplotlib. org/downloads.html >`_.
7070
7171In case Python is not installed for all users (not the default), the
7272Microsoft Visual C++ 2008 (
@@ -106,14 +106,15 @@ standard Python shell or IPython. It is enabled as the default backend
106106for the official binaries. GTK3 is not supported on Windows.
107107
108108The Windows installers (:file:`*.exe`) and wheels (:file:`*.whl`) on
109- the download page do not contain test data or example code.
109+ the `download page <http://matplotlib.org/downloads.html>`_ do not
110+ contain test data or example code.
110111If you want to try the many demos that come in the matplotlib source
111- distribution, download the zip file and look in the :file:`examples`
112- subdirectory.
113- To run the test suite, copy the lib\matplotlib\tests and
114- lib\mpl_toolkits\tests directories from the source distribution to
115- sys.prefix\Lib\site-packages\matplotlib and
116- sys.prefix\Lib\site-packages\mpl_toolkits respectively, and install
112+ distribution, download the :file:`*.tar.gz` file and look in the
113+ :file:`examples` subdirectory.
114+ To run the test suite, copy the :file:` lib\matplotlib\tests` and
115+ :file:` lib\mpl_toolkits\tests` directories from the source distribution to
116+ :file:` sys.prefix\Lib\site-packages\matplotlib` and
117+ :file:` sys.prefix\Lib\site-packages\mpl_toolkits` respectively, and install
117118`nose <https://pypi.python.org/pypi/nose>`_,
118119`mock <https://pypi.python.org/pypi/mock>`_,
119120Pillow, MiKTeX, GhostScript, ffmpeg, avconv, mencoder, ImageMagick, and
@@ -163,9 +164,11 @@ Build requirements
163164
164165These are external packages which you will need to install before
165166installing matplotlib. If you are building on OSX, see
166- :ref:`build_osx`. If you are installing dependencies with a package
167- manager on Linux, you may need to install the development packages
168- (look for a "-dev" postfix) in addition to the libraries themselves.
167+ :ref:`build_osx`. If you are building on Windows, see
168+ :ref:`build_windows`. If you are installing dependencies with a
169+ package manager on Linux, you may need to install the development
170+ packages (look for a "-dev" postfix) in addition to the libraries
171+ themselves.
169172
170173
171174Required Dependencies
@@ -197,9 +200,7 @@ six 1.3 or later
197200libpng 1.2 (or later)
198201 library for loading and saving :term:`PNG` files (`download
199202 <http://www.libpng.org/pub/png/libpng.html>`__). libpng requires
200- zlib. If you are a Windows user, you can ignore this because we
201- build support into the matplotlib single-click installer
202-
203+ zlib.
203204
204205Optional GUI framework
205206^^^^^^^^^^^^^^^^^^^^^^
@@ -235,13 +236,23 @@ ImageMagick
235236Optional dependencies
236237^^^^^^^^^^^^^^^^^^^^^
237238
238- `Pillow http://python-imaging.github.io/`__
239+ `Pillow < http://python-imaging.github.io/>`_
239240 If Pillow is installed, matplotlib can read and write a larger
240241 selection of image file formats.
241242
243+ :term:`freetype` 2.4 or later
244+ library for reading true type font files. Matplotlib in known
245+ to work with freetype 2.3, and the required version will be reduced
246+ in 1.4.1. If you need to build from source on a system which only has
247+ freetype 2.3 available, please edit L945 of `setupext.py` to reduce
248+ `min_version` to 2.3.
249+
250+ `pytz`
251+ Required if you want to manipulate datetime objects which are time-zone
252+ aware. An exception will be raised if you try to make time-zone aware
253+ plots with out `pytz` installed. It will become a required dependency
254+ in 1.4.1.
242255
243- :term:`freetype` 1.4 (or later)
244- library for reading true type font files.
245256
246257
247258Required libraries that ship with matplotlib
@@ -295,12 +306,20 @@ the different OSX version (e.g., 10.4 and 10.5). We recommend that you build
295306the way we do for the OSX release: get the source from the tarball or the
296307git repository and follow the instruction in :file:`README.osx`.
297308
298- .. _build_osx:
309+
310+ .. _build_windows:
311+
299312
300313Building on Windows
301314-------------------
302315
303- Building for source on windows can be difficult. Please see
304- `matplotlib-windbuild
305- <https://github.com/jbmohler/matplotlib-winbuild>`_ for detailed
306- instructions, dependency source blobs, and helper scripts.
316+ The Python shipped from http://www.python.org is compiled with Visual Studio
317+ 2008 for versions before 3.3 and Visual Studio 2010 for 3.3 and later. Python
318+ extensions are recommended to be compiled with the same compiler. The .NET
319+ Framework 4.0 is required for MSBuild (you'll likely have the requisite
320+ Framework with Visual Studio). In addition to Visual Studio `CMake
321+ <http://www.cmake.org>`_ is required for building libpng.
322+
323+ Since there is no canonical Windows package manager the build methods for
324+ freetype, zlib, libpng, tcl, & tk source code are documented as a build script
325+ at `matplotlib-winbuild <https://github.com/jbmohler/matplotlib-winbuild>`.
0 commit comments