mesa/docs
Dylan Baker 07f1ef5656 docs: Update stable process around using fixes: and gitlab
Currently the docs still recommend using
mesa-stable@lists.freedesktop.org, which is pretty awful. We really
don't want a second mailing list and it's mostly full of junk because of
CC: tags anyway.

This changes the preferred actions to be:
1) use a fixes: tag ahead of time
2) use a Cc tag ahead of time if fixes isn't appropriate
3) Use a gitlab MR against the staging/ branch for post-merge/backport
   nominations

Reviewed-by: Timothy Arceri <tarceri@itsqueeze.com>
Tested-by: Marge Bot <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/3056>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/3056>
2020-03-05 18:24:14 +00:00
..
relnotes glapi/copyimage: Implement CopyImageSubDataNV 2020-02-24 16:31:06 +00:00
specs Revert "egl: Add EGL_CONFIG_SELECT_GROUP_MESA ext." 2019-10-18 18:41:51 +00:00
application-issues.html docs: add more more code-tags 2019-06-05 23:48:44 +02:00
ARB_color_buffer_float.txt
bugs.html docs: Update bug report URLs for the gitlab migration 2019-09-19 16:37:36 +00:00
codingstyle.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
conform.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
contents.html docs: fixup link-target 2019-06-13 14:14:05 +00:00
debugging.html docs: add more more code-tags 2019-06-05 23:48:44 +02:00
developers.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
devinfo.html docs: remove trailing newlines 2020-01-18 11:39:22 +01:00
dispatch.html docs: remove trailing header 2020-01-18 11:39:14 +01:00
download.html docs: reword a bit and list HTTPS before FTP 2019-12-10 15:21:23 +00:00
egl.html docs: remove pointless haiku-comment 2019-06-13 14:14:05 +00:00
envvars.html radv: implement a dummy winsys for creating devices without AMDGPU 2020-02-26 08:09:46 +01:00
extensions.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
faq.html docs: work around broken dsbox.com link 2019-06-13 14:14:05 +00:00
favicon.ico docs: add favicon to the website 2018-05-29 14:48:21 +01:00
favicon.png docs: add favicon to the website 2018-05-29 14:48:21 +01:00
features.txt docs/features: add v3d driver 2020-03-02 15:54:40 +01:00
gears.png
helpwanted.html docs: Update bug report URLs for the gitlab migration 2019-09-19 16:37:36 +00:00
index.html docs: Update index, relnotes, and release-calendar for 20.0 2020-02-20 14:15:37 -08:00
install.html docs: fix paragraphs 2020-01-17 13:18:25 +01:00
intro.html docs: fixup indentation 2020-01-18 11:39:32 +01:00
libGL.txt glx: turn LIBGL_ALWAYS_INDIRECT into a boolean 2017-09-12 13:53:12 +01:00
license.html docs: use [1] instead of asterisk for footnote 2020-01-18 11:39:25 +01:00
lists.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
llvmpipe.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
mesa.css docs: use figure/figcaption instead of tables 2020-01-18 11:39:07 +01:00
meson.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
opengles.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
osmesa.html docs: fix "empty array" meson syntax 2019-08-04 12:21:19 +01:00
perf.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
postprocess.html docs: remove pointless trailing hard-breaks 2019-06-05 23:48:45 +02:00
precompiled.html docs: do not use br-tag for non-significant breaks 2019-06-05 23:48:45 +02:00
README.UVD radeon/uvd: add H.265/HEVC to legal notes 2015-11-08 18:16:01 -05:00
README.VCE radeon/winsys: add VCE support v4 2014-02-13 11:11:24 +01:00
README.WIN32 docs: https all the links \o/ 2017-02-09 11:28:15 +00:00
release-calendar.html docs: Update index, relnotes, and release-calendar for 20.0 2020-02-20 14:15:37 -08:00
releasing.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
relnotes.html docs: Update index, relnotes, and release-calendar for 20.0 2020-02-20 14:15:37 -08:00
repository.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
shading.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
sourcedocs.html docs: update doxygen-links 2019-06-05 23:48:45 +02:00
sourcetree.html docs: fixup indentation 2020-01-18 11:39:32 +01:00
submittingpatches.html docs: Update stable process around using fixes: and gitlab 2020-03-05 18:24:14 +00:00
systems.html docs: Update Platforms and Drivers page with more comprehensive information. 2019-07-31 22:50:43 +00:00
thanks.html docs: work around broken altsoftware.com link 2019-06-13 14:14:05 +00:00
utilities.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
VERSIONS Fix a few typos 2015-04-27 17:28:29 +03:00
versions.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
viewperf.html docs: remove stray whitespace 2019-06-05 23:48:45 +02:00
vmware-guest.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00
webmaster.html docs: drop h1 in header 2019-05-08 07:18:15 +00:00
xlibdriver.html docs: remove leading spaces 2020-01-18 11:39:18 +01:00

File: docs/README.WIN32

Last updated: 21 June 2013


Quick Start
----- -----

Windows drivers are build with SCons.  Makefiles or Visual Studio projects are
no longer shipped or supported.

Run

  scons libgl-gdi

to build gallium based GDI driver.

This will work both with MSVS or Mingw.


Windows Drivers
------- -------

At this time, only the gallium GDI driver is known to work.

Source code also exists in the tree for other drivers in
src/mesa/drivers/windows, but the status of this code is unknown.

Recipe
------

Building on windows requires several open-source packages. These are
steps that work as of this writing.

- install python 2.7
- install scons (latest)
- install mingw, flex, and bison
- install pywin32 from here: http://www.lfd.uci.edu/~gohlke/pythonlibs
  get pywin32-218.4.win-amd64-py2.7.exe
- install git
- download mesa from git
  see https://www.mesa3d.org/repository.html
- run scons

General
-------

After building, you can copy the above DLL files to a place in your
PATH such as $SystemRoot/SYSTEM32.  If you don't like putting things
in a system directory, place them in the same directory as the
executable(s).  Be careful about accidentially overwriting files of
the same name in the SYSTEM32 directory.

The DLL files are built so that the external entry points use the
stdcall calling convention.

Static LIB files are not built.  The LIB files that are built with are
the linker import files associated with the DLL files.

The si-glu sources are used to build the GLU libs.  This was done
mainly to get the better tessellator code.

If you have a Windows-related build problem or question, please post
to the mesa-dev or mesa-users list.