blob: 5f74f11791226166a923c40c107751d0c36e2783 [file] [log] [blame]
Eric Engestromeadc0682018-06-08 16:56:03 +01001`Mesa <https://mesa3d.org>`_ - The 3D Graphics Library
2======================================================
3
4
5Source
6------
7
8This repository lives at https://gitlab.freedesktop.org/mesa/mesa.
9Other repositories are likely forks, and code found there is not supported.
10
11
12Build status
13------------
14
15Travis:
16
17.. image:: https://travis-ci.org/mesa3d/mesa.svg?branch=master
18 :target: https://travis-ci.org/mesa3d/mesa
19
20Appveyor:
21
22.. image:: https://img.shields.io/appveyor/ci/mesa3d/mesa.svg
23 :target: https://ci.appveyor.com/project/mesa3d/mesa
24
25Coverity:
26
27.. image:: https://scan.coverity.com/projects/139/badge.svg?flat=1
28 :target: https://scan.coverity.com/projects/mesa
29
30
31Build & install
32---------------
33
34You can find more information in our documentation (`docs/install.html
35<https://mesa3d.org/install.html>`_), but the recommended way is to use
36Meson (`docs/meson.html <https://mesa3d.org/meson.html>`_):
37
38.. code-block:: sh
39
40 $ mkdir build
41 $ cd build
42 $ meson ..
43 $ sudo ninja install
44
45
46Support
47-------
48
49Many Mesa devs hang on IRC; if you're not sure which channel is
50appropriate, you should ask your question on `Freenode's #dri-devel
51<irc://chat.freenode.net#dri-devel>`_, someone will redirect you if
52necessary.
53Remember that not everyone is in the same timezone as you, so it might
54take a while before someone qualified sees your question.
55
56The next best option is to ask your question in an email to the
57mailing lists: `mesa-dev\@lists.freedesktop.org
58<https://lists.freedesktop.org/mailman/listinfo/mesa-dev>`_
59
60
61Bug reports
62-----------
63
64If you think something isn't working properly, please file a bug report
65(`docs/bugs.html <https://mesa3d.org/bugs.html>`_).
66
67
68Contributing
69------------
70
71Contributions are welcome, and step-by-step instructions can be found in our
72documentation (`docs/submittingpatches.html
73<https://mesa3d.org/submittingpatches.html>`_).
74
75Note that Mesa uses email mailing-lists for patches submission, review and
76discussions.