docs: update 18.3.0 release notes

Signed-off-by: Emil Velikov <emil.velikov@collabora.com>

.editorconfig

@@ -11,7 +11,6 @@ tab_width = 8
 [*.{c,h,cpp,hpp,cc,hh}]
 indent_style = space
 indent_size = 3
-max_line_length = 78
 
 [{Makefile*,*.mk}]
 indent_style = tab
@@ -35,6 +34,6 @@ indent_size = 2
 [*.patch]
 trim_trailing_whitespace = false
 
-[{meson.build,meson_options.txt}]
+[meson.build,meson_options.txt]
 indent_style = space
 indent_size = 2

.gitignore

@@ -1,4 +1,54 @@
+*.a
+*.dll
+*.exe
+*.ilk
+*.la
+*.lo
+*.log
+*.o
+*.obj
+*.orig
+*.os
+*.pc
+*.pdb
 *.pyc
 *.pyo
-*.out
+*.rej
+*.so
+*.so.*
+*.sw[a-z]
+*.tar
+*.tar.bz2
+*.tar.gz
+*.tar.xz
+*.trs
+*.zip
+*~
+depend
+depend.bak
+bin/ltmain.sh
+lib
+lib64
+configure
+configure.lineno
+autom4te.cache
+aclocal.m4
+config.log
+config.status
+cscope*
+tags
+.scon*
+config.py
 build
+libtool
+manifest.txt
+.dir-locals.el
+.deps/
+.dirstamp
+.libs/
+Makefile
+Makefile.in
+.install-mesa-links
+.install-gallium-links
+/src/git_sha1.h
+TAGS

.gitlab-ci.yml

@@ -1,308 +0,0 @@
-# This is the tag of the docker image used for the build jobs. If the
-# image doesn't exist yet, the containers-build stage generates it.
-#
-# In order to generate a new image, one should generally change the tag.
-# While removing the image from the registry would also work, that's not
-# recommended except for ephemeral images during development: Replacing
-# an image after a significant amount of time might pull in newer
-# versions of gcc/clang or other packages, which might break the build
-# with older commits using the same tag.
-#
-# After merging a change resulting in generating a new image to the
-# main repository, it's recommended to remove the image from the source
-# repository's container registry, so that the image from the main
-# repository's registry will be used there as well.
-variables:
-  UPSTREAM_REPO: mesa/mesa
-  DEBIAN_TAG: "2019-07-11"
-  DEBIAN_VERSION: stretch-slim
-  DEBIAN_IMAGE: "$CI_REGISTRY_IMAGE/debian/$DEBIAN_VERSION:$DEBIAN_TAG"
-
-include:
-  - project: 'wayland/ci-templates'
-    ref: c73dae8b84697ef18e2dbbf4fed7386d9652b0cd
-    file: '/templates/debian.yml'
-
-stages:
-  - containers-build
-  - build+test
-
-
-# When to automatically run the CI
-.ci-run-policy: &ci-run-policy
-  only:
-    - branches@mesa/mesa
-    - merge_requests
-    - /^ci([-/].*)?$/
-  retry:
-    max: 2
-    when:
-      - runner_system_failure
-
-
-# CONTAINERS
-
-debian:
-  extends: .debian@container-ifnot-exists
-  stage: containers-build
-  <<: *ci-run-policy
-  variables:
-    GIT_STRATEGY: none # no need to pull the whole tree for rebuilding the image
-    DEBIAN_EXEC: 'bash .gitlab-ci/debian-install.sh'
-
-
-# BUILD
-
-.build:
-  <<: *ci-run-policy
-  image: $DEBIAN_IMAGE
-  stage: build+test
-  cache:
-    paths:
-      - ccache
-  artifacts:
-    when: on_failure
-    untracked: true
-  variables:
-    CCACHE_COMPILERCHECK: "content"
-  # Use ccache transparently, and print stats before/after
-  before_script:
-    - export PATH="/usr/lib/ccache:$PATH"
-    - export CCACHE_BASEDIR="$PWD"
-    - export CCACHE_DIR="$PWD/ccache"
-    - ccache --zero-stats || true
-    - ccache --show-stats || true
-  after_script:
-    - export CCACHE_DIR="$PWD/ccache"
-    - ccache --show-stats
-
-.meson-build:
-  extends: .build
-  script:
-    - .gitlab-ci/meson-build.sh
-
-.scons-build:
-  extends: .build
-  variables:
-    SCONSFLAGS: "-j4"
-  script:
-    - if test -n "$LLVM_VERSION"; then
-        export LLVM_CONFIG="llvm-config-${LLVM_VERSION}";
-      fi
-    - scons $SCONS_TARGET
-    - eval $SCONS_CHECK_COMMAND
-
-# NOTE: Building SWR is 2x (yes two) times slower than all the other
-# gallium drivers combined.
-# Start this early so that it doesn't limit the total run time.
-#
-# We also put softpipe (and therefore gallium nine, which requires
-# it) here, since softpipe/llvmpipe can't be built alongside classic
-# swrast.
-#
-# Putting glvnd here is arbitrary, but we want it in one of the builds
-# for coverage.
-meson-swr-glvnd:
-  extends: .meson-build
-  variables:
-    UNWIND: "true"
-    DRI_LOADERS: >
-      -D glvnd=true
-      -D egl=true
-    GALLIUM_ST: >
-      -D dri3=true
-      -D gallium-vdpau=false
-      -D gallium-xvmc=false
-      -D gallium-omx=disabled
-      -D gallium-va=false
-      -D gallium-xa=false
-      -D gallium-nine=true
-      -D gallium-opencl=disabled
-      -D osmesa=gallium
-    GALLIUM_DRIVERS: "swr,swrast,iris"
-    LLVM_VERSION: "6.0"
-
-meson-clang:
-  extends: .meson-build
-  variables:
-    UNWIND: "true"
-    DRI_DRIVERS: "auto"
-    GALLIUM_DRIVERS: "auto"
-    VULKAN_DRIVERS: intel,amd,freedreno
-    CC: "ccache clang-8"
-    CXX: "ccache clang++-8"
-  before_script:
-    - export CCACHE_BASEDIR="$PWD" CCACHE_DIR="$PWD/ccache"
-    - ccache --zero-stats --show-stats || true
-     # clang++ breaks if it picks up the GCC 8 directory without libstdc++.so
-    - apt-get remove -y libgcc-8-dev
-
-scons-swr:
-  extends: .scons-build
-  variables:
-    SCONS_TARGET: "swr=1"
-    SCONS_CHECK_COMMAND: "true"
-    LLVM_VERSION: "6.0"
-
-scons-win64:
-  extends: .scons-build
-  variables:
-    SCONS_TARGET: platform=windows machine=x86_64
-    SCONS_CHECK_COMMAND: "true"
-
-meson-main:
-  extends: .meson-build
-  variables:
-    UNWIND: "true"
-    DRI_LOADERS: >
-      -D glx=dri
-      -D gbm=true
-      -D egl=true
-      -D platforms=x11,wayland,drm,surfaceless
-      -D osmesa=classic
-    DRI_DRIVERS: "i915,i965,r100,r200,swrast,nouveau"
-    GALLIUM_ST: >
-      -D dri3=true
-      -D gallium-extra-hud=true
-      -D gallium-vdpau=true
-      -D gallium-xvmc=true
-      -D gallium-omx=bellagio
-      -D gallium-va=true
-      -D gallium-xa=true
-      -D gallium-nine=false
-      -D gallium-opencl=disabled
-    GALLIUM_DRIVERS: "iris,nouveau,kmsro,r300,r600,freedreno,svga,v3d,vc4,virgl,etnaviv,panfrost,lima"
-    LLVM_VERSION: "7"
-    EXTRA_OPTION: >
-      -D tools=all
-
-meson-clover:
-  extends: .meson-build
-  variables:
-    UNWIND: "true"
-    DRI_LOADERS: >
-      -D glx=disabled
-      -D egl=false
-      -D gbm=false
-    GALLIUM_ST: >
-      -D dri3=false
-      -D gallium-vdpau=false
-      -D gallium-xvmc=false
-      -D gallium-omx=disabled
-      -D gallium-va=false
-      -D gallium-xa=false
-      -D gallium-nine=false
-      -D gallium-opencl=icd
-  script:
-    - export GALLIUM_DRIVERS="r600,radeonsi"
-    - .gitlab-ci/meson-build.sh
-    - LLVM_VERSION=7 .gitlab-ci/meson-build.sh
-    - export GALLIUM_DRIVERS="i915,r600"
-    - LLVM_VERSION=3.9 .gitlab-ci/meson-build.sh
-    - LLVM_VERSION=4.0 .gitlab-ci/meson-build.sh
-    - LLVM_VERSION=5.0 .gitlab-ci/meson-build.sh
-    - LLVM_VERSION=6.0 .gitlab-ci/meson-build.sh
-
-meson-vulkan:
-  extends: .meson-build
-  variables:
-    UNWIND: "false"
-    DRI_LOADERS: >
-      -D glx=disabled
-      -D gbm=false
-      -D egl=false
-      -D platforms=x11,wayland,drm
-      -D osmesa=none
-    GALLIUM_ST: >
-      -D dri3=true
-      -D gallium-vdpau=false
-      -D gallium-xvmc=false
-      -D gallium-omx=disabled
-      -D gallium-va=false
-      -D gallium-xa=false
-      -D gallium-nine=false
-      -D gallium-opencl=disabled
-    VULKAN_DRIVERS: intel,amd,freedreno
-    LLVM_VERSION: "7"
-    EXTRA_OPTION: >
-      -D vulkan-overlay-layer=true
-
-.meson-cross:
-  extends: .meson-build
-  variables:
-    UNWIND: "false"
-    DRI_LOADERS: >
-      -D glx=disabled
-      -D gbm=false
-      -D egl=false
-      -D platforms=surfaceless
-      -D osmesa=none
-    GALLIUM_ST: >
-      -D dri3=false
-      -D gallium-vdpau=false
-      -D gallium-xvmc=false
-      -D gallium-omx=disabled
-      -D gallium-va=false
-      -D gallium-xa=false
-      -D gallium-nine=false
-      -D llvm=false
-    CROSS: >
-      --libdir lib
-      --cross /tmp/cross_file.txt
-
-  script:
-    - /usr/share/meson/debcrossgen --arch ${ARCH} -o /tmp/cross_file.txt
-    # Work around a bug in debcrossgen that should be fixed in the next release
-    - sed -i "s|cpu_family = 'i686'|cpu_family = 'x86'|g" /tmp/cross_file.txt
-    - .gitlab-ci/meson-build.sh
-
-meson-armhf:
-  extends: .meson-cross
-  variables:
-    ARCH: armhf
-    VULKAN_DRIVERS: freedreno
-    GALLIUM_DRIVERS: "etnaviv,freedreno,kmsro,lima,nouveau,panfrost,tegra,v3d,vc4"
-    # Disable the tests since we're cross compiling.
-    EXTRA_OPTION: >
-      -D build-tests=false
-      -D I-love-half-baked-turnips=true
-      -D vulkan-overlay-layer=true
-
-meson-arm64:
-  extends: .meson-cross
-  variables:
-    ARCH: arm64
-    VULKAN_DRIVERS: freedreno
-    GALLIUM_DRIVERS: "etnaviv,freedreno,kmsro,lima,nouveau,panfrost,tegra,v3d,vc4"
-    # Disable the tests since we're cross compiling.
-    EXTRA_OPTION: >
-      -D build-tests=false
-      -D I-love-half-baked-turnips=true
-      -D vulkan-overlay-layer=true
-
-meson-i386:
-  extends: .meson-cross
-  variables:
-    ARCH: i386
-    VULKAN_DRIVERS: intel
-    GALLIUM_DRIVERS: "swrast"
-    # Disable i386 tests, because u_format_tests gets precision
-    # failures in dxtn unpacking
-    EXTRA_OPTION: >
-      -D build-tests=false
-      -D vulkan-overlay-layer=true
-
-scons-nollvm:
-  extends: .scons-build
-  variables:
-    SCONS_TARGET: "llvm=0"
-    SCONS_CHECK_COMMAND: "scons llvm=0 check"
-
-scons-llvm:
-  extends: .scons-build
-  variables:
-    SCONS_TARGET: "llvm=1"
-    SCONS_CHECK_COMMAND: "scons llvm=1 check"
-    LLVM_VERSION: "3.4"
-    # LLVM 3.4 packages were built with an old libstdc++ ABI
-    CXX: "g++ -D_GLIBCXX_USE_CXX11_ABI=0"

.gitlab-ci/debian-install.sh

@@ -1,214 +0,0 @@
-#!/bin/bash
-
-set -e
-set -o xtrace
-
-export DEBIAN_FRONTEND=noninteractive
-
-CROSS_ARCHITECTURES="armhf arm64 i386"
-for arch in $CROSS_ARCHITECTURES; do
-    dpkg --add-architecture $arch
-done
-
-apt-get install -y \
-      apt-transport-https \
-      ca-certificates \
-      curl \
-      wget \
-      unzip \
-      gnupg \
-      software-properties-common
-
-curl -fsSL https://apt.llvm.org/llvm-snapshot.gpg.key | apt-key add -
-add-apt-repository "deb https://apt.llvm.org/stretch/ llvm-toolchain-stretch-7 main"
-add-apt-repository "deb https://apt.llvm.org/stretch/ llvm-toolchain-stretch-8 main"
-
-sed -i -e 's/http:\/\/deb/https:\/\/deb/g' /etc/apt/sources.list
-echo 'deb https://deb.debian.org/debian stretch-backports main' >/etc/apt/sources.list.d/backports.list
-echo 'deb https://deb.debian.org/debian jessie main' >/etc/apt/sources.list.d/jessie.list
-
-apt-get update
-apt-get install -y -t stretch-backports \
-      llvm-3.4-dev \
-      llvm-3.9-dev \
-      libclang-3.9-dev \
-      llvm-4.0-dev \
-      libclang-4.0-dev \
-      llvm-5.0-dev \
-      libclang-5.0-dev \
-      llvm-6.0-dev \
-      libclang-6.0-dev \
-      llvm-7-dev \
-      libclang-7-dev \
-      llvm-8-dev \
-      libclang-8-dev \
-      g++ \
-      clang-8
-
-# Install remaining packages from Debian buster to get newer versions
-add-apt-repository "deb https://deb.debian.org/debian/ buster main"
-add-apt-repository "deb https://deb.debian.org/debian/ buster-updates main"
-apt-get update
-apt-get install -y \
-      bzip2 \
-      zlib1g-dev \
-      pkg-config \
-      libxrender-dev \
-      libxdamage-dev \
-      libxxf86vm-dev \
-      gcc \
-      libclc-dev \
-      libxvmc-dev \
-      libomxil-bellagio-dev \
-      xz-utils \
-      libexpat1-dev \
-      libx11-xcb-dev \
-      libelf-dev \
-      libunwind-dev \
-      libglvnd-dev \
-      python-mako \
-      python3-mako \
-      meson \
-      scons
-
-# autotools build deps
-apt-get install -y \
-      automake \
-      libtool \
-      bison \
-      flex \
-      gettext \
-      make
-
-# Cross-build Mesa deps
-for arch in $CROSS_ARCHITECTURES; do
-    apt-get install -y \
-            libdrm-dev:${arch} \
-            libexpat1-dev:${arch} \
-            libelf-dev:${arch}
-done
-apt-get install -y \
-        dpkg-dev \
-        gcc-aarch64-linux-gnu \
-        g++-aarch64-linux-gnu \
-        gcc-arm-linux-gnueabihf \
-        g++-arm-linux-gnueabihf \
-        gcc-i686-linux-gnu \
-        g++-i686-linux-gnu
-
-# for 64bit windows cross-builds
-apt-get install -y mingw-w64
-
-# for the vulkan overlay layer
-wget https://github.com/KhronosGroup/glslang/releases/download/master-tot/glslang-master-linux-Release.zip
-unzip glslang-master-linux-Release.zip bin/glslangValidator
-install -m755 bin/glslangValidator /usr/local/bin/
-rm bin/glslangValidator glslang-master-linux-Release.zip
-
-
-# dependencies where we want a specific version
-export              XORG_RELEASES=https://xorg.freedesktop.org/releases/individual
-export               XCB_RELEASES=https://xcb.freedesktop.org/dist
-export           WAYLAND_RELEASES=https://wayland.freedesktop.org/releases
-
-export         XORGMACROS_VERSION=util-macros-1.19.0
-export            GLPROTO_VERSION=glproto-1.4.17
-export          DRI2PROTO_VERSION=dri2proto-2.8
-export       LIBPCIACCESS_VERSION=libpciaccess-0.13.4
-export             LIBDRM_VERSION=libdrm-2.4.99
-export           XCBPROTO_VERSION=xcb-proto-1.13
-export         RANDRPROTO_VERSION=randrproto-1.3.0
-export          LIBXRANDR_VERSION=libXrandr-1.3.0
-export             LIBXCB_VERSION=libxcb-1.13
-export       LIBXSHMFENCE_VERSION=libxshmfence-1.3
-export           LIBVDPAU_VERSION=libvdpau-1.1
-export              LIBVA_VERSION=libva-1.7.0
-export         LIBWAYLAND_VERSION=wayland-1.15.0
-export  WAYLAND_PROTOCOLS_VERSION=wayland-protocols-1.8
-
-wget $XORG_RELEASES/util/$XORGMACROS_VERSION.tar.bz2
-tar -xvf $XORGMACROS_VERSION.tar.bz2 && rm $XORGMACROS_VERSION.tar.bz2
-cd $XORGMACROS_VERSION; ./configure; make install; cd ..
-rm -rf $XORGMACROS_VERSION
-
-wget $XORG_RELEASES/proto/$GLPROTO_VERSION.tar.bz2
-tar -xvf $GLPROTO_VERSION.tar.bz2 && rm $GLPROTO_VERSION.tar.bz2
-cd $GLPROTO_VERSION; ./configure; make install; cd ..
-rm -rf $GLPROTO_VERSION
-
-wget $XORG_RELEASES/proto/$DRI2PROTO_VERSION.tar.bz2
-tar -xvf $DRI2PROTO_VERSION.tar.bz2 && rm $DRI2PROTO_VERSION.tar.bz2
-cd $DRI2PROTO_VERSION; ./configure; make install; cd ..
-rm -rf $DRI2PROTO_VERSION
-
-wget $XCB_RELEASES/$XCBPROTO_VERSION.tar.bz2
-tar -xvf $XCBPROTO_VERSION.tar.bz2 && rm $XCBPROTO_VERSION.tar.bz2
-cd $XCBPROTO_VERSION; ./configure; make install; cd ..
-rm -rf $XCBPROTO_VERSION
-
-wget $XCB_RELEASES/$LIBXCB_VERSION.tar.bz2
-tar -xvf $LIBXCB_VERSION.tar.bz2 && rm $LIBXCB_VERSION.tar.bz2
-cd $LIBXCB_VERSION; ./configure; make install; cd ..
-rm -rf $LIBXCB_VERSION
-
-wget $XORG_RELEASES/lib/$LIBPCIACCESS_VERSION.tar.bz2
-tar -xvf $LIBPCIACCESS_VERSION.tar.bz2 && rm $LIBPCIACCESS_VERSION.tar.bz2
-cd $LIBPCIACCESS_VERSION; ./configure; make install; cd ..
-rm -rf $LIBPCIACCESS_VERSION
-
-wget https://dri.freedesktop.org/libdrm/$LIBDRM_VERSION.tar.bz2
-tar -xvf $LIBDRM_VERSION.tar.bz2 && rm $LIBDRM_VERSION.tar.bz2
-cd $LIBDRM_VERSION; ./configure --enable-vc4 --enable-freedreno --enable-etnaviv-experimental-api; make install; cd ..
-rm -rf $LIBDRM_VERSION
-
-wget $XORG_RELEASES/proto/$RANDRPROTO_VERSION.tar.bz2
-tar -xvf $RANDRPROTO_VERSION.tar.bz2 && rm $RANDRPROTO_VERSION.tar.bz2
-cd $RANDRPROTO_VERSION; ./configure; make install; cd ..
-rm -rf $RANDRPROTO_VERSION
-
-wget $XORG_RELEASES/lib/$LIBXRANDR_VERSION.tar.bz2
-tar -xvf $LIBXRANDR_VERSION.tar.bz2 && rm $LIBXRANDR_VERSION.tar.bz2
-cd $LIBXRANDR_VERSION; ./configure; make install; cd ..
-rm -rf $LIBXRANDR_VERSION
-
-wget $XORG_RELEASES/lib/$LIBXSHMFENCE_VERSION.tar.bz2
-tar -xvf $LIBXSHMFENCE_VERSION.tar.bz2 && rm $LIBXSHMFENCE_VERSION.tar.bz2
-cd $LIBXSHMFENCE_VERSION; ./configure; make install; cd ..
-rm -rf $LIBXSHMFENCE_VERSION
-
-wget https://people.freedesktop.org/~aplattner/vdpau/$LIBVDPAU_VERSION.tar.bz2
-tar -xvf $LIBVDPAU_VERSION.tar.bz2 && rm $LIBVDPAU_VERSION.tar.bz2
-cd $LIBVDPAU_VERSION; ./configure; make install; cd ..
-rm -rf $LIBVDPAU_VERSION
-
-wget https://www.freedesktop.org/software/vaapi/releases/libva/$LIBVA_VERSION.tar.bz2
-tar -xvf $LIBVA_VERSION.tar.bz2 && rm $LIBVA_VERSION.tar.bz2
-cd $LIBVA_VERSION; ./configure --disable-wayland --disable-dummy-driver; make install; cd ..
-rm -rf $LIBVA_VERSION
-
-wget $WAYLAND_RELEASES/$LIBWAYLAND_VERSION.tar.xz
-tar -xvf $LIBWAYLAND_VERSION.tar.xz && rm $LIBWAYLAND_VERSION.tar.xz
-cd $LIBWAYLAND_VERSION; ./configure --enable-libraries --without-host-scanner --disable-documentation --disable-dtd-validation; make install; cd ..
-rm -rf $LIBWAYLAND_VERSION
-
-wget $WAYLAND_RELEASES/$WAYLAND_PROTOCOLS_VERSION.tar.xz
-tar -xvf $WAYLAND_PROTOCOLS_VERSION.tar.xz && rm $WAYLAND_PROTOCOLS_VERSION.tar.xz
-cd $WAYLAND_PROTOCOLS_VERSION; ./configure; make install; cd ..
-rm -rf $WAYLAND_PROTOCOLS_VERSION
-
-# Use ccache to speed up builds
-apt-get install -y ccache
-
-# We need xmllint to validate the XML files in Mesa
-apt-get install -y libxml2-utils
-
-# Remove unused packages
-apt-get purge -y \
-      automake \
-      libtool \
-      curl \
-      unzip \
-      wget \
-      gnupg \
-      software-properties-common
-apt-get autoremove -y --purge

.gitlab-ci/meson-build.sh

@@ -1,34 +0,0 @@
-#!/bin/bash
-
-set -e
-set -o xtrace
-
-# We need to control the version of llvm-config we're using, so we'll
-# generate a native file to do so. This requires meson >=0.49
-if test -n "$LLVM_VERSION"; then
-    LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
-    echo -e "[binaries]\nllvm-config = '`which $LLVM_CONFIG`'" > native.file
-    $LLVM_CONFIG --version
-else
-    rm -f native.file
-    touch native.file
-fi
-
-rm -rf _build
-meson _build --native-file=native.file \
-      ${CROSS} \
-      -D buildtype=debug \
-      -D build-tests=true \
-      -D libunwind=${UNWIND} \
-      ${DRI_LOADERS} \
-      -D dri-drivers=${DRI_DRIVERS:-[]} \
-      ${GALLIUM_ST} \
-      -D gallium-drivers=${GALLIUM_DRIVERS:-[]} \
-      -D vulkan-drivers=${VULKAN_DRIVERS:-[]} \
-      -D I-love-half-baked-turnips=true \
-      ${EXTRA_OPTION}
-cd _build
-meson configure
-ninja -j4
-LC_ALL=C.UTF-8 ninja test
-DESTDIR=$PWD/../install ninja install

.mailmap

@@ -265,9 +265,6 @@ Kristian Høgsberg <krh@bitplanet.net> <krh@hinata.boston.redhat.com>
 Kristian Høgsberg <krh@bitplanet.net> <krh@sasori.boston.redhat.com>
 Kristian Høgsberg <krh@bitplanet.net> <krh@temari.boston.redhat.com>
 Kristian Høgsberg <krh@bitplanet.net> <kristian.h.kristensen@intel.com>
-Kristian Høgsberg <krh@bitplanet.net> <hoegsberg@chromium.org>
-Kristian Høgsberg <krh@bitplanet.net> <hoegsberg@google.com>
-Kristian Høgsberg <krh@bitplanet.net> <hoegsberg@gmail.com>
 
 Krzesimir Nowak <qdlacz@gmail.com> <krzesimir@kinvolk.io>
 

.travis.yml

@@ -1,40 +1,716 @@
 language: c
 
-os: osx
+sudo: false
+dist: trusty
 
 cache:
+  apt: true
   ccache: true
 
 env:
   global:
-    - PKG_CONFIG_PATH=""
+    - XORG_RELEASES=https://xorg.freedesktop.org/releases/individual
+    - XCB_RELEASES=https://xcb.freedesktop.org/dist
+    - WAYLAND_RELEASES=https://wayland.freedesktop.org/releases
+    - XORGMACROS_VERSION=util-macros-1.19.0
+    - GLPROTO_VERSION=glproto-1.4.17
+    - DRI2PROTO_VERSION=dri2proto-2.8
+    - LIBPCIACCESS_VERSION=libpciaccess-0.13.4
+    - LIBDRM_VERSION=libdrm-2.4.74
+    - XCBPROTO_VERSION=xcb-proto-1.13
+    - RANDRPROTO_VERSION=randrproto-1.3.0
+    - LIBXRANDR_VERSION=libXrandr-1.3.0
+    - LIBXCB_VERSION=libxcb-1.13
+    - LIBXSHMFENCE_VERSION=libxshmfence-1.2
+    - LIBVDPAU_VERSION=libvdpau-1.1
+    - LIBVA_VERSION=libva-1.7.0
+    - LIBWAYLAND_VERSION=wayland-1.15.0
+    - WAYLAND_PROTOCOLS_VERSION=wayland-protocols-1.8
+    - PKG_CONFIG_PATH=$HOME/prefix/lib/pkgconfig:$HOME/prefix/share/pkgconfig
+    - LD_LIBRARY_PATH="$HOME/prefix/lib:$LD_LIBRARY_PATH"
+    - PATH="$HOME/prefix/bin:$PATH"
+
+matrix:
+  include:
+    - env:
+        - LABEL="meson Vulkan"
+        - BUILD=meson
+        - DRI_DRIVERS=""
+        - GALLIUM_DRIVERS=""
+        - VULKAN_DRIVERS="intel,amd"
+        - LLVM_VERSION=6.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-6.0
+            # llvm-6 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            # From sources above
+            - llvm-6.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - python3.5
+            - python3-pip
+    - env:
+        - LABEL="meson loaders/classic DRI"
+        - BUILD=meson
+        - DRI_DRIVERS="i915,i965,r100,r200,swrast,nouveau"
+        - GALLIUM_DRIVERS=""
+        - VULKAN_DRIVERS=""
+      addons:
+        apt:
+          packages:
+            - xz-utils
+            - x11proto-xf86vidmode-dev
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libxdamage-dev
+            - libxfixes-dev
+            - python3.5
+            - python3-pip
+    - env:
+        - LABEL="make loaders/classic DRI"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="make check"
+        - DRI_LOADERS="--enable-glx --enable-gbm --enable-egl --with-platforms=x11,drm,surfaceless,wayland --enable-osmesa"
+        - DRI_DRIVERS="i915,i965,radeon,r200,swrast,nouveau"
+        - GALLIUM_ST="--enable-dri --disable-opencl --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS=""
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--disable-libunwind"
+      addons:
+        apt:
+          packages:
+            - xz-utils
+            - x11proto-xf86vidmode-dev
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libxdamage-dev
+            - libxfixes-dev
+            - python3-pip
+    - env:
+        # NOTE: Building SWR is 2x (yes two) times slower than all the other
+        # gallium drivers combined.
+        # Start this early so that it doesn't hunder the run time.
+        - LABEL="make Gallium Drivers SWR"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=6.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--enable-dri --disable-opencl --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="swr"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-6.0
+            # llvm-6 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            # From sources above
+            - llvm-6.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium Drivers RadeonSI"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=6.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--enable-dri --disable-opencl --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="radeonsi"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-6.0
+            # llvm-6 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            # From sources above
+            - llvm-6.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium Drivers Other"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=3.9
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        # New binutils linker is required for llvm-3.9
+        - OVERRIDE_PATH=/usr/lib/binutils-2.26/bin
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--enable-dri --disable-opencl --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="i915,nouveau,pl111,r300,r600,freedreno,svga,swrast,v3d,vc4,virgl,etnaviv,imx"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-3.9
+          packages:
+            - binutils-2.26
+            # LLVM packaging is broken and misses these dependencies
+            - libedit-dev
+            # From sources above
+            - llvm-3.9-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium ST Clover LLVM-3.9"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=3.9
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - OVERRIDE_CC=gcc-4.7
+        - OVERRIDE_CXX=g++-4.7
+        # New binutils linker is required for llvm-3.9
+        - OVERRIDE_PATH=/usr/lib/binutils-2.26/bin
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--disable-dri --enable-opencl --enable-opencl-icd --enable-llvm --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="r600"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-3.9
+          packages:
+            - binutils-2.26
+            - libclc-dev
+            # LLVM packaging is broken and misses these dependencies
+            - libedit-dev
+            - g++-4.7
+            # From sources above
+            - llvm-3.9-dev
+            - clang-3.9
+            - libclang-3.9-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium ST Clover LLVM-4.0"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=4.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - OVERRIDE_CC=gcc-4.8
+        - OVERRIDE_CXX=g++-4.8
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--disable-dri --enable-opencl --enable-opencl-icd --enable-llvm --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="r600"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-4.0
+          packages:
+            - libclc-dev
+            # LLVM packaging is broken and misses these dependencies
+            - libedit-dev
+            - g++-4.8
+            # From sources above
+            - llvm-4.0-dev
+            - clang-4.0
+            - libclang-4.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium ST Clover LLVM-5.0"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=5.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - OVERRIDE_CC=gcc-4.8
+        - OVERRIDE_CXX=g++-4.8
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--disable-dri --enable-opencl --enable-opencl-icd --enable-llvm --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="r600"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-5.0
+          packages:
+            - libclc-dev
+            # LLVM packaging is broken and misses these dependencies
+            - libedit-dev
+            - g++-4.8
+            # From sources above
+            - llvm-5.0-dev
+            - clang-5.0
+            - libclang-5.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium ST Clover LLVM-6.0"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=6.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--disable-dri --enable-opencl --enable-opencl-icd --enable-llvm --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="r600,radeonsi"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-6.0
+            # llvm-6 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            - libclc-dev
+            # From sources above
+            - llvm-6.0-dev
+            - clang-6.0
+            - libclang-6.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Gallium ST Clover LLVM-7"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=7
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--disable-dri --enable-opencl --enable-opencl-icd --enable-llvm --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS="r600,radeonsi"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          sources:
+            - sourceline: 'deb http://apt.llvm.org/trusty/ llvm-toolchain-trusty-7 main'
+              key_url: https://apt.llvm.org/llvm-snapshot.gpg.key
+            # llvm-7 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            - libclc-dev
+            # From sources above
+            - llvm-7-dev
+            - clang-7
+            - libclang-7-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+    - env:
+        - LABEL="make Gallium ST Other"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="true"
+        - LLVM_VERSION=3.3
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--enable-dri --disable-opencl --enable-xa --enable-nine --enable-xvmc --enable-vdpau --enable-va --enable-omx-bellagio --enable-gallium-osmesa"
+        # We need swrast for osmesa and nine.
+        # i915 most likely doesn't work with most ST.
+        # Regardless - we're doing a quick build test here.
+        - GALLIUM_DRIVERS="i915,swrast"
+        - VULKAN_DRIVERS=""
+        - LIBUNWIND_FLAGS="--enable-libunwind"
+      addons:
+        apt:
+          packages:
+            # We actually want to test against llvm-3.3
+            - llvm-3.3-dev
+            # Nine requires gcc 4.6... which is the one we have right ?
+            - libxvmc-dev
+            # Build locally, for now.
+            #- libvdpau-dev
+            #- libva-dev
+            - libomxil-bellagio-dev
+            # LLVM packaging is broken and misses these dependencies
+            - libedit-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - libunwind8-dev
+            - python3-pip
+    - env:
+        - LABEL="make Vulkan"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="make -C src/gtest check && make -C src/intel check"
+        - LLVM_VERSION=6.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        - DRI_LOADERS="--disable-glx --disable-gbm --disable-egl --with-platforms=x11,wayland"
+        - DRI_DRIVERS=""
+        - GALLIUM_ST="--enable-dri --enable-dri3 --disable-opencl --disable-xa --disable-nine --disable-xvmc --disable-vdpau --disable-va --disable-omx-bellagio --disable-gallium-osmesa"
+        - GALLIUM_DRIVERS=""
+        - VULKAN_DRIVERS="intel,radeon"
+        - LIBUNWIND_FLAGS="--disable-libunwind"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-6.0
+            # llvm-6 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            # From sources above
+            - llvm-6.0-dev
+            # Common
+            - xz-utils
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+            - python3-pip
+    - env:
+        - LABEL="scons"
+        - BUILD=scons
+        - SCONSFLAGS="-j4"
+        # Explicitly disable.
+        - SCONS_TARGET="llvm=0"
+        # Keep it symmetrical to the make build.
+        - SCONS_CHECK_COMMAND="scons llvm=0 check"
+      addons:
+        apt:
+          packages:
+            # Common
+            - xz-utils
+            - x11proto-xf86vidmode-dev
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+    - env:
+        - LABEL="scons LLVM"
+        - BUILD=scons
+        - SCONSFLAGS="-j4"
+        - SCONS_TARGET="llvm=1"
+        # Keep it symmetrical to the make build.
+        - SCONS_CHECK_COMMAND="scons llvm=1 check"
+        - LLVM_VERSION=3.3
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+      addons:
+        apt:
+          packages:
+            # LLVM packaging is broken and misses these dependencies
+            - libedit-dev
+            - llvm-3.3-dev
+            # Common
+            - xz-utils
+            - x11proto-xf86vidmode-dev
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+    - env:
+        - LABEL="scons SWR"
+        - BUILD=scons
+        - SCONSFLAGS="-j4"
+        - SCONS_TARGET="swr=1"
+        - LLVM_VERSION=6.0
+        - LLVM_CONFIG="llvm-config-${LLVM_VERSION}"
+        # Keep it symmetrical to the make build. There's no actual SWR, yet.
+        - SCONS_CHECK_COMMAND="true"
+      addons:
+        apt:
+          sources:
+            - llvm-toolchain-trusty-6.0
+            # llvm-6 requires libstdc++4.9 which is not in main repo
+            - ubuntu-toolchain-r-test
+          packages:
+            # From sources above
+            - llvm-6.0-dev
+            # Common
+            - xz-utils
+            - x11proto-xf86vidmode-dev
+            - libexpat1-dev
+            - libx11-xcb-dev
+            - libelf-dev
+    - env:
+        - LABEL="macOS make"
+        - BUILD=make
+        - MAKEFLAGS="-j4"
+        - MAKE_CHECK_COMMAND="make check"
+        - DRI_LOADERS="--with-platforms=x11 --disable-egl"
+      os: osx
+    - env:
+        - LABEL="macOS meson"
+        - BUILD=meson
+      os: osx
 
 before_install:
-  - HOMEBREW_NO_AUTO_UPDATE=1 brew install python3 ninja expat gettext
-  # Set PATH for homebrew pip3 installs
-  - PATH="$HOME/Library/Python/3.6/bin:${PATH}"
-  # Set PKG_CONFIG_PATH for keg-only expat
-  - PKG_CONFIG_PATH="/usr/local/opt/expat/lib/pkgconfig:${PKG_CONFIG_PATH}"
-  # Set PATH for keg-only gettext
-  - PATH="/usr/local/opt/gettext/bin:${PATH}"
+  - |
+    if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then
+      HOMEBREW_NO_AUTO_UPDATE=1 brew install python3 ninja expat gettext
+      # Set PATH for homebrew pip3 installs
+      PATH="$HOME/Library/Python/3.6/bin:${PATH}"
+      # Set PKG_CONFIG_PATH for keg-only expat
+      PKG_CONFIG_PATH="/usr/local/opt/expat/lib/pkgconfig:${PKG_CONFIG_PATH}"
+      # Set PATH for keg-only gettext
+      PATH="/usr/local/opt/gettext/bin:${PATH}"
 
-  # Install xquartz for prereqs ...
-  - XQUARTZ_VERSION="2.7.11"
-  - wget -nv https://dl.bintray.com/xquartz/downloads/XQuartz-${XQUARTZ_VERSION}.dmg
-  - hdiutil attach XQuartz-${XQUARTZ_VERSION}.dmg
-  - sudo installer -pkg /Volumes/XQuartz-${XQUARTZ_VERSION}/XQuartz.pkg -target /
-  - hdiutil detach /Volumes/XQuartz-${XQUARTZ_VERSION}
-  # ... and set paths
-  - PKG_CONFIG_PATH="/opt/X11/share/pkgconfig:/opt/X11/lib/pkgconfig:${PKG_CONFIG_PATH}"
+      # Install xquartz for prereqs ...
+      XQUARTZ_VERSION="2.7.11"
+      wget -nv https://dl.bintray.com/xquartz/downloads/XQuartz-${XQUARTZ_VERSION}.dmg
+      hdiutil attach XQuartz-${XQUARTZ_VERSION}.dmg
+      sudo installer -pkg /Volumes/XQuartz-${XQUARTZ_VERSION}/XQuartz.pkg -target /
+      hdiutil detach /Volumes/XQuartz-${XQUARTZ_VERSION}
+      # ... and set paths
+      PATH="/opt/X11/bin:${PATH}"
+      PKG_CONFIG_PATH="/opt/X11/share/pkgconfig:/opt/X11/lib/pkgconfig:${PKG_CONFIG_PATH}"
+      ACLOCAL="aclocal -I /opt/X11/share/aclocal -I /usr/local/share/aclocal"
+    fi
 
 install:
-  - pip3 install --user meson
-  - pip3 install --user mako
+  # Install a more modern meson from pip, since the version in the
+  # ubuntu repos is often quite old. This requires python>=3.5, so
+  # let's make it default
+  - if test "x$BUILD" = xmeson; then
+      sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.5 10;
+      pip3 install --user meson;
+      pip3 install --user mako;
+    fi
+
+  # Install autotools build dependencies
+  - if test "x$BUILD" = xmake; then
+      pip2 install --user mako;
+    fi
+
+  # Install a more modern scons from pip.
+  - if test "x$BUILD" = xscons; then
+      pip2 install --user "scons>=2.4";
+      pip2 install --user mako;
+    fi
+
+  # Since libdrm gets updated in configure.ac regularly, try to pick up the
+  # latest version from there.
+  - for line in `grep "^LIBDRM.*_REQUIRED=" configure.ac`; do
+      old_ver=`echo $LIBDRM_VERSION | sed 's/libdrm-//'`;
+      new_ver=`echo $line | sed 's/.*REQUIRED=//'`;
+      if `echo "$old_ver,$new_ver" | tr ',' '\n' | sort -Vc 2> /dev/null`; then
+        export LIBDRM_VERSION="libdrm-$new_ver";
+      fi;
+    done
+
+  # Install dependencies where we require specific versions (or where
+  # disallowed by Travis CI's package whitelisting).
+
+  - |
+    if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then
+      wget $XORG_RELEASES/util/$XORGMACROS_VERSION.tar.bz2
+      tar -jxvf $XORGMACROS_VERSION.tar.bz2
+      (cd $XORGMACROS_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XORG_RELEASES/proto/$GLPROTO_VERSION.tar.bz2
+      tar -jxvf $GLPROTO_VERSION.tar.bz2
+      (cd $GLPROTO_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XORG_RELEASES/proto/$DRI2PROTO_VERSION.tar.bz2
+      tar -jxvf $DRI2PROTO_VERSION.tar.bz2
+      (cd $DRI2PROTO_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XCB_RELEASES/$XCBPROTO_VERSION.tar.bz2
+      tar -jxvf $XCBPROTO_VERSION.tar.bz2
+      (cd $XCBPROTO_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XCB_RELEASES/$LIBXCB_VERSION.tar.bz2
+      tar -jxvf $LIBXCB_VERSION.tar.bz2
+      (cd $LIBXCB_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XORG_RELEASES/lib/$LIBPCIACCESS_VERSION.tar.bz2
+      tar -jxvf $LIBPCIACCESS_VERSION.tar.bz2
+      (cd $LIBPCIACCESS_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget https://dri.freedesktop.org/libdrm/$LIBDRM_VERSION.tar.bz2
+      tar -jxvf $LIBDRM_VERSION.tar.bz2
+      (cd $LIBDRM_VERSION && ./configure --prefix=$HOME/prefix --enable-vc4 --enable-freedreno --enable-etnaviv-experimental-api && make install)
+
+      wget $XORG_RELEASES/proto/$RANDRPROTO_VERSION.tar.bz2
+      tar -jxvf $RANDRPROTO_VERSION.tar.bz2
+      (cd $RANDRPROTO_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XORG_RELEASES/lib/$LIBXRANDR_VERSION.tar.bz2
+      tar -jxvf $LIBXRANDR_VERSION.tar.bz2
+      (cd $LIBXRANDR_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget $XORG_RELEASES/lib/$LIBXSHMFENCE_VERSION.tar.bz2
+      tar -jxvf $LIBXSHMFENCE_VERSION.tar.bz2
+      (cd $LIBXSHMFENCE_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget https://people.freedesktop.org/~aplattner/vdpau/$LIBVDPAU_VERSION.tar.bz2
+      tar -jxvf $LIBVDPAU_VERSION.tar.bz2
+      (cd $LIBVDPAU_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      wget https://www.freedesktop.org/software/vaapi/releases/libva/$LIBVA_VERSION.tar.bz2
+      tar -jxvf $LIBVA_VERSION.tar.bz2
+      (cd $LIBVA_VERSION && ./configure --prefix=$HOME/prefix --disable-wayland --disable-dummy-driver && make install)
+
+      wget $WAYLAND_RELEASES/$LIBWAYLAND_VERSION.tar.xz
+      tar -axvf $LIBWAYLAND_VERSION.tar.xz
+      (cd $LIBWAYLAND_VERSION && ./configure --prefix=$HOME/prefix --enable-libraries --without-host-scanner --disable-documentation --disable-dtd-validation && make install)
+
+      wget $WAYLAND_RELEASES/$WAYLAND_PROTOCOLS_VERSION.tar.xz
+      tar -axvf $WAYLAND_PROTOCOLS_VERSION.tar.xz
+      (cd $WAYLAND_PROTOCOLS_VERSION && ./configure --prefix=$HOME/prefix && make install)
+
+      # Meson requires ninja >= 1.6, but trusty has 1.3.x
+      wget https://github.com/ninja-build/ninja/releases/download/v1.6.0/ninja-linux.zip
+      unzip ninja-linux.zip
+      mv ninja $HOME/prefix/bin/
+
+      # Generate this header since one is missing on the Travis instance
+      mkdir -p linux
+      printf "%s\n" \
+           "#ifndef _LINUX_MEMFD_H" \
+           "#define _LINUX_MEMFD_H" \
+           "" \
+           "#define MFD_CLOEXEC             0x0001U" \
+           "#define MFD_ALLOW_SEALING       0x0002U" \
+           "" \
+           "#endif /* _LINUX_MEMFD_H */" > linux/memfd.h
+
+      # Generate this header, including the missing SYS_memfd_create
+      # macro, which is not provided by the header in the Travis
+      # instance
+      mkdir -p sys
+      printf "%s\n" \
+           "#ifndef _SYSCALL_H" \
+           "#define _SYSCALL_H      1" \
+           "" \
+           "#include <asm/unistd.h>" \
+           "" \
+           "#ifndef _LIBC" \
+           "# include <bits/syscall.h>" \
+           "#endif" \
+           "" \
+           "#ifndef __NR_memfd_create" \
+           "# define __NR_memfd_create 319 /* Taken from <asm/unistd_64.h> */" \
+           "#endif" \
+           "" \
+           "#ifndef SYS_memfd_create" \
+           "# define SYS_memfd_create __NR_memfd_create" \
+           "#endif" \
+           "" \
+           "#endif" > sys/syscall.h
+    fi
 
 script:
-  - meson _build
-      -Dbuild-tests=true
-      -Dplatforms=x11
-      -Dgallium-drivers=swrast
-  - ninja -C _build
-  - ninja -C _build test
+  - if test "x$BUILD" = xmake; then
+      test -n "$OVERRIDE_CC" && export CC="$OVERRIDE_CC";
+      test -n "$OVERRIDE_CXX" && export CXX="$OVERRIDE_CXX";
+      test -n "$OVERRIDE_PATH" && export PATH="$OVERRIDE_PATH:$PATH";
+
+      export CFLAGS="$CFLAGS -isystem`pwd`";
+
+      mkdir build &&
+      cd build &&
+      ../autogen.sh --enable-debug
+        $LIBUNWIND_FLAGS
+        $DRI_LOADERS
+        --with-dri-drivers=$DRI_DRIVERS
+        $GALLIUM_ST
+        --with-gallium-drivers=$GALLIUM_DRIVERS
+        --with-vulkan-drivers=$VULKAN_DRIVERS
+        --disable-llvm-shared-libs
+        &&
+      make && eval $MAKE_CHECK_COMMAND;
+    fi
+
+  - if test "x$BUILD" = xscons; then
+      test -n "$OVERRIDE_CC" && export CC="$OVERRIDE_CC";
+      test -n "$OVERRIDE_CXX" && export CXX="$OVERRIDE_CXX";
+      scons $SCONS_TARGET && eval $SCONS_CHECK_COMMAND;
+    fi
+
+  - |
+    if test "x$BUILD" = xmeson; then
+
+      if test "x$TRAVIS_OS_NAME" == xosx; then
+        MESON_OPTIONS="-Degl=false"
+      fi
+
+      if test "x$TRAVIS_OS_NAME" == xlinux; then
+        MESON_OPTIONS="-Ddri-drivers=${DRI_DRIVERS:-[]} -Dgallium-drivers=${GALLIUM_DRIVERS:-[]} -Dvulkan-drivers=${VULKAN_DRIVERS:-[]}"
+      fi
+
+      # Travis CI has moved to LLVM 5.0, and meson is detecting
+      # automatically the available version in /usr/local/bin based on
+      # the PATH env variable order preference.
+      #
+      # As for 0.44.x, Meson cannot receive the path to the
+      # llvm-config binary as a configuration parameter. See
+      # https://github.com/mesonbuild/meson/issues/2887 and
+      # https://github.com/dcbaker/meson/commit/7c8b6ee3fa42f43c9ac7dcacc61a77eca3f1bcef
+      #
+      # We want to use the custom (APT) installed version. Therefore,
+      # let's make Meson find our wanted version sooner than the one
+      # at /usr/local/bin
+      #
+      # Once this is corrected, we would still need a patch similar
+      # to:
+      # https://lists.freedesktop.org/archives/mesa-dev/2017-December/180217.html
+      test -f /usr/bin/$LLVM_CONFIG && ln -s /usr/bin/$LLVM_CONFIG $HOME/prefix/bin/llvm-config
+
+      export CFLAGS="$CFLAGS -isystem`pwd`"
+      meson _build $MESON_OPTIONS
+      ninja -C _build
+    fi

Android.common.mk

@@ -32,12 +32,12 @@ LOCAL_C_INCLUDES += \
 MESA_VERSION := $(shell cat $(MESA_TOP)/VERSION)
 LOCAL_CFLAGS += \
 	-Wno-error \
-	-Werror=incompatible-pointer-types \
 	-Wno-unused-parameter \
 	-Wno-pointer-arith \
 	-Wno-missing-field-initializers \
 	-Wno-initializer-overrides \
 	-Wno-mismatched-tags \
+	-DVERSION=\"$(MESA_VERSION)\" \
 	-DPACKAGE_VERSION=\"$(MESA_VERSION)\" \
 	-DPACKAGE_BUGREPORT=\"https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa\"
 
@@ -98,14 +98,12 @@ ifeq ($(filter 5 6 7 8 9, $(MESA_ANDROID_MAJOR_VERSION)),)
 LOCAL_CFLAGS += -DHAVE_TIMESPEC_GET
 endif
 
-# Android's libc began supporting shm in Oreo
-ifeq ($(shell test $(PLATFORM_SDK_VERSION) -ge 26 && echo true),true)
-LOCAL_CFLAGS += -DHAVE_SYS_SHM_H
-endif
-
+ifeq ($(strip $(MESA_ENABLE_ASM)),true)
 ifeq ($(TARGET_ARCH),x86)
 LOCAL_CFLAGS += \
 	-DUSE_X86_ASM
+
+endif
 endif
 ifeq ($(ARCH_ARM_HAVE_NEON),true)
 LOCAL_CFLAGS_arm += -DUSE_ARM_ASM

Android.mk

@@ -24,7 +24,7 @@
 # BOARD_GPU_DRIVERS should be defined.  The valid values are
 #
 #   classic drivers: i915 i965
-#   gallium drivers: swrast freedreno i915g nouveau kmsro r300g r600g radeonsi vc4 virgl vmwgfx etnaviv iris lima
+#   gallium drivers: swrast freedreno i915g nouveau pl111 r300g r600g radeonsi vc4 virgl vmwgfx etnaviv imx
 #
 # The main target is libGLES_mesa.  For each classic driver enabled, a DRI
 # module will also be built.  DRI modules will be loaded by libGLES_mesa.
@@ -52,7 +52,7 @@ gallium_drivers := \
 	freedreno.HAVE_GALLIUM_FREEDRENO \
 	i915g.HAVE_GALLIUM_I915 \
 	nouveau.HAVE_GALLIUM_NOUVEAU \
-	kmsro.HAVE_GALLIUM_KMSRO \
+	pl111.HAVE_GALLIUM_PL111 \
 	r300g.HAVE_GALLIUM_R300 \
 	r600g.HAVE_GALLIUM_R600 \
 	radeonsi.HAVE_GALLIUM_RADEONSI \
@@ -60,8 +60,7 @@ gallium_drivers := \
 	vc4.HAVE_GALLIUM_VC4 \
 	virgl.HAVE_GALLIUM_VIRGL \
 	etnaviv.HAVE_GALLIUM_ETNAVIV \
-	iris.HAVE_GALLIUM_IRIS \
-	lima.HAVE_GALLIUM_LIMA
+	imx.HAVE_GALLIUM_IMX
 
 ifeq ($(BOARD_GPU_DRIVERS),all)
 MESA_BUILD_CLASSIC := $(filter HAVE_%, $(subst ., , $(classic_drivers)))
@@ -83,6 +82,13 @@ endif
 
 $(foreach d, $(MESA_BUILD_CLASSIC) $(MESA_BUILD_GALLIUM), $(eval $(d) := true))
 
+# host and target must be the same arch to generate matypes.h
+ifeq ($(TARGET_ARCH),$(HOST_ARCH))
+MESA_ENABLE_ASM := true
+else
+MESA_ENABLE_ASM := false
+endif
+
 ifneq ($(filter true, $(HAVE_GALLIUM_RADEONSI)),)
 MESA_ENABLE_LLVM := true
 endif
@@ -91,19 +97,18 @@ define mesa-build-with-llvm
   $(if $(filter $(MESA_ANDROID_MAJOR_VERSION), 4 5), \
     $(warning Unsupported LLVM version in Android $(MESA_ANDROID_MAJOR_VERSION)),) \
   $(if $(filter 6,$(MESA_ANDROID_MAJOR_VERSION)), \
-    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0307 -DMESA_LLVM_VERSION_STRING=\"3.7\")) \
+    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0307 -DMESA_LLVM_VERSION_PATCH=0)) \
   $(if $(filter 7,$(MESA_ANDROID_MAJOR_VERSION)), \
-    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0308 -DMESA_LLVM_VERSION_STRING=\"3.8\")) \
+    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0308 -DMESA_LLVM_VERSION_PATCH=0)) \
   $(if $(filter 8,$(MESA_ANDROID_MAJOR_VERSION)), \
-    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0309 -DMESA_LLVM_VERSION_STRING=\"3.9\")) \
+    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0309 -DMESA_LLVM_VERSION_PATCH=0)) \
   $(if $(filter P,$(MESA_ANDROID_MAJOR_VERSION)), \
-    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0309 -DMESA_LLVM_VERSION_STRING=\"3.9\")) \
+    $(eval LOCAL_CFLAGS += -DHAVE_LLVM=0x0309 -DMESA_LLVM_VERSION_PATCH=0)) \
   $(eval LOCAL_SHARED_LIBRARIES += libLLVM)
 endef
 
 # add subdirectories
 SUBDIRS := \
-	src/freedreno \
 	src/gbm \
 	src/loader \
 	src/mapi \

Makefile.am

@@ -0,0 +1,92 @@
+# Copyright © 2012 Intel Corporation
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice (including the next
+# paragraph) shall be included in all copies or substantial portions of the
+# Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+# IN THE SOFTWARE.
+
+SUBDIRS = src
+
+AM_DISTCHECK_CONFIGURE_FLAGS = \
+	--enable-dri \
+	--enable-dri3 \
+	--enable-egl \
+	--enable-gallium-tests \
+	--enable-gallium-osmesa \
+	--enable-llvm \
+	--enable-gbm \
+	--enable-gles1 \
+	--enable-gles2 \
+	--enable-glx \
+	--enable-glx-tls \
+	--enable-nine \
+	--enable-opencl \
+	--enable-opencl-icd \
+	--enable-opengl \
+	--enable-va \
+	--enable-vdpau \
+	--enable-xa \
+	--enable-xvmc \
+	--enable-llvm-shared-libs \
+	--enable-libunwind \
+	--with-platforms=x11,wayland,drm,surfaceless \
+	--with-dri-drivers=i915,i965,nouveau,radeon,r200,swrast \
+	--with-gallium-drivers=i915,nouveau,r300,pl111,r600,radeonsi,freedreno,svga,swrast,vc4,tegra,virgl,swr,etnaviv,imx \
+	--with-vulkan-drivers=intel,radeon
+
+ACLOCAL_AMFLAGS = -I m4
+
+EXTRA_DIST = \
+	autogen.sh \
+	common.py \
+	docs \
+	doxygen \
+	bin/git_sha1_gen.py \
+	scons \
+	SConstruct \
+	build-support/conftest.dyn \
+	build-support/conftest.map \
+	meson.build \
+	meson_options.txt \
+	bin/meson.build \
+	include/meson.build \
+	bin/install_megadrivers.py \
+	bin/meson_get_version.py
+
+noinst_HEADERS = \
+	include/c99_alloca.h \
+	include/c99_compat.h \
+	include/c99_math.h \
+	include/c11 \
+	include/drm-uapi/drm.h \
+	include/drm-uapi/drm_fourcc.h \
+	include/drm-uapi/drm_mode.h \
+	include/drm-uapi/i915_drm.h \
+	include/drm-uapi/tegra_drm.h \
+	include/drm-uapi/v3d_drm.h \
+	include/drm-uapi/vc4_drm.h \
+	include/D3D9 \
+	include/GL/wglext.h \
+	include/HaikuGL \
+	include/no_extern_c.h \
+	include/pci_ids \
+	include/vulkan
+
+# We list some directories in EXTRA_DIST, but don't actually want to include
+# the .gitignore files in the tarball.
+dist-hook:
+	find $(distdir) -name .gitignore -exec $(RM) {} +

README.rst

@@ -9,6 +9,25 @@ This repository lives at https://gitlab.freedesktop.org/mesa/mesa.
 Other repositories are likely forks, and code found there is not supported.
 
 
+Build status
+------------
+
+Travis:
+
+.. image:: https://travis-ci.org/mesa3d/mesa.svg?branch=master
+    :target: https://travis-ci.org/mesa3d/mesa
+
+Appveyor:
+
+.. image:: https://img.shields.io/appveyor/ci/mesa3d/mesa.svg
+    :target: https://ci.appveyor.com/project/mesa3d/mesa
+
+Coverity:
+
+.. image:: https://scan.coverity.com/projects/139/badge.svg?flat=1
+    :target: https://scan.coverity.com/projects/mesa
+
+
 Build & install
 ---------------
 

REVIEWERS

@@ -72,9 +72,7 @@ F: src/loader/
 
 EGL
 R: Eric Engestrom <eric@engestrom.ch>
-R: Emil Velikov <emil.l.velikov@gmail.com>
 F: src/egl/
-F: include/EGL/
 
 HAIKU
 R: Alexander von Gluck IV <kallisti5@unixzen.com>
@@ -94,6 +92,14 @@ GALLIUM TARGETS
 R: Emil Velikov <emil.l.velikov@gmail.com>
 F: src/gallium/targets/
 
+AUTOCONF BUILD
+R: Emil Velikov <emil.l.velikov@gmail.com>
+F: autogen.sh
+F: configure.ac
+F: */Automake.inc
+F: */Makefile.*am
+F: */Makefile.sources
+
 SCONS BUILD
 F: scons/
 F: */SConscript*
@@ -130,8 +136,3 @@ F:	src/gallium/drivers/freedreno/
 GLX
 R: Adam Jackson <ajax@redhat.com>
 F: src/glx/
-
-VULKAN
-R: Eric Engestrom <eric@engestrom.ch>
-F: src/vulkan/
-F: include/vulkan/

VERSION

@@ -1 +1 @@
-19.2.0-devel
+18.3.0

autogen.sh

@@ -0,0 +1,14 @@
+#! /bin/sh
+
+srcdir=`dirname "$0"`
+test -z "$srcdir" && srcdir=.
+
+ORIGDIR=`pwd`
+cd "$srcdir"
+
+autoreconf --force --verbose --install || exit 1
+cd "$ORIGDIR" || exit $?
+
+if test -z "$NOCONFIGURE"; then
+    "$srcdir"/configure "$@"
+fi

bin/.cherry-ignore

@@ -0,0 +1,2 @@
+# fixes: Commit was squashed into the respective offenders
+c02390f8fcd367c7350db568feabb2f062efca14 egl/wayland: rather obvious build fix

bin/.gitignore

@@ -0,0 +1,9 @@
+config.guess
+config.sub
+install-sh
+/depcomp
+/missing
+ylwrap
+compile
+ar-lib
+/test-driver

bin/get-pick-list.sh

@@ -13,54 +13,39 @@
 
 is_stable_nomination()
 {
-	git show --pretty=medium --summary "$1" | grep -q -i -o "CC:.*mesa-stable"
+	git show --summary "$1" | grep -q -i -o "CC:.*mesa-stable"
 }
 
 is_typod_nomination()
 {
-	git show --pretty=medium --summary "$1" | grep -q -i -o "CC:.*mesa-dev"
+	git show --summary "$1" | grep -q -i -o "CC:.*mesa-dev"
 }
 
-fixes=
-
 # Helper to handle various mistypos of the fixes tag.
 # The tag string itself is passed as argument and normalised within.
-#
-# Resulting string in the global variable "fixes" and contains entries
-# in the form "fixes:$sha"
 is_sha_nomination()
 {
 	fixes=`git show --pretty=medium -s $1 | tr -d "\n" | \
 		sed -e 's/'"$2"'/\nfixes:/Ig' | \
 		grep -Eo 'fixes:[a-f0-9]{8,40}'`
 
-	fixes_count=`echo "$fixes" | grep "fixes:" | wc -l`
+	fixes_count=`echo "$fixes" | wc -l`
 	if test $fixes_count -eq 0; then
-		return 1
+		return 0
 	fi
-
-	# Throw a warning for each invalid sha
 	while test $fixes_count -gt 0; do
 		# Treat only the current line
 		id=`echo "$fixes" | tail -n $fixes_count | head -n 1 | cut -d : -f 2`
 		fixes_count=$(($fixes_count-1))
-		if ! git show $id >/dev/null 2>&1; then
-			echo WARNING: Commit $1 lists invalid sha $id
+
+		# Bail out if we cannot find suitable id.
+		# Any specific validation the $id is valid and not some junk, is
+		# implied with the follow up code
+		if test "x$id" = x; then
+			continue
 		fi
-	done
 
-	return 0
-}
-
-# Checks if at least one of offending commits, listed in the global
-# "fixes", is in branch.
-sha_in_range()
-{
-	fixes_count=`echo "$fixes" | grep "fixes:" | wc -l`
-	while test $fixes_count -gt 0; do
-		# Treat only the current line
-		id=`echo "$fixes" | tail -n $fixes_count | head -n 1 | cut -d : -f 2`
-		fixes_count=$(($fixes_count-1))
+		#Check if the offending commit is in branch.
 
 		# Be that cherry-picked ...
 		# ... or landed before the branchpoint.
@@ -118,32 +103,22 @@ do
 		continue
 	fi
 
-	if is_fixes_nomination "$sha"; then
+	if is_stable_nomination "$sha"; then
+		tag=stable
+	elif is_typod_nomination "$sha"; then
+		tag=typod
+	elif is_fixes_nomination "$sha"; then
 		tag=fixes
 	elif is_brokenby_nomination "$sha"; then
 		tag=brokenby
 	elif is_revert_nomination "$sha"; then
 		tag=revert
-	elif is_stable_nomination "$sha"; then
-		tag=stable
-	elif is_typod_nomination "$sha"; then
-		tag=typod
 	else
 		continue
 	fi
 
-	case "$tag" in
-	fixes | brokenby | revert )
-		if ! sha_in_range; then
-			continue
-		fi
-		;;
-	* )
-		;;
-	esac
-
 	printf "[ %8s ] " "$tag"
-	git --no-pager show --no-patch --oneline $sha
+	git --no-pager show --summary --oneline $sha
 done
 
 rm -f already_picked

bin/install_megadrivers.py

@@ -24,6 +24,7 @@
 from __future__ import print_function
 import argparse
 import os
+import shutil
 
 
 def main():
@@ -34,11 +35,7 @@ def main():
     args = parser.parse_args()
 
     if os.path.isabs(args.libdir):
-        destdir = os.environ.get('DESTDIR')
-        if destdir:
-            to = os.path.join(destdir, args.libdir[1:])
-        else:
-            to = args.libdir
+        to = os.path.join(os.environ.get('DESTDIR', '/'), args.libdir[1:])
     else:
         to = os.path.join(os.environ['MESON_INSTALL_DESTDIR_PREFIX'], args.libdir)
 
@@ -48,6 +45,7 @@ def main():
         if os.path.lexists(to):
             os.unlink(to)
         os.makedirs(to)
+    shutil.copy(args.megadriver, master)
 
     for driver in args.drivers:
         abs_driver = os.path.join(to, driver)
@@ -69,14 +67,7 @@ def main():
                 name, ext = os.path.splitext(name)
         finally:
             os.chdir(ret)
-
-    # Remove meson-created master .so and symlinks
     os.unlink(master)
-    name, ext = os.path.splitext(master)
-    while ext != '.so':
-        if os.path.lexists(name):
-            os.unlink(name)
-        name, ext = os.path.splitext(name)
 
 
 if __name__ == '__main__':

bin/meson-cmd-extract.py

@@ -1,88 +0,0 @@
-#!/usr/bin/env python3
-# Copyright © 2019 Intel Corporation
-
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
-"""This script reads a meson build directory and gives back the command line it
-was configured with.
-
-This only works for meson 0.49.0 and newer.
-"""
-
-import argparse
-import ast
-import configparser
-import pathlib
-import sys
-
-
-def parse_args() -> argparse.Namespace:
-    """Parse arguments."""
-    parser = argparse.ArgumentParser()
-    parser.add_argument(
-        'build_dir',
-        help='Path the meson build directory')
-    args = parser.parse_args()
-    return args
-
-
-def load_config(path: pathlib.Path) -> configparser.ConfigParser:
-    """Load config file."""
-    conf = configparser.ConfigParser()
-    with path.open() as f:
-        conf.read_file(f)
-    return conf
-
-
-def build_cmd(conf: configparser.ConfigParser) -> str:
-    """Rebuild the command line."""
-    args = []
-    for k, v in conf['options'].items():
-        if ' ' in v:
-            args.append(f'-D{k}="{v}"')
-        else:
-            args.append(f'-D{k}={v}')
-
-    cf = conf['properties'].get('cross_file')
-    if cf:
-        args.append('--cross-file={}'.format(cf))
-    nf = conf['properties'].get('native_file')
-    if nf:
-        # this will be in the form "['str', 'str']", so use ast.literal_eval to
-        # convert it to a list of strings.
-        nf = ast.literal_eval(nf)
-        args.extend(['--native-file={}'.format(f) for f in nf])
-    return ' '.join(args)
-
-
-def main():
-    args = parse_args()
-    path = pathlib.Path(args.build_dir, 'meson-private', 'cmd_line.txt')
-    if not path.exists():
-        print('Cannot find the necessary file to rebuild command line. '
-              'Is your meson version >= 0.49.0?', file=sys.stderr)
-        sys.exit(1)
-
-    conf = load_config(path)
-    cmd = build_cmd(conf)
-    print(cmd)
-
-
-if __name__ == '__main__':
-    main()

bin/meson-options.py

@@ -1,63 +0,0 @@
-#!/usr/bin/env python3
-
-from os import get_terminal_size
-from textwrap import wrap
-from mesonbuild import coredata
-from mesonbuild import optinterpreter
-
-(COLUMNS, _) = get_terminal_size()
-
-def describe_option(option_name: str, option_default_value: str,
-                    option_type: str, option_message: str) -> None:
-    print('name:    ' + option_name)
-    print('default: ' + option_default_value)
-    print('type:    ' + option_type)
-    for line in wrap(option_message, width=COLUMNS - 9):
-        print('         ' + line)
-    print('---')
-
-oi = optinterpreter.OptionInterpreter('')
-oi.process('meson_options.txt')
-
-for (name, value) in oi.options.items():
-    if isinstance(value, coredata.UserStringOption):
-        describe_option(name,
-                        value.value,
-                        'string',
-                        "You can type what you want, but make sure it makes sense")
-    elif isinstance(value, coredata.UserBooleanOption):
-        describe_option(name,
-                        'true' if value.value else 'false',
-                        'boolean',
-                        "You can set it to 'true' or 'false'")
-    elif isinstance(value, coredata.UserIntegerOption):
-        describe_option(name,
-                        str(value.value),
-                        'integer',
-                        "You can set it to any integer value between '{}' and '{}'".format(value.min_value, value.max_value))
-    elif isinstance(value, coredata.UserUmaskOption):
-        describe_option(name,
-                        str(value.value),
-                        'umask',
-                        "You can set it to 'preserve' or a value between '0000' and '0777'")
-    elif isinstance(value, coredata.UserComboOption):
-        choices = '[' + ', '.join(["'" + v + "'" for v in value.choices]) + ']'
-        describe_option(name,
-                        value.value,
-                        'combo',
-                        "You can set it to any one of those values: " + choices)
-    elif isinstance(value, coredata.UserArrayOption):
-        choices = '[' + ', '.join(["'" + v + "'" for v in value.choices]) + ']'
-        value = '[' + ', '.join(["'" + v + "'" for v in value.value]) + ']'
-        describe_option(name,
-                        value,
-                        'array',
-                        "You can set it to one or more of those values: " + choices)
-    elif isinstance(value, coredata.UserFeatureOption):
-        describe_option(name,
-                        value.value,
-                        'feature',
-                        "You can set it to 'auto', 'enabled', or 'disabled'")
-    else:
-        print(name + ' is an option of a type unknown to this script')
-        print('---')

bin/meson.build

@@ -19,4 +19,3 @@
 # SOFTWARE.
 
 git_sha1_gen_py = files('git_sha1_gen.py')
-symbols_check = find_program('symbols-check.py')

bin/symbols-check.py

@@ -1,115 +0,0 @@
-#!/usr/bin/env python
-
-import argparse
-import subprocess
-import os
-
-# This list contains symbols that _might_ be exported for some platforms
-PLATFORM_SYMBOLS = [
-    '__bss_end__',
-    '__bss_start__',
-    '__bss_start',
-    '__end__',
-    '_bss_end__',
-    '_edata',
-    '_end',
-    '_fini',
-    '_init',
-]
-
-
-def get_symbols(nm, lib):
-    '''
-    List all the (non platform-specific) symbols exported by the library
-    '''
-    symbols = []
-    output = subprocess.check_output([nm, '--format=bsd', '-D', '--defined-only', lib],
-                                     stderr=open(os.devnull, 'w')).decode("ascii")
-    for line in output.splitlines():
-        (_, _, symbol_name) = line.split()
-        symbols.append(symbol_name)
-    return symbols
-
-
-def main():
-    parser = argparse.ArgumentParser()
-    parser.add_argument('--symbols-file',
-                        action='store',
-                        required=True,
-                        help='path to file containing symbols')
-    parser.add_argument('--lib',
-                        action='store',
-                        required=True,
-                        help='path to library')
-    parser.add_argument('--nm',
-                        action='store',
-                        required=True,
-                        help='path to binary (or name in $PATH)')
-    args = parser.parse_args()
-
-    lib_symbols = get_symbols(args.nm, args.lib)
-    mandatory_symbols = []
-    optional_symbols = []
-    with open(args.symbols_file) as symbols_file:
-        qualifier_optional = '(optional)'
-        for line in symbols_file.readlines():
-
-            # Strip comments
-            line = line.split('#')[0]
-            line = line.strip()
-            if not line:
-                continue
-
-            # Line format:
-            # [qualifier] symbol
-            qualifier = None
-            symbol = None
-
-            fields = line.split()
-            if len(fields) == 1:
-                symbol = fields[0]
-            elif len(fields) == 2:
-                qualifier = fields[0]
-                symbol = fields[1]
-            else:
-                print(args.symbols_file + ': invalid format: ' + line)
-                exit(1)
-
-            # The only supported qualifier is 'optional', which means the
-            # symbol doesn't have to be exported by the library
-            if qualifier and not qualifier == qualifier_optional:
-                print(args.symbols_file + ': invalid qualifier: ' + qualifier)
-                exit(1)
-
-            if qualifier == qualifier_optional:
-                optional_symbols.append(symbol)
-            else:
-                mandatory_symbols.append(symbol)
-
-    unknown_symbols = []
-    for symbol in lib_symbols:
-        if symbol in mandatory_symbols:
-            continue
-        if symbol in optional_symbols:
-            continue
-        if symbol in PLATFORM_SYMBOLS:
-            continue
-        unknown_symbols.append(symbol)
-
-    missing_symbols = [
-        sym for sym in mandatory_symbols if sym not in lib_symbols
-    ]
-
-    for symbol in unknown_symbols:
-        print(args.lib + ': unknown symbol exported: ' + symbol)
-
-    for symbol in missing_symbols:
-        print(args.lib + ': missing symbol: ' + symbol)
-
-    if unknown_symbols or missing_symbols:
-        exit(1)
-    exit(0)
-
-
-if __name__ == '__main__':
-    main()

docs/application-issues.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -48,25 +48,23 @@ start-up because of an extension string buffer-overflow problem.
 
 <p>
 The problem is a modern OpenGL driver will return a very long string
-for the <code>glGetString(GL_EXTENSIONS)</code> query and if the application
+for the glGetString(GL_EXTENSIONS) query and if the application
 naively copies the string into a fixed-size buffer it can overflow the
 buffer and crash the application.
 </p>
 
 <p>
-The work-around is to set the <code>MESA_EXTENSION_MAX_YEAR</code>
-environment variable to the approximate release year of the game.
-This will cause the <code>glGetString(GL_EXTENSIONS)</code> query to only report
-extensions older than the given year.
+The work-around is to set the MESA_EXTENSION_MAX_YEAR environment variable
+to the approximate release year of the game.
+This will cause the glGetString(GL_EXTENSIONS) query to only report extensions
+older than the given year.
 </p>
 
 <p>
 For example, if the game was released in 2001, do
-</p>
 <pre>
 export MESA_EXTENSION_MAX_YEAR=2001
 </pre>
-<p>
 before running the game.
 </p>
 

docs/autoconf.html

@@ -0,0 +1,264 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8">
+  <title>Compilation and Installation using Autoconf</title>
+  <link rel="stylesheet" type="text/css" href="mesa.css">
+</head>
+<body>
+
+<div class="header">
+  <h1>The Mesa 3D Graphics Library</h1>
+</div>
+
+<iframe src="contents.html"></iframe>
+<div class="content">
+
+<h1>Compilation and Installation using Autoconf</h1>
+
+<ol>
+<li><p><a href="#basic">Basic Usage</a></li>
+<li><p><a href="#driver">Driver Options</a>
+  <ul>
+  <li><a href="#xlib">Xlib Driver Options</a></li>
+  <li><a href="#dri">DRI Driver Options</a></li>
+  <li><a href="#osmesa">OSMesa Driver Options</a></li>
+  </ul>
+</ol>
+
+
+<h2 id="basic">1. Basic Usage</h2>
+
+<p>
+The autoconf generated configure script can be used to guess your
+platform and change various options for building Mesa. To use the
+configure script, type:
+</p>
+
+<pre>
+    ./configure
+</pre>
+
+<p>
+To see a short description of all the options, type <code>./configure
+--help</code>. If you are using a development snapshot and the configure
+script does not exist, type <code>./autogen.sh</code> to generate it
+first. If you know the options you want to pass to
+<code>configure</code>, you can pass them to <code>autogen.sh</code>. It
+will run <code>configure</code> with these options after it is
+generated. Once you have run <code>configure</code> and set the options
+to your preference, type:
+</p>
+
+<pre>
+    make
+</pre>
+
+<p>
+This will produce libGL.so and/or several other libraries depending on the
+options you have chosen. Later, if you want to rebuild for a different
+configuration run <code>make realclean</code> before rebuilding.
+</p>
+
+<p>
+Some of the generic autoconf options are used with Mesa:
+</p>
+<dl>
+<dt><code>--prefix=PREFIX</code></dt>
+<dd><p>This is the root directory where
+files will be installed by <code>make install</code>. The default is
+<code>/usr/local</code>.</p>
+</dd>
+
+<dt><code>--exec-prefix=EPREFIX</code></dt>
+<dd><p>This is the root directory
+where architecture-dependent files will be installed. In Mesa, this is
+only used to derive the directory for the libraries. The default is
+<code>${prefix}</code>.</p>
+</dd>
+
+<dt><code>--libdir=LIBDIR</code></dt>
+<dd><p>This option specifies the directory
+where the GL libraries will be installed. The default is
+<code>${exec_prefix}/lib</code>. It also serves as the name of the
+library staging area in the source tree. For instance, if the option
+<code>--libdir=/usr/local/lib64</code> is used, the libraries will be
+created in a <code>lib64</code> directory at the top of the Mesa source
+tree.</p>
+</dd>
+
+<dt><code>--sysconfdir=DIR</code></dt>
+<dd><p>This option specifies the directory where the configuration
+files will be installed. The default is <code>${prefix}/etc</code>.
+Currently there's only one config file provided when dri drivers are
+enabled - it's <code>drirc</code>.</p>
+</dd>
+
+<dt><code>--datadir=DIR</code></dt>
+<dd><p>This option specifies the directory where the data files will
+be installed. The default is <code>${prefix}/share</code>.
+Currently when dri drivers are enabled, <code>drirc.d/</code> is at
+this place.</p>
+</dd>
+
+<dt><code>--enable-static, --disable-shared</code></dt>
+<dd><p>By default, Mesa
+will build shared libraries. Either of these options will force static
+libraries to be built. It is not currently possible to build static and
+shared libraries in a single pass.</p>
+</dd>
+
+<dt><code>CC, CFLAGS, CXX, CXXFLAGS</code></dt>
+<dd><p>These environment variables
+control the C and C++ compilers used during the build. By default,
+<code>gcc</code> and <code>g++</code> are used and the debug/optimisation
+level is left unchanged.</p>
+</dd>
+
+<dt><code>LDFLAGS</code></dt>
+<dd><p>An environment variable specifying flags to
+pass when linking programs. These should be empty and
+<code>PKG_CONFIG_PATH</code> is recommended to be used instead. If needed
+it can be used to direct the linker to use libraries in nonstandard
+directories. For example, <code>LDFLAGS="-L/usr/X11R6/lib"</code>.</p>
+</dd>
+
+<dt><code>PKG_CONFIG_PATH</code></dt>
+<dd><p>The
+<code>pkg-config</code> utility is a hard requirement for configuring and
+building mesa. It is used to search for external libraries
+on the system. This environment variable is used to control the search
+path for <code>pkg-config</code>. For instance, setting
+<code>PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig</code> will search for
+package metadata in <code>/usr/X11R6</code> before the standard
+directories.</p>
+</dd>
+</dl>
+
+<p>
+There are also a few general options for altering the Mesa build:
+</p>
+<dl>
+<dt><code>--enable-debug</code></dt>
+<dd><p>This option will set the compiler debug/optimisation levels (if the user
+hasn't already set them via the CFLAGS/CXXFLAGS) and macros to aid in
+debugging the Mesa libraries.</p>
+
+<p>Note that enabling this option can lead to noticeable loss of performance.</p>
+
+<dt><code>--disable-asm</code></dt>
+<dd><p>There are assembly routines
+available for a few architectures. These will be used by default if
+one of these architectures is detected. This option ensures that
+assembly will not be used.</p>
+</dd>
+
+<dt><code>--build=</code></dt>
+<dt><code>--host=</code></dt>
+<dd><p>By default, the build will compile code for the architecture that
+it's running on. In order to build cross-compile Mesa on a x86-64 machine
+that is to run on a i686, one would need to set the options to:</p>
+
+<p><code>--build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu</code></p>
+
+Note that these can vary from distribution to distribution. For more
+information check with the
+<a href="https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.69/html_node/Specifying-Target-Triplets.html">
+autoconf manual</a>.
+Note that you will need to correctly set <code>PKG_CONFIG_PATH</code> as well.
+
+
+<p>In some cases a single compiler is capable of handling both architectures
+(multilib) in that case one would need to set the <code>CC,CXX</code> variables
+appending the correct machine options. Seek your compiler documentation for
+further information -
+<a href="https://gcc.gnu.org/onlinedocs/gcc/Submodel-Options.html"> gcc
+machine dependent options</a></p>
+
+<p>In addition to specifying correct <code>PKG_CONFIG_PATH</code> for the target
+architecture, the following should be sufficient to configure multilib Mesa</p>
+
+<code>./configure CC="gcc -m32" CXX="g++ -m32" --build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu ...</code>
+</dd>
+</dl>
+
+
+<h2 id="driver">2. GL Driver Options</h2>
+
+<p>
+There are several different driver modes that Mesa can use. These are
+described in more detail in the <a href="install.html">basic
+installation instructions</a>. The Mesa driver is controlled through the
+configure options <code>--enable-glx</code> and <code>--enable-osmesa</code>
+</p>
+
+<h3 id="xlib">Xlib</h3><p>
+It uses Xlib as a software renderer to do all rendering. It corresponds
+to the option <code>--enable-glx=xlib</code> or <code>--enable-glx=gallium-xlib</code>.
+
+<h3 id="dri">DRI</h3><p>This mode uses the DRI hardware drivers for
+accelerated OpenGL rendering. To enable use <code>--enable-glx=dri
+--enable-dri</code>.
+
+<!-- DRI specific options -->
+<dl>
+<dt><code>--with-dri-driverdir=DIR</code>
+<dd><p> This option specifies the
+location the DRI drivers will be installed to and the location libGL
+will search for DRI drivers. The default is <code>${libdir}/dri</code>.
+<dt><code>--with-dri-drivers=DRIVER,DRIVER,...</code>
+<dd><p> This option
+allows a specific set of DRI drivers to be built. For example,
+<code>--with-dri-drivers="swrast,i965,radeon,nouveau"</code>. By
+default, the drivers will be chosen depending on the target platform.
+See the directory <code>src/mesa/drivers/dri</code> in the source tree
+for available drivers. Beware that the swrast DRI driver is used by both
+libGL and the X.Org xserver GLX module to do software rendering, so you
+may run into problems if it is not available.
+<!-- This explanation might be totally bogus. Kristian? -->
+<dt><code>--disable-driglx-direct</code>
+<dd><p> Disable direct rendering in
+GLX. Normally, direct hardware rendering through the DRI drivers and
+indirect software rendering are enabled in GLX. This option disables
+direct rendering entirely. It can be useful on architectures where
+kernel DRM modules are not available.
+<dt><code>--enable-glx-tls</code> <dd><p>
+Enable Thread Local Storage (TLS) in
+GLX.
+<dt><code>--with-expat=DIR</code>
+<dd><p><strong>DEPRECATED</strong>, use <code>PKG_CONFIG_PATH</code> instead.</p>
+<p>The DRI-enabled libGL uses expat to
+parse the DRI configuration files in <code>${sysconfdir}/drirc</code> and
+<code>~/.drirc</code>. This option allows a specific expat installation
+to be used. For example, <code>--with-expat=/usr/local</code> will
+search for expat headers and libraries in <code>/usr/local/include</code>
+and <code>/usr/local/lib</code>, respectively.
+</dl>
+
+<h3 id="osmesa">OSMesa </h3><p> No libGL is built in this
+mode. Instead, the driver code is built into the Off-Screen Mesa
+(OSMesa) library. See the <a href="osmesa.html">Off-Screen Rendering</a>
+page for more details.  It corresponds to the option
+<code>--enable-osmesa</code>.
+
+<!-- OSMesa specific options -->
+<dl>
+<dt><code>--with-osmesa-bits=BITS</code>
+<dd><p> This option allows the size
+of the color channel in bits to be specified. By default, an 8-bit
+channel will be used, and the driver will be named libOSMesa. Other
+options are 16- and 32-bit color channels, which will add the bit size
+to the library name. For example, <code>--with-osmesa-bits=16</code>
+will create the libOSMesa16 library with a 16-bit color channel.
+</dl>
+
+
+<h2 id="library">3. Library Options</h2>
+
+<p>
+The configure script provides more fine grained control over the libraries
+that will be built.
+
+</div>
+</body>
+</html>

docs/bugs.html

@@ -2,19 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Report a Bug</title>
+  <title>Mesa Bug Reporting</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Report a Bug</h1>
+<h1>Bug Database</h1>
 
 <p>
 The Mesa bug database is hosted on

docs/codingstyle.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -48,19 +48,19 @@ For example:
    }
 </pre>
 
-<li>Put a space before/after operators.  For example, <code>a = b + c;</code>
-and not <code>a=b+c;</code>
+<li>Put a space before/after operators.  For example, <tt>a = b + c;</tt>
+and not <tt>a=b+c;</tt>
 
 <li>This GNU indent command generally does the right thing for formatting:
 <pre>
    indent -br -i3 -npcs --no-tabs infile.c -o outfile.c
 </pre>
 
-<li>
-<p>Use comments wherever you think it would be helpful for other developers.
+<li>Use comments wherever you think it would be helpful for other developers.
 Several specific cases and style examples follow.  Note that we roughly
-follow <a href="http://www.doxygen.nl">Doxygen</a> conventions.
-</p>
+follow <a href="https://www.stack.nl/~dimitri/doxygen/">Doxygen</a> conventions.
+<br>
+<br>
 Single-line comments:
 <pre>
    /* null-out pointer to prevent dangling reference below */
@@ -120,23 +120,22 @@ the opening brace goes on the next line by itself (see above.)
    _mesa_foo_bar()  - an internal non-static Mesa function
 </pre>
 
-<li>Constants, macros and enum names are <code>ALL_UPPERCASE</code>, with _
-between words.
-<li>Mesa usually uses camel case for local variables (Ex:
-<code>localVarname</code>) while gallium typically uses underscores (Ex:
-<code>local_var_name</code>).
+<li>Constants, macros and enum names are ALL_UPPERCASE, with _ between
+words.
+<li>Mesa usually uses camel case for local variables (Ex: "localVarname")
+while gallium typically uses underscores (Ex: "local_var_name").
 <li>Global variables are almost never used because Mesa should be thread-safe.
 
 <li>Booleans.  Places that are not directly visible to the GL API
-should prefer the use of <code>bool</code>, <code>true</code>, and
-<code>false</code> over <code>GLboolean</code>, <code>GL_TRUE</code>, and
-<code>GL_FALSE</code>.  In C code, this may mean that
-<code>#include &lt;stdbool.h&gt;</code> needs to be added.  The
-<code>try_emit_*</code> methods in <code>src/mesa/program/ir_to_mesa.cpp</code>
-and <code>src/mesa/state_tracker/st_glsl_to_tgsi.cpp</code> can serve as
-examples.
+should prefer the use of <tt>bool</tt>, <tt>true</tt>, and
+<tt>false</tt> over <tt>GLboolean</tt>, <tt>GL_TRUE</tt>, and
+<tt>GL_FALSE</tt>.  In C code, this may mean that
+<tt>#include &lt;stdbool.h&gt;</tt> needs to be added.  The
+<tt>try_emit_</tt>* methods in src/mesa/program/ir_to_mesa.cpp and
+src/mesa/state_tracker/st_glsl_to_tgsi.cpp can serve as examples.
 
 </ul>
+</p>
 
 </div>
 </body>

docs/conform.html

@@ -2,19 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Conformance Testing</title>
+  <title>Conformance</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Conformance Testing</h1>
+<h1>Conformance</h1>
 
 <p>
 The SGI OpenGL conformance tests verify correct operation of OpenGL

docs/contents.html

@@ -12,10 +12,6 @@
       background-color: #cccccc;
       color: black;
     }
-    h2 {
-      font-size: inherit;
-      font-weight: bold;
-    }
     a:link {
       color: #000;
     }
@@ -27,56 +23,59 @@
 </head>
 <body>
 
-<h2>Documentation</h2>
+<b>Documentation</b>
 <ul>
 <li><a href="intro.html" target="_parent">Introduction</a>
 <li><a href="index.html" target="_parent">News</a>
 <li><a href="developers.html" target="_parent">Developers</a>
 <li><a href="systems.html" target="_parent">Platforms and Drivers</a>
-<li><a href="license.html" target="_parent">License and Copyright</a>
-<li><a href="faq.html" target="_parent">Frequently Asked Questions</a>
+<li><a href="license.html" target="_parent">License &amp; Copyright</a>
+<li><a href="faq.html" target="_parent">FAQ</a>
 <li><a href="relnotes.html" target="_parent">Release Notes</a>
 <li><a href="thanks.html" target="_parent">Acknowledgements</a>
 <li><a href="conform.html" target="_parent">Conformance Testing</a>
+<li>more docs below...
 </ul>
 
-<h2>Download and Install</h2>
+<b>Download / Install</b>
 <ul>
-<li><a href="download.html" target="_parent">Downloading and Unpacking</a>
-<li><a href="install.html" target="_parent">Compiling and Installing</a>
+<li><a href="download.html" target="_parent">Downloading / Unpacking</a>
+<li><a href="install.html" target="_parent">Compiling / Installing</a>
   <ul>
+    <li><a href="autoconf.html" target="_parent">Autoconf</a></li>
     <li><a href="meson.html" target="_parent">Meson</a></li>
   </ul>
 </li>
 <li><a href="precompiled.html" target="_parent">Precompiled Libraries</a>
 </ul>
 
-<h2>Need help?</h2>
+<b>Resources</b>
 <ul>
 <li><a href="lists.html" target="_parent">Mailing Lists</a>
-<li><a href="bugs.html" target="_parent">Report a bug</a>
+<li><a href="bugs.html" target="_parent">Bug Database</a>
 <li><a href="webmaster.html" target="_parent">Webmaster</a>
 <li><a href="https://dri.freedesktop.org/" target="_parent">Mesa/DRI Wiki</a>
 </ul>
 
-<h2>User Topics</h2>
+<b>User Topics</b>
 <ul>
 <li><a href="shading.html" target="_parent">Shading Language</a>
 <li><a href="egl.html" target="_parent">EGL</a>
 <li><a href="opengles.html" target="_parent">OpenGL ES</a>
 <li><a href="envvars.html" target="_parent">Environment Variables</a>
-<li><a href="osmesa.html" target="_parent">Off-screen Rendering</a>
+<li><a href="osmesa.html" target="_parent">Off-Screen Rendering</a>
 <li><a href="debugging.html" target="_parent">Debugging Tips</a>
 <li><a href="perf.html" target="_parent">Performance Tips</a>
 <li><a href="extensions.html" target="_parent">Mesa Extensions</a>
-<li><a href="llvmpipe.html" target="_parent">Gallium LLVMpipe Driver</a>
-<li><a href="vmware-guest.html" target="_parent">VMware SVGA3D Guest Driver</a>
-<li><a href="postprocess.html" target="_parent">Gallium Post-processing</a>
+<li><a href="mangling.html" target="_parent">GL Function Name Mangling</a>
+<li><a href="llvmpipe.html" target="_parent">Gallium llvmpipe driver</a>
+<li><a href="vmware-guest.html" target="_parent">VMware SVGA3D guest driver</a>
+<li><a href="postprocess.html" target="_parent">Gallium post-processing</a>
 <li><a href="application-issues.html" target="_parent">Application Issues</a>
 <li><a href="viewperf.html" target="_parent">Viewperf Issues</a>
 </ul>
 
-<h2>Developer Topics</h2>
+<b>Developer Topics</b>
 <ul>
 <li><a href="repository.html" target="_parent">Source Code Repository</a>
 <li><a href="sourcetree.html" target="_parent">Source Code Tree</a>
@@ -84,25 +83,26 @@
 <li><a href="helpwanted.html" target="_parent">Help Wanted</a>
 <li><a href="devinfo.html" target="_parent">Development Notes</a>
 <li><a href="codingstyle.html" target="_parent">Coding Style</a>
-<li><a href="submittingpatches.html" target="_parent">Submitting Patches</a>
-<li><a href="releasing.html" target="_parent">Releasing Process</a>
-<li><a href="release-calendar.html" target="_parent">Release Calendar</a>
+<li><a href="submittingpatches.html" target="_parent">Submitting patches</a>
+<li><a href="releasing.html" target="_parent">Releasing process</a>
+<li><a href="release-calendar.html" target="_parent">Release calendar</a>
 <li><a href="sourcedocs.html" target="_parent">Source Documentation</a>
 <li><a href="dispatch.html" target="_parent">GL Dispatch</a>
 </ul>
 
-<h2>Links</h2>
+<b>Links</b>
 <ul>
-<li><a href="https://www.opengl.org" target="_parent">OpenGL Website</a>
-<li><a href="https://dri.freedesktop.org" target="_parent">DRI Website</a>
+<li><a href="https://www.opengl.org" target="_parent">OpenGL website</a>
+<li><a href="https://dri.freedesktop.org" target="_parent">DRI website</a>
 <li><a href="https://www.freedesktop.org" target="_parent">freedesktop.org</a>
-<li><a href="https://planet.freedesktop.org" target="_parent">Developer Blogs</a>
+<li><a href="https://planet.freedesktop.org" target="_parent">Developer blogs</a>
 </ul>
 
-<h2>Hosted by:</h2>
-<dl>
-<dd><a href="https://www.freedesktop.org" target="_parent">freedesktop.org</a>
-</dl>
+<b>Hosted by:</b>
+<br>
+<blockquote>
+<a href="https://freedesktop.org" target="_parent">freedesktop.org</a>
+</blockquote>
 
 </body>
 </html>

docs/debugging.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -20,22 +20,26 @@
    Normally Mesa (and OpenGL) records but does not notify the user of
    errors.  It is up to the application to call
    <code>glGetError</code> to check for errors.  Mesa supports an
-   environment variable, <code>MESA_DEBUG</code>, to help with debugging.  If
-   <code>MESA_DEBUG</code> is defined, a message will be printed to stdout
-   whenever an error occurs.
+   environment variable, MESA_DEBUG, to help with debugging.  If
+   MESA_DEBUG is defined, a message will be printed to stdout whenever
+   an error occurs.
 </p>
 
 <p>
-   More extensive error checking is done in DEBUG builds
-   (<code>--buildtype debug</code> for meson, <code>build=debug</code> for scons).
+   More extensive error checking is done when Mesa is compiled with the
+   DEBUG symbol defined.  You'll have to edit the Make-config file and
+   add -DDEBUG to the CFLAGS line for your system configuration.  You may
+   also want to replace any optimization flags with the -g flag so you can
+   use your debugger.  After you've edited Make-config type 'make clean'
+   before recompiling.
 </p>
 <p>
-   In your debugger you can set a breakpoint in <code>_mesa_error()</code> to trap
-   Mesa errors.
+   In your debugger you can set a breakpoint in _mesa_error() to trap Mesa
+   errors.
 </p>
 <p>
    There is a display list printing/debugging facility.  See the end of
-   <code>src/dlist.c</code> for details.
+   src/dlist.c for details.
 </p>
 
 </div>

docs/developers.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>

docs/devinfo.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -25,12 +25,11 @@
 
 <p>
 To add a new GL extension to Mesa you have to do at least the following.
-</p>
 
 <ul>
 <li>
-   If <code>glext.h</code> doesn't define the extension, edit
-   <code>include/GL/gl.h</code> and add code like this:
+   If glext.h doesn't define the extension, edit include/GL/gl.h and add
+   code like this:
    <pre>
      #ifndef GL_EXT_the_extension_name
      #define GL_EXT_the_extension_name 1
@@ -41,18 +40,18 @@ To add a new GL extension to Mesa you have to do at least the following.
    </pre>
 </li>
 <li>
-   In the <code>src/mapi/glapi/gen/</code> directory, add the new extension
-   functions and enums to the <code>gl_API.xml</code> file.
+   In the src/mapi/glapi/gen/ directory, add the new extension functions and
+   enums to the gl_API.xml file.
    Then, a bunch of source files must be regenerated by executing the
    corresponding Python scripts.
 </li>
 <li>
-   Add a new entry to the <code>gl_extensions</code> struct in
-   <code>mtypes.h</code> if the extension requires driver capabilities not
-   already exposed by another extension.
+   Add a new entry to the <code>gl_extensions</code> struct in mtypes.h
+   if the extension requires driver capabilities not already exposed by
+   another extension.
 </li>
 <li>
-   Add a new entry to the <code>src/mesa/main/extensions_table.h</code> file.
+   Add a new entry to the src/mesa/main/extensions_table.h file.
 </li>
 <li>
    From this point, the best way to proceed is to find another extension,
@@ -60,22 +59,21 @@ To add a new GL extension to Mesa you have to do at least the following.
    as an example.
 </li>
 <li>
-   If the new extension adds new GL state, the functions in
-   <code>get.c</code>, <code>enable.c</code> and <code>attrib.c</code>
-   will most likely require new code.
+   If the new extension adds new GL state, the functions in get.c, enable.c
+   and attrib.c will most likely require new code.
 </li>
 <li>
    To determine if the new extension is active in the current context,
-   use the auto-generated <code>_mesa_has_##name_str()</code> function
-   defined in <code>src/mesa/main/extensions.h</code>.
+   use the auto-generated _mesa_has_##name_str() function defined in
+   src/mesa/main/extensions.h.
 </li>
 <li>
-   The dispatch tests <code>check_table.cpp</code> and
-   <code>dispatch_sanity.cpp</code> should be updated with details about
-   the new extensions functions. These tests are run using
-   <code>meson test</code>.
+   The dispatch tests check_table.cpp and dispatch_sanity.cpp
+   should be updated with details about the new extensions functions. These
+   tests are run using 'make check'
 </li>
 </ul>
+</p>
 
 
 

docs/dispatch.html

@@ -2,19 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>GL Dispatch</title>
+  <title>GL Dispatch in Mesa</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>GL Dispatch</h1>
+<h1>GL Dispatch in Mesa</h1>
 
 <p>Several factors combine to make efficient dispatch of OpenGL functions
 fairly complicated.  This document attempts to explain some of the issues
@@ -30,28 +30,28 @@ of the GL related state for the application.  Every texture, every buffer
 object, every enable, and much, much more is stored in the context.  Since
 an application can have more than one context, the context to be used is
 selected by a window-system dependent function such as
-<code>glXMakeContextCurrent</code>.</p>
+<tt>glXMakeContextCurrent</tt>.</p>
 
 <p>In environments that implement OpenGL with X-Windows using GLX, every GL
-function, including the pointers returned by <code>glXGetProcAddress</code>, are
+function, including the pointers returned by <tt>glXGetProcAddress</tt>, are
 <em>context independent</em>.  This means that no matter what context is
-currently active, the same <code>glVertex3fv</code> function is used.</p>
+currently active, the same <tt>glVertex3fv</tt> function is used.</p>
 
 <p>This creates the first bit of dispatch complexity.  An application can
 have two GL contexts.  One context is a direct rendering context where
 function calls are routed directly to a driver loaded within the
 application's address space.  The other context is an indirect rendering
 context where function calls are converted to GLX protocol and sent to a
-server.  The same <code>glVertex3fv</code> has to do the right thing depending
+server.  The same <tt>glVertex3fv</tt> has to do the right thing depending
 on which context is current.</p>
 
 <p>Highly optimized drivers or GLX protocol implementations may want to
 change the behavior of GL functions depending on current state.  For
-example, <code>glFogCoordf</code> may operate differently depending on whether
+example, <tt>glFogCoordf</tt> may operate differently depending on whether
 or not fog is enabled.</p>
 
 <p>In multi-threaded environments, it is possible for each thread to have a
-different GL context current.  This means that poor old <code>glVertex3fv</code>
+different GL context current.  This means that poor old <tt>glVertex3fv</tt>
 has to know which GL context is current in the thread where it is being
 called.</p>
 
@@ -64,18 +64,18 @@ dispatch table stores pointers to functions that actually implement
 specific GL functions.  Each time a new context is made current in a thread,
 these pointers a updated.</p>
 
-<p>The implementation of functions such as <code>glVertex3fv</code> becomes
+<p>The implementation of functions such as <tt>glVertex3fv</tt> becomes
 conceptually simple:</p>
 
 <ul>
 <li>Fetch the current dispatch table pointer.</li>
-<li>Fetch the pointer to the real <code>glVertex3fv</code> function from the
+<li>Fetch the pointer to the real <tt>glVertex3fv</tt> function from the
 table.</li>
 <li>Call the real function.</li>
 </ul>
 
 <p>This can be implemented in just a few lines of C code.  The file
-<code>src/mesa/glapi/glapitemp.h</code> contains code very similar to this.</p>
+<tt>src/mesa/glapi/glapitemp.h</tt> contains code very similar to this.</p>
 
 <blockquote>
 <table border="1">
@@ -93,9 +93,9 @@ void glVertex3f(GLfloat x, GLfloat y, GLfloat z)
 overhead that it adds to every GL function call.</p>
 
 <p>In a multithreaded environment, a naive implementation of
-<code>GET_DISPATCH</code> involves a call to <code>pthread_getspecific</code> or a
+<tt>GET_DISPATCH</tt> involves a call to <tt>pthread_getspecific</tt> or a
 similar function.  Mesa provides a wrapper function called
-<code>_glapi_get_dispatch</code> that is used by default.</p>
+<tt>_glapi_get_dispatch</tt> that is used by default.</p>
 
 <h2>3. Optimizations</h2>
 
@@ -109,7 +109,7 @@ each can or cannot be used are listed.</p>
 <p>The vast majority of OpenGL applications use the API in a single threaded
 manner.  That is, the application has only one thread that makes calls into
 the GL.  In these cases, not only do the calls to
-<code>pthread_getspecific</code> hurt performance, but they are completely
+<tt>pthread_getspecific</tt> hurt performance, but they are completely
 unnecessary!  It is possible to detect this common case and avoid these
 calls.</p>
 
@@ -118,15 +118,15 @@ of the executing thread.  If the same thread ID is always seen, Mesa knows
 that the application is, from OpenGL's point of view, single threaded.</p>
 
 <p>As long as an application is single threaded, Mesa stores a pointer to
-the dispatch table in a global variable called <code>_glapi_Dispatch</code>.
+the dispatch table in a global variable called <tt>_glapi_Dispatch</tt>.
 The pointer is also stored in a per-thread location via
-<code>pthread_setspecific</code>.  When Mesa detects that an application has
-become multithreaded, <code>NULL</code> is stored in <code>_glapi_Dispatch</code>.</p>
+<tt>pthread_setspecific</tt>.  When Mesa detects that an application has
+become multithreaded, <tt>NULL</tt> is stored in <tt>_glapi_Dispatch</tt>.</p>
 
 <p>Using this simple mechanism the dispatch functions can detect the
-multithreaded case by comparing <code>_glapi_Dispatch</code> to <code>NULL</code>.
-The resulting implementation of <code>GET_DISPATCH</code> is slightly more
-complex, but it avoids the expensive <code>pthread_getspecific</code> call in
+multithreaded case by comparing <tt>_glapi_Dispatch</tt> to <tt>NULL</tt>.
+The resulting implementation of <tt>GET_DISPATCH</tt> is slightly more
+complex, but it avoids the expensive <tt>pthread_getspecific</tt> call in
 the common case.</p>
 
 <blockquote>
@@ -134,9 +134,9 @@ the common case.</p>
 <tr><td><pre>
 #define GET_DISPATCH() \
     (_glapi_Dispatch != NULL) \
-        ? _glapi_Dispatch : pthread_getspecific(&amp;_glapi_Dispatch_key)
+        ? _glapi_Dispatch : pthread_getspecific(&_glapi_Dispatch_key)
 </pre></td></tr>
-<tr><td>Improved <code>GET_DISPATCH</code> Implementation</td></tr></table>
+<tr><td>Improved <tt>GET_DISPATCH</tt> Implementation</td></tr></table>
 </blockquote>
 
 <h3>3.2. ELF TLS</h3>
@@ -144,14 +144,14 @@ the common case.</p>
 <p>Starting with the 2.4.20 Linux kernel, each thread is allocated an area
 of per-thread, global storage.  Variables can be put in this area using some
 extensions to GCC.  By storing the dispatch table pointer in this area, the
-expensive call to <code>pthread_getspecific</code> and the test of
-<code>_glapi_Dispatch</code> can be avoided.</p>
+expensive call to <tt>pthread_getspecific</tt> and the test of
+<tt>_glapi_Dispatch</tt> can be avoided.</p>
 
 <p>The dispatch table pointer is stored in a new variable called
-<code>_glapi_tls_Dispatch</code>.  A new variable name is used so that a single
+<tt>_glapi_tls_Dispatch</tt>.  A new variable name is used so that a single
 libGL can implement both interfaces.  This allows the libGL to operate with
 direct rendering drivers that use either interface.  Once the pointer is
-properly declared, <code>GET_DISPACH</code> becomes a simple variable
+properly declared, <tt>GET_DISPACH</tt> becomes a simple variable
 reference.</p>
 
 <blockquote>
@@ -162,11 +162,11 @@ extern __thread struct _glapi_table *_glapi_tls_Dispatch
 
 #define GET_DISPATCH() _glapi_tls_Dispatch
 </pre></td></tr>
-<tr><td>TLS <code>GET_DISPATCH</code> Implementation</td></tr></table>
+<tr><td>TLS <tt>GET_DISPATCH</tt> Implementation</td></tr></table>
 </blockquote>
 
 <p>Use of this path is controlled by the preprocessor define
-<code>GLX_USE_TLS</code>.  Any platform capable of using TLS should use this as
+<tt>GLX_USE_TLS</tt>.  Any platform capable of using TLS should use this as
 the default dispatch method.</p>
 
 <h3>3.3. Assembly Language Dispatch Stubs</h3>
@@ -185,13 +185,13 @@ ways that the dispatch table pointer can be accessed.  There are four
 different methods that can be used:</p>
 
 <ol>
-<li>Using <code>_glapi_Dispatch</code> directly in builds for non-multithreaded
+<li>Using <tt>_glapi_Dispatch</tt> directly in builds for non-multithreaded
 environments.</li>
-<li>Using <code>_glapi_Dispatch</code> and <code>_glapi_get_dispatch</code> in
+<li>Using <tt>_glapi_Dispatch</tt> and <tt>_glapi_get_dispatch</tt> in
 multithreaded environments.</li>
-<li>Using <code>_glapi_Dispatch</code> and <code>pthread_getspecific</code> in
+<li>Using <tt>_glapi_Dispatch</tt> and <tt>pthread_getspecific</tt> in
 multithreaded environments.</li>
-<li>Using <code>_glapi_tls_Dispatch</code> directly in TLS enabled
+<li>Using <tt>_glapi_tls_Dispatch</tt> directly in TLS enabled
 multithreaded environments.</li>
 </ol>
 
@@ -204,13 +204,13 @@ terribly relevant.</p>
 few preprocessor defines.</p>
 
 <ul>
-<li>If <code>GLX_USE_TLS</code> is defined, method #3 is used.</li>
-<li>If <code>HAVE_PTHREAD</code> is defined, method #2 is used.</li>
+<li>If <tt>GLX_USE_TLS</tt> is defined, method #3 is used.</li>
+<li>If <tt>HAVE_PTHREAD</tt> is defined, method #2 is used.</li>
 <li>If none of the preceding are defined, method #1 is used.</li>
 </ul>
 
 <p>Two different techniques are used to handle the various different cases.
-On x86 and SPARC, a macro called <code>GL_STUB</code> is used.  In the preamble
+On x86 and SPARC, a macro called <tt>GL_STUB</tt> is used.  In the preamble
 of the assembly source file different implementations of the macro are
 selected based on the defined preprocessor variables.  The assembly code
 then consists of a series of invocations of the macros such as:
@@ -220,7 +220,7 @@ then consists of a series of invocations of the macros such as:
 <tr><td><pre>
 GL_STUB(Color3fv, _gloffset_Color3fv)
 </pre></td></tr>
-<tr><td>SPARC Assembly Implementation of <code>glColor3fv</code></td></tr></table>
+<tr><td>SPARC Assembly Implementation of <tt>glColor3fv</tt></td></tr></table>
 </blockquote>
 
 <p>The benefit of this technique is that changes to the calling pattern
@@ -231,32 +231,32 @@ changed lines in the assembly code.</p>
 implementation does not change based on the parameters passed to the
 function.  For example, since x86 passes all parameters on the stack, no
 additional code is needed to save and restore function parameters around a
-call to <code>pthread_getspecific</code>.  Since x86-64 passes parameters in
+call to <tt>pthread_getspecific</tt>.  Since x86-64 passes parameters in
 registers, varying amounts of code needs to be inserted around the call to
-<code>pthread_getspecific</code> to save and restore the GL function's
+<tt>pthread_getspecific</tt> to save and restore the GL function's
 parameters.</p>
 
 <p>The other technique, used by platforms like x86-64 that cannot use the
-first technique, is to insert <code>#ifdef</code> within the assembly
+first technique, is to insert <tt>#ifdef</tt> within the assembly
 implementation of each function.  This makes the assembly file considerably
-larger (e.g., 29,332 lines for <code>glapi_x86-64.S</code> versus 1,155 lines for
-<code>glapi_x86.S</code>) and causes simple changes to the function
+larger (e.g., 29,332 lines for <tt>glapi_x86-64.S</tt> versus 1,155 lines for
+<tt>glapi_x86.S</tt>) and causes simple changes to the function
 implementation to generate many lines of diffs.  Since the assembly files
 are typically generated by scripts (see <a href="#autogen">below</a>), this
 isn't a significant problem.</p>
 
 <p>Once a new assembly file is created, it must be inserted in the build
 system.  There are two steps to this.  The file must first be added to
-<code>src/mesa/sources</code>.  That gets the file built and linked.  The second
-step is to add the correct <code>#ifdef</code> magic to
-<code>src/mesa/glapi/glapi_dispatch.c</code> to prevent the C version of the
+<tt>src/mesa/sources</tt>.  That gets the file built and linked.  The second
+step is to add the correct <tt>#ifdef</tt> magic to
+<tt>src/mesa/glapi/glapi_dispatch.c</tt> to prevent the C version of the
 dispatch functions from being built.</p>
 
 <h3 id="fixedsize">3.4. Fixed-Length Dispatch Stubs</h3>
 
-<p>To implement <code>glXGetProcAddress</code>, Mesa stores a table that
+<p>To implement <tt>glXGetProcAddress</tt>, Mesa stores a table that
 associates function names with pointers to those functions.  This table is
-stored in <code>src/mesa/glapi/glprocs.h</code>.  For different reasons on
+stored in <tt>src/mesa/glapi/glprocs.h</tt>.  For different reasons on
 different platforms, storing all of those pointers is inefficient.  On most
 platforms, including all known platforms that support TLS, we can avoid this
 added overhead.</p>
@@ -267,8 +267,8 @@ calculated by multiplying the size of the dispatch stub by the offset of the
 function in the table.  This value is then added to the address of the first
 dispatch stub.</p>
 
-<p>This path is activated by adding the correct <code>#ifdef</code> magic to
-<code>src/mesa/glapi/glapi.c</code> just before <code>glprocs.h</code> is
+<p>This path is activated by adding the correct <tt>#ifdef</tt> magic to
+<tt>src/mesa/glapi/glapi.c</tt> just before <tt>glprocs.h</tt> is
 included.</p>
 
 <h2 id="autogen">4. Automatic Generation of Dispatch Stubs</h2>

docs/download.html

@@ -2,21 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Downloading and Unpacking</title>
+  <title>Getting Mesa</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Downloading and Unpacking</h1>
-
-<h2>Downloading</h2>
+<h1>Downloading</h1>
 
 <p>
 Primary Mesa download site:
@@ -27,38 +25,54 @@ or <a href="https://mesa.freedesktop.org/archive/">mesa.freedesktop.org</a>
 
 <p>
 Starting with the first release of 2017, Mesa's version scheme is
-year-based. Filenames are in the form <code>mesa-Y.N.P.tar.gz</code>, where
-<code>Y</code> is the year (two digits), <code>N</code> is an incremental number
-(starting at 0) and <code>P</code> is the patch number (0 for the first
+year-based. Filenames are in the form <tt>mesa-Y.N.P.tar.gz</tt>, where
+<tt>Y</tt> is the year (two digits), <tt>N</tt> is an incremental number
+(starting at 0) and <tt>P</tt> is the patch number (0 for the first
 release, 1 for the first patch after that).
 </p>
 
 <p>
 When a new release is coming, release candidates (betas) may be found
 in the same directory, and are recognisable by the
-<code>mesa-Y.N.P-<b>rc</b>X.tar.gz</code> filename.
+<tt>mesa-Y.N.P-<b>rc</b>X.tar.gz</tt> filename.
 </p>
 
 
-<h2>Unpacking</h2>
+<h1>Unpacking</h1>
 
 <p>
-Mesa releases are available in two formats: <code>.tar.xz</code> and <code>.tar.gz</code>.
+Mesa releases are available in two formats: <tt>.tar.xz</tt> and <tt>.tar.gz</tt>.
 </p>
 
 <p>
 To unpack the tarball:
-</p>
 <pre>
 	tar xf mesa-Y.N.P.tar.xz
 </pre>
-<p>or</p>
+or
 <pre>
 	tar xf mesa-Y.N.P.tar.gz
 </pre>
+</p>
 
 
-<h2>Contents</h2>
+<h1>Contents</h1>
+
+<p>
+After unpacking you'll have these files and directories (among others):
+</p>
+<pre>
+autogen.sh	- Autoconf script for *nix systems
+scons/		- SCons script for Windows builds
+include/	- GL header (include) files
+bin/		- shell scripts for making shared libraries, etc
+docs/		- documentation
+src/		- source code for libraries
+src/mesa	- sources for the main Mesa library and device drivers
+src/gallium     - sources for Gallium and Gallium drivers
+src/glx		- sources for building libGL with full GLX and DRI support
+</pre>
+
 
 <p>
 Proceed to the <a href="install.html">compilation and installation
@@ -66,7 +80,7 @@ instructions</a>.
 </p>
 
 
-<h2>Demos, GLUT, and GLU</h2>
+<h1>Demos, GLUT, and GLU</h1>
 
 <p>
 A package of SGI's GLU library is available

docs/egl.html

@@ -2,19 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>EGL</title>
+  <title>Mesa EGL</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>EGL</h1>
+<h1>Mesa EGL</h1>
 
 <p>The current version of EGL in Mesa implements EGL 1.4.  More information
 about EGL can be found at
@@ -33,16 +33,13 @@ directly dispatched to the drivers.</p>
 
 <ol>
 <li>
-<p>Configure your build with the desired client APIs and enable
-the driver for your hardware.  For example:</p>
+<p>Run <code>configure</code> with the desired client APIs and enable
+the driver for your hardware.  For example</p>
 
 <pre>
-$ meson configure \
-        -D egl=true \
-        -D gles1=true \
-        -D gles2=true \
-        -D dri-drivers=... \
-        -D gallium-drivers=...
+  $ ./configure --enable-gles1 --enable-gles2 \
+                --with-dri-drivers=... \
+                --with-gallium-drivers=...
 </pre>
 
 <p>The main library and OpenGL is enabled by default.  The first two options
@@ -64,7 +61,7 @@ or more EGL drivers.</p>
 time</p>
 
 <dl>
-<dt><code>-D egl=true</code></dt>
+<dt><code>--enable-egl</code></dt>
 <dd>
 
 <p>By default, EGL is enabled.  When disabled, the main library and the drivers
@@ -72,11 +69,19 @@ will not be built.</p>
 
 </dd>
 
-<dt><code>-D platforms=...</code></dt>
+<dt><code>--with-egl-driver-dir</code></dt>
+<dd>
+
+<p>The directory EGL drivers should be installed to.  If not specified, EGL
+drivers will be installed to <code>${libdir}/egl</code>.</p>
+
+</dd>
+
+<dt><code>--with-platforms</code></dt>
 <dd>
 
 <p>List the platforms (window systems) to support.  Its argument is a comma
-separated string such as <code>-D platforms=x11,drm</code>.  It decides
+separated string such as <code>--with-platforms=x11,drm</code>.  It decides
 the platforms a driver may support.  The first listed platform is also used by
 the main library to decide the native platform.</p>
 
@@ -85,13 +90,15 @@ the main library to decide the native platform.</p>
 and <code>haiku</code>.
 The <code>android</code> platform can either be built as a system
 component, part of AOSP, using <code>Android.mk</code> files, or
-cross-compiled using appropriate options.
+cross-compiled using appropriate <code>configure</code> options.
+The <code>haiku</code> platform can only be built with SCons.
 Unless for special needs, the build system should
 select the right platforms automatically.</p>
 
 </dd>
 
-<dt><code>-D gles1=true</code> and <code>-D gles2=true</code></dt>
+<dt><code>--enable-gles1</code></dt>
+<dt><code>--enable-gles2</code></dt>
 <dd>
 
 <p>These options enable OpenGL ES support in OpenGL.  The result is one big
@@ -99,7 +106,7 @@ internal library that supports multiple APIs.</p>
 
 </dd>
 
-<dt><code>-D shared-glapi=true</code></dt>
+<dt><code>--enable-shared-glapi</code></dt>
 <dd>
 
 <p>By default, <code>libGL</code> has its own copy of <code>libglapi</code>.
@@ -127,9 +134,9 @@ runtime</p>
 <dd>
 
 <p>This variable specifies the native platform.  The valid values are the same
-as those for <code>-D platforms=...</code>.  When the variable is not set,
+as those for <code>--with-platforms</code>.  When the variable is not set,
 the main library uses the first platform listed in
-<code>-D platforms=...</code> as the native platform.</p>
+<code>--with-platforms</code> as the native platform.</p>
 
 <p>Extensions like <code>EGL_MESA_drm_display</code> define new functions to
 create displays for non-native platforms.  These extensions are usually used by

docs/envvars.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -25,206 +25,145 @@ sometimes be useful for debugging end-user issues.
 
 <h2>LibGL environment variables</h2>
 
-<dl>
-<dt><code>LIBGL_DEBUG</code></dt>
-<dd>If defined debug information will be printed to stderr.
-    If set to <code>verbose</code> additional information will be
-    printed.</dd>
-<dt><code>LIBGL_DRIVERS_PATH</code></dt>
-<dd>colon-separated list of paths to search for DRI drivers</dd>
-<dt><code>LIBGL_ALWAYS_INDIRECT</code></dt>
-<dd>if set to <code>true</code>, forces an indirect rendering
-    context/connection.</dd>
-<dt><code>LIBGL_ALWAYS_SOFTWARE</code></dt>
-<dd>if set to <code>true</code>, always use software rendering</dd>
-<dt><code>LIBGL_NO_DRAWARRAYS</code></dt>
-<dd>if set to <code>true</code>, do not use DrawArrays GLX protocol
-    (for debugging)</dd>
-<dt><code>LIBGL_SHOW_FPS</code></dt>
-<dd>print framerate to stdout based on the number of
-    <code>glXSwapBuffers</code> calls per second.</dd>
-<dt><code>LIBGL_DRI3_DISABLE</code></dt>
-<dd>disable DRI3 if set to <code>true</code>.</dd>
-</dl>
+<ul>
+<li>LIBGL_DEBUG - If defined debug information will be printed to stderr.
+   If set to 'verbose' additional information will be printed.
+<li>LIBGL_DRIVERS_PATH - colon-separated list of paths to search for DRI drivers
+<li>LIBGL_ALWAYS_INDIRECT - if set to `true`, forces an indirect rendering context/connection.
+<li>LIBGL_ALWAYS_SOFTWARE - if set to `true`, always use software rendering
+<li>LIBGL_NO_DRAWARRAYS - if set to `true`, do not use DrawArrays GLX protocol (for debugging)
+<li>LIBGL_SHOW_FPS - print framerate to stdout based on the number of glXSwapBuffers
+    calls per second.
+<li>LIBGL_DRI3_DISABLE - disable DRI3 if set to `true`.
+</ul>
+
+
 
 <h2>Core Mesa environment variables</h2>
 
-<dl>
-<dt><code>MESA_NO_ASM</code></dt>
-<dd>if set, disables all assembly language optimizations</dd>
-<dt><code>MESA_NO_MMX</code></dt>
-<dd>if set, disables Intel MMX optimizations</dd>
-<dt><code>MESA_NO_3DNOW</code></dt>
-<dd>if set, disables AMD 3DNow! optimizations</dd>
-<dt><code>MESA_NO_SSE</code></dt>
-<dd>if set, disables Intel SSE optimizations</dd>
-<dt><code>MESA_NO_ERROR</code></dt>
-<dd>if set to 1, error checking is disabled as per <code>KHR_no_error</code>.
-    This will result in undefined behaviour for invalid use of the api, but
-    can reduce CPU use for apps that are known to be error free.</dd>
-<dt><code>MESA_DEBUG</code></dt>
-<dd>if set, error messages are printed to stderr.  For example,
-    if the application generates a <code>GL_INVALID_ENUM</code> error, a
-    corresponding error message indicating where the error occurred, and
-    possibly why, will be printed to stderr. For release builds,
-    <code>MESA_DEBUG</code> defaults to off (no debug output).
-    <code>MESA_DEBUG</code> accepts the following comma-separated list of
-    named flags, which adds extra behaviour to just set
-    <code>MESA_DEBUG=1</code>:
-    <dl>
-      <dt><code>silent</code></dt>
-      <dd>turn off debug messages. Only useful for debug builds.</dd>
-      <dt><code>flush</code></dt>
-      <dd>flush after each drawing command</dd>
-      <dt><code>incomplete_tex</code></dt>
-      <dd>extra debug messages when a texture is incomplete</dd>
-      <dt><code>incomplete_fbo</code></dt>
-      <dd>extra debug messages when a fbo is incomplete</dd>
-      <dt><code>context</code></dt>
-      <dd>create a debug context (see <code>GLX_CONTEXT_DEBUG_BIT_ARB</code>)
-          and print error and performance messages to stderr (or
-          <code>MESA_LOG_FILE</code>).</dd>
-    </dl>
-</dd>
-<dt><code>MESA_LOG_FILE</code></dt>
-<dd>specifies a file name for logging all errors, warnings,
-    etc., rather than stderr</dd>
-<dt><code>MESA_TEX_PROG</code></dt>
-<dd>if set, implement conventional texture env modes with
-    fragment programs (intended for developers only)</dd>
-<dt><code>MESA_TNL_PROG</code></dt>
-<dd>if set, implement conventional vertex transformation operations with
-    vertex programs (intended for developers only). Setting this variable
-    automatically sets the <code>MESA_TEX_PROG</code> variable as well.</dd>
-<dt><code>MESA_EXTENSION_OVERRIDE</code></dt>
-<dd>can be used to enable/disable extensions. A value such as
-    <code>GL_EXT_foo -GL_EXT_bar</code> will enable the
-    <code>GL_EXT_foo</code> extension and disable the
-    <code>GL_EXT_bar</code> extension.</dd>
-<dt><code>MESA_EXTENSION_MAX_YEAR</code></dt>
-<dd>The <code>GL_EXTENSIONS</code> string returned by Mesa is sorted by
-    extension year. If this variable is set to year X, only extensions
-    defined on or before year X will be reported. This is to work-around a
-    bug in some games where the extension string is copied into a fixed-size
-    buffer without truncating. If the extension string is too long, the
-    buffer overrun can cause the game to crash. This is a work-around for
-    that.</dd>
-<dt><code>MESA_GL_VERSION_OVERRIDE</code></dt>
-<dd>changes the value returned by
-<code>glGetString(GL_VERSION)</code> and possibly the GL API type.
 <ul>
-  <li>The format should be <code>MAJOR.MINOR[FC|COMPAT]</code>
-  <li><code>FC</code> is an optional suffix that indicates a forward
-      compatible context. This is only valid for versions &gt;= 3.0.
-  <li><code>COMPAT</code> is an optional suffix that indicates a
-      compatibility context or <code>GL_ARB_compatibility</code> support.
-      This is only valid for versions &gt;= 3.1.
+<li>MESA_NO_ASM - if set, disables all assembly language optimizations
+<li>MESA_NO_MMX - if set, disables Intel MMX optimizations
+<li>MESA_NO_3DNOW - if set, disables AMD 3DNow! optimizations
+<li>MESA_NO_SSE - if set, disables Intel SSE optimizations
+<li>MESA_NO_ERROR - if set to 1, error checking is disabled as per KHR_no_error.
+   This will result in undefined behaviour for invalid use of the api, but
+   can reduce CPU use for apps that are known to be error free.</li>
+<li>MESA_DEBUG - if set, error messages are printed to stderr.  For example,
+   if the application generates a GL_INVALID_ENUM error, a corresponding error
+   message indicating where the error occurred, and possibly why, will be
+   printed to stderr.<br>
+
+   For release builds, MESA_DEBUG defaults to off (no debug output).
+
+   MESA_DEBUG accepts the following comma-separated list of named
+   flags, which adds extra behaviour to just set MESA_DEBUG=1:
+   <ul>
+     <li>silent - turn off debug messages. Only useful for debug builds.</li>
+     <li>flush - flush after each drawing command</li>
+     <li>incomplete_tex - extra debug messages when a texture is incomplete</li>
+     <li>incomplete_fbo - extra debug messages when a fbo is incomplete</li>
+     <li>context - create a debug context (see GLX_CONTEXT_DEBUG_BIT_ARB) and
+         print error and performance messages to stderr (or MESA_LOG_FILE).</li>
+   </ul>
+<li>MESA_LOG_FILE - specifies a file name for logging all errors, warnings,
+etc., rather than stderr
+<li>MESA_TEX_PROG - if set, implement conventional texture env modes with
+fragment programs (intended for developers only)
+<li>MESA_TNL_PROG - if set, implement conventional vertex transformation
+operations with vertex programs (intended for developers only).
+Setting this variable automatically sets the MESA_TEX_PROG variable as well.
+<li>MESA_EXTENSION_OVERRIDE - can be used to enable/disable extensions.
+A value such as "GL_EXT_foo -GL_EXT_bar" will enable the GL_EXT_foo extension
+and disable the GL_EXT_bar extension.
+<li>MESA_EXTENSION_MAX_YEAR - The GL_EXTENSIONS string returned by Mesa is sorted
+by extension year.
+If this variable is set to year X, only extensions defined on or before year
+X will be reported.
+This is to work-around a bug in some games where the extension string is
+copied into a fixed-size buffer without truncating.
+If the extension string is too long, the buffer overrun can cause the game
+to crash.
+This is a work-around for that.
+<li>MESA_GL_VERSION_OVERRIDE - changes the value returned by
+glGetString(GL_VERSION) and possibly the GL API type.
+<ul>
+  <li>The format should be MAJOR.MINOR[FC|COMPAT]
+  <li>FC is an optional suffix that indicates a forward compatible
+      context. This is only valid for versions &gt;= 3.0.
+  <li>COMPAT is an optional suffix that indicates a compatibility
+      context or GL_ARB_compatibility support. This is only valid for
+      versions &gt;= 3.1.
   <li>GL versions &lt;= 3.0 are set to a compatibility (non-Core)
       profile
   <li>GL versions = 3.1, depending on the driver, it may or may not
-      have the <code>ARB_compatibility</code> extension enabled.
+      have the ARB_compatibility extension enabled.
   <li>GL versions &gt;= 3.2 are set to a Core profile
-  <li>Examples:
-  <dl>
-    <dt><code>2.1</code></dt>
-    <dd>select a compatibility (non-Core) profile with GL version 2.1.</dd>
-    <dt><code>3.0</code></dt>
-    <dd>select a compatibility (non-Core) profile with GL version 3.0.</dd>
-    <dt><code>3.0FC</code></dt>
-    <dd>select a Core+Forward Compatible profile with GL version 3.0.</dd>
-    <dt><code>3.1</code></dt>
-    <dd>select GL version 3.1 with <code>GL_ARB_compatibility</code>
-        enabled per the driver default.</dd>
-    <dt><code>3.1FC</code></dt>
-    <dd>select GL version 3.1 with forward compatibility and
-        <code>GL_ARB_compatibility</code> disabled.</dd>
-    <dt><code>3.1COMPAT</code></dt>
-    <dd>select GL version 3.1 with <code>GL_ARB_compatibility</code>
-        enabled.</dd>
-    <dt><code>X.Y</code></dt>
-    <dd>override GL version to X.Y without changing the profile.</dd>
-    <dt><code>X.YFC</code></dt>
-    <dd>select a Core+Forward Compatible profile with GL version X.Y.</dd>
-    <dt><code>X.YCOMPAT</code></dt>
-    <dd>select a Compatibility profile with GL version X.Y.</dd>
-  </dl>
+  <li>Examples: 2.1, 3.0, 3.0FC, 3.1, 3.1FC, 3.1COMPAT, X.Y, X.YFC,
+      X.YCOMPAT.
+  <ul>
+    <li>2.1 - select a compatibility (non-Core) profile with GL
+        version 2.1.
+    <li>3.0 - select a compatibility (non-Core) profile with GL
+        version 3.0.
+    <li>3.0FC - select a Core+Forward Compatible profile with GL
+        version 3.0.
+    <li>3.1 - select GL version 3.1 with GL_ARB_compatibility enabled
+        per the driver default.
+    <li>3.1FC - select GL version 3.1 with forward compatibility and
+        GL_ARB_compatibility disabled.
+    <li>3.1COMPAT - select GL version 3.1 with GL_ARB_compatibility
+        enabled.
+    <li>X.Y - override GL version to X.Y without changing the profile.
+    <li>X.YFC - select a Core+Forward Compatible profile with GL
+        version X.Y.
+    <li>X.YCOMPAT - select a Compatibility profile with GL version
+        X.Y.
+  </ul>
   <li>Mesa may not really implement all the features of the given
       version. (for developers only)
 </ul>
-</dd>
-<dt><code>MESA_GLES_VERSION_OVERRIDE</code></dt>
-<dd>changes the value returned by <code>glGetString(GL_VERSION)</code>
-    for OpenGL ES.
+<li>MESA_GLES_VERSION_OVERRIDE - changes the value returned by
+glGetString(GL_VERSION) for OpenGL ES.
 <ul>
-<li> The format should be <code>MAJOR.MINOR</code>
-<li> Examples: <code>2.0</code>, <code>3.0</code>, <code>3.1</code>
+<li> The format should be MAJOR.MINOR
+<li> Examples: 2.0, 3.0, 3.1
 <li> Mesa may not really implement all the features of the given version.
 (for developers only)
 </ul>
-</dd>
-<dt><code>MESA_GLSL_VERSION_OVERRIDE</code></dt>
-<dd>changes the value returned by
-    <code>glGetString(GL_SHADING_LANGUAGE_VERSION)</code>.
-    Valid values are integers, such as <code>130</code>.  Mesa will not
-    really implement all the features of the given language version if
-    it's higher than what's normally reported. (for developers only)
-</dd>
-<dt><code>MESA_GLSL_CACHE_DISABLE</code></dt>
-<dd>if set to <code>true</code>, disables the GLSL shader cache</dd>
-<dt><code>MESA_GLSL_CACHE_MAX_SIZE</code></dt>
-<dd>if set, determines the maximum size of the on-disk cache of compiled GLSL
-    programs. Should be set to a number optionally followed by <code>K</code>,
-    <code>M</code>, or <code>G</code> to specify a size in kilobytes,
-    megabytes, or gigabytes. By default, gigabytes will be assumed. And if
-    unset, a maximum size of 1GB will be used. Note: A separate cache might
-    be created for each architecture that Mesa is installed for on your
-    system. For example under the default settings you may end up with a 1GB
-    cache for x86_64 and another 1GB cache for i386.</dd>
-<dt><code>MESA_GLSL_CACHE_DIR</code></dt>
-<dd>if set, determines the directory to be used for the on-disk cache of
-    compiled GLSL programs. If this variable is not set, then the cache will
-    be stored in <code>$XDG_CACHE_HOME/mesa_shader_cache</code> (if that
-    variable is set), or else within <code>.cache/mesa_shader_cache</code>
-    within the user's home directory.
-</dd>
-<dt><code>MESA_GLSL</code></dt>
-<dd><a href="shading.html#envvars">shading language compiler options</a></dd>
-<dt><code>MESA_NO_MINMAX_CACHE</code></dt>
-<dd>when set, the minmax index cache is globally disabled.</dd>
-<dt><code>MESA_SHADER_CAPTURE_PATH</code></dt>
-<dd>see <a href="shading.html#capture">Capturing Shaders</a></dd>
-<dt><code>MESA_SHADER_DUMP_PATH</code> and <code>MESA_SHADER_READ_PATH</code></dt>
-<dd>see <a href="shading.html#replacement">Experimenting with Shader Replacements</a></dd>
-<dt><code>MESA_VK_VERSION_OVERRIDE</code></dt>
-<dd>changes the Vulkan physical device version
-    as returned in <code>VkPhysicalDeviceProperties::apiVersion</code>.
+<li>MESA_GLSL_VERSION_OVERRIDE - changes the value returned by
+glGetString(GL_SHADING_LANGUAGE_VERSION). Valid values are integers, such as
+"130".  Mesa will not really implement all the features of the given language version
+if it's higher than what's normally reported. (for developers only)
+<li>MESA_GLSL_CACHE_DISABLE - if set to `true`, disables the GLSL shader cache
+<li>MESA_GLSL_CACHE_MAX_SIZE - if set, determines the maximum size of
+the on-disk cache of compiled GLSL programs. Should be set to a number
+optionally followed by 'K', 'M', or 'G' to specify a size in
+kilobytes, megabytes, or gigabytes. By default, gigabytes will be
+assumed. And if unset, a maximum size of 1GB will be used. Note: A separate
+cache might be created for each architecture that Mesa is installed for on
+your system. For example under the default settings you may end up with a 1GB
+cache for x86_64 and another 1GB cache for i386.
+<li>MESA_GLSL_CACHE_DIR - if set, determines the directory to be used
+for the on-disk cache of compiled GLSL programs. If this variable is
+not set, then the cache will be stored in $XDG_CACHE_HOME/mesa_shader_cache (if
+that variable is set), or else within .cache/mesa_shader_cache within the user's
+home directory.
+<li>MESA_GLSL - <a href="shading.html#envvars">shading language compiler options</a>
+<li>MESA_NO_MINMAX_CACHE - when set, the minmax index cache is globally disabled.
+<li>MESA_SHADER_CAPTURE_PATH - see <a href="shading.html#capture">Capturing Shaders</a></li>
+<li>MESA_SHADER_DUMP_PATH and MESA_SHADER_READ_PATH - see <a href="shading.html#replacement">Experimenting with Shader Replacements</a></li>
+<li>MESA_VK_VERSION_OVERRIDE - changes the Vulkan physical device version
+    as returned in VkPhysicalDeviceProperties::apiVersion.
   <ul>
-    <li>The format should be <code>MAJOR.MINOR[.PATCH]</code></li>
+    <li>The format should be MAJOR.MINOR[.PATCH]</li>
     <li>This will not let you force a version higher than the driver's
-        instance version as advertised by
-        <code>vkEnumerateInstanceVersion</code></li>
+        instance versionas advertised by vkEnumerateInstanceVersion</li>
     <li>This can be very useful for debugging but some features may not be
         implemented correctly. (For developers only)</li>
   </ul>
-</dd>
-</dl>
-
-
-<h2>NIR passes enviroment variables</h2>
-<p>
-The following are only applicable for drivers that uses NIR, as they
-modify the behaviour for the common NIR_PASS and NIR_PASS_V macros,
-that wrap calls to NIR lowering/optimizations.
-</p>
-
-<dl>
-  <dt><code>NIR_PRINT</code></dt>
-  <dd>If defined, the resulting NIR shader will be printed out at each succesful NIR lowering/optimization call.</dd>
-  <dt><code>NIR_TEST_CLONE</code></dt>
-  <dd>If defined, cloning a NIR shader would be tested at each succesful NIR lowering/optimization call.</dd>
-  <dt><code>NIR_TEST_SERIALIZE</code></dt>
-  <dd>If defined, serialize and deserialize a NIR shader would be tested at each succesful NIR lowering/optimization call.</dd>
-</dl>
+</li>
+</ul>
 
 
 <h2>Mesa Xlib driver environment variables</h2>
@@ -233,137 +172,80 @@ that wrap calls to NIR lowering/optimizations.
 The following are only applicable to the Mesa Xlib software driver.
 See the <a href="xlibdriver.html">Xlib software driver page</a> for details.
 </p>
-<dl>
-<dt><code>MESA_RGB_VISUAL</code></dt>
-<dd>specifies the X visual and depth for RGB mode</dd>
-<dt><code>MESA_CI_VISUAL</code></dt>
-<dd>specifies the X visual and depth for CI mode</dd>
-<dt><code>MESA_BACK_BUFFER</code></dt>
-<dd>specifies how to implement the back color buffer, either
-    <code>pixmap</code> or <code>ximage</code></dd>
-<dt><code>MESA_GAMMA</code></dt>
-<dd>gamma correction coefficients for red, green, blue channels</dd>
-<dt><code>MESA_XSYNC</code></dt>
-<dd>enable synchronous X behavior (for debugging only)</dd>
-<dt><code>MESA_GLX_FORCE_CI</code></dt>
-<dd>if set, force GLX to treat 8bpp visuals as CI visuals</dd>
-<dt><code>MESA_GLX_FORCE_ALPHA</code></dt>
-<dd>if set, forces RGB windows to have an alpha channel.</dd>
-<dt><code>MESA_GLX_DEPTH_BITS</code></dt>
-<dd>specifies default number of bits for depth buffer.</dd>
-<dt><code>MESA_GLX_ALPHA_BITS</code></dt>
-<dd>specifies default number of bits for alpha channel.</dd>
-</dl>
+<ul>
+<li>MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode
+<li>MESA_CI_VISUAL - specifies the X visual and depth for CI mode
+<li>MESA_BACK_BUFFER - specifies how to implement the back color buffer,
+    either "pixmap" or "ximage"
+<li>MESA_GAMMA - gamma correction coefficients for red, green, blue channels
+<li>MESA_XSYNC - enable synchronous X behavior (for debugging only)
+<li>MESA_GLX_FORCE_CI - if set, force GLX to treat 8bpp visuals as CI visuals
+<li>MESA_GLX_FORCE_ALPHA - if set, forces RGB windows to have an alpha channel.
+<li>MESA_GLX_DEPTH_BITS - specifies default number of bits for depth buffer.
+<li>MESA_GLX_ALPHA_BITS - specifies default number of bits for alpha channel.
+</ul>
 
 
 <h2>i945/i965 driver environment variables (non-Gallium)</h2>
 
-<dl>
-<dt><code>INTEL_NO_HW</code></dt>
-<dd>if set to 1, prevents batches from being submitted to the hardware.
-    This is useful for debugging hangs, etc.</dd>
-<dt><code>INTEL_DEBUG</code></dt>
-<dd>a comma-separated list of named flags, which do various things:
-<dl>
-   <dt><code>ann</code></dt>
-   <dd>annotate IR in assembly dumps</dd>
-   <dt><code>aub</code></dt>
-   <dd>dump batches into an AUB trace for use with simulation tools</dd>
-   <dt><code>bat</code></dt>
-   <dd>emit batch information</dd>
-   <dt><code>blit</code></dt>
-   <dd>emit messages about blit operations</dd>
-   <dt><code>blorp</code></dt>
-   <dd>emit messages about the blorp operations (blits &amp; clears)</dd>
-   <dt><code>buf</code></dt>
-   <dd>emit messages about buffer objects</dd>
-   <dt><code>clip</code></dt>
-   <dd>emit messages about the clip unit (for old gens, includes the CLIP program)</dd>
-   <dt><code>color</code></dt>
-   <dd>use color in output</dd>
-   <dt><code>cs</code></dt>
-   <dd>dump shader assembly for compute shaders</dd>
-   <dt><code>do32</code></dt>
-   <dd>generate compute shader SIMD32 programs even if workgroup size doesn't exceed the SIMD16 limit</dd>
-   <dt><code>dri</code></dt>
-   <dd>emit messages about the DRI interface</dd>
-   <dt><code>fbo</code></dt>
-   <dd>emit messages about framebuffers</dd>
-   <dt><code>fs</code></dt>
-   <dd>dump shader assembly for fragment shaders</dd>
-   <dt><code>gs</code></dt>
-   <dd>dump shader assembly for geometry shaders</dd>
-   <dt><code>hex</code></dt>
-   <dd>print instruction hex dump with the disassembly</dd>
-   <dt><code>l3</code></dt>
-   <dd>emit messages about the new L3 state during transitions</dd>
-   <dt><code>miptree</code></dt>
-   <dd>emit messages about miptrees</dd>
-   <dt><code>no8</code></dt>
-   <dd>don't generate SIMD8 fragment shader</dd>
-   <dt><code>no16</code></dt>
-   <dd>suppress generation of 16-wide fragment shaders. useful for debugging broken shaders</dd>
-   <dt><code>nocompact</code></dt>
-   <dd>disable instruction compaction</dd>
-   <dt><code>nodualobj</code></dt>
-   <dd>suppress generation of dual-object geometry shader code</dd>
-   <dt><code>norbc</code></dt>
-   <dd>disable single sampled render buffer compression</dd>
-   <dt><code>optimizer</code></dt>
-   <dd>dump shader assembly to files at each optimization pass and iteration that make progress</dd>
-   <dt><code>perf</code></dt>
-   <dd>emit messages about performance issues</dd>
-   <dt><code>perfmon</code></dt>
-   <dd>emit messages about <code>AMD_performance_monitor</code></dd>
-   <dt><code>pix</code></dt>
-   <dd>emit messages about pixel operations</dd>
-   <dt><code>prim</code></dt>
-   <dd>emit messages about drawing primitives</dd>
-   <dt><code>reemit</code></dt>
-   <dd>mark all state dirty on each draw call</dd>
-   <dt><code>sf</code></dt>
-   <dd>emit messages about the strips &amp; fans unit (for old gens, includes the SF program)</dd>
-   <dt><code>shader_time</code></dt>
-   <dd>record how much GPU time is spent in each shader</dd>
-   <dt><code>spill_fs</code></dt>
-   <dd>force spilling of all registers in the scalar backend (useful to debug spilling code)</dd>
-   <dt><code>spill_vec4</code></dt>
-   <dd>force spilling of all registers in the vec4 backend (useful to debug spilling code)</dd>
-   <dt><code>state</code></dt>
-   <dd>emit messages about state flag tracking</dd>
-   <dt><code>submit</code></dt>
-   <dd>emit batchbuffer usage statistics</dd>
-   <dt><code>sync</code></dt>
-   <dd>after sending each batch, emit a message and wait for that batch to finish rendering</dd>
-   <dt><code>tcs</code></dt>
-   <dd>dump shader assembly for tessellation control shaders</dd>
-   <dt><code>tes</code></dt>
-   <dd>dump shader assembly for tessellation evaluation shaders</dd>
-   <dt><code>tex</code></dt>
-   <dd>emit messages about textures.</dd>
-   <dt><code>urb</code></dt>
-   <dd>emit messages about URB setup</dd>
-   <dt><code>vert</code></dt>
-   <dd>emit messages about vertex assembly</dd>
-   <dt><code>vs</code></dt>
-   <dd>dump shader assembly for vertex shaders</dd>
-</dl>
-</dd>
-<dt><code>INTEL_SCALAR_VS</code> (or <code>TCS</code>, <code>TES</code>,
-    <code>GS</code>)</dt>
-<dd>force scalar/vec4 mode for a shader stage (Gen8-9 only)</dd>
-<dt><code>INTEL_PRECISE_TRIG</code></dt>
-<dd>if set to 1, true or yes, then the driver prefers accuracy over
-    performance in trig functions.</dd>
-</dl>
+<ul>
+<li>INTEL_NO_HW - if set to 1, prevents batches from being submitted to the hardware.
+   This is useful for debugging hangs, etc.</li>
+<li>INTEL_DEBUG - a comma-separated list of named flags, which do various things:
+<ul>
+   <li>ann - annotate IR in assembly dumps</li>
+   <li>aub - dump batches into an AUB trace for use with simulation tools</li>
+   <li>bat - emit batch information</li>
+   <li>blit - emit messages about blit operations</li>
+   <li>blorp - emit messages about the blorp operations (blits &amp; clears)</li>
+   <li>buf - emit messages about buffer objects</li>
+   <li>clip - emit messages about the clip unit (for old gens, includes the CLIP program)</li>
+   <li>color - use color in output</li>
+   <li>cs - dump shader assembly for compute shaders</li>
+   <li>do32 - generate compute shader SIMD32 programs even if workgroup size doesn't exceed the SIMD16 limit</li>
+   <li>dri - emit messages about the DRI interface</li>
+   <li>fbo - emit messages about framebuffers</li>
+   <li>fs - dump shader assembly for fragment shaders</li>
+   <li>gs - dump shader assembly for geometry shaders</li>
+   <li>hex - print instruction hex dump with the disassembly</li>
+   <li>l3 - emit messages about the new L3 state during transitions</li>
+   <li>miptree - emit messages about miptrees</li>
+   <li>no8 - don't generate SIMD8 fragment shader</li>
+   <li>no16 - suppress generation of 16-wide fragment shaders. useful for debugging broken shaders</li>
+   <li>nocompact - disable instruction compaction</li>
+   <li>nodualobj - suppress generation of dual-object geometry shader code</li>
+   <li>norbc - disable single sampled render buffer compression</li>
+   <li>optimizer - dump shader assembly to files at each optimization pass and iteration that make progress</li>
+   <li>perf - emit messages about performance issues</li>
+   <li>perfmon - emit messages about AMD_performance_monitor</li>
+   <li>pix - emit messages about pixel operations</li>
+   <li>prim - emit messages about drawing primitives</li>
+   <li>reemit - mark all state dirty on each draw call</li>
+   <li>sf - emit messages about the strips &amp; fans unit (for old gens, includes the SF program)</li>
+   <li>shader_time - record how much GPU time is spent in each shader</li>
+   <li>spill_fs - force spilling of all registers in the scalar backend (useful to debug spilling code)</li>
+   <li>spill_vec4 - force spilling of all registers in the vec4 backend (useful to debug spilling code)</li>
+   <li>state - emit messages about state flag tracking</li>
+   <li>submit - emit batchbuffer usage statistics</li>
+   <li>sync - after sending each batch, emit a message and wait for that batch to finish rendering</li>
+   <li>tcs - dump shader assembly for tessellation control shaders</li>
+   <li>tes - dump shader assembly for tessellation evaluation shaders</li>
+   <li>tex - emit messages about textures.</li>
+   <li>urb - emit messages about URB setup</li>
+   <li>vert - emit messages about vertex assembly</li>
+   <li>vs - dump shader assembly for vertex shaders</li>
+</ul>
+<li>INTEL_SCALAR_VS (or TCS, TES, GS) - force scalar/vec4 mode for a shader stage (Gen8-9 only)</li>
+<li>INTEL_PRECISE_TRIG - if set to 1, true or yes, then the driver prefers
+   accuracy over performance in trig functions.</li>
+</ul>
 
 
 <h2>Radeon driver environment variables (radeon, r200, and r300g)</h2>
 
-<dl>
-<dt><code>RADEON_NO_TCL</code></dt>
-<dd>if set, disable hardware-accelerated Transform/Clip/Lighting.</dd>
-</dl>
+<ul>
+<li>RADEON_NO_TCL - if set, disable hardware-accelerated Transform/Clip/Lighting.
+</ul>
 
 
 <h2>EGL environment variables</h2>
@@ -376,170 +258,119 @@ Mesa EGL supports different sets of environment variables.  See the
 
 <h2>Gallium environment variables</h2>
 
-<dl>
-<dt><code>GALLIUM_HUD</code></dt>
-<dd>draws various information on the screen, like framerate,
+<ul>
+<li>GALLIUM_HUD - draws various information on the screen, like framerate,
     cpu load, driver statistics, performance counters, etc.
-    Set <code>GALLIUM_HUD=help</code> and run e.g.
-    <code>glxgears</code> for more info.</dd>
-<dt><code>GALLIUM_HUD_PERIOD</code></dt>
-<dd>sets the hud update rate in seconds (float). Use zero
-    to update every frame. The default period is 1/2 second.</dd>
-<dt><code>GALLIUM_HUD_VISIBLE</code></dt>
-<dd>control default visibility, defaults to true.</dd>
-<dt><code>GALLIUM_HUD_TOGGLE_SIGNAL</code></dt>
-<dd>toggle visibility via user specified signal.
+    Set GALLIUM_HUD=help and run e.g. glxgears for more info.
+<li>GALLIUM_HUD_PERIOD - sets the hud update rate in seconds (float). Use zero
+    to update every frame. The default period is 1/2 second.
+<li>GALLIUM_HUD_VISIBLE - control default visibility, defaults to true.
+<li>GALLIUM_HUD_TOGGLE_SIGNAL - toggle visibility via user specified signal.
     Especially useful to toggle hud at specific points of application and
     disable for unencumbered viewing the rest of the time. For example, set
-    <code>GALLIUM_HUD_VISIBLE</code> to <code>false</code> and
-    <code>GALLIUM_HUD_TOGGLE_SIGNAL</code> to <code>10</code>
-    (<code>SIGUSR1</code>).
-    Use <code>kill -10 &lt;pid&gt;</code> to toggle the hud as desired.</dd>
-<dt><code>GALLIUM_HUD_DUMP_DIR</code></dt>
-<dd>specifies a directory for writing the displayed hud values into files.</dd>
-<dt><code>GALLIUM_DRIVER</code></dt>
-<dd>useful in combination with <code>LIBGL_ALWAYS_SOFTWARE=true</code> for
-    choosing one of the software renderers <code>softpipe</code>,
-    <code>llvmpipe</code> or <code>swr</code>.</dd>
-<dt><code>GALLIUM_LOG_FILE</code></dt>
-<dd>specifies a file for logging all errors, warnings, etc.
-    rather than stderr.</dd>
-<dt><code>GALLIUM_PRINT_OPTIONS</code></dt>
-<dd>if non-zero, print all the Gallium environment variables which are
-    used, and their current values.</dd>
-<dt><code>GALLIUM_DUMP_CPU</code></dt>
-<dd>if non-zero, print information about the CPU on start-up</dd>
-<dt><code>TGSI_PRINT_SANITY</code></dt>
-<dd>if set, do extra sanity checking on TGSI shaders and
-    print any errors to stderr.</dd>
-<dt><code>DRAW_FSE</code></dt>
-<dd>???</dd>
-<dt><code>DRAW_NO_FSE</code></dt>
-<dd>???</dd>
-<dt><code>DRAW_USE_LLVM</code></dt>
-<dd>if set to zero, the draw module will not use LLVM to execute
-    shaders, vertex fetch, etc.</dd>
-<dt><code>ST_DEBUG</code></dt>
-<dd>controls debug output from the Mesa/Gallium state tracker.
-    Setting to <code>tgsi</code>, for example, will print all the TGSI
-    shaders. See <code>src/mesa/state_tracker/st_debug.c</code> for other
-    options.</dd>
-</dl>
+    GALLIUM_HUD_VISIBLE to false and GALLIUM_HUD_TOGGLE_SIGNAL to 10 (SIGUSR1).
+    Use kill -10 &lt;pid&gt; to toggle the hud as desired.
+<li>GALLIUM_HUD_DUMP_DIR - specifies a directory for writing the displayed
+    hud values into files.
+<li>GALLIUM_DRIVER - useful in combination with LIBGL_ALWAYS_SOFTWARE=true for
+    choosing one of the software renderers "softpipe", "llvmpipe" or "swr".
+<li>GALLIUM_LOG_FILE - specifies a file for logging all errors, warnings, etc.
+    rather than stderr.
+<li>GALLIUM_PRINT_OPTIONS - if non-zero, print all the Gallium environment
+    variables which are used, and their current values.
+<li>GALLIUM_DUMP_CPU - if non-zero, print information about the CPU on start-up
+<li>TGSI_PRINT_SANITY - if set, do extra sanity checking on TGSI shaders and
+    print any errors to stderr.
+<LI>DRAW_FSE - ???
+<LI>DRAW_NO_FSE - ???
+<li>DRAW_USE_LLVM - if set to zero, the draw module will not use LLVM to execute
+    shaders, vertex fetch, etc.
+<li>ST_DEBUG - controls debug output from the Mesa/Gallium state tracker.
+Setting to "tgsi", for example, will print all the TGSI shaders.
+See src/mesa/state_tracker/st_debug.c for other options.
+</ul>
 
 <h3>Clover state tracker environment variables</h3>
 
-<dl>
-<dt><code>CLOVER_EXTRA_BUILD_OPTIONS</code></dt>
-<dd>allows specifying additional compiler and linker
+<ul>
+<li>CLOVER_EXTRA_BUILD_OPTIONS - allows specifying additional compiler and linker
     options. Specified options are appended after the options set by the OpenCL
-    program in <code>clBuildProgram</code>.</dd>
-<dt><code>CLOVER_EXTRA_COMPILE_OPTIONS</code></dt>
-<dd>allows specifying additional compiler
+    program in clBuildProgram.
+<li>CLOVER_EXTRA_COMPILE_OPTIONS - allows specifying additional compiler
     options. Specified options are appended after the options set by the OpenCL
-    program in <code>clCompileProgram</code>.</dd>
-<dt><code>CLOVER_EXTRA_LINK_OPTIONS</code></dt>
-<dd>allows specifying additional linker
+    program in clCompileProgram.
+<li>CLOVER_EXTRA_LINK_OPTIONS - allows specifying additional linker
     options. Specified options are appended after the options set by the OpenCL
-    program in <code>clLinkProgram</code>.</dd>
-</dl>
+    program in clLinkProgram.
+</ul>
 
 
 <h3>Softpipe driver environment variables</h3>
-<dl>
-<dt><code>SOFTPIPE_DUMP_FS</code></dt>
-<dd>if set, the softpipe driver will print fragment shaders to stderr</dd>
-<dt><code>SOFTPIPE_DUMP_GS</code></dt>
-<dd>if set, the softpipe driver will print geometry shaders to stderr</dd>
-<dt><code>SOFTPIPE_NO_RAST</code></dt>
-<dd>if set, rasterization is no-op'd.  For profiling purposes.</dd>
-<dt><code>SOFTPIPE_USE_LLVM</code></dt>
-<dd>if set, the softpipe driver will try to use LLVM JIT for
-    vertex shading processing.</dd>
-</dl>
+<ul>
+<li>SOFTPIPE_DUMP_FS - if set, the softpipe driver will print fragment shaders
+    to stderr
+<li>SOFTPIPE_DUMP_GS - if set, the softpipe driver will print geometry shaders
+    to stderr
+<li>SOFTPIPE_NO_RAST - if set, rasterization is no-op'd.  For profiling purposes.
+<li>SOFTPIPE_USE_LLVM - if set, the softpipe driver will try to use LLVM JIT for
+    vertex shading processing.
+</ul>
 
 
 <h3>LLVMpipe driver environment variables</h3>
-<dl>
-<dt><code>LP_NO_RAST</code></dt>
-<dd>if set LLVMpipe will no-op rasterization</dd>
-<dt><code>LP_DEBUG</code></dt>
-<dd>a comma-separated list of debug options is accepted.  See the
-    source code for details.</dd>
-<dt><code>LP_PERF</code></dt>
-<dd>a comma-separated list of options to selectively no-op various
-    parts of the driver.  See the source code for details.</dd>
-<dt><code>LP_NUM_THREADS</code></dt>
-<dd>an integer indicating how many threads to use for rendering.
+<ul>
+<li>LP_NO_RAST - if set LLVMpipe will no-op rasterization
+<li>LP_DEBUG - a comma-separated list of debug options is accepted.  See the
+    source code for details.
+<li>LP_PERF - a comma-separated list of options to selectively no-op various
+    parts of the driver.  See the source code for details.
+<li>LP_NUM_THREADS - an integer indicating how many threads to use for rendering.
     Zero turns off threading completely.  The default value is the number of CPU
-    cores present.</dd>
-</dl>
+    cores present.
+</ul>
 
 <h3>VMware SVGA driver environment variables</h3>
-<dl>
-<dt><code>SVGA_FORCE_SWTNL</code></dt>
-<dd>force use of software vertex transformation</dd>
-<dt><code>SVGA_NO_SWTNL</code></dt>
-<dd>don't allow software vertex transformation fallbacks (will often result
-    in incorrect rendering).</dd>
-<dt><code>SVGA_DEBUG</code></dt>
-<dd>for dumping shaders, constant buffers, etc.  See the code for
-    details.</dd>
-<dt><code>SVGA_EXTRA_LOGGING</code></dt>
-<dd>if set, enables extra logging to the <code>vmware.log</code> file,
-    such as the OpenGL program's name and command line arguments.</dd>
-<dt><code>SVGA_NO_LOGGING</code></dt>
-<dd>if set, disables logging to the <code>vmware.log</code> file. This is
-    useful when using Valgrind because it otherwise crashes when
-    initializing the host log feature.</dd>
-</dl>
-<p>See the driver code for other, lesser-used variables.</p>
+<ul>
+<li>SVGA_FORCE_SWTNL - force use of software vertex transformation
+<li>SVGA_NO_SWTNL - don't allow software vertex transformation fallbacks
+(will often result in incorrect rendering).
+<li>SVGA_DEBUG - for dumping shaders, constant buffers, etc.  See the code
+for details.
+<li>SVGA_EXTRA_LOGGING - if set, enables extra logging to the vmware.log file,
+such as the OpenGL program's name and command line arguments.
+<li>See the driver code for other, lesser-used variables.
+</ul>
 
 <h3>WGL environment variables</h3>
-<dl>
-<dt><code>WGL_SWAP_INTERVAL</code></dt>
-<dd>to set a swap interval, equivalent to calling
-    <code>wglSwapIntervalEXT()</code> in an application.  If this
-    environment variable is set, application calls to
-    <code>wglSwapIntervalEXT()</code> will have no effect.</dd>
-</dl>
+<ul>
+<li>WGL_SWAP_INTERVAL - to set a swap interval, equivalent to calling
+wglSwapIntervalEXT() in an application.  If this environment variable
+is set, application calls to wglSwapIntervalEXT() will have no effect.
+</ul>
 
 <h3>VA-API state tracker environment variables</h3>
-<dl>
-<dt><code>VAAPI_MPEG4_ENABLED</code></dt>
-<dd>enable MPEG4 for VA-API, disabled by default.</dd>
-</dl>
+<ul>
+<li>VAAPI_MPEG4_ENABLED - enable MPEG4 for VA-API, disabled by default.
+</ul>
 
 
 <h3>VC4 driver environment variables</h3>
-<dl>
-<dt><code>VC4_DEBUG</code></dt>
-<dd>a comma-separated list of named flags, which do various things:
-<dl>
-   <dt><code>cl</code></dt>
-   <dd>dump command list during creation</dd>
-   <dt><code>qpu</code></dt>
-   <dd>dump generated QPU instructions</dd>
-   <dt><code>qir</code></dt>
-   <dd>dump QPU IR during program compile</dd>
-   <dt><code>nir</code></dt>
-   <dd>dump NIR during program compile</dd>
-   <dt><code>tgsi</code></dt>
-   <dd>dump TGSI during program compile</dd>
-   <dt><code>shaderdb</code></dt>
-   <dd>dump program compile information for shader-db analysis</dd>
-   <dt><code>perf</code></dt>
-   <dd>print during performance-related events</dd>
-   <dt><code>norast</code></dt>
-   <dd>skip actual hardware execution of commands</dd>
-   <dt><code>always_flush</code></dt>
-   <dd>flush after each draw call</dd>
-   <dt><code>always_sync</code></dt>
-   <dd>wait for finish after each flush</dd>
-   <dt><code>dump</code></dt>
-   <dd>write a GPU command stream trace file (VC4 simulator only)</dd>
-</dl>
-</dd>
-</dl>
+<ul>
+<li>VC4_DEBUG - a comma-separated list of named flags, which do various things:
+<ul>
+   <li>cl - dump command list during creation</li>
+   <li>qpu - dump generated QPU instructions</li>
+   <li>qir - dump QPU IR during program compile</li>
+   <li>nir - dump NIR during program compile</li>
+   <li>tgsi - dump TGSI during program compile</li>
+   <li>shaderdb - dump program compile information for shader-db analysis</li>
+   <li>perf - print during performance-related events</li>
+   <li>norast - skip actual hardware execution of commands</li>
+   <li>always_flush - flush after each draw call</li>
+   <li>always_sync - wait for finish after each flush</li>
+   <li>dump - write a GPU command stream trace file (VC4 simulator only)</li>
+</ul>
+</ul>
 
 
 <p>

docs/extensions.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>

docs/faq.html

@@ -2,32 +2,42 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Frequently Asked Questions</title>
+  <title>Mesa FAQ</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Frequently Asked Questions</h1>
+<center>
+<h1>Mesa Frequently Asked Questions</h1>
 Last updated: 19 September 2018
+</center>
 
+<br>
+<br>
 <h2>Index</h2>
-<ol>
-  <li><a href="#part1">High-level Questions and Answers</a></li>
-  <li><a href="#part2">Compilation and Installation Problems</a></li>
-  <li><a href="#part3">Runtime / Rendering Problems</a></li>
-  <li><a href="#part4">Developer Questions</a></li>
-</ol>
+<a href="#part1">1. High-level Questions and Answers</a>
+<br>
+<a href="#part2">2. Compilation and Installation Problems</a>
+<br>
+<a href="#part3">3. Runtime / Rendering Problems</a>
+<br>
+<a href="#part4">4. Developer Questions</a>
+<br>
+<br>
+<br>
 
-<h2 id="part1">1. High-level Questions and Answers</h2>
 
-<h3>1.1 What is Mesa?</h3>
+
+<h1 id="part1">1. High-level Questions and Answers</h1>
+
+<h2>1.1 What is Mesa?</h2>
 <p>
 Mesa is an open-source implementation of the OpenGL specification.
 OpenGL is a programming library for writing interactive 3D applications.
@@ -96,17 +106,17 @@ the Xlib API:
 <li>The GLX wire protocol is not supported and there's no OpenGL extension
     loaded by the X server.
 <li>There is no hardware acceleration.
-<li>The OpenGL library, <code>libGL.so</code>, contains everything (the
-    programming API, the GLX functions and all the rendering code).
+<li>The OpenGL library, libGL.so, contains everything (the programming API,
+    the GLX functions and all the rendering code).
 </ul>
 <p>
 Alternately, Mesa acts as the core for a number of OpenGL hardware drivers
 within the DRI (Direct Rendering Infrastructure):
 <ul>
-<li>The <code>libGL.so</code> library provides the GL and GLX API functions,
-    a GLX protocol encoder, and a device driver loader.
-<li>The device driver modules (such as <code>r200_dri.so</code>) contain
-    a built-in copy of the core Mesa code.
+<li>The libGL.so library provides the GL and GLX API functions, a GLX
+    protocol encoder, and a device driver loader.
+<li>The device driver modules (such as r200_dri.so) contain a built-in
+    copy of the core Mesa code.
 <li>The X server loads the GLX module.
     The GLX module decodes incoming GLX protocol and dispatches the commands
     to a rendering module.
@@ -126,7 +136,7 @@ Just follow the Mesa <a href="install.html">compilation instructions</a>.
 
 <h2>1.6 Are there other open-source implementations of OpenGL?</h2>
 <p>
-Yes, SGI's <a href="http://web.archive.org/web/20171010115110_/http://oss.sgi.com/projects/ogl-sample/index.html">
+Yes, SGI's <a href="http://oss.sgi.com/projects/ogl-sample/index.html">
 OpenGL Sample Implementation (SI)</a> is available.
 The SI was written during the time that OpenGL was originally designed.
 Unfortunately, development of the SI has stagnated.
@@ -138,9 +148,8 @@ Mesa is much more up to date with modern features and extensions.
 an open-source implementation of OpenGL ES for mobile devices.
 
 <p>
-<a href="http://web.archive.org/web/20130830162848/http://www.dsbox.com/minigl.html">miniGL</a>
-is a subset of OpenGL for PalmOS devices. The website is gone, but the source
-code can still be found on <a href="https://sourceforge.net/projects/minigl/">sourceforge.net</a>.
+<a href="http://www.dsbox.com/minigl.html">miniGL</a>
+is a subset of OpenGL for PalmOS devices.
 
 <p>
 <a href="http://bellard.org/TinyGL/">TinyGL</a>
@@ -170,16 +179,22 @@ popular and feature-complete.
 </p>
 
 
-<h2 id="part2">2. Compilation and Installation Problems</h2>
 
-<h3>2.1 What's the easiest way to install Mesa?</h3>
+<br>
+<br>
+
+
+<h1 id="part2">2. Compilation and Installation Problems</h1>
+
+
+<h2>2.1 What's the easiest way to install Mesa?</h2>
 <p>
 If you're using a Linux-based system, your distro CD most likely already
 has Mesa packages (like RPM or DEB) which you can easily install.
 </p>
 
 
-<h3>2.2 I get undefined symbols such as bgnpolygon, v3f, etc...</h3>
+<h2>2.2 I get undefined symbols such as bgnpolygon, v3f, etc...</h2>
 <p>
 You're application is written in IRIS GL, not OpenGL.
 IRIS GL was the predecessor to OpenGL and is a different thing (almost)
@@ -188,72 +203,63 @@ Mesa's not the solution.
 </p>
 
 
-<h3>2.3 Where is the GLUT library?</h3>
+<h2>2.3 Where is the GLUT library?</h2>
 <p>
-GLUT (OpenGL Utility Toolkit) is no longer in the separate
-<code>MesaGLUT-x.y.z.tar.gz</code> file.
+GLUT (OpenGL Utility Toolkit) is no longer in the separate MesaGLUT-x.y.z.tar.gz file.
 If you don't already have GLUT installed, you should grab 
 <a href="http://freeglut.sourceforge.net/">freeglut</a>.
 </p>
 
 
-<h3>2.4 Where is the GLw library?</h3>
+<h2>2.4 Where is the GLw library?</h2>
 <p>
-GLw (OpenGL widget library) is now available from a separate <a href="https://gitlab.freedesktop.org/mesa/glw">git repository</a>.  Unless you're using very old Xt/Motif applications with OpenGL, you shouldn't need it.
+GLw (OpenGL widget library) is now available from a separate <a href="https://cgit.freedesktop.org/mesa/glw/">git repository</a>.  Unless you're using very old Xt/Motif applications with OpenGL, you shouldn't need it.
 </p>
 
 
 <h2>2.5 What's the proper place for the libraries and headers?</h2>
 <p>
 On Linux-based systems you'll want to follow the
-<a href="https://www.khronos.org/registry/OpenGL/ABI/">Linux ABI</a> standard.
+<a href="http://oss.sgi.com/projects/ogl-sample/ABI/index.html">Linux ABI</a> standard.
 Basically you'll want the following:
 </p>
-<dl>
-<dt><code>/usr/include/GL/gl.h</code></dt>
-<dd>the main OpenGL header</dd>
-<dt><code>/usr/include/GL/glu.h</code></dt>
-<dd>the OpenGL GLU (utility) header</dd>
-<dt><code>/usr/include/GL/glx.h</code></dt>
-<dd>the OpenGL GLX header</dd>
-<dt><code>/usr/include/GL/glext.h</code></dt>
-<dd>the OpenGL extensions header</dd>
-<dt><code>/usr/include/GL/glxext.h</code></dt>
-<dd>the OpenGL GLX extensions header</dd>
-<dt><code>/usr/include/GL/osmesa.h</code></dt>
-<dd>the Mesa off-screen rendering header</dd>
-<dt><code>/usr/lib/libGL.so</code></dt>
-<dd>a symlink to <code>libGL.so.1</code></dd>
-<dt><code>/usr/lib/libGL.so.1</code></dt>
-<dd>a symlink to <code>libGL.so.1.xyz</code></dd>
-<dt><code>/usr/lib/libGL.so.xyz</code></dt>
-<dd>the actual OpenGL/Mesa library.  xyz denotes the
+<ul>
+<li>/usr/include/GL/gl.h - the main OpenGL header
+</li><li>/usr/include/GL/glu.h - the OpenGL GLU (utility) header
+</li><li>/usr/include/GL/glx.h - the OpenGL GLX header
+</li><li>/usr/include/GL/glext.h - the OpenGL extensions header
+</li><li>/usr/include/GL/glxext.h - the OpenGL GLX extensions header
+</li><li>/usr/include/GL/osmesa.h - the Mesa off-screen rendering header
+</li><li>/usr/lib/libGL.so - a symlink to libGL.so.1
+</li><li>/usr/lib/libGL.so.1 - a symlink to libGL.so.1.xyz
+</li><li>/usr/lib/libGL.so.xyz - the actual OpenGL/Mesa library.  xyz denotes the
 Mesa version number.
-</dd>
-</dl>
+</li></ul>
 <p>
-When configuring Mesa, there are three meson options that affect the install
+When configuring Mesa, there are three autoconf options that affect the install
 location that you should take care with: <code>--prefix</code>,
-<code>--libdir</code>, and <code>-D dri-drivers-path</code>. To install Mesa
+<code>--libdir</code>, and <code>--with-dri-driverdir</code>. To install Mesa
 into the system location where it will be available for all programs to use, set
 <code>--prefix=/usr</code>. Set <code>--libdir</code> to where your Linux
 distribution installs system libraries, usually either <code>/usr/lib</code> or
-<code>/usr/lib64</code>. Set <code>-D dri-drivers-path</code> to the directory
+<code>/usr/lib64</code>. Set <code>--with-dri-driverdir</code> to the directory
 where your Linux distribution installs DRI drivers. To find your system's DRI
 driver directory, try executing <code>find /usr -type d -name dri</code>. For
 example, if the <code>find</code> command listed <code>/usr/lib64/dri</code>,
-then set <code>-D dri-drivers-path=/usr/lib64/dri</code>.
+then set <code>--with-dri-driverdir=/usr/lib64/dri</code>.
 </p>
 <p>
 After determining the correct values for the install location, configure Mesa
-with <code>meson configure --prefix=/usr --libdir=xxx -D dri-drivers-path=xxx</code>
-and then install with <code>sudo ninja install</code>.
+with <code>./configure --prefix=/usr --libdir=xxx --with-dri-driverdir=xxx</code>
+and then install with <code>sudo make install</code>.
 </p>
+<br>
+<br>
 
 
-<h2 id="part3">3. Runtime / Rendering Problems</h2>
+<h1 id="part3">3. Runtime / Rendering Problems</h1>
 
-<h3>3.1 Rendering is slow / why isn't my graphics hardware being used?</h3>
+<h2>3.1 Rendering is slow / why isn't my graphics hardware being used?</h2>
 <p>
 If Mesa can't use its hardware accelerated drivers it falls back on one of its software renderers.
 (eg. classic swrast, softpipe or llvmpipe)
@@ -274,57 +280,60 @@ If your DRI-based driver isn't working, go to the
 </p>
 
 
-<h3>3.2 I'm seeing errors in depth (Z) buffering.  Why?</h3>
+<h2>3.2 I'm seeing errors in depth (Z) buffering.  Why?</h2>
 <p>
 Make sure the ratio of the far to near clipping planes isn't too great.
 Look
-<a href="https://www.opengl.org/archives/resources/faq/technical/depthbuffer.htm#0040">here</a>
+<a href="https://www.opengl.org/resources/faq/technical/depthbuffer.htm#0040">here</a>
 for details.
 </p>
 <p>
 Mesa uses a 16-bit depth buffer by default which is smaller and faster
 to clear than a 32-bit buffer but not as accurate.
 If you need a deeper you can modify the parameters to
-<code>glXChooseVisual</code> in your code.
+<code> glXChooseVisual</code> in your code.
 </p>
 
 
-<h3>3.3 Why Isn't depth buffering working at all?</h3>
+<h2>3.3 Why Isn't depth buffering working at all?</h2>
 <p>
-Be sure you're requesting a depth buffered-visual.  If you set the
-<code>MESA_DEBUG</code> environment variable it will warn you about trying
-to enable depth testing when you don't have a depth buffer.
+Be sure you're requesting a depth buffered-visual.  If you set the MESA_DEBUG
+environment variable it will warn you about trying to enable depth testing
+when you don't have a depth buffer.
 </p>
 <p>Specifically, make sure <code>glutInitDisplayMode</code> is being called
 with <code>GLUT_DEPTH</code> or <code>glXChooseVisual</code> is being
-called with a non-zero value for <code>GLX_DEPTH_SIZE</code>.
+called with a non-zero value for GLX_DEPTH_SIZE.
 </p>
 <p>This discussion applies to stencil buffers, accumulation buffers and
 alpha channels too.
 </p>
 
 
-<h3>3.4 Why does <code>glGetString()</code> always return <code>NULL</code>?</h3>
+<h2>3.4 Why does glGetString() always return NULL?</h2>
 <p>
 Be sure you have an active/current OpenGL rendering context before
-calling <code>glGetString</code>.
+calling glGetString.
 </p>
 
 
-<h3>3.5 <code>GL_POINTS</code> and <code>GL_LINES</code> don't touch the
-right pixels</h3>
+<h2>3.5 GL_POINTS and GL_LINES don't touch the right pixels</h2>
 <p>
-If you're trying to draw a filled region by using <code>GL_POINTS</code> or
-<code>GL_LINES</code> and seeing holes or gaps it's because of a float-to-int
-rounding problem. But this is not a bug. See Appendix H of the OpenGL
-Programming Guide - "OpenGL Correctness Tips". Basically, applying a
-translation of (0.375, 0.375, 0.0) to your coordinates will fix the problem.
+If you're trying to draw a filled region by using GL_POINTS or GL_LINES
+and seeing holes or gaps it's because of a float-to-int rounding problem.
+But this is not a bug.
+See Appendix H of the OpenGL Programming Guide - "OpenGL Correctness Tips".
+Basically, applying a translation of (0.375, 0.375, 0.0) to your coordinates
+will fix the problem.
 </p>
 
+<br>
+<br>
 
-<h2 id="part4">4. Developer Questions</h2>
 
-<h3>4.1 How can I contribute?</h3>
+<h1 id="part4">4. Developer Questions</h1>
+
+<h2>4.1 How can I contribute?</h2>
 <p>
 First, join the <a href="lists.html">mesa-dev mailing list</a>.
 That's where Mesa development is discussed.
@@ -338,7 +347,7 @@ You should read it.
 extensions, writing hardware drivers (for the DRI), and code optimization.
 </p>
 
-<h3>4.2 How do I write a new device driver?</h3>
+<h2>4.2 How do I write a new device driver?</h2>
 <p>
 Unfortunately, writing a device driver isn't easy.
 It requires detailed understanding of OpenGL, the Mesa code, and your
@@ -362,8 +371,7 @@ the archives) is a good way to get information.
 </p>
 
 
-<h3>4.3 Why isn't <code>GL_EXT_texture_compression_s3tc</code> implemented in
-Mesa?</h3>
+<h2>4.3 Why isn't GL_EXT_texture_compression_s3tc implemented in Mesa?</h2>
 <p>
 Oh but it is! Prior to 2nd October 2017, the Mesa project did not include s3tc
 support due to intellectual property (IP) and/or patent issues around the s3tc

docs/features.txt

@@ -63,7 +63,7 @@ GL 3.0, GLSL 1.30 --- all DONE: freedreno, i965, nv50, nvc0, r600, radeonsi, llv
   glVertexAttribI commands                              DONE
   Depth format cube textures                            DONE ()
   GLX_ARB_create_context (GLX 1.4 is required)          DONE
-  Multisample anti-aliasing                             DONE (freedreno/a5xx+, freedreno (*), llvmpipe (*), softpipe (*), swr (*))
+  Multisample anti-aliasing                             DONE (freedreno/a5xx, freedreno (*), llvmpipe (*), softpipe (*), swr (*))
 
 (*) freedreno (a2xx-a4xx), llvmpipe, softpipe, and swr have fake Multisample anti-aliasing support
 
@@ -90,7 +90,7 @@ GL 3.2, GLSL 1.50 --- all DONE: i965, nv50, nvc0, r600, radeonsi, llvmpipe, soft
   GL_ARB_fragment_coord_conventions (Frag shader coord) DONE (freedreno)
   GL_ARB_provoking_vertex (Provoking vertex)            DONE (freedreno)
   GL_ARB_seamless_cube_map (Seamless cubemaps)          DONE (freedreno)
-  GL_ARB_texture_multisample (Multisample textures)     DONE (freedreno/a5xx+)
+  GL_ARB_texture_multisample (Multisample textures)     DONE (freedreno/a5xx)
   GL_ARB_depth_clamp (Frag depth clamp)                 DONE (freedreno)
   GL_ARB_sync (Fence objects)                           DONE (freedreno)
   GLX_ARB_create_context_profile                        DONE
@@ -115,26 +115,26 @@ GL 4.0, GLSL 4.00 --- all DONE: i965/gen7+, nvc0, r600, radeonsi, virgl
   GL_ARB_draw_buffers_blend                             DONE (freedreno, i965/gen6+, nv50, llvmpipe, softpipe, swr)
   GL_ARB_draw_indirect                                  DONE (freedreno, i965/gen7+, llvmpipe, softpipe, swr)
   GL_ARB_gpu_shader5                                    DONE (i965/gen7+)
-  - 'precise' qualifier                                 DONE (softpipe)
+  - 'precise' qualifier                                 DONE
   - Dynamically uniform sampler array indices           DONE (softpipe)
-  - Dynamically uniform UBO array indices               DONE (freedreno, softpipe)
-  - Implicit signed -> unsigned conversions             DONE (softpipe)
-  - Fused multiply-add                                  DONE (softpipe)
+  - Dynamically uniform UBO array indices               DONE (freedreno)
+  - Implicit signed -> unsigned conversions             DONE
+  - Fused multiply-add                                  DONE ()
   - Packing/bitfield/conversion functions               DONE (freedreno, softpipe)
   - Enhanced textureGather                              DONE (freedreno, softpipe)
   - Geometry shader instancing                          DONE (llvmpipe, softpipe)
-  - Geometry shader multiple streams                    DONE (softpipe)
+  - Geometry shader multiple streams                    DONE ()
   - Enhanced per-sample shading                         DONE ()
-  - Interpolation functions                             DONE (softpipe)
-  - New overload resolution rules                       DONE (softpipe)
-  GL_ARB_gpu_shader_fp64                                DONE (i965/gen7+, llvmpipe, softpipe, swr)
-  GL_ARB_sample_shading                                 DONE (freedreno/a6xx, i965/gen6+, nv50)
+  - Interpolation functions                             DONE ()
+  - New overload resolution rules                       DONE
+  GL_ARB_gpu_shader_fp64                                DONE (i965/gen7+, llvmpipe, softpipe)
+  GL_ARB_sample_shading                                 DONE (i965/gen6+, nv50)
   GL_ARB_shader_subroutine                              DONE (freedreno, i965/gen6+, nv50, llvmpipe, softpipe, swr)
   GL_ARB_tessellation_shader                            DONE (i965/gen7+)
   GL_ARB_texture_buffer_object_rgb32                    DONE (freedreno, i965/gen6+, llvmpipe, softpipe, swr)
-  GL_ARB_texture_cube_map_array                         DONE (i965/gen6+, nv50, llvmpipe, softpipe, swr)
+  GL_ARB_texture_cube_map_array                         DONE (i965/gen6+, nv50, llvmpipe, softpipe)
   GL_ARB_texture_gather                                 DONE (freedreno, i965/gen6+, nv50, llvmpipe, softpipe, swr)
-  GL_ARB_texture_query_lod                              DONE (freedreno, i965, nv50, llvmpipe, softpipe, swr)
+  GL_ARB_texture_query_lod                              DONE (freedreno, i965, nv50, llvmpipe, softpipe)
   GL_ARB_transform_feedback2                            DONE (i965/gen6+, nv50, llvmpipe, softpipe, swr)
   GL_ARB_transform_feedback3                            DONE (i965/gen7+, llvmpipe, softpipe, swr)
 
@@ -145,19 +145,19 @@ GL 4.1, GLSL 4.10 --- all DONE: i965/gen7+, nvc0, r600, radeonsi, virgl
   GL_ARB_get_program_binary                             DONE (0 or 1 binary formats)
   GL_ARB_separate_shader_objects                        DONE (all drivers)
   GL_ARB_shader_precision                               DONE (i965/gen7+, all drivers that support GLSL 4.10)
-  GL_ARB_vertex_attrib_64bit                            DONE (i965/gen7+, llvmpipe, softpipe, swr)
-  GL_ARB_viewport_array                                 DONE (i965, nv50, llvmpipe, softpipe, swr)
+  GL_ARB_vertex_attrib_64bit                            DONE (i965/gen7+, llvmpipe, softpipe)
+  GL_ARB_viewport_array                                 DONE (i965, nv50, llvmpipe, softpipe)
 
 
 GL 4.2, GLSL 4.20 -- all DONE: i965/gen7+, nvc0, r600, radeonsi, virgl
 
   GL_ARB_texture_compression_bptc                       DONE (freedreno, i965)
   GL_ARB_compressed_texture_pixel_storage               DONE (all drivers)
-  GL_ARB_shader_atomic_counters                         DONE (freedreno/a5xx+, i965, llvmpipe, softpipe)
+  GL_ARB_shader_atomic_counters                         DONE (freedreno/a5xx, i965, softpipe)
   GL_ARB_texture_storage                                DONE (all drivers)
   GL_ARB_transform_feedback_instanced                   DONE (freedreno, i965, nv50, llvmpipe, softpipe, swr)
   GL_ARB_base_instance                                  DONE (freedreno, i965, nv50, llvmpipe, softpipe, swr)
-  GL_ARB_shader_image_load_store                        DONE (freedreno/a5xx+, i965, softpipe)
+  GL_ARB_shader_image_load_store                        DONE (freedreno/a5xx, i965, softpipe)
   GL_ARB_conservative_depth                             DONE (all drivers that support GLSL 1.30)
   GL_ARB_shading_language_420pack                       DONE (all drivers that support GLSL 1.30)
   GL_ARB_shading_language_packing                       DONE (all drivers)
@@ -170,8 +170,8 @@ GL 4.3, GLSL 4.30 -- all DONE: i965/gen8+, nvc0, r600, radeonsi, virgl
   GL_ARB_arrays_of_arrays                               DONE (all drivers that support GLSL 1.30)
   GL_ARB_ES3_compatibility                              DONE (all drivers that support GLSL 3.30)
   GL_ARB_clear_buffer_object                            DONE (all drivers)
-  GL_ARB_compute_shader                                 DONE (freedreno/a5xx+, i965, softpipe)
-  GL_ARB_copy_image                                     DONE (i965, nv50, softpipe, llvmpipe, swr)
+  GL_ARB_compute_shader                                 DONE (freedreno/a5xx, i965, softpipe)
+  GL_ARB_copy_image                                     DONE (i965, nv50, softpipe, llvmpipe)
   GL_KHR_debug                                          DONE (all drivers)
   GL_ARB_explicit_uniform_location                      DONE (all drivers that support GLSL)
   GL_ARB_fragment_layer_viewport                        DONE (i965, nv50, llvmpipe, softpipe)
@@ -181,10 +181,10 @@ GL 4.3, GLSL 4.30 -- all DONE: i965/gen8+, nvc0, r600, radeonsi, virgl
   GL_ARB_multi_draw_indirect                            DONE (freedreno, i965, llvmpipe, softpipe, swr)
   GL_ARB_program_interface_query                        DONE (all drivers)
   GL_ARB_robust_buffer_access_behavior                  DONE (i965)
-  GL_ARB_shader_image_size                              DONE (freedreno/a5xx+, i965, softpipe)
-  GL_ARB_shader_storage_buffer_object                   DONE (freedreno/a5xx+, i965, llvmpipe, softpipe)
+  GL_ARB_shader_image_size                              DONE (freedreno/a5xx, i965, softpipe)
+  GL_ARB_shader_storage_buffer_object                   DONE (freedreno/a5xx, i965, softpipe)
   GL_ARB_stencil_texturing                              DONE (freedreno, i965/hsw+, nv50, llvmpipe, softpipe, swr)
-  GL_ARB_texture_buffer_range                           DONE (freedreno, nv50, i965, softpipe, llvmpipe, swr)
+  GL_ARB_texture_buffer_range                           DONE (freedreno, nv50, i965, llvmpipe)
   GL_ARB_texture_query_levels                           DONE (all drivers that support GLSL 1.30)
   GL_ARB_texture_storage_multisample                    DONE (all drivers that support GL_ARB_texture_multisample)
   GL_ARB_texture_view                                   DONE (freedreno, i965, nv50, llvmpipe, softpipe, swr)
@@ -204,33 +204,33 @@ GL 4.4, GLSL 4.40 -- all DONE: i965/gen8+, nvc0, r600, radeonsi
   - specified transform/feedback layout                 DONE
   - input/output block locations                        DONE
   GL_ARB_multi_bind                                     DONE (all drivers)
-  GL_ARB_query_buffer_object                            DONE (i965/hsw+, virgl)
+  GL_ARB_query_buffer_object                            DONE (i965/hsw+)
   GL_ARB_texture_mirror_clamp_to_edge                   DONE (i965, nv50, llvmpipe, softpipe, swr, virgl)
   GL_ARB_texture_stencil8                               DONE (freedreno, i965/hsw+, nv50, llvmpipe, softpipe, swr, virgl)
   GL_ARB_vertex_type_10f_11f_11f_rev                    DONE (i965, nv50, llvmpipe, softpipe, swr, virgl)
 
-GL 4.5, GLSL 4.50 -- all DONE: nvc0, radeonsi, r600
+GL 4.5, GLSL 4.50 -- all DONE: nvc0, radeonsi
 
-  GL_ARB_ES3_1_compatibility                            DONE (i965/hsw+, softpipe, virgl)
-  GL_ARB_clip_control                                   DONE (freedreno, i965, nv50, llvmpipe, softpipe, swr)
-  GL_ARB_conditional_render_inverted                    DONE (freedreno, i965, nv50, llvmpipe, softpipe, swr, virgl)
-  GL_ARB_cull_distance                                  DONE (i965, nv50, llvmpipe, softpipe, swr, virgl)
-  GL_ARB_derivative_control                             DONE (i965, nv50, virgl)
+  GL_ARB_ES3_1_compatibility                            DONE (i965/hsw+, r600, virgl)
+  GL_ARB_clip_control                                   DONE (freedreno, i965, nv50, r600, llvmpipe, softpipe, swr)
+  GL_ARB_conditional_render_inverted                    DONE (freedreno, i965, nv50, r600, llvmpipe, softpipe, swr, virgl)
+  GL_ARB_cull_distance                                  DONE (i965, nv50, r600, llvmpipe, softpipe, swr, virgl)
+  GL_ARB_derivative_control                             DONE (i965, nv50, r600, virgl)
   GL_ARB_direct_state_access                            DONE (all drivers)
   GL_ARB_get_texture_sub_image                          DONE (all drivers)
-  GL_ARB_shader_texture_image_samples                   DONE (i965, nv50, virgl)
-  GL_ARB_texture_barrier                                DONE (freedreno, i965, nv50, virgl)
+  GL_ARB_shader_texture_image_samples                   DONE (i965, nv50, r600, virgl)
+  GL_ARB_texture_barrier                                DONE (freedreno, i965, nv50, r600, virgl)
   GL_KHR_context_flush_control                          DONE (all - but needs GLX/EGL extension to be useful)
-  GL_KHR_robustness                                     DONE (freedreno, i965)
+  GL_KHR_robustness                                     DONE (i965)
   GL_EXT_shader_integer_mix                             DONE (all drivers that support GLSL)
 
 GL 4.6, GLSL 4.60
 
   GL_ARB_gl_spirv                                       in progress (Nicolai Hähnle, Ian Romanick)
-  GL_ARB_indirect_parameters                            DONE (i965/gen7+, nvc0, radeonsi, virgl)
+  GL_ARB_indirect_parameters                            DONE (i965/gen7+, nvc0, radeonsi)
   GL_ARB_pipeline_statistics_query                      DONE (i965, nvc0, r600, radeonsi, llvmpipe, softpipe, swr)
   GL_ARB_polygon_offset_clamp                           DONE (freedreno, i965, nv50, nvc0, r600, radeonsi, llvmpipe, swr, virgl)
-  GL_ARB_shader_atomic_counter_ops                      DONE (freedreno/a5xx+, i965/gen7+, nvc0, r600, radeonsi, llvmpipe, softpipe, virgl)
+  GL_ARB_shader_atomic_counter_ops                      DONE (freedreno/a5xx, i965/gen7+, nvc0, r600, radeonsi, softpipe, virgl)
   GL_ARB_shader_draw_parameters                         DONE (i965, nvc0, radeonsi)
   GL_ARB_shader_group_vote                              DONE (i965, nvc0, radeonsi)
   GL_ARB_spirv_extensions                               in progress (Nicolai Hähnle, Ian Romanick)
@@ -244,23 +244,23 @@ These are the extensions cherry-picked to make GLES 3.1
 GLES3.1, GLSL ES 3.1 -- all DONE: i965/hsw+, nvc0, r600, radeonsi, virgl
 
   GL_ARB_arrays_of_arrays                               DONE (all drivers that support GLSL 1.30)
-  GL_ARB_compute_shader                                 DONE (freedreno/a5xx+, i965/gen7+, softpipe)
+  GL_ARB_compute_shader                                 DONE (freedreno/a5xx, i965/gen7+, softpipe)
   GL_ARB_draw_indirect                                  DONE (freedreno, i965/gen7+, llvmpipe, softpipe, swr)
   GL_ARB_explicit_uniform_location                      DONE (all drivers that support GLSL)
   GL_ARB_framebuffer_no_attachments                     DONE (freedreno, i965/gen7+, softpipe)
   GL_ARB_program_interface_query                        DONE (all drivers)
-  GL_ARB_shader_atomic_counters                         DONE (freedreno/a5xx+, i965/gen7+, llvmpipe, softpipe)
-  GL_ARB_shader_image_load_store                        DONE (freedreno/a5xx+, i965/gen7+, softpipe)
-  GL_ARB_shader_image_size                              DONE (freedreno/a5xx+, i965/gen7+, softpipe)
-  GL_ARB_shader_storage_buffer_object                   DONE (freedreno/a5xx+, i965/gen7+, llvmpipe, softpipe)
+  GL_ARB_shader_atomic_counters                         DONE (freedreno/a5xx, i965/gen7+, softpipe)
+  GL_ARB_shader_image_load_store                        DONE (freedreno/a5xx, i965/gen7+, softpipe)
+  GL_ARB_shader_image_size                              DONE (freedreno/a5xx, i965/gen7+, softpipe)
+  GL_ARB_shader_storage_buffer_object                   DONE (freedreno/a5xx, i965/gen7+, softpipe)
   GL_ARB_shading_language_packing                       DONE (all drivers)
   GL_ARB_separate_shader_objects                        DONE (all drivers)
   GL_ARB_stencil_texturing                              DONE (freedreno, nv50, llvmpipe, softpipe, swr)
-  GL_ARB_texture_multisample (Multisample textures)     DONE (freedreno/a5xx+, i965/gen7+, nv50, llvmpipe, softpipe)
+  GL_ARB_texture_multisample (Multisample textures)     DONE (freedreno/a5xx, i965/gen7+, nv50, llvmpipe, softpipe)
   GL_ARB_texture_storage_multisample                    DONE (all drivers that support GL_ARB_texture_multisample)
   GL_ARB_vertex_attrib_binding                          DONE (all drivers)
   GS5 Enhanced textureGather                            DONE (freedreno, i965/gen7+)
-  GS5 Packing/bitfield/conversion functions             DONE (freedreno/a5xx+, i965/gen6+)
+  GS5 Packing/bitfield/conversion functions             DONE (freedreno/a5xx, i965/gen6+)
   GL_EXT_shader_integer_mix                             DONE (all drivers that support GLSL)
 
   Additional functionality not covered above:
@@ -272,25 +272,25 @@ GLES3.1, GLSL ES 3.1 -- all DONE: i965/hsw+, nvc0, r600, radeonsi, virgl
 GLES3.2, GLSL ES 3.2 -- all DONE: i965/gen9+, radeonsi, virgl
 
   GL_EXT_color_buffer_float                             DONE (all drivers)
-  GL_KHR_blend_equation_advanced                        DONE (freedreno/a6xx, i965, nvc0)
+  GL_KHR_blend_equation_advanced                        DONE (i965, nvc0)
   GL_KHR_debug                                          DONE (all drivers)
-  GL_KHR_robustness                                     DONE (freedreno, i965, nvc0)
+  GL_KHR_robustness                                     DONE (i965, nvc0)
   GL_KHR_texture_compression_astc_ldr                   DONE (freedreno, i965/gen9+)
   GL_OES_copy_image                                     DONE (all drivers)
   GL_OES_draw_buffers_indexed                           DONE (all drivers that support GL_ARB_draw_buffers_blend)
   GL_OES_draw_elements_base_vertex                      DONE (all drivers)
-  GL_OES_geometry_shader                                DONE (i965/hsw+, nvc0, softpipe)
-  GL_OES_gpu_shader5                                    DONE (freedreno/a6xx, all drivers that support GL_ARB_gpu_shader5)
-  GL_OES_primitive_bounding_box                         DONE (freedreno/a5xx+, i965/gen7+, nvc0, softpipe)
-  GL_OES_sample_shading                                 DONE (freedreno/a6xx, i965, nvc0, r600)
-  GL_OES_sample_variables                               DONE (freedreno/a6xx, i965, nvc0, r600)
+  GL_OES_geometry_shader                                DONE (i965/hsw+, nvc0)
+  GL_OES_gpu_shader5                                    DONE (all drivers that support GL_ARB_gpu_shader5)
+  GL_OES_primitive_bounding_box                         DONE (i965/gen7+, nvc0)
+  GL_OES_sample_shading                                 DONE (i965, nvc0, r600)
+  GL_OES_sample_variables                               DONE (i965, nvc0, r600)
   GL_OES_shader_image_atomic                            DONE (all drivers that support GL_ARB_shader_image_load_store)
   GL_OES_shader_io_blocks                               DONE (All drivers that support GLES 3.1)
-  GL_OES_shader_multisample_interpolation               DONE (freedreno/a6xx, i965, nvc0, r600)
+  GL_OES_shader_multisample_interpolation               DONE (i965, nvc0, r600)
   GL_OES_tessellation_shader                            DONE (all drivers that support GL_ARB_tessellation_shader)
   GL_OES_texture_border_clamp                           DONE (all drivers)
-  GL_OES_texture_buffer                                 DONE (freedreno, i965, nvc0, softpipe)
-  GL_OES_texture_cube_map_array                         DONE (i965/hsw+, nvc0, softpipe)
+  GL_OES_texture_buffer                                 DONE (freedreno, i965, nvc0)
+  GL_OES_texture_cube_map_array                         DONE (i965/hsw+, nvc0)
   GL_OES_texture_stencil8                               DONE (all drivers that support GL_ARB_texture_stencil8)
   GL_OES_texture_storage_multisample_2d_array           DONE (all drivers that support GL_ARB_texture_multisample)
 
@@ -302,11 +302,11 @@ Khronos, ARB, and OES extensions that are not part of any OpenGL or OpenGL ES ve
   GL_ARB_ES3_2_compatibility                            DONE (i965/gen8+, radeonsi, virgl)
   GL_ARB_fragment_shader_interlock                      DONE (i965)
   GL_ARB_gpu_shader_int64                               DONE (i965/gen8+, nvc0, radeonsi, softpipe, llvmpipe)
-  GL_ARB_parallel_shader_compile                        DONE (all drivers)
-  GL_ARB_post_depth_coverage                            DONE (i965, nvc0, radeonsi)
+  GL_ARB_parallel_shader_compile                        not started, but Chia-I Wu did some related work in 2014
+  GL_ARB_post_depth_coverage                            DONE (i965, nvc0)
   GL_ARB_robustness_isolation                           not started
   GL_ARB_sample_locations                               DONE (nvc0)
-  GL_ARB_seamless_cubemap_per_texture                   DONE (etnaviv/SEAMLESS_CUBE_MAP, freedreno, i965, nvc0, radeonsi, r600, softpipe, swr, virgl)
+  GL_ARB_seamless_cubemap_per_texture                   DONE (freedreno, i965, nvc0, radeonsi, r600, softpipe, swr, virgl)
   GL_ARB_shader_ballot                                  DONE (i965/gen8+, nvc0, radeonsi)
   GL_ARB_shader_clock                                   DONE (i965/gen7+, nv50, nvc0, r600, radeonsi, virgl)
   GL_ARB_shader_stencil_export                          DONE (i965/gen9+, r600, radeonsi, softpipe, llvmpipe, swr, virgl)
@@ -319,13 +319,11 @@ Khronos, ARB, and OES extensions that are not part of any OpenGL or OpenGL ES ve
   GL_EXT_memory_object                                  DONE (radeonsi)
   GL_EXT_memory_object_fd                               DONE (radeonsi)
   GL_EXT_memory_object_win32                            not started
-  GL_EXT_render_snorm                                   DONE (i965, radeonsi)
+  GL_EXT_render_snorm                                   DONE (i965)
   GL_EXT_semaphore                                      DONE (radeonsi)
   GL_EXT_semaphore_fd                                   DONE (radeonsi)
   GL_EXT_semaphore_win32                                not started
-  GL_EXT_sRGB_write_control                             DONE (all drivers that support GLES 3.0+)
-  GL_EXT_texture_norm16                                 DONE (freedreno, i965, r600, radeonsi, nvc0)
-  GL_EXT_texture_sRGB_R8                                DONE (all drivers that support GLES 3.0+)
+  GL_EXT_texture_norm16                                 DONE (i965, r600, radeonsi, nvc0)
   GL_KHR_blend_equation_advanced_coherent               DONE (i965/gen9+)
   GL_KHR_texture_compression_astc_hdr                   DONE (i965/bxt)
   GL_KHR_texture_compression_astc_sliced_3d             DONE (i965/gen9+, radeonsi)
@@ -340,8 +338,8 @@ Khronos, ARB, and OES extensions that are not part of any OpenGL or OpenGL ES ve
   GL_OES_texture_float_linear                           DONE (freedreno, i965, r300, r600, radeonsi, nv30, nv50, nvc0, softpipe, llvmpipe)
   GL_OES_texture_half_float                             DONE (freedreno, i965, r300, r600, radeonsi, nv30, nv50, nvc0, softpipe, llvmpipe)
   GL_OES_texture_half_float_linear                      DONE (freedreno, i965, r300, r600, radeonsi, nv30, nv50, nvc0, softpipe, llvmpipe)
-  GL_OES_texture_view                                   DONE (freedreno, i965/gen8+, r600, radeonsi, nv50, nvc0, softpipe, llvmpipe, swr)
-  GL_OES_viewport_array                                 DONE (i965, nvc0, radeonsi, softpipe)
+  GL_OES_texture_view                                   DONE (i965/gen8+)
+  GL_OES_viewport_array                                 DONE (i965, nvc0, radeonsi)
   GLX_ARB_context_flush_control                         not started
   GLX_ARB_robustness_application_isolation              not started
   GLX_ARB_robustness_share_group_isolation              not started
@@ -441,7 +439,7 @@ Vulkan 1.1 -- all DONE: anv, radv
   VK_KHR_variable_pointers                              DONE (anv, radv)
 
 Khronos extensions that are not part of any Vulkan version:
-  VK_KHR_8bit_storage                                   DONE (anv, radv)
+  VK_KHR_8bit_storage                                   DONE (anv)
   VK_KHR_android_surface                                not started
   VK_KHR_create_renderpass2                             DONE (anv, radv)
   VK_KHR_display                                        DONE (anv, radv)

docs/helpwanted.html

@@ -8,13 +8,13 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Help Wanted</h1>
+<h1>Help Wanted / To-Do List</h1>
 
 <p>
 We can always use more help with the Mesa project.
@@ -32,8 +32,8 @@ Just applying patches, testing and reporting back is helpful.
 There are plenty of open bugs in the <a href="https://bugs.freedesktop.org/describecomponents.cgi?product=Mesa">bug database</a>.
 <li>
 <b>Remove aliasing warnings.</b>
-Enable gcc's <code>-Wstrict-aliasing=2 -fstrict-aliasing</code> arguments, and
-track down aliasing issues in the code.
+Enable gcc -Wstrict-aliasing=2 -fstrict-aliasing and track down aliasing
+issues in the code.
 <li>
 <b>Contribute more tests to
 <a href="https://piglit.freedesktop.org/">Piglit</a>.</b>
@@ -48,8 +48,7 @@ You can find some further To-do lists here:
 </p>
 <ul>
   <li><a href="https://gitlab.freedesktop.org/mesa/mesa/blob/master/docs/features.txt">
-    <code>features.txt</code></a> - Status of OpenGL 3.x / 4.x features in
-    Mesa.</li>
+    <b>features.txt</b></a> - Status of OpenGL 3.x / 4.x features in Mesa.</li>
 </ul>
 
 <p>
@@ -57,9 +56,9 @@ You can find some further To-do lists here:
 </p>
 <ul>
   <li><a href="https://dri.freedesktop.org/wiki/R600ToDo">
-    <code>r600g</code></a> - Driver for ATI/AMD R600 - Northern Island.</li>
+    <b>r600g</b></a> - Driver for ATI/AMD R600 - Northern Island.</li>
   <li><a href="https://dri.freedesktop.org/wiki/R300ToDo">
-    <code>r300g</code></a> - Driver for ATI R300 - R500.</li>
+    <b>r300g</b></a> - Driver for ATI R300 - R500.</li>
 </ul>
 
 <p>

docs/index.html

@@ -8,176 +8,13 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
 <h1>News</h1>
-
-<h2>July 23, 2019</h2>
-<p>
-<a href="relnotes/19.1.3.html">Mesa 19.1.3</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>July 9, 2019</h2>
-<p>
-<a href="relnotes/19.1.2.html">Mesa 19.1.2</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>June 26, 2019</h2>
-<p>
-<a href="relnotes/19.0.8.html">Mesa 19.0.8</a> is released.
-This is an emergency bug fix release. Users of 19.0.7 should updated to 19.0.8
-or 19.1.1 immediately.
-</p>
-
-<h2>June 25, 2019</h2>
-<p>
-<a href="relnotes/19.1.1.html">Mesa 19.1.1</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>June 24, 2019</h2>
-<p>
-<a href="relnotes/19.0.7.html">Mesa 19.0.7</a> is released.
-This is a bug-fix release.
-</p>
-<p>
-NOTE: It is anticipated that 19.0.7 will be the final release in the
-19.0 series. Users of 19.0 are encouraged to migrate to the 19.1
-series in order to obtain future fixes.
-</p>
-
-<h2>June 11, 2019</h2>
-<p>
-<a href="relnotes/19.1.0.html">Mesa 19.1.0</a> is released.
-This is a new development release. See the release notes for more
-information about this release
-</p>
-<h2>June 5, 2019</h2>
-<p>
-<a href="relnotes/19.0.6.html">Mesa 19.0.6</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>May 21, 2019</h2>
-<p>
-<a href="relnotes/19.0.5.html">Mesa 19.0.5</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>May 9, 2019</h2>
-<p>
-<a href="relnotes/19.0.4.html">Mesa 19.0.4</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>April 24, 2019</h2>
-<p>
-<a href="relnotes/19.0.3.html">Mesa 19.0.3</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>April 10, 2019</h2>
-<p>
-<a href="relnotes/19.0.2.html">Mesa 19.0.2</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>April 5, 2019</h2>
-<p>
-<a href="relnotes/18.3.6.html">Mesa 18.3.6</a> is released.
-This is a bug-fix release.
-</p>
-<p>
-NOTE: It is anticipated that 18.3.6 will be the final release in the
-18.3 series. Users of 18.3 are encouraged to migrate to the 19.0
-series in order to obtain future fixes.
-</p>
-
-<h2>March 27, 2019</h2>
-<p>
-<a href="relnotes/19.0.1.html">Mesa 19.0.1</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>March 18, 2019</h2>
-<p>
-<a href="relnotes/18.3.5.html">Mesa 18.3.5</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>March 13, 2019</h2>
-<p>
-<a href="relnotes/19.0.0.html">Mesa 19.0.0</a> is released.
-This is a new development release. See the release notes for more
-information about this release
-</p>
-
-<h2>February 18, 2019</h2>
-<p>
-<a href="relnotes/18.3.4.html">Mesa 18.3.4</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>January 31, 2019</h2>
-<p>
-<a href="relnotes/18.3.3.html">Mesa 18.3.3</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>January 17, 2019</h2>
-<p>
-<a href="relnotes/18.3.2.html">Mesa 18.3.2</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>December 27, 2018</h2>
-<p>
-<a href="relnotes/18.2.8.html">Mesa 18.2.8</a> is released.
-This is a bug-fix release.
-</p>
-<p>
-NOTE: It is anticipated that 18.2.8 will be the final release in the
-18.2 series. Users of 18.2 are encouraged to migrate to the 18.3
-series in order to obtain future fixes.
-</p>
-
-<h2>December 13, 2018</h2>
-<p>
-<a href="relnotes/18.2.7.html">Mesa 18.2.7</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>December 11, 2018</h2>
-<p>
-<a href="relnotes/18.3.1.html">Mesa 18.3.1</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>December 7, 2018</h2>
-<p>
-<a href="relnotes/18.3.0.html">Mesa 18.3.0</a> is released.  This is a
-new development release.  See the release notes for more information
-about the release.
-</p>
-
-<h2>November 28, 2018</h2>
-<p>
-<a href="relnotes/18.2.6.html">Mesa 18.2.6</a> is released.
-This is a bug-fix release.
-</p>
-
-<h2>November 15, 2018</h2>
-<p>
-<a href="relnotes/18.2.5.html">Mesa 18.2.5</a> is released.
-This is a bug-fix release.
-</p>
-
 <h2>October 31, 2018</h2>
 <p>
 <a href="relnotes/18.2.4.html">Mesa 18.2.4</a> is released.
@@ -200,8 +37,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/18.1.9.html">Mesa 18.1.9</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 18.1.9 will be the final release in the
 18.1 series. Users of 18.1 are encouraged to migrate to the 18.2
 series in order to obtain future fixes.
@@ -263,8 +99,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/18.0.5.html">Mesa 18.0.5</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 18.0.5 will be the final release in the
 18.0 series. Users of 18.0 are encouraged to migrate to the 18.1
 series in order to obtain future fixes.
@@ -311,8 +146,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/17.3.9.html">Mesa 17.3.9</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 17.3.9 will be the final release in the
 17.3 series. Users of 17.3 are encouraged to migrate to the 18.0
 series in order to obtain future fixes.
@@ -371,8 +205,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/17.2.8.html">Mesa 17.2.8</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 17.2.8 will be the final release in the
 17.2 series. Users of 17.2 are encouraged to migrate to the 17.3
 series in order to obtain future fixes.
@@ -431,8 +264,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/17.1.10.html">Mesa 17.1.10</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 17.1.10 will be the final release in the
 17.1 series. Users of 17.1 are encouraged to migrate to the 17.2
 series in order to obtain future fixes.
@@ -503,8 +335,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/17.0.7.html">Mesa 17.0.7</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 17.0.7 will be the final release in the 17.0
 series. Users of 17.0 are encouraged to migrate to the 17.1 series in order
 to obtain future fixes.
@@ -553,8 +384,7 @@ This is a bug-fix release.
 <a href="relnotes/17.0.2.html">Mesa 17.0.2</a> are released.
 
 These are bug-fix releases from the 13.0 and 17.0 branches, respectively.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 13.0.6 will be the final release in the 13.0
 series. Users of 13.0 are encouraged to migrate to the 17.0 series in order
 to obtain future fixes.
@@ -589,8 +419,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/12.0.6.html">Mesa 12.0.6</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: This is an extra release for the 12.0 stable branch, as per developers'
 feedback. It is anticipated that 12.0.6 will be the final release in the 12.0
 series. Users of 12.0 are encouraged to migrate to the 13.0 series in order
@@ -607,8 +436,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/12.0.5.html">Mesa 12.0.5</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 12.0.5 will be the final release in the 12.0
 series. Users of 12.0 are encouraged to migrate to the 13.0 series in order
 to obtain future fixes.
@@ -670,8 +498,7 @@ about the release.
 <a href="relnotes/11.2.2.html">Mesa 11.2.2</a> are released.
 
 These are bug-fix releases from the 11.1 and 11.2 branches, respectively.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 11.1.4 will be the final release in the 11.1.4
 series. Users of 11.1 are encouraged to migrate to the 11.2 series in order
 to obtain future fixes.
@@ -702,8 +529,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/11.0.9.html">Mesa 11.0.9</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 11.0.9 will be the final release in the 11.0
 series. Users of 11.0 are encouraged to migrate to the 11.1 series in order
 to obtain future fixes.
@@ -767,8 +593,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/10.6.9.html">Mesa 10.6.9</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 10.6.9 will be the final release in the 10.6
 series. Users of 10.6 are encouraged to migrate to the 11.0 series in order
 to obtain future fixes.
@@ -839,8 +664,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/10.5.9.html">Mesa 10.5.9</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 10.5.9 will be the final release in the 10.5
 series. Users of 10.5 are encouraged to migrate to the 10.6 series in order
 to obtain future fixes.
@@ -950,8 +774,7 @@ This is a bug-fix release.
 and <a href="relnotes/10.4.2.html">Mesa 10.4.2</a> are released.
 
 These are bug-fix releases from the 10.3 and 10.4 branches, respectively.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 10.3.7 will be the final release in the 10.3
 series. Users of 10.3 are encouraged to migrate to the 10.4 series in order
 to obtain future fixes.
@@ -1002,8 +825,7 @@ This is a bug-fix release.
 and <a href="relnotes/10.3.1.html">Mesa 10.3.1</a> are released.
 
 These are bug-fix releases from the 10.2 and 10.3 branches, respectively.
-</p>
-<p>
+<br>
 NOTE: It is anticipated that 10.2.9 will be the final release in the 10.2
 series. Users of 10.2 are encouraged to migrate to the 10.3 series in order
 to obtain future fixes.
@@ -1115,8 +937,7 @@ This is a bug-fix release.
 <p>
 <a href="relnotes/10.0.5.html">Mesa 10.0.5</a> is released.
 This is a bug-fix release.
-</p>
-<p>
+<br>
 NOTE: Since the 10.1.1 release is being released concurrently, it is
 anticipated that 10.0.5 will be the final release in the 10.0
 series. Users of 10.0 are encouraged to migrate to the 10.1 series in
@@ -1595,7 +1416,7 @@ with a new test that does over 130 tests of the
 shading language and built-in functions.
 </p>
 
-<h2>April 4, 2007</h2>
+<h2>April 2007</h2>
 <p>
 Thomas Hellstr&ouml;m of Tungsten Graphics has written a whitepaper
 describing the new DRI memory management system.
@@ -2048,7 +1869,7 @@ Mesa 5.0.2 has been released.  This is a stable, bug-fix release.
 </pre>
 
 
-<h2>June 8, 2003</h2>
+<h2>June 2003</h2>
 
 <p>
 Mesa's directory tree has been overhauled.
@@ -2425,7 +2246,7 @@ Here's what's new:</p>
 
 <h2>April 29, 2001</h2>
 <p>New Mesa website</p>
-<p>Mark Manning produced the new website. Thanks, Mark!</p>
+<p>Mark Manning produced the new website.<br>Thanks, Mark!</p>
 
 
 <h2>February 14, 2001</h2>
@@ -2544,9 +2365,8 @@ just bug fixes.</p>
 </pre>
 
 <p>Please report any problems with this release ASAP. Bugs should be filed on the
-Mesa3D website at sourceforge.
-</p>
-<p>After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.</p>
+Mesa3D website at sourceforge.<br>
+After 3.2 is wrapped up I hope to release 3.3 beta 1 soon afterward.</p>
 <p>-- Brian</p>
 
 <h2>December 17, 1999</h2>
@@ -2591,27 +2411,21 @@ ftp, and CVS services aren't fully restored yet. Please be patient.</p>
 <p>-Brian</p>
 
 <h2>June 7, 1999</h2>
-<p>RPMS of the nVidia RIVA server can be found at
-<a href="ftp://ftp.mesa3d.org/mesa/misc/nVidia/">
-ftp://ftp.mesa3d.org/mesa/misc/nVidia/</a>.</p>
+<p>RPMS of the nVidia RIVA server can be found at <code>ftp://ftp.mesa3d.org/mesa/misc/nVidia/</code>.</p>
 
 <h2>June 2, 1999</h2>
 <p><a href="https://www.nvidia.com/">nVidia</a> has released some Linux binaries for
 xfree86 3.3.3.1, along with the <b>full source</b>, which includes GLX acceleration
-based on Mesa 3.0. They can be downloaded from
-<a href="https://www.nvidia.com/Products.nsf/htmlmedia/software_drivers.html">
-https://www.nvidia.com/Products.nsf/htmlmedia/software_drivers.html</a>.</p>
+based on Mesa 3.0. They can be downloaded from <code>https://www.nvidia.com/Products.nsf/htmlmedia/software_drivers.html</code>.</p>
 
 <h2>May 24, 1999</h2>
-<p>Beta 2 of Mesa 3.1 has been make available at
-<a href="ftp://ftp.mesa3d.org/mesa/beta/">ftp://ftp.mesa3d.org/mesa/beta/</a>. If you are into the
-quake scene, you may want to try this out, as it contains some optimizations
-specifically in the Q3A rendering path.
+<p>Beta 2 of Mesa 3.1 has been make available at <code>ftp://ftp.mesa3d.org/mesa/beta/</code>.
+If you are into the quake scene, you may want to try this out, as it contains some
+optimizations specifically in the Q3A rendering path.
 
 <h2>May 13, 1999</h2>
 <p>For those interested in the integration of Mesa into XFree86 4.0, Precision Insight
-has posted their lowlevel design documents at
-<a href="http://www.precisioninsight.com">www.precisioninsight.com</a>.</p>
+has posted their lowlevel design documents at <code>http://www.precisioninsight.com</code>.</p>
 
 <h2>May 13, 1999</h2>
 <pre>May 1999 - John Carmack of id Software, Inc. has made a donation of
@@ -2637,11 +2451,11 @@ grateful.
 
 <h2>May 1, 1999</h2>
 <p>John Carmack made an interesting .plan update yesterday:</p>
-<pre>
-I put together a document on optimizing OpenGL drivers for Q3 that should be helpful to the various Linux 3D teams.
-
-http://www.quake3arena.com/news/glopt.html
-</pre>
+<blockquote>
+    <i>"I put together a document on optimizing OpenGL drivers for Q3 that
+    should be helpful to the various Linux 3D teams.</i><br>
+    http://www.quake3arena.com/news/glopt.html"
+</blockquote>
 
 <h2>April 7, 1999</h2>
 <p>Updated the Mesa contributors section and added links to RPM Mesa packages.</p>
@@ -2651,8 +2465,7 @@ http://www.quake3arena.com/news/glopt.html
 
 <h2>February 16, 1999</h2>
 <p><a href="https://www.sgi.com/">SGI</a> releases its
-<a href="http://web.archive.org/web/20040805154836/http://www.sgi.com/software/opensource/glx/download.html">GLX source code</a>.
-</p>
+<a href="https://www.sgi.com/software/opensource/glx/">GLX source code</a>.</p>
 
 <h2>January 22, 1999</h2>
 <p><a href="https://www.mesa3d.org">www.mesa3d.org</a> established</p>

docs/install.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -22,7 +22,6 @@
   <li><a href="#prereq-general">General prerequisites</a>
   <li><a href="#prereq-dri">For DRI and hardware acceleration</a>
   </ul>
-<li><a href="#meson">Building with meson</a>
 <li><a href="#autoconf">Building with autoconf (Linux/Unix/X11)</a>
 <li><a href="#scons">Building with SCons (Windows/Linux)</a>
 <li><a href="#android">Building with AOSP (Android)</a>
@@ -31,17 +30,18 @@
 </ol>
 
 
-<h2 id="prereq-general">1. Prerequisites for building</h2>
+<h1 id="prereq-general">1. Prerequisites for building</h1>
 
-<h3>1.1 General</h3>
+<h2>1.1 General</h2>
 
-<h4>Build system</h4>
+<p>
+Build system.
+</p>
 
 <ul>
-<li><a href="https://mesonbuild.com">meson</a> is required when building on *nix platforms.
-<li>Autoconf was removed in 19.1.0, use meson instead
+<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 meson.)
+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.
@@ -49,7 +49,6 @@ is used when when building ARC.
 </ul>
 
 
-<h4>Compiler</h4>
 <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.
@@ -62,8 +61,9 @@ willing to maintain support for other compiler get in touch.
 </ul>
 
 
-<h4>Third party/extra tools.</h4>
 <p>
+Third party/extra tools.
+<br>
 <strong>Note</strong>: 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>.
@@ -72,21 +72,20 @@ you think you've spotted a bug let developers know by filing a
 
 <ul>
 <li><a href="https://www.python.org/">Python</a> - Python is required.
-When building with scons 2.7 is required.
-When building with meson 3.5 or newer is required.
+Version 2.7 or later should work.
 </li>
 <li><a href="http://www.makotemplates.org/">Python Mako module</a> -
 Python Mako module is required. Version 0.8.0 or later should work.
 </li>
 <li>lex / yacc - for building the Mesa IR and GLSL compiler.
-<p>
+<div>
 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:
 <pre>mingw-get install msys-flex msys-bison</pre>
 For MSVC on Windows, install
 <a href="http://winflexbison.sourceforge.net/">Win flex-bison</a>.
-</p>
+</div>
 </ul>
 <p><strong>Note</strong>: Some versions can be buggy (eg. flex 2.6.2) so do try others if things fail.</p>
 
@@ -112,35 +111,29 @@ the packaging tool used by your distro.
   ... # others
 </pre>
 
-<h2 id="meson">2. Building with meson</h2>
+
+<h1 id="autoconf">2. Building with autoconf (Linux/Unix/X11)</h1>
 
 <p>
-Meson is the latest build system in mesa, it is currently able to build for
-*nix systems like Linux and BSD, and will be able to build for windows as well.
+The primary method to build Mesa on Unix systems is with autoconf.
 </p>
 
 <p>
-The general approach is:
+The general approach is the standard:
 </p>
 <pre>
-  meson builddir/
-  ninja -C builddir/
-  sudo ninja -C builddir/ install
+  ./configure
+  make
+  sudo make install
 </pre>
 <p>
-Please read the <a href="meson.html">detailed meson instructions</a>
-for more information
-</p>
-
-<h2 id="autoconf">3. Building with autoconf (Linux/Unix/X11)</h2>
-
-<p>
-  Autoconf support was removed in Mesa 19.1.0. Please use meson instead.
+But please read the <a href="autoconf.html">detailed autoconf instructions</a>
+for more details.
 </p>
 
 
 
-<h2 id="scons">4. Building with SCons (Windows/Linux)</h2>
+<h1 id="scons">3. Building with SCons (Windows/Linux)</h1>
 
 <p>
 To build Mesa with SCons on Linux or Windows do
@@ -176,7 +169,7 @@ Additional information is available in <a href="README.WIN32">README.WIN32</a>.
 
 
 
-<h2 id="android">5. Building with AOSP (Android)</h2>
+<h1 id="android">4. Building with AOSP (Android)</h1>
 
 <p>
 Currently one can build Mesa for Android as part of the AOSP project, yet
@@ -195,7 +188,7 @@ Android-x86 and/or other resources.
 </p>
 
 
-<h2 id="libs">6. Library Information</h2>
+<h1 id="libs">5. Library Information</h1>
 
 <p>
 When compilation has finished, look in the top-level <code>lib/</code>
@@ -203,17 +196,18 @@ When compilation has finished, look in the top-level <code>lib/</code>
 You'll see a set of library files similar to this:
 </p>
 <pre>
-lrwxrwxrwx    1 brian    users          10 Mar 26 07:53 libGL.so -&gt; libGL.so.1*
-lrwxrwxrwx    1 brian    users          19 Mar 26 07:53 libGL.so.1 -&gt; libGL.so.1.5.060100*
+lrwxrwxrwx    1 brian    users          10 Mar 26 07:53 libGL.so -> libGL.so.1*
+lrwxrwxrwx    1 brian    users          19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100*
 -rwxr-xr-x    1 brian    users     3375861 Mar 26 07:53 libGL.so.1.5.060100*
-lrwxrwxrwx    1 brian    users          14 Mar 26 07:53 libOSMesa.so -&gt; libOSMesa.so.6*
-lrwxrwxrwx    1 brian    users          23 Mar 26 07:53 libOSMesa.so.6 -&gt; libOSMesa.so.6.1.060100*
+lrwxrwxrwx    1 brian    users          14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6*
+lrwxrwxrwx    1 brian    users          23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100*
 -rwxr-xr-x    1 brian    users       23871 Mar 26 07:53 libOSMesa.so.6.1.060100*
 </pre>
 
 <p>
-<b>libGL</b> is the main OpenGL library (i.e. Mesa), while <b>libOSMesa</b>
-is the OSMesa (Off-Screen) interface library.
+<b>libGL</b> is the main OpenGL library (i.e. Mesa).
+<br>
+<b>libOSMesa</b> is the OSMesa (Off-Screen) interface library.
 </p>
 
 <p>
@@ -232,10 +226,10 @@ versions of libGL and device drivers.
 </p>
 
 
-<h2 id="pkg-config">7. Building OpenGL programs with pkg-config</h2>
+<h1 id="pkg-config">6. Building OpenGL programs with pkg-config</h1>
 
 <p>
-Running <code>ninja install</code> will install package configuration files
+Running <code>make install</code> will install package configuration files
 for the pkg-config utility.
 </p>
 
@@ -251,6 +245,8 @@ For example, compiling and linking a GLUT application can be done with:
    gcc `pkg-config --cflags --libs glut` mydemo.c -o mydemo
 </pre>
 
+<br>
+
 </div>
 </body>
 </html>

docs/intro.html

@@ -2,13 +2,13 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Introduction</title>
+  <title>Mesa Introduction</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -50,7 +50,7 @@ systems.
 
 
 
-<h2>Project History</h2>
+<h1>Project History</h1>
 
 <p>
 The Mesa project was originally started by Brian Paul.
@@ -185,7 +185,7 @@ of the OpenGL, OpenGL ES and Vulkan specifications.
 
 
 
-<h2>Major Versions</h2>
+<h1>Major Versions</h1>
 
 <p>
 This is a summary of the major versions of Mesa.
@@ -194,7 +194,7 @@ of the OpenGL specification is implemented.
 </p>
 
 
-<h3>Version 12.x features</h3>
+<h2>Version 12.x features</h2>
 <p>
 Version 12.x of Mesa implements the OpenGL 4.3 API, but not all drivers
 support OpenGL 4.3.
@@ -204,21 +204,21 @@ Initial support for Vulkan is also included.
 </p>
 
 
-<h3>Version 11.x features</h3>
+<h2>Version 11.x features</h2>
 <p>
 Version 11.x of Mesa implements the OpenGL 4.1 API, but not all drivers
 support OpenGL 4.1.
 </p>
 
 
-<h3>Version 10.x features</h3>
+<h2>Version 10.x features</h2>
 <p>
 Version 10.x of Mesa implements the OpenGL 3.3 API, but not all drivers
 support OpenGL 3.3.
 </p>
 
 
-<h3>Version 9.x features</h3>
+<h2>Version 9.x features</h2>
 <p>
 Version 9.x of Mesa implements the OpenGL 3.1 API.
 While the driver for Intel Sandy Bridge and Ivy Bridge is the only
@@ -233,7 +233,7 @@ tracker for OpenCL.
 </p>
 
 
-<h3>Version 8.x features</h3>
+<h2>Version 8.x features</h2>
 <p>
 Version 8.x of Mesa implements the OpenGL 3.0 API.
 The developers at Intel deserve a lot of credit for implementing most
@@ -242,14 +242,14 @@ the i965 driver.
 </p>
 
 
-<h3>Version 7.x features</h3>
+<h2>Version 7.x features</h2>
 <p>
 Version 7.x of Mesa implements the OpenGL 2.1 API.  The main feature
 of OpenGL 2.x is the OpenGL Shading Language.
 </p>
 
 
-<h3>Version 6.x features</h3>
+<h2>Version 6.x features</h2>
 <p>
 Version 6.x of Mesa implements the OpenGL 1.5 API with the following
 extensions incorporated as standard features:
@@ -289,7 +289,7 @@ OpenGL specification</a> for more details.
 
 
 
-<h3>Version 5.x features</h3>
+<h2>Version 5.x features</h2>
 <p>
 Version 5.x of Mesa implements the OpenGL 1.4 API with the following
 extensions incorporated as standard features:
@@ -315,7 +315,7 @@ extensions incorporated as standard features:
 </ul>
 
 
-<h3>Version 4.x features</h3>
+<h2>Version 4.x features</h2>
 
 <p>
 Version 4.x of Mesa implements the OpenGL 1.3 API with the following
@@ -334,7 +334,7 @@ extensions incorporated as standard features:
 <li>GL_ARB_transpose_matrix
 </ul>
 
-<h3>Version 3.x features</h3>
+<h2>Version 3.x features</h2>
 
 <p>
 Version 3.x of Mesa implements the OpenGL 1.2 API with the following
@@ -350,7 +350,7 @@ features:
 </ul>
 
 
-<h3>Version 2.x features</h3>
+<h2>Version 2.x features</h2>
 <p>
 Version 2.x of Mesa implements the OpenGL 1.1 API with the following
 features.

docs/license.html

@@ -2,21 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>License and Copyright</title>
+  <title>License / Copyright Information</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>License and Copyright</h1>
-
-<h2>Disclaimer</h2>
+<h1>Disclaimer</h1>
 
 <p>
 Mesa is a 3-D graphics library with an API which is very similar to
@@ -34,7 +32,7 @@ vendor.
 <p>
 Please do not refer to the library as <em>MesaGL</em> (for legal
 reasons). It's just <em>Mesa</em> or <em>The Mesa 3-D graphics
-library</em>.
+library</em>. <br>
 </p>
 
 <p>
@@ -44,7 +42,7 @@ library</em>.
 
 
 
-<h2>License / Copyright Information</h2>
+<h1>License / Copyright Information</h1>
 
 <p>
 The Mesa distribution consists of several components.  Different copyrights
@@ -84,7 +82,7 @@ SOFTWARE.
 </pre>
 
 
-<h2>Attention, Contributors</h2>
+<h1>Attention, Contributors</h1>
 
 <p>
 When contributing to the Mesa project you must agree to the licensing terms
@@ -94,7 +92,7 @@ and their respective licenses.
 </p>
 
 
-<h2>Mesa Component Licenses</h2>
+<h1>Mesa Component Licenses</h1>
 
 <pre>
 Component         Location               License

docs/lists.html

@@ -2,13 +2,13 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Mailing Lists</title>
+  <title>Mesa Mailing Lists</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -68,14 +68,14 @@ kernels, see the
 </p>
 
 
-<h2>IRC</h2>
+<h1>IRC</h1>
 
 <p>join <a href="irc://chat.freenode.net#dri-devel">#dri-devel channel</a>
 on <a href="https://webchat.freenode.net/">irc.freenode.net</a>
 </p>
 
 
-<h2>OpenGL Forums</h2>
+<h1>OpenGL Forums</h1>
 
 <p>
 Here are some other OpenGL-related forums you might find useful:

docs/llvmpipe.html

@@ -2,21 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Gallium LLVMpipe Driver</title>
+  <title>llvmpipe</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Gallium LLVMpipe Driver</h1>
-
-<h2>Introduction</h2>
+<h1>Introduction</h1>
 
 <p>
 The Gallium llvmpipe driver is a software rasterizer that uses LLVM to
@@ -30,7 +28,7 @@ It's the fastest software rasterizer for Mesa.
 </p>
 
 
-<h2>Requirements</h2>
+<h1>Requirements</h1>
 
 <ul>
 <li>
@@ -47,7 +45,7 @@ It's the fastest software rasterizer for Mesa.
    built with LLVM version 4.0 or later.
    </p>
    <p>
-   See <code>/proc/cpuinfo</code> to know what your CPU supports.
+   See /proc/cpuinfo to know what your CPU supports.
    </p>
 </li>
 <li>
@@ -73,9 +71,8 @@ It's the fastest software rasterizer for Mesa.
 
    <p>
    For Windows you will need to build LLVM from source with MSVC or MINGW
-   (either natively or through cross compilers) and CMake, and set the
-   <code>LLVM</code> environment variable to the directory you installed
-   it to.
+   (either natively or through cross compilers) and CMake, and set the LLVM
+   environment variable to the directory you installed it to.
 
    LLVM will be statically linked, so when building on MSVC it needs to be
    built with a matching CRT as Mesa, and you'll need to pass
@@ -104,8 +101,8 @@ It's the fastest software rasterizer for Mesa.
    </table>
 
    <p>
-   You can build only the x86 target by passing
-   <code>-DLLVM_TARGETS_TO_BUILD=X86</code> to cmake.
+   You can build only the x86 target by passing -DLLVM_TARGETS_TO_BUILD=X86
+   to cmake.
    </p>
 </li>
 
@@ -115,7 +112,7 @@ It's the fastest software rasterizer for Mesa.
 </ul>
 
 
-<h2>Building</h2>
+<h1>Building</h1>
 
 To build everything on Linux invoke scons as:
 
@@ -123,12 +120,10 @@ To build everything on Linux invoke scons as:
   scons build=debug libgl-xlib
 </pre>
 
-Alternatively, you can build it with meson with:
+Alternatively, you can build it with autoconf/make with:
 <pre>
-  mkdir build
-  cd build
-  meson -D glx=gallium-xlib -D gallium-drivers=swrast
-  ninja
+  ./configure --enable-glx=gallium-xlib --with-gallium-drivers=swrast --disable-dri --disable-gbm --disable-egl
+  make
 </pre>
 
 but the rest of these instructions assume that scons is used.
@@ -140,12 +135,11 @@ For Windows the procedure is similar except the target:
 </pre>
 
 
-<h2>Using</h2>
+<h1>Using</h1>
 
-<h3>Linux</h3>
+<h2>Linux</h2>
 
-<p>On Linux, building will create a drop-in alternative for
-<code>libGL.so</code> into</p>
+<p>On Linux, building will create a drop-in alternative for libGL.so into</p>
 
 <pre>
   build/foo/gallium/targets/libgl-xlib/libGL.so
@@ -155,15 +149,13 @@ or
   lib/gallium/libGL.so
 </pre>
 
-<p>To use it set the <code>LD_LIBRARY_PATH</code> environment variable
-accordingly.</p>
+<p>To use it set the LD_LIBRARY_PATH environment variable accordingly.</p>
 
-<p>For performance evaluation pass <code>build=release</code> to scons,
-and use the corresponding lib directory without the <code>-debug</code>
-suffix.</p>
+<p>For performance evaluation pass build=release to scons, and use the corresponding
+lib directory without the "-debug" suffix.</p>
 
 
-<h3>Windows</h3>
+<h2>Windows</h2>
 
 <p>
 On Windows, building will create
@@ -181,9 +173,7 @@ any OpenGL drivers):
 </p>
 
 <ul>
-  <li><p>copy <code>build/windows-x86-debug/gallium/targets/libgl-gdi/opengl32.dll</code>
-         to <code>C:\Windows\SysWOW64\mesadrv.dll</code>
-  </p></li>
+  <li><p>copy build/windows-x86-debug/gallium/targets/libgl-gdi/opengl32.dll to C:\Windows\SysWOW64\mesadrv.dll</p></li>
   <li><p>load this registry settings:</p>
   <pre>REGEDIT4
 
@@ -200,7 +190,7 @@ any OpenGL drivers):
 </ul>
 
 
-<h2>Profiling</h2>
+<h1>Profiling</h1>
 
 <p>
 To profile llvmpipe you should build as
@@ -214,7 +204,7 @@ This will ensure that frame pointers are used both in C and JIT functions, and
 that no tail call optimizations are done by gcc.
 </p>
 
-<h3>Linux perf integration</h3>
+<h2>Linux perf integration</h2>
 
 <p>
 On Linux, it is possible to have symbol resolution of JIT code with <a href="https://perf.wiki.kernel.org/">Linux perf</a>:
@@ -226,28 +216,27 @@ On Linux, it is possible to have symbol resolution of JIT code with <a href="htt
 </pre>
 
 <p>
-When run inside Linux perf, llvmpipe will create a
-<code>/tmp/perf-XXXXX.map</code> file with symbol address table.  It also
-dumps assembly code to <code>/tmp/perf-XXXXX.map.asm</code>, which can be
-used by the <code>bin/perf-annotate-jit.py</code> script to produce
-disassembly of the generated code annotated with the samples.
+When run inside Linux perf, llvmpipe will create a /tmp/perf-XXXXX.map file with
+symbol address table.  It also dumps assembly code to /tmp/perf-XXXXX.map.asm,
+which can be used by the bin/perf-annotate-jit.py script to produce disassembly of
+the generated code annotated with the samples.
 </p>
 
 <p>You can obtain a call graph via
 <a href="https://github.com/jrfonseca/gprof2dot#linux-perf">Gprof2Dot</a>.</p>
 
 
-<h2>Unit testing</h2>
+<h1>Unit testing</h1>
 
 <p>
 Building will also create several unit tests in
-<code>build/linux-???-debug/gallium/drivers/llvmpipe</code>:
+build/linux-???-debug/gallium/drivers/llvmpipe:
 </p>
 
 <ul>
-<li> <code>lp_test_blend</code>: blending
-<li> <code>lp_test_conv</code>: SIMD vector conversion
-<li> <code>lp_test_format</code>: pixel unpacking/packing
+<li> lp_test_blend: blending
+<li> lp_test_conv: SIMD vector conversion
+<li> lp_test_format: pixel unpacking/packing
 </ul>
 
 <p>
@@ -259,31 +248,29 @@ for later analysis, e.g.:
 </pre>
 
 
-<h2>Development Notes</h2>
+<h1>Development Notes</h1>
 
 <ul>
 <li>
   When looking at this code for the first time, start in lp_state_fs.c, and
-  then skim through the <code>lp_bld_*</code> functions called there, and
-  the comments at the top of the <code>lp_bld_*.c</code> functions.
+  then skim through the lp_bld_* functions called there, and the comments
+  at the top of the lp_bld_*.c functions.
 </li>
 <li>
   The driver-independent parts of the LLVM / Gallium code are found in
-  <code>src/gallium/auxiliary/gallivm/</code>.  The filenames and function
-  prefixes need to be renamed from <code>lp_bld_</code> to something else
-  though.
+  src/gallium/auxiliary/gallivm/.  The filenames and function prefixes
+  need to be renamed from "lp_bld_" to something else though.
 </li>
 <li>
   We use LLVM-C bindings for now. They are not documented, but follow the C++
   interfaces very closely, and appear to be complete enough for code
   generation. See 
   <a href="https://npcontemplation.blogspot.com/2008/06/secret-of-llvm-c-bindings.html">
-  this stand-alone example</a>.  See the <code>llvm-c/Core.h</code> file for
-  reference.
+  this stand-alone example</a>.  See the llvm-c/Core.h file for reference.
 </li>
 </ul>
 
-<h2 id="recommended_reading">Recommended Reading</h2>
+<h1 id="recommended_reading">Recommended Reading</h1>
 
 <ul>
   <li>
@@ -319,7 +306,7 @@ for later analysis, e.g.:
       <li><a href="http://www.drdobbs.com/optimizing-pixomatic-for-modern-x86-proc/184405807">Optimizing Pixomatic For Modern x86 Processors</a></li>
       <li><a href="http://www.intel.com/content/www/us/en/architecture-and-technology/64-ia-32-architectures-optimization-manual.html">Intel 64 and IA-32 Architectures Optimization Reference Manual</a></li>
       <li><a href="http://www.agner.org/optimize/">Software optimization resources</a></li>
-      <li><a href="https://software.intel.com/en-us/articles/intel-intrinsics-guide">Intel Intrinsics Guide</a></li>
+      <li><a href="https://software.intel.com/en-us/articles/intel-intrinsics-guide">Intel Intrinsics Guide</a><li>
     </ul>
   </li>
   <li>

docs/mangling.html

@@ -0,0 +1,37 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8">
+  <title>GL Function Name Mangling</title>
+  <link rel="stylesheet" type="text/css" href="mesa.css">
+</head>
+<body>
+
+<div class="header">
+  <h1>The Mesa 3D Graphics Library</h1>
+</div>
+
+<iframe src="contents.html"></iframe>
+<div class="content">
+
+<h1>GL Function Name Mangling</h1>
+
+<p>
+If you want to use both Mesa and another OpenGL library in the same
+application at the same time you may find it useful to compile Mesa with
+<i>name mangling</i>.
+This results in all the Mesa functions being prefixed with
+<b>mgl</b> instead of <b>gl</b>.
+</p>
+
+<p>
+This option is supported only with the autoconf build. To use it add
+--enable-mangling to your configure line.
+</p>
+<pre>
+<code>./configure --enable-mangling ...</code>
+</pre>
+
+</div>
+</body>
+</html>

docs/mesa.css

@@ -3,48 +3,61 @@ body {
 	background-color: #ffffff;
 	font: 14px 'Lucida Grande', Geneva, Arial, Verdana, sans-serif;
 	color: black;
+ 	link: #111188;
 }
 
 h1 {
-	font-size: 24px;
+	font: 24px 'Lucida Grande', Geneva, Arial, Verdana, sans-serif;
 	font-weight: bold;
+	color: black;
 }
 
 h2 {
-	font-size: 18px;
+	font: 18px 'Lucida Grande', Geneva, Arial, Verdana, sans-serif, bold;
 	font-weight: bold;
+	color: black;
 }
 
 code {
 	font-family: monospace;
 	font-size: 10pt;
+	color: black;
 }
 
+
 pre {
+	/*font-family: monospace;*/
 	font-size: 10pt;
-	background-color: #eee;
-	margin-left: 2em;
-	padding: .5em;
+	/*color: black;*/
 }
 
 iframe {
-	width: 19em;
-	height: 80em;
-	border: none;
-	float: left;
+  width: 19em;
+  height: 80em;
+  border: none;
+  float: left;
 }
 
 .content {
-	position: absolute;
-	left: 20em;
-	right: 10px;
-	overflow: hidden;
+  position: absolute;
+  left: 20em;
+  right: 10px;
+  overflow: hidden
 }
 
 .header {
-	background: url('gears.png') 15px no-repeat, black url('gears.png') right no-repeat;
-	padding: 1.75rem;
-	text-align: center;
-	color: white;
-	font: x-large sans-serif;
+  background: black url('gears.png') 15px no-repeat;
+  margin:0;
+  padding: 5px;
+  clear:both;
+}
+
+.header h1 {
+  background: url('gears.png') right no-repeat;
+  color: white;
+  font: x-large sans-serif;
+  text-align: center;
+  height: 50px;
+  margin: 0;
+  padding-top: 30px;
 }

docs/meson.html

@@ -2,119 +2,69 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Compilation and Installation Using Meson</title>
+  <title>Compilation and Installation using Meson</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Compilation and Installation Using Meson</h1>
+<h1>Compilation and Installation using Meson</h1>
 
-<ul>
-  <li><a href="#intro">Introduction</a></li>
-  <li><a href="#basic">Basic Usage</a></li>
-  <li><a href="#advanced">Advanced Usage</a></li>
-  <li><a href="#cross-compilation">Cross-compilation and 32-bit builds</a></li>
-</ul>
+<h2 id="basic">1. Basic Usage</h2>
 
-<h2 id="intro">1. Introduction</h2>
+<p><strong>The Meson build system is generally considered stable and ready
+for production</strong></p>
 
-<p>For general information about Meson see the
-<a href="http://mesonbuild.com/">Meson website</a>.</p>
-
-<p><strong>Mesa's Meson build system is generally considered stable and ready
-for production.</strong></p>
-
-<p>The Meson build of Mesa is tested on Linux, macOS, Cygwin and Haiku, FreeBSD,
+<p>The meson build is tested on Linux, macOS, Cygwin and Haiku, FreeBSD,
 DragonflyBSD, NetBSD, and should work on OpenBSD.</p>
 
-<p>If Meson is not already installed on your system, you can typically
-install it with your package installer.  For example:</p>
-<pre>
-sudo apt-get install meson   # Ubuntu
-</pre>
-or
-<pre>
-sudo dnf install meson   # Fedora
-</pre>
-
-<p><strong>Mesa requires Meson &gt;= 0.45.0 to build.</strong>
+<p><strong>Mesa requires Meson >= 0.45.0 to build.</strong>
 
 Some older versions of meson do not check that they are too old and will error
 out in odd ways.
 </p>
 
-<p>You'll also need <a href="https://ninja-build.org/">Ninja</a>.
-If it's not already installed, use apt-get or dnf to install
-the <em>ninja-build</em> package.
-</p>
-
-<h2 id="basic">2. Basic Usage</h2>
-
 <p>
 The meson program is used to configure the source directory and generates
 either a ninja build file or Visual Studio® build files. The latter must
-be enabled via the <code>--backend</code> switch, as ninja is the default
-backend on all
-operating systems.
-</p>
-
-<p>
-Meson only supports out-of-tree builds, and must be passed a
+be enabled via the <code>--backend</code> switch, as ninja is the default backend on all
+operating systems. Meson only supports out-of-tree builds, and must be passed a
 directory to put built and generated sources into. We'll call that directory
-"build" here.
-It's recommended to create a
-<a href="http://mesonbuild.com/Using-multiple-build-directories.html">
-separate build directory</a> for each configuration you might want to use.
+"build" for examples.
 </p>
 
-
-
-<p>Basic configuration is done with:</p>
-
 <pre>
-meson build/
+    meson build/
 </pre>
 
 <p>
-This will create the build directory.
-If any dependencies are missing, you can install them, or try to remove
-the dependency with a Meson configuration option (see below).
+To see a description of your options you can run <code>meson configure</code>
+along with a build directory to view the selected options for. This will show
+your meson global arguments and project arguments, along with their defaults
+and your local settings.
+
+Meson does not currently support listing options before configure a build
+directory, but this feature is being discussed upstream.
 </p>
 
-<p>
-To review the options which Meson chose, run:
-</p>
 <pre>
-meson configure build/
+    meson configure build/
 </pre>
 
 <p>
-Meson does not currently support listing configuration options before
-running "meson build/" but this feature is being discussed upstream.
-For now, we have a <code>bin/meson-options.py</code> script that prints
-the options for you.
-If that script doesn't work for some reason, you can always look in the
-<a href="https://gitlab.freedesktop.org/mesa/mesa/blob/master/meson_options.txt">
-meson_options.txt</a> file at the root of the project.
-</p>
-
-<p>
-With additional arguments <code>meson configure</code> can be used to change
-options for a previously configured build directory.
-All options passed to this command are in the form
-<code>-D "option"="value"</code>.
-For example:
+With additional arguments <code>meson configure</code> is used to change
+options on already configured build directory. All options passed to this
+command are in the form <code>-D "command"="value"</code>.
 </p>
 
 <pre>
-meson configure build/ -Dprefix=/tmp/install -Dglx=true
+    meson configure build/ -Dprefix=/tmp/install -Dglx=true
 </pre>
 
 <p>
@@ -127,161 +77,72 @@ and brackets to represent an empty list (<code>-D platforms=[]</code>).
 
 <p>
 Once you've run the initial <code>meson</code> command successfully you can use
-your configured backend to build the project in your build directory:
+your configured backend to build the project. With ninja, the -C option can be
+be used to point at a directory to build.
 </p>
 
 <pre>
-ninja -C build/
+    ninja -C build/
 </pre>
 
 <p>
-The next step is to install the Mesa libraries, drivers, etc.
-This also finishes up some final steps of the build process (such as creating
-symbolic links for drivers).  To install:
+Without arguments, it will produce libGL.so and/or several other libraries
+depending on the options you have chosen. Later, if you want to rebuild for a
+different configuration, you should run <code>ninja clean</code> before
+changing the configuration, or create a new out of tree build directory for
+each configuration you want to build
+<a href="http://mesonbuild.com/Using-multiple-build-directories.html">as
+recommended in the documentation</a>
 </p>
 
-<pre>
-ninja -C build/ install
-</pre>
-
 <p>
-Note: autotools automatically updated translation files (used by the DRI
-configuration tool) as part of the build process,
-Meson does not do this.  Instead, you will need do this:
+Autotools automatically updates translation files as part of the build process,
+meson does not do this. Instead if you want translated drirc files you will need 
+to invoke non-default targets for ninja to update them:
+<code>ninja -C build/ xmlpool-pot xmlpool-update-po xmlpool-gmo</code>
 </p>
-<pre>
-ninja -C build/ xmlpool-pot xmlpool-update-po xmlpool-gmo
-</pre>
-
-<h2 id="advanced">3. Advanced Usage</h2>
 
 <dl>
+<dt><code>Environment Variables</code></dt>
+<dd><p>Meson supports the standard CC and CXX environment variables for
+changing the default compiler, and CFLAGS, CXXFLAGS, and LDFLAGS for setting
+options to the compiler and linker during the initial configuration.
 
-<dt>Installation Location</dt>
-<dd>
-<p>
-Meson default to installing libGL.so in your system's main lib/ directory
-and DRI drivers to a dri/ subdirectory.
-</p>
-<p>
-Developers will often want to install Mesa to a testing directory rather
-than the system library directory.
-This can be done with the --prefix option.  For example:
+These arguments are consumed and stored by meson when it is initialized. To
+change these flags after the build is initialized (or when doing a first
+initialization), consider using <code>-D${lang}_args</code> and
+<code>-D${lang}_link_args</code> instead. Meson will never change compiler in a
+configured build directory.
 </p>
+
 <pre>
-meson --prefix="${PWD}/build/install" build/
+    CC=clang CXX=clang++ meson build-clang
+    ninja -C build-clang
+    ninja -C build-clang clean
+    meson configure build -Dc_args="-Wno-typedef-redefinition"
+    ninja -C build-clang
 </pre>
-<p>
-will put the final libraries and drivers into the build/install/
-directory.
-Then you can set LD_LIBRARY_PATH and LIBGL_DRIVERS_PATH to that location
-to run/test the driver.
-</p>
-<p>
-Meson also honors <code>DESTDIR</code> for installs.
-</p>
-</dd>
 
-<dt>Compiler Options</dt>
-<dd>
-<p>Meson supports the common CFLAGS, CXXFLAGS, etc. environment
-variables but their use is discouraged because of the many caveats
-in using them.
-</p>
-<p>Instead, it is recomended to use <code>-D${lang}_args</code> and
-<code>-D${lang}_link_args</code>. Among the benefits of these options
-is that they are guaranteed to persist across rebuilds and reconfigurations.
-</p>
-<p>
-This example sets -fmax-errors for compiling C sources and -DMAGIC=123
-for C++ sources:
-</p>
-<pre>
-meson builddir/ -Dc_args=-fmax-errors=10 -Dcpp_args=-DMAGIC=123
-</pre>
-</dd>
-
-
-<dt>Compiler Specification</dt>
-<dd>
-<p>
-Meson supports the standard CC and CXX environment variables for
-changing the default compiler.  Note that Meson does not allow
-changing the compilers in a configured builddir so you will need
-to create a new build dir for a different compiler.
-</p>
-<p>
-This is an example of specifying the clang compilers and cleaning
-the build directory before reconfiguring with an extra C option:
-</p>
-<pre>
-CC=clang CXX=clang++ meson build-clang
-ninja -C build-clang
-ninja -C build-clang clean
-meson configure build -Dc_args="-Wno-typedef-redefinition"
-ninja -C build-clang
-</pre>
 <p>
 The default compilers depends on your operating system. Meson supports most of
 the popular compilers, a complete list is available
 <a href="http://mesonbuild.com/Reference-tables.html#compiler-ids">here</a>.
 </p>
+
+<p>Meson also honors <code>DESTDIR</code> for installs</p>
 </dd>
 
-<dt>LLVM</dt>
+
+<dt><code>LLVM</code></dt>
 <dd><p>Meson includes upstream logic to wrap llvm-config using its standard
-dependency interface.
-</p></dd>
-
-<dd><p>
-As of meson 0.49.0 meson also has the concept of a
-<a href="https://mesonbuild.com/Native-environments.html">"native file"</a>,
-these files provide information about the native build environment (as opposed
-to a cross build environment). They are ini formatted and can override where to
-find llvm-config:
-</p>
-
-custom-llvm.ini
-<pre>
-    [binaries]
-    llvm-config = '/usr/local/bin/llvm/llvm-config'
-</pre>
-
-Then configure meson:
-
-<pre>
-    meson builddir/ --native-file custom-llvm.ini
-</pre>
-</dd>
-
-<dd><p>
-For selecting llvm-config for cross compiling a
-<a href="https://mesonbuild.com/Cross-compilation.html#defining-the-environment">"cross file"</a>
-should be used. It uses the same format as the native file above:
-</p>
-
-<p>cross-llvm.ini</p>
-<pre>
-    [binaries]
-    ...
-    llvm-config = '/usr/lib/llvm-config-32'
-</pre>
-
-<p>Then configure meson:</p>
-<pre>
-    meson builddir/ --cross-file cross-llvm.ini
-</pre>
-
-See the <a href="#cross-compilation">Cross Compilation</a> section for more information.
-</dd>
-
-<dd><p>
-For older versions of meson <code>$PATH</code> (or <code>%PATH%</code> on
-windows) will be searched for llvm-config (and llvm-config$version and
-llvm-config-$version), you can override this environment variable to control
-the search: <code>PATH=/path/with/llvm-config:$PATH meson build</code>.
+dependency interface. It will search <code>$PATH</code> (or <code>%PATH%</code> on windows) for
+llvm-config (and llvm-config$version and llvm-config-$version), so using an
+LLVM from a non-standard path is as easy as
+<code>PATH=/path/with/llvm-config:$PATH meson build</code>.
 </p></dd>
+</dl>
 
+<dl>
 <dt><code>PKG_CONFIG_PATH</code></dt>
 <dd><p>The
 <code>pkg-config</code> utility is a hard requirement for configuring and
@@ -317,7 +178,9 @@ with debugging as some code and validation will be optimized away.
 buildtype, which causes meson to inject no additional compiler arguments, only
 those in the C/CXXFLAGS and those that mesa itself defines.</p>
 </dd>
+</dl>
 
+<dl>
 <dt><code>-Db_ndebug</code></dt>
 <dd><p>This option controls assertions in meson projects. When set to <code>false</code>
 (the default) assertions are enabled, when set to true they are disabled. This
@@ -327,93 +190,6 @@ is unrelated to the <code>buildtype</code>; setting the latter to
 </dd>
 </dl>
 
-<h2 id="cross-compilation">4. Cross-compilation and 32-bit builds</h2>
-
-<p><a href="https://mesonbuild.com/Cross-compilation.html">Meson supports
-cross-compilation</a> by specifying a number of binary paths and
-settings in a file and passing this file to <code>meson</code> or
-<code>meson configure</code> with the <code>--cross-file</code>
-parameter.</p>
-
-<p>This file can live at any location, but you can use the bare filename
-(without the folder path) if you put it in $XDG_DATA_HOME/meson/cross or
-~/.local/share/meson/cross</p>
-
-<p>Below are a few example of cross files, but keep in mind that you
-will likely have to alter them for your system.</p>
-
-<p>
-Those running on ArchLinux can use the AUR-maintained packages for some
-of those, as they'll have the right values for your system:
-</p>
-<ul>
-  <li><a href="https://aur.archlinux.org/packages/meson-cross-x86-linux-gnu">meson-cross-x86-linux-gnu</a></li>
-  <li><a href="https://aur.archlinux.org/packages/meson-cross-aarch64-linux-gnu">meson-cross-aarch64-linux-gnu</a></li>
-</ul>
-
-<p>
-32-bit build on x86 linux:
-</p>
-<pre>
-[binaries]
-c = '/usr/bin/gcc'
-cpp = '/usr/bin/g++'
-ar = '/usr/bin/gcc-ar'
-strip = '/usr/bin/strip'
-pkgconfig = '/usr/bin/pkg-config-32'
-llvm-config = '/usr/bin/llvm-config32'
-
-[properties]
-c_args = ['-m32']
-c_link_args = ['-m32']
-cpp_args = ['-m32']
-cpp_link_args = ['-m32']
-
-[host_machine]
-system = 'linux'
-cpu_family = 'x86'
-cpu = 'i686'
-endian = 'little'
-</pre>
-
-<p>
-64-bit build on ARM linux:
-</p>
-<pre>
-[binaries]
-c = '/usr/bin/aarch64-linux-gnu-gcc'
-cpp = '/usr/bin/aarch64-linux-gnu-g++'
-ar = '/usr/bin/aarch64-linux-gnu-gcc-ar'
-strip = '/usr/bin/aarch64-linux-gnu-strip'
-pkgconfig = '/usr/bin/aarch64-linux-gnu-pkg-config'
-exe_wrapper = '/usr/bin/qemu-aarch64-static'
-
-[host_machine]
-system = 'linux'
-cpu_family = 'aarch64'
-cpu = 'aarch64'
-endian = 'little'
-</pre>
-
-<p>
-64-bit build on x86 windows:
-</p>
-<pre>
-[binaries]
-c = '/usr/bin/x86_64-w64-mingw32-gcc'
-cpp = '/usr/bin/x86_64-w64-mingw32-g++'
-ar = '/usr/bin/x86_64-w64-mingw32-ar'
-strip = '/usr/bin/x86_64-w64-mingw32-strip'
-pkgconfig = '/usr/bin/x86_64-w64-mingw32-pkg-config'
-exe_wrapper = 'wine'
-
-[host_machine]
-system = 'windows'
-cpu_family = 'x86_64'
-cpu = 'i686'
-endian = 'little'
-</pre>
-
 </div>
 </body>
 </html>

docs/opengles.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -25,7 +25,7 @@ https://www.khronos.org/opengles/</a>.</p>
 
 <h2>Build the Libraries</h2>
 <ol>
-<li>Run <code>meson configure</code> with <code>-D gles1=true -D gles2=true</code> and enable the Gallium driver for your hardware.</li>
+<li>Run <code>configure</code> with <code>--enable-gles1 --enable-gles2</code> and enable the Gallium driver for your hardware.</li>
 <li>Build and install Mesa as usual.</li>
 </ol>
 
@@ -33,7 +33,7 @@ Alternatively, if XCB-DRI2 is installed on the system, one can use
 <code>egl_dri2</code> EGL driver with OpenGL|ES-enabled DRI drivers
 
 <ol>
-<li>Run <code>meson configure</code> with <code>-D gles1=true -D gles2=true</code>.</li>
+<li>Run <code>configure</code> with <code>--enable-gles1 --enable-gles2</code>.</li>
 <li>Build and install Mesa as usual.</li>
 </ol>
 

docs/osmesa.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -45,14 +45,14 @@ The OSMesa interface may be used with any of three software renderers:
 There are several examples of OSMesa in the mesa/demos repository.
 </p>
 
-<h2>Building OSMesa</h2>
+<h1>Building OSMesa</h1>
 
 <p>
 Configure and build Mesa with something like:
 
 <pre>
-meson builddir -Dosmesa=gallium -Dgallium-drivers=swrast -Ddri-drivers= -Dvulkan-drivers= -Dprefix=$PWD/builddir/install
-ninja -C builddir install
+configure --enable-osmesa --disable-driglx-direct --disable-dri --with-gallium-drivers=swrast
+make
 </pre>
 
 <p>
@@ -63,12 +63,13 @@ Make sure you have LLVM installed first if you want to use the llvmpipe driver.
 When the build is complete you should find:
 </p>
 <pre>
-$PWD/builddir/install/lib/libOSMesa.so  (swrast-based OSMesa)
-$PWD/builddir/install/lib/gallium/libOSMsea.so  (gallium-based OSMesa)
+lib/libOSMesa.so  (swrast-based OSMesa)
+lib/gallium/libOSMsea.so  (gallium-based OSMesa)
 </pre>
 
 <p>
-Set your LD_LIBRARY_PATH to point to $PWD/builddir/install to use the libraries
+Set your LD_LIBRARY_PATH to point to one directory or the other to select
+the library you want to use.
 </p>
 
 <p>

docs/perf.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>

docs/postprocess.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -55,6 +55,10 @@ Numbers higher than 8 see minimizing gains.
 <li>pp_celshade - set to 1 to enable cell shading (a more complex color filter).
 </ul>
 
+
+<br>
+<br>
+
 </div>
 </body>
 </html>

docs/precompiled.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -22,14 +22,15 @@ In general, precompiled Mesa libraries are not available.
 <p>
 Some Linux distributions closely follow the latest Mesa releases. On others one
 has to use unofficial channels.
-</p>
-<p>There are some general directions:</p>
+<br>
+There are some general directions:
 <ul>
 <li>Debian/Ubuntu based distros - PPA: xorg-edgers, oibaf and padoka</li>
 <li>Fedora - Corp: erp and che</li>
 <li>OpenSuse/SLES - OBS: X11:XOrg and pontostroy:X11</li>
 <li>Gentoo/Archlinux - officially provided/supported</li>
 </ul>
+</p>
 
 </div>
 </body>

docs/release-calendar.html

@@ -2,53 +2,32 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Release Calendar</title>
+  <title>Release calendar</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Release Calendar</h1>
-
-<h2>Overview</h2>
+<h1>Overview</h1>
 
 <p>
 Mesa provides feature/development and stable releases.
 </p>
-
 <p>
 The table below lists the date and release manager that is expected to do the
 specific release.
-</p>
-
-<p>
-Regular updates will ensure that the schedule for the current and the next two
-feature releases are shown in the table.
-</p>
-
-<p>
-In order to keep the whole releasing team up to date with the tools used, best
-practices and other details, the member in charge of the next feature release
-will be in constant rotation.
-</p>
-
-<p>
-The way the release schedule works is explained
-<a href="releasing.html#schedule" target="_parent">here</a>.
-</p
->
-<p>
+<br>
 Take a look <a href="submittingpatches.html#criteria" target="_parent">here</a>
 if you'd like to nominate a patch in the next stable release.
 </p>
 
-<h2 id="calendar">Calendar</h2>
+<h1 id="calendar">Calendar</h1>
 
 <table border="1">
 
@@ -60,79 +39,47 @@ if you'd like to nominate a patch in the next stable release.
 <th>Notes</th>
 </tr>
 <tr>
-<td rowspan="4">19.1</td>
-<td>2019-08-06</td>
-<td>19.1.4</td>
+<td rowspan="3">18.2</td>
+<td>2018-11-14</td>
+<td>18.2.5</td>
 <td>Juan A. Suarez</td>
-<td>
+<td/>
 </tr>
 <tr>
-<td>2019-08-20</td>
-<td>19.1.5</td>
+<td>2018-11-28</td>
+<td>18.2.6</td>
 <td>Juan A. Suarez</td>
-<td>
+<td/>
 </tr>
 <tr>
-<td>2019-09-03</td>
-<td>19.1.6</td>
+<td>2018-12-12</td>
+<td>18.2.7</td>
 <td>Juan A. Suarez</td>
-<td>
+<td>Last planned 18.2.x release</td>
 </tr>
-<tr>
-<td>2019-09-17</td>
-<td>19.1.7</td>
-<td>Juan A. Suarez</td>
-<td>Last planned 19.1.x release</td>
-</tr>
-<tr>
-<td rowspan="4">19.2</td>
-<td>2019-08-06</td>
-<td>19.2.0-rc1</td>
+<td rowspan="4">18.3</td>
+<td>2018-10-31</td>
+<td>18.3.0-rc1</td>
 <td>Emil Velikov</td>
-<td>
+<td></td>
 </tr>
 <tr>
-<td>2019-08-13</td>
-<td>19.2.0-rc2</td>
+<td>2018-11-07</td>
+<td>18.3.0-rc2</td>
 <td>Emil Velikov</td>
-<td>
+<td/>
 </tr>
 <tr>
-<td>2019-08-20</td>
-<td>19.2.0-rc3</td>
+<td>2018-11-14</td>
+<td>18.3.0-rc3</td>
 <td>Emil Velikov</td>
-<td>
+<td/>
 </tr>
 <tr>
-<td>2019-08-27</td>
-<td>19.2.0-rc4</td>
+<td>2018-11-21</td>
+<td>18.3.0-rc4</td>
 <td>Emil Velikov</td>
-<td>Last planned RC/Final release</td>
-</tr>
-<tr>
-<td rowspan="4">19.3</td>
-<td>2019-10-15</td>
-<td>19.3.0-rc1</td>
-<td>Dylan Baker</td>
-<td>
-</tr>
-<tr>
-<td>2019-10-22</td>
-<td>19.3.0-rc2</td>
-<td>Dylan Baker</td>
-<td>
-</tr>
-<tr>
-<td>2019-10-29</td>
-<td>19.3.0-rc3</td>
-<td>Dylan Baker</td>
-<td>
-</tr>
-<tr>
-<td>2019-11-05</td>
-<td>19.3.0-rc4</td>
-<td>Dylan Baker</td>
-<td>Last planned RC/Final release</td>
+<td>Last planned RC/final release</td>
 </tr>
 </table>
 

docs/releasing.html

@@ -2,20 +2,20 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Releasing Process</title>
+  <title>Releasing process</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
 
-<h1>Releasing Process</h1>
+<h1>Releasing process</h1>
 
 <ul>
 <li><a href="#overview">Overview</a>
@@ -31,14 +31,12 @@
 </ul>
 
 
-<h2 id="overview">Overview</h2>
+<h1 id="overview">Overview</h1>
 
 <p>
 This document uses the convention X.Y.Z for the release number with X.Y being
 the stable branch name.
-</p>
-
-<p>
+<br>
 Mesa provides feature and bugfix releases. Former use zero as patch version (Z),
 while the latter have a non-zero one.
 </p>
@@ -54,16 +52,13 @@ For example:
 </pre>
 
 
-<h2 id="schedule">Release schedule</h2>
+<h1 id="schedule">Release schedule</h1>
 
 <p>
 Releases should happen on Wednesdays. Delays can occur although those
-should be kept to a minimum.
-</p>
-
-<p>
-See our <a href="release-calendar.html" target="_parent">calendar</a>
-for information about how the release schedule is planned, and the
+should be keep to a minimum.
+<br>
+See our <a href="release-calendar.html" target="_parent">calendar</a> for the
 date and other details for individual releases.
 </p>
 
@@ -72,9 +67,6 @@ date and other details for individual releases.
 <li>Available approximately every three months.
 <li>Initial timeplan available 2-4 weeks before the planned branchpoint (rc1)
 on the mesa-announce@ mailing list.
-<li>Typically, the final release will happen after 4
-candidates. Additional ones may be needed in order to resolve blocking
-regressions, though.
 <li>A <a href="#prerelease">pre-release</a> announcement should be available
 approximately 24 hours before the final (non-rc) release.
 </ul>
@@ -89,23 +81,13 @@ approximately 48 hours before the actual release.
 
 <p>
 Note: There is one or two releases overlap when changing branches. For example:
-</p>
-
-<p>
+<br>
 The final release from the 12.0 series Mesa 12.0.5 will be out around the same
 time (or shortly after) 13.0.1 is out.
 </p>
 
-<p>
-This also involves that, as a final release may be delayed due to the
-need of additional candidates to solve some blocking regression(s),
-the release manager might have to update
-the <a href="release-calendar.html" target="_parent">calendar</a> with
-additional bug fix releases of the current stable branch.
-</p>
 
-
-<h2 id="pickntest">Cherry-picking and testing</h2>
+<h1 id="pickntest">Cherry-picking and testing</h1>
 
 <p>
 Commits nominated for the active branch are picked as based on the
@@ -122,7 +104,7 @@ a casual search for terms such as regression, fix, broken and similar.
 
 <p>
 Maintainer is also responsible for testing in various possible permutations of
-the meson and scons build.
+the autoconf and scons build.
 </p>
 
 <h2>Cherry-picking and build/check testing</h2>
@@ -130,21 +112,18 @@ the meson and scons build.
 <p>Done continuously up-to the <a href="#prerelease">pre-release</a> announcement.</p>
 
 <p>
-Developers can request, <em>as an exception</em>, patches to be applied up-to
-the last one hour before the actual release. This is made <strong>only</strong>
-with explicit permission/request, and the patch <strong>must</strong> be very
-well contained. Thus it cannot affect more than one driver/subsystem.
+As an exception, patches can be applied up-to the last ~1h before the actual
+release. This is made <strong>only</strong> with explicit permission/request,
+and the patch <strong>must</strong> be very well contained. Thus it cannot
+affect more than one driver/subsystem.
 </p>
 
-<p>Following developers have requested permanent exception</p>
-<ul>
-<li><em>Ilia Mirkin</em>
-<li><em>AMD team</em>
-</ul>
+<p>
+Currently Ilia Mirkin and AMD devs have requested "permanent" exception.
+</p>
 
-<p>The following must pass:</p>
 <ul>
-<li>meson test, scons and scons check
+<li>make distcheck, scons and scons check must pass
 <li>Testing with different version of system components - LLVM and others is also
 performed where possible.
 <li>As a general rule, testing with various combinations of configure
@@ -152,9 +131,9 @@ switches, depending on the specific patchset.
 </ul>
 
 <p>
-These are achieved by combination of <a href="basictesting">local testing</a>,
-which includes mingw-w64 cross compilation and AppVeyor plus Travis-CI, the
-latter two as part of their Github integration.
+Achieved by combination of local ad-hoc scripts, mingw-w64 cross
+compilation and AppVeyor plus Travis-CI, the latter as part of their
+Github integration.
 </p>
 
 <p>
@@ -175,8 +154,9 @@ good contact point.
 
 <p>
 <strong>Note:</strong> If a patch in the current queue needs any additional
-fix(es), then they should be squashed together. The commit messages and the
-&quot;<code>cherry picked from</code>&quot;-tags must be preserved.
+fix(es), then they should be squashed together.
+<br>
+The commit messages and the <code>cherry picked from</code> tags must be preserved.
 </p>
 
 <p>
@@ -230,7 +210,7 @@ system and making some every day's use until the release may be a good
 idea too.
 </p>
 
-<h2 id="stagingbranch">Staging branch</h2>
+<h1 id="stagingbranch">Staging branch</h1>
 
 <p>
 A live branch, which contains the currently merge/rejected patches is available
@@ -245,12 +225,12 @@ in the main repository under <code>staging/X.Y</code>. For example:
 Notes:
 </p>
 <ul>
-<li>People are encouraged to test the staging branch and report regressions.</li>
+<li>People are encouraged to test the branch and report regressions.</li>
 <li>The branch history is not stable and it <strong>will</strong> be rebased,</li>
 </ul>
 
 
-<h2 id="branch">Making a branchpoint</h2>
+<h1 id="branch">Making a branchpoint</h1>
 
 <p>
 A branchpoint is made such that new development can continue in parallel to
@@ -258,9 +238,10 @@ stabilisation and bugfixing.
 </p>
 
 <p>
-Note: Before doing a branch ensure that basic build and <code>meson test</code>
-testing is done and there are little to-no issues. Ideally all of those should
-be tackled already.
+Note: Before doing a branch ensure that basic build and <code>make check</code>
+testing is done and there are little to-no issues.
+<br>
+Ideally all of those should be tackled already.
 </p>
 
 <p>
@@ -299,15 +280,14 @@ Proceed to <a href="#release">release</a> -rc1.
 </p>
 
 
-<h2 id="prerelease">Pre-release announcement</h2>
+<h1 id="prerelease">Pre-release announcement</h1>
 
 <p>
 It comes shortly after outstanding patches in the respective branch are pushed.
 Developers can check, in brief, what's the status of their patches. They,
 alongside very early testers, are strongly encouraged to test the branch and
 report any regressions.
-</p>
-<p>
+<br>
 It is followed by a brief period (normally 24 or 48 hours) before the actual
 release is made.
 </p>
@@ -337,8 +317,10 @@ Barring reported regressions or objections from developers.
 <p>
 Patch does not fit the
 <a href="submittingpatches.html#criteria" target="_parent">criteria</a> and
-is followed by a brief information. The release maintainer is human so if you
-believe you've spotted a mistake do let them know.
+is followed by a brief information.
+<br>
+The release maintainer is human so if you believe you've spotted a mistake do
+let them know.
 </p>
 
 <h2>Format/template</h2>
@@ -450,7 +432,7 @@ Reason: The patch was reverted shortly after it was merged.
 </pre>
 
 
-<h2 id="release">Making a new release</h2>
+<h1 id="release">Making a new release</h1>
 
 <p>
 These are the instructions for making a new Mesa release.
@@ -463,7 +445,7 @@ Ensure the latest code is available - both in your local master and the
 relevant branch.
 </p>
 
-<h3 id="basictesting">Perform basic testing</h3>
+<h3>Perform basic testing</h3>
 
 <p>
 Most of the testing should already be done during the
@@ -473,48 +455,96 @@ So we do a quick 'touch test'
 </p>
 
 <ul>
-<li>meson dist
+<li>make distcheck (you can omit this if you're not using --dist below)
 <li>scons (from release tarball)
 <li>the produced binaries work
 </ul>
 
 <p>
-  Here is one solution:
+Here is one solution that I've been using.
 </p>
 
 <pre>
-    __glxgears_cmd='glxgears 2&gt;&amp;1 | grep -v "configuration file"'
-    __es2info_cmd='es2_info 2&gt;&amp;1 | egrep "GL_VERSION|GL_RENDERER|.*dri\.so"'
-    __es2gears_cmd='es2gears_x11 2&gt;&amp;1 | grep -v "configuration file"'
-    test "x$LD_LIBRARY_PATH" != 'x' &amp;&amp; __old_ld="$LD_LIBRARY_PATH"
-    export LD_LIBRARY_PATH=`pwd`/test/usr/local/lib/:"${__old_ld}"
-    export LIBGL_DRIVERS_PATH=`pwd`/test/usr/local/lib/dri/
-    export LIBGL_DEBUG=verbose
-    eval $__glxinfo_cmd
-    eval $__glxgears_cmd
-    eval $__es2info_cmd
-    eval $__es2gears_cmd
-    export LIBGL_ALWAYS_SOFTWARE=true
-    eval $__glxinfo_cmd
-    eval $__glxgears_cmd
-    eval $__es2info_cmd
-    eval $__es2gears_cmd
-    export LIBGL_ALWAYS_SOFTWARE=true
-    export GALLIUM_DRIVER=softpipe
-    eval $__glxinfo_cmd
-    eval $__glxgears_cmd
-    eval $__es2info_cmd
-    eval $__es2gears_cmd
-    # Smoke test DOTA2
-    unset LD_LIBRARY_PATH
-    test "x$__old_ld" != 'x' &amp;&amp; export LD_LIBRARY_PATH="$__old_ld" &amp;&amp; unset __old_ld
-    unset LIBGL_DRIVERS_PATH
-    unset LIBGL_DEBUG
-    unset LIBGL_ALWAYS_SOFTWARE
-    unset GALLIUM_DRIVER
-    export VK_ICD_FILENAMES=`pwd`/src/intel/vulkan/dev_icd.json
-    steam steam://rungameid/570  -vconsole -vulkan
-    unset VK_ICD_FILENAMES
+	# Set MAKEFLAGS if you haven't already
+	git clean -fXd; git clean -nxd
+	read # quick cross check any outstanding files
+	export __version=`cat VERSION`
+	export __mesa_root=../
+	export __build_root=./foo
+	chmod 755 -fR $__build_root; rm -rf $__build_root
+	mkdir -p $__build_root &amp;&amp; cd $__build_root
+
+	# For the native builds - such as distcheck, scons, sanity test, you
+	# may want to specify which LLVM to use:
+	# export LLVM_CONFIG=/usr/lib/llvm-3.9/bin/llvm-config
+
+	# Do a full distcheck
+	$__mesa_root/autogen.sh &amp;&amp; make distcheck
+
+	# Build check the tarballs (scons, linux)
+	tar -xaf mesa-$__version.tar.xz &amp;&amp; cd mesa-$__version
+	scons
+	cd .. &amp;&amp; rm -rf mesa-$__version
+
+	# Build check the tarballs (scons, windows/mingw)
+	# Temporary drop LLVM_CONFIG, unless you have a Windows/mingw one.
+	# save_LLVM_CONFIG=`echo $LLVM_CONFIG`; unset LLVM_CONFIG
+	tar -xaf mesa-$__version.tar.xz &amp;&amp; cd mesa-$__version
+	scons platform=windows toolchain=crossmingw
+	cd .. &amp;&amp; rm -rf mesa-$__version
+
+	# Test the automake binaries
+	# Restore LLVM_CONFIG, if applicable:
+	# export LLVM_CONFIG=`echo $save_LLVM_CONFIG`; unset save_LLVM_CONFIG
+	tar -xaf mesa-$__version.tar.xz &amp;&amp; cd mesa-$__version
+	./configure \
+		--with-dri-drivers=i965,swrast \
+		--with-gallium-drivers=swrast \
+		--with-vulkan-drivers=intel \
+		--enable-llvm-shared-libs \
+		--enable-llvm \
+		--enable-glx-tls \
+		--enable-gbm \
+		--enable-egl \
+		--with-platforms=x11,drm,wayland,surfaceless
+	make &amp;&amp; DESTDIR=`pwd`/test make install
+
+	# Drop LLVM_CONFIG, if applicable:
+	# unset LLVM_CONFIG
+
+	__glxinfo_cmd='glxinfo 2&gt;&amp;1 | egrep -o "Mesa.*|Gallium.*|.*dri\.so"'
+	__glxgears_cmd='glxgears 2&gt;&amp;1 | grep -v "configuration file"'
+	__es2info_cmd='es2_info 2&gt;&amp;1 | egrep "GL_VERSION|GL_RENDERER|.*dri\.so"'
+	__es2gears_cmd='es2gears_x11 2&gt;&amp;1 | grep -v "configuration file"'
+	test "x$LD_LIBRARY_PATH" != 'x' &amp;&amp; __old_ld="$LD_LIBRARY_PATH"
+	export LD_LIBRARY_PATH=`pwd`/test/usr/local/lib/:"${__old_ld}"
+	export LIBGL_DRIVERS_PATH=`pwd`/test/usr/local/lib/dri/
+	export LIBGL_DEBUG=verbose
+	eval $__glxinfo_cmd
+	eval $__glxgears_cmd
+	eval $__es2info_cmd
+	eval $__es2gears_cmd
+	export LIBGL_ALWAYS_SOFTWARE=true
+	eval $__glxinfo_cmd
+	eval $__glxgears_cmd
+	eval $__es2info_cmd
+	eval $__es2gears_cmd
+	export LIBGL_ALWAYS_SOFTWARE=true
+	export GALLIUM_DRIVER=softpipe
+	eval $__glxinfo_cmd
+	eval $__glxgears_cmd
+	eval $__es2info_cmd
+	eval $__es2gears_cmd
+	# Smoke test DOTA2
+	unset LD_LIBRARY_PATH
+	test "x$__old_ld" != 'x' &amp;&amp; export LD_LIBRARY_PATH="$__old_ld" &amp;&amp; unset __old_ld
+	unset LIBGL_DRIVERS_PATH
+	unset LIBGL_DEBUG
+	unset LIBGL_ALWAYS_SOFTWARE
+	unset GALLIUM_DRIVER
+	export VK_ICD_FILENAMES=`pwd`/src/intel/vulkan/dev_icd.json
+	steam steam://rungameid/570  -vconsole -vulkan
+	unset VK_ICD_FILENAMES
 </pre>
 
 <h3>Update version in file VERSION</h3>
@@ -604,7 +634,7 @@ docs/release-calendar.html. Then commit and push:
 </pre>
 
 
-<h2 id="announce">Announce the release</h2>
+<h1 id="announce">Announce the release</h1>
 
 <p>
 Use the generated template during the releasing process.
@@ -616,7 +646,7 @@ series, if that is the case.
 </p>
 
 
-<h2 id="website">Update the mesa3d.org website</h2>
+<h1 id="website">Update the mesa3d.org website</h1>
 
 <p>
 As the hosting was moved to freedesktop, git hooks are deployed to update the
@@ -624,12 +654,14 @@ website. Manually check that it is updated 5-10 minutes after the final <code>gi
 </p>
 
 
-<h2 id="bugzilla">Update Bugzilla</h2>
+<h1 id="bugzilla">Update Bugzilla</h1>
 
 <p>
 Parse through the bugreports as listed in the docs/relnotes/X.Y.Z.html
-document. If there's outstanding action, close the bug referencing the commit
-ID which addresses the bug and mention the Mesa version that has the fix.
+document.
+<br>
+If there's outstanding action, close the bug referencing the commit ID which
+addresses the bug and mention the Mesa version that has the fix.
 </p>
 
 <p>

docs/relnotes.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="contents.html"></iframe>
@@ -21,30 +21,6 @@ The release notes summarize what's new or changed in each Mesa release.
 </p>
 
 <ul>
-<li><a href="relnotes/19.1.3.html">19.1.3 release notes</a>
-<li><a href="relnotes/19.1.2.html">19.1.2 release notes</a>
-<li><a href="relnotes/19.0.8.html">19.0.8 release notes</a>
-<li><a href="relnotes/19.1.1.html">19.1.1 release notes</a>
-<li><a href="relnotes/19.0.7.html">19.0.7 release notes</a>
-<li><a href="relnotes/19.1.0.html">19.1.0 release notes</a>
-<li><a href="relnotes/19.0.6.html">19.0.6 release notes</a>
-<li><a href="relnotes/19.0.5.html">19.0.5 release notes</a>
-<li><a href="relnotes/19.0.4.html">19.0.4 release notes</a>
-<li><a href="relnotes/19.0.3.html">19.0.3 release notes</a>
-<li><a href="relnotes/19.0.2.html">19.0.2 release notes</a>
-<li><a href="relnotes/18.3.6.html">18.3.6 release notes</a>
-<li><a href="relnotes/19.0.1.html">19.0.1 release notes</a>
-<li><a href="relnotes/18.3.5.html">18.3.5 release notes</a>
-<li><a href="relnotes/19.0.0.html">19.0.0 release notes</a>
-<li><a href="relnotes/18.3.4.html">18.3.4 release notes</a>
-<li><a href="relnotes/18.3.3.html">18.3.3 release notes</a>
-<li><a href="relnotes/18.3.2.html">18.3.2 release notes</a>
-<li><a href="relnotes/18.2.8.html">18.2.8 release notes</a>
-<li><a href="relnotes/18.2.7.html">18.2.7 release notes</a>
-<li><a href="relnotes/18.3.1.html">18.3.1 release notes</a>
-<li><a href="relnotes/18.3.0.html">18.3.0 release notes</a>
-<li><a href="relnotes/18.2.6.html">18.2.6 release notes</a>
-<li><a href="relnotes/18.2.5.html">18.2.5 release notes</a>
 <li><a href="relnotes/18.2.4.html">18.2.4 release notes</a>
 <li><a href="relnotes/18.2.3.html">18.2.3 release notes</a>
 <li><a href="relnotes/18.2.2.html">18.2.2 release notes</a>

docs/relnotes/10.0.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.0.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.0.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.0.4.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.0.5.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.0.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.4.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.5.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.6.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.4.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.5.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.6.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.7.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.8.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.9.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>
@@ -69,15 +69,14 @@ TBD.
 <h2>Changes</h2>
 
 <ul>
-<li>Renamed <i>--with-llvm-shared-libs</i> to <i>--enable-llvm-shared-libs</i>
+<li>Renamed <i>--with-llvm-shared-libs</i> to <i>--enable-llvm-shared-libs</i></li>
 <p>
 The option is used to control how mesa is linked against LLVM, and now
 defaults to enabled (shared linking).
 </p>
-</li>
 
 <li>Split <i>libxatracker.so</i> into a standalone library which can be used
-with any gallium driver.
+with any gallium driver.</li>
 <p>
 Previously the library was linked statically against vmware's virtual gpu
 driver(svga), whereas now it loads a shared pipe_*.so driver. Provide the
@@ -89,7 +88,6 @@ following options during configure, if you would like support for svga driver
 Note: The files are installed in $(libdir)/gallium-pipe/ and the interface
 between them and libxatracker.so is <strong>not</strong> stable.
 </p>
-</li>
 
 <li>The environment variable GALLIUM_MSAA that forced a multisample GLX visual was removed.</li>
 </ul>

docs/relnotes/10.3.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.4.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.5.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.6.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.7.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>
@@ -327,7 +327,7 @@ DRM drivers that don't have a full-fledged GEM (such as qxl or simpledrm)</li>
 <li>Removed support for the GL_ATI_envmap_bumpmap extension</li>
 <li>The hacky --enable-32/64-bit is no longer available in configure. To build
 32/64 bit mesa refer to the default method recommended by your distribution</li>
-<li>The environment variable GALLIUM_MSAA that forced a multisample GLX visual was removed.</li>
+</li>The environment variable GALLIUM_MSAA that forced a multisample GLX visual was removed.</li>
 </ul>
 
 </div>

docs/relnotes/10.4.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.4.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.5.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.6.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.7.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.4.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.5.0.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.5.1.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.5.2.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>

docs/relnotes/10.5.3.html

@@ -8,7 +8,7 @@
 <body>
 
 <div class="header">
-  The Mesa 3D Graphics Library
+  <h1>The Mesa 3D Graphics Library</h1>
 </div>
 
 <iframe src="../contents.html"></iframe>