From 0fa854aea5ff0a8fe7ed21fef8e9ae2551bae486 Mon Sep 17 00:00:00 2001 From: Emil Velikov Date: Wed, 29 Jun 2016 13:13:25 +0100 Subject: [PATCH] docs: rework/update install.html Still far from perfect, but a few small steps in the right direction. - Split build systems, compilers, third party tools - Mention building mesa for Android (part of AOSP) - Drop explicit "other" dependencies. Reference to disto methods to get them. - HTML 4.01 Traditional compliance fixes - mixed ul and br tags. - nuke dead links README.{CYGWIN,VMS} v2: Squash typos, add note about buggy flex 2.6.2 (Eric), add Suse zipper command (Tobias). Signed-off-by: Emil Velikov Reviewed-by: Brian Paul --- docs/install.html | 111 +++++++++++++++++++++++++++++----------------- 1 file changed, 71 insertions(+), 40 deletions(-) diff --git a/docs/install.html b/docs/install.html index 8b349c40b9d..7a690c9ef9b 100644 --- a/docs/install.html +++ b/docs/install.html @@ -24,7 +24,7 @@
  • Building with autoconf (Linux/Unix/X11)
  • Building with SCons (Windows/Linux) -
  • Building for other systems +
  • Building with AOSP (Android)
  • Library Information
  • Building OpenGL programs with pkg-config @@ -33,62 +33,85 @@

    1. Prerequisites for building

    1.1 General

    + +

    +Build system. +

    + +
      +
    • Autoconf is required when building on *nix platforms. +
    • SCons is required for building on +Windows and optional for Linux (it's an alternative to autoconf/automake.) +
      • +
    • Android Build system when building as native Android component. Autoconf +is used when when building ARC. +
      • +
    + + +

    +The following compilers are known to work, if you know of others or you're +willing to maintain support for other compiler get in touch. +

    + +
      +
    • GCC 4.2.0 or later (some parts of Mesa may require later versions) +
    • clang - exact minimum requirement is currently unknown. +
    • Microsoft Visual Studio 2013 Update 4 or later is required, for building on Windows. +
    + + +

    +Third party/extra tools. +
    +Note: These should not be required, when building from a release tarball. If +you think you've spotted a bug let developers know by filing a +bug report. +

    + +
    • Python - Python is required. Version 2.6.4 or later should work.
      • -
    • Python Mako module - Python Mako module is required. Version 0.3.4 or later should work.
      • -
      -
    • SCons is required for building on -Windows and optional for Linux (it's an alternative to autoconf/automake.) -
      • -
      -
    • lex / yacc - for building the GLSL compiler. -
      -
      -On Linux systems, flex and bison are used. -Versions 2.5.35 and 2.4.1, respectively, (or later) should work. -
      -
      +
    • lex / yacc - for building the Mesa IR and GLSL compiler. +
      +On Linux systems, flex and bison versions 2.5.35 and 2.4.1, respectively, +(or later) should work. On Windows with MinGW, install flex and bison with: 
      mingw-get install msys-flex msys-bison
      For MSVC on Windows, install Win flex-bison. -
      • -
      -
    • For building on Windows, Microsoft Visual Studio 2013 or later is required. -
      • +
    +

    Note: Some versions can be buggy (eg. flex 2.6.2) so do try others if things fail.

    -

    1.2 For DRI and hardware acceleration

    +

    1.2 Requirements

    -The following are required for DRI-based hardware acceleration with Mesa: +The requirements depends on the features selected at configure stage. +Check/install the respective -devel package as prompted by the configure error +message.

    -
      -
    • -dri2proto version 2.6 or later -
    • libDRM latest version -
    • Xorg server version 1.5 or later -
    • Linux 2.6.28 or later -

    -If you're using a fedora distro the following command should install all -the needed dependencies: +Here are some common ways to retrieve most/all of the dependencies based on +the packaging tool used by your distro.

    + 
    -  sudo yum install flex bison imake libtool xorg-x11-proto-devel libdrm-devel \
-  gcc-c++ xorg-x11-server-devel libXi-devel libXmu-devel libXdamage-devel git \
-  expat-devel llvm-devel python-mako
+  zypper source-install --build-deps-only Mesa # openSUSE/SLED/SLES
+  yum-builddep mesa # yum Fedora, OpenSuse(?)
+  dnf builddep mesa # dnf Fedora
+  apt-get build-dep mesa # Debian and derivatives
+  ... # others
    -

    2. Building with autoconf (Linux/Unix/X11)

    @@ -139,22 +162,30 @@ This will create:

    Put them all in the same directory to test them. + +Additional information is available in README.WIN32. +

    -

    4. Building for other systems

    +

    4. Building with AOSP (Android)

    -Documentation for other environments (some may be very out of date): +Currently one can build Mesa for Android as part of the AOSP project, yet +your experience might vary.

    - +

    +In order to achieve that one should update their local manifest to point to the +upstream repo, set the approapriate BOARD_GPU_DRIVERS and build the +libGLES_mesa library. +

    +

    +FINISHME: Improve on the instructions add references to Rob H repos/Jenkins, +Android-x86 and/or other resources. +

    5. Library Information

    -- 2.30.2