docs/amber.rst

   1 Amber Branch
   2 ============
   3
   4 After Mesa 21.3, all non-Gallium DRI drivers were removed from the Mesa
   5 source-tree. These drivers are still being maintained to some degree,
   6 but only on the 21.3.x branch, and only for critical fixes.
   7
   8 These drivers include:
   9
  10 -  Radeon
  11 -  r200
  12 -  i915
  13 -  i965
  14 -  Nouveau (the DRI driver for NV04-NV20)
  15
  16 At the same time, the OpenSWR Gallium driver was removed from the Mesa
  17 source-tree, because it was already practically speaking unmaintained and
  18 the actively maintained LLVMpipe offers much of the same functionality.
  19
  20 Users with Intel GPUs that were using i965 should migrate to either Iris
  21 or Crocus, depending on their GPU. These drivers generally speaking both
  22 perform better and have more features than i965 had, and due to sharing
  23 more code with the rest of the Mesa infrastructure, gets more bug fixes
  24 and features.
  25
  26 Similarly, users of i915 should migrate to i915g (the Gallium driver for
  27 the same hardware), as it's still being maintained.
  28
  29 Users who depend on the removed drivers will have to use them built from
  30 the Amber branch in order to get updates.
  31
  32 Building
  33 --------
  34
  35 The Amber branch has some extra logic to be able to coexist with recent
  36 Mesa releases without them stepping on each others toes. In order to
  37 enable that logic, you need to pass the ``-Damber=true`` flag to Meson.
  38
  39 Documentation
  40 -------------
  41
  42 On `docs.mesa3d.org <https://docs.mesa3d.org/>`, we currently only
  43 publish the documentation from our main branch. But you can view the
  44 documentation for the Amber branch `here
  45 <https://gitlab.freedesktop.org/mesa/mesa/-/tree/21.3/docs>`_.
  46