From ebe0796ba2d314202c30a1c9291a7e725c64b16a Mon Sep 17 00:00:00 2001 From: José Fonseca Date: Wed, 17 Jun 2009 10:12:11 +0100 Subject: docs: Document building with SCons. --- docs/install.html | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 50 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/install.html b/docs/install.html index be61ef3043..953d2094d5 100644 --- a/docs/install.html +++ b/docs/install.html @@ -21,6 +21,7 @@
  • Building OpenGL programs with pkg-config
  • Windows +
  • SCons
  • Other
    @@ -328,13 +329,60 @@ For example, compiling and linking a GLUT application can be done with:

    2. Windows Compilation and Installation

    -Please see the README.WIN32 file. +Please see the instructions on building with SCons. +Alternatively see README.WIN32 file.

    + +

    3. Building with SCons

    + +

    +To build Mesa with SCons on Linux or Windows do +

    +
    +    scons
    +
    +

    +The build output will be placed in +build/platform-machine-debug/..., where platform is for +example linux or windows, machine is x86 or x86_64, optionally followed +by -debug for debug builds. +

    + +

    +The sample programs are built seperately. To build them do +

    +    scons -C progs
    +
    +And the build output will be placed in progs/build/... +

    + +

    +To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do +

    +
    +    scons platform=windows toolchain=crossmingw machine=x86 statetrackers=mesa drivers=softpipe,trace winsys=gdi
    +    scons -C progs platform=windows toolchain=crossmingw machine=x86 -k
    +
    +

    +This will create: +

    +
      +
    • build/windows-x86-debug/gallium/winsys/gdi/opengl32.dll — Mesa + Gallium + softpipe, binary compatible with Windows's opengl32.dll +
    • build/windows-x86-debug/glut/glx/glut32.dll +
    • progs/build/windows-x86-debug/wgl/wglinfo.exe +
    • progs/build/windows-x86-debug/trivial/tri.exe +
    • and many other samples in progs/build/windows-x86-debug/... +
    +

    +Put them all in the same directory to test them. +

    + +
    -

    3. Other systems

    +

    4. Other systems

    Documentation for other environments (some may be very out of date): -- cgit v1.2.3