| 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 ``amber`` 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/amber/docs>`__.
|
|---|
| 46 |
|
|---|
