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