| Erik Faye-Lund | 4d06683 | 2020-06-12 20:09:42 +0200 | [diff] [blame] | 1 | Downloading and Unpacking |
| 2 | ========================= |
| 3 | |
| 4 | Downloading |
| 5 | ----------- |
| 6 | |
| 7 | You can download the released versions of Mesa via |
| 8 | `HTTPS <https://mesa.freedesktop.org/archive/>`__ or |
| 9 | `FTP <ftp://ftp.freedesktop.org/pub/mesa/>`__. |
| 10 | |
| 11 | Starting with the first release of 2017, Mesa's version scheme is |
| 12 | year-based. Filenames are in the form ``mesa-Y.N.P.tar.gz``, where ``Y`` |
| 13 | is the year (two digits), ``N`` is an incremental number (starting at 0) |
| 14 | and ``P`` is the patch number (0 for the first release, 1 for the first |
| 15 | patch after that). |
| 16 | |
| 17 | When a new release is coming, release candidates (betas) may be found in |
| 18 | the same directory, and are recognisable by the |
| 19 | ``mesa-Y.N.P-rcX.tar.gz`` filename. |
| 20 | |
| 21 | Unpacking |
| 22 | --------- |
| 23 | |
| 24 | Mesa releases are available in two formats: ``.tar.xz`` and ``.tar.gz``. |
| 25 | |
| 26 | To unpack the tarball: |
| 27 | |
| Erik Faye-Lund | d6be994 | 2019-06-04 14:14:13 +0200 | [diff] [blame] | 28 | .. code-block:: console |
| Erik Faye-Lund | 4d06683 | 2020-06-12 20:09:42 +0200 | [diff] [blame] | 29 | |
| 30 | tar xf mesa-Y.N.P.tar.xz |
| 31 | |
| 32 | or |
| 33 | |
| Erik Faye-Lund | d6be994 | 2019-06-04 14:14:13 +0200 | [diff] [blame] | 34 | .. code-block:: console |
| Erik Faye-Lund | 4d06683 | 2020-06-12 20:09:42 +0200 | [diff] [blame] | 35 | |
| 36 | tar xf mesa-Y.N.P.tar.gz |
| 37 | |
| 38 | Contents |
| 39 | -------- |
| 40 | |
| Erik Faye-Lund | 9be0e2d | 2020-06-15 12:31:36 +0200 | [diff] [blame] | 41 | Proceed to the :doc:`compilation and installation |
| 42 | instructions <install>`. |
| Erik Faye-Lund | 4d06683 | 2020-06-12 20:09:42 +0200 | [diff] [blame] | 43 | |
| 44 | Demos, GLUT, and GLU |
| 45 | -------------------- |
| 46 | |
| 47 | A package of SGI's GLU library is available |
| 48 | `here <ftp://ftp.freedesktop.org/pub/mesa/glu/>`__ |
| 49 | |
| 50 | A package of Mark Kilgard's GLUT library is available |
| 51 | `here <ftp://ftp.freedesktop.org/pub/mesa/glut/>`__ |
| 52 | |
| 53 | The Mesa demos collection is available |
| 54 | `here <ftp://ftp.freedesktop.org/pub/mesa/demos/>`__ |
| 55 | |
| 56 | In the past, GLUT, GLU and the Mesa demos were released in conjunction |
| 57 | with Mesa releases. But since GLUT, GLU and the demos change |
| 58 | infrequently, they were split off into their own git repositories: |
| 59 | `GLUT <https://gitlab.freedesktop.org/mesa/glut>`__, |
| 60 | `GLU <https://gitlab.freedesktop.org/mesa/glu>`__ and |
| 61 | `Demos <https://gitlab.freedesktop.org/mesa/demos>`__, |