docs/download.rst

   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
  28 .. code-block:: console
  29
  30       tar xf mesa-Y.N.P.tar.xz
  31
  32 or
  33
  34 .. code-block:: console
  35
  36       tar xf mesa-Y.N.P.tar.gz
  37
  38 Contents
  39 --------
  40
  41 Proceed to the :doc:`compilation and installation
  42 instructions <install>`.
  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>`__,