README.rst

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