On 16 November 2016 at 22:56, Eric Engestrom <e...@engestrom.ch> wrote:
> On Wednesday, 2016-11-16 18:46:23 +0000, Emil Velikov wrote:
>> From: Emil Velikov <emil.veli...@collabora.com>
>>
>> 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}
>>
>> Signed-off-by: Emil Velikov <emil.veli...@collabora.com>
>> ---
>> docs/install.html | 109
>> ++++++++++++++++++++++++++++++++++--------------------
>> 1 file changed, 69 insertions(+), 40 deletions(-)
>>
>> diff --git a/docs/install.html b/docs/install.html
>> index 8b349c4..28aef22 100644
>> --- a/docs/install.html
>> +++ b/docs/install.html
>> @@ -24,7 +24,7 @@
>> </ul>
>> <li><a href="#autoconf">Building with autoconf (Linux/Unix/X11)</a>
>> <li><a href="#scons">Building with SCons (Windows/Linux)</a>
>> -<li><a href="#other">Building for other systems</a>
>> +<li><a href="#android">Building with AOSP (Android)</a>
>> <li><a href="#libs">Library Information</a>
>> <li><a href="#pkg-config">Building OpenGL programs with pkg-config</a>
>> </ol>
>> @@ -33,62 +33,83 @@
>> <h1 id="prereq-general">1. Prerequisites for building</h1>
>>
>> <h2>1.1 General</h2>
>> +
>> +<p>
>> +Build system.
>> +</p>
>> +
>> +<ul>
>> +<li>Autoconf is required when building on *nix platforms.
>> +<li><a href="http://www.scons.org/";>SCons</a> is required for building on
>> +Windows and optional for Linux (it's an alternative to autoconf/automake.)
>> +</li>
>> +<li>Android Build system when building as native Android component. Autoconf
>> +is used when when building ARC.
>> +</li>
>> +</ul>
>> +
>> +
>> +<p>
>> +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.
>> +</p>
>> +
>> +<ul>
>> +<li>GCC 4.2.0 or later (some parts of Mesa may require later versions)
>> +<li>clang - exact minimum requirement is currently unknown.
>> +<li>Microsoft Visual Studio 2013 Update 4 or later is required, for
>> building on Windows.
>> +</ul>
>> +
>> +
>> +<p>
>> +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
>> +<a href="bugs.html">bug report</a>.
>> +</p>
>> +
>> +
>> <ul>
>> <li><a href="http://www.python.org/";>Python</a> - Python is required.
>> Version 2.6.4 or later should work.
>> </li>
>> -<br>
>> <li><a href="http://www.makotemplates.org/";>Python Mako module</a> -
>> Python Mako module is required. Version 0.3.4 or later should work.
>> </li>
>> -</br>
>> -<li><a href="http://www.scons.org/";>SCons</a> is required for building on
>> -Windows and optional for Linux (it's an alternative to autoconf/automake.)
>> -</li>
>> -<br>
>> -<li>lex / yacc - for building the GLSL compiler.
>> -<br>
>> -<br>
>> -On Linux systems, flex and bison are used.
>> -Versions 2.5.35 and 2.4.1, respectively, (or later) should work.
>> -<br>
>> -<br>
>> +<li>lex / yacc - for building the Mesa IR and GLSL compiler.
>> +<div>
>> +On Linux systems, flex and bison versions 2.5.35 and 2.4.1, respectively,
>> +(or later) should work.
>
> Worth mentioning the flex 2.6.2 bug?
>
I'm split really. Fix seems to be there, but there's no suggestion
from the dev/maintainer about 2.6.3 release.
Barring any objections I'll add
"Some versions can be buggy (eg. flex 2.6.2) so do try another if things fail."
>> On Windows with MinGW, install flex and bison with:
>> <pre>mingw-get install msys-flex msys-bison</pre>
>> For MSVC on Windows, install
>> <a href="http://winflexbison.sourceforge.net/";>Win flex-bison</a>.
>> -</li>
>> -<br>
>> -<li>For building on Windows, Microsoft Visual Studio 2013 or later is
>> required.
>> -</li>
>> +</div>
>> </ul>
>>
>>
>> -<h3 id="prereq-dri">1.2 For DRI and hardware acceleration</h3>
>> +<h3 id="prereq-dri">1.2 Requirements</h3>
>>
>> <p>
>> -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.
>> </p>
>>
>> -<ul>
>> -<li><a href="http://xorg.freedesktop.org/releases/individual/proto/";>
>> -dri2proto</a> version 2.6 or later
>> -<li><a href="http://dri.freedesktop.org/libdrm/";>libDRM</a> latest version
>> -<li>Xorg server version 1.5 or later
>> -<li>Linux 2.6.28 or later
>> -</ul>
>> <p>
>> -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.
>> </p>
>> +
>> <pre>
>> - 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
>> + yum-builddep mesa # yum Fedora/OpenSuse
>> + dnf builddep mesa # dnf Fedora
>> + apt-get build-dep mesa # Debian and derivatives
>
> (We need to get something like this on Arch :/)
>
Yeah, as a Arch user I would love that as well. Then again we'll first need to:
- convince all Arch devs to not rely on implicit/transient
dependencies. only seem to be some sold on the idea.
- enhance pacman/makepkg.
>> +<p>
>> +FINISHME: Improve on the instructions add references to Rob H repos/Jenkins,
>> +Android-x86 and/or other resources.
>> +</p>
>
> Did you mean to leave that in?
>
Since I don't have plans to expand on it I've explicitly let it in.
This way people can use the references to look things up, until we get
a volunteer to finish it.
> Other than these few notes, the series is:
> Reviewed-by: Eric Engestrom <e...@engestrom.ch>
>
Thanks
Emil
_______________________________________________
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev
