panvk: document reason for maxResourceSize-limit
[mesa.git] / README.rst
blobd9f2f06e9b0f9a64535bd33c814656e2871c88dd
1 `Mesa <https://mesa3d.org>`_ - The 3D Graphics Library
2 ======================================================
5 Source
6 ------
8 This repository lives at https://gitlab.freedesktop.org/mesa/mesa.
9 Other repositories are likely forks, and code found there is not supported.
12 Build & install
13 ---------------
15 You can find more information in our documentation (`docs/install.rst
16 <https://docs.mesa3d.org/install.html>`_), but the recommended way is to use
17 Meson (`docs/meson.rst <https://docs.mesa3d.org/meson.html>`_):
19 .. code-block:: sh
21   $ meson setup build
22   $ ninja -C build/
23   $ sudo ninja -C build/ install
25 Support
26 -------
28 Many Mesa devs hang on IRC; if you're not sure which channel is
29 appropriate, you should ask your question on `OFTC's #dri-devel
30 <irc://irc.oftc.net/dri-devel>`_, someone will redirect you if
31 necessary.
32 Remember that not everyone is in the same timezone as you, so it might
33 take a while before someone qualified sees your question.
34 To figure out who you're talking to, or which nick to ping for your
35 question, check out `Who's Who on IRC
36 <https://dri.freedesktop.org/wiki/WhosWho/>`_.
38 The next best option is to ask your question in an email to the
39 mailing lists: `mesa-dev\@lists.freedesktop.org
40 <https://lists.freedesktop.org/mailman/listinfo/mesa-dev>`_
43 Bug reports
44 -----------
46 If you think something isn't working properly, please file a bug report
47 (`docs/bugs.rst <https://docs.mesa3d.org/bugs.html>`_).
50 Contributing
51 ------------
53 Contributions are welcome, and step-by-step instructions can be found in our
54 documentation (`docs/submittingpatches.rst
55 <https://docs.mesa3d.org/submittingpatches.html>`_).
57 Note that Mesa uses gitlab for patches submission, review and discussions.