[Mesa-dev] [PATCH v2 06/15] docs: Add results of script - pandoc-generated rst pages.
Laura Ekstrand
laura at jlekstrand.net
Wed May 30 22:53:18 UTC 2018
---
docs/application-issues.rst | 90 +-
docs/autoconf.rst | 406 ++-
docs/bugs.rst | 75 +-
docs/codingstyle.rst | 244 +-
docs/conform.rst | 1343 +++++-----
docs/debugging.rst | 66 +-
docs/developers.rst | 63 +-
docs/devinfo.rst | 103 +-
docs/dispatch.rst | 510 ++--
docs/download.rst | 130 +-
docs/egl.rst | 311 +--
docs/envvars.rst | 746 +++---
docs/extensions.rst | 80 +-
docs/faq.rst | 614 ++---
docs/helpwanted.rst | 110 +-
docs/index.rst | 4365 ++++++++++++++++----------------
docs/install.rst | 335 ++-
docs/intro.rst | 609 ++---
docs/license.rst | 163 +-
docs/lists.rst | 129 +-
docs/llvmpipe.rst | 519 ++--
docs/mangling.rst | 32 +-
docs/meson.rst | 301 +--
docs/opengles.rst | 85 +-
docs/osmesa.rst | 82 +-
docs/perf.rst | 112 +-
docs/postprocess.rst | 75 +-
docs/precompiled.rst | 35 +-
docs/release-calendar.rst | 218 +-
docs/releasing.rst | 877 +++----
docs/relnotes.rst | 482 ++--
docs/relnotes/10.0.1.rst | 192 +-
docs/relnotes/10.0.2.rst | 211 +-
docs/relnotes/10.0.3.rst | 307 ++-
docs/relnotes/10.0.4.rst | 331 ++-
docs/relnotes/10.0.5.rst | 235 +-
docs/relnotes/10.0.rst | 254 +-
docs/relnotes/10.1.1.rst | 434 ++--
docs/relnotes/10.1.2.rst | 323 ++-
docs/relnotes/10.1.3.rst | 107 +-
docs/relnotes/10.1.4.rst | 119 +-
docs/relnotes/10.1.5.rst | 124 +-
docs/relnotes/10.1.6.rst | 176 +-
docs/relnotes/10.1.rst | 90 +-
docs/relnotes/10.2.1.rst | 72 +-
docs/relnotes/10.2.2.rst | 261 +-
docs/relnotes/10.2.3.rst | 158 +-
docs/relnotes/10.2.4.rst | 214 +-
docs/relnotes/10.2.5.rst | 340 ++-
docs/relnotes/10.2.6.rst | 205 +-
docs/relnotes/10.2.7.rst | 346 ++-
docs/relnotes/10.2.8.rst | 167 +-
docs/relnotes/10.2.9.rst | 121 +-
docs/relnotes/10.2.rst | 121 +-
docs/relnotes/10.3.1.rst | 229 +-
docs/relnotes/10.3.2.rst | 147 +-
docs/relnotes/10.3.3.rst | 378 ++-
docs/relnotes/10.3.4.rst | 132 +-
docs/relnotes/10.3.5.rst | 110 +-
docs/relnotes/10.3.6.rst | 155 +-
docs/relnotes/10.3.7.rst | 118 +-
docs/relnotes/10.3.rst | 681 ++---
docs/relnotes/10.4.1.rst | 120 +-
docs/relnotes/10.4.2.rst | 161 +-
docs/relnotes/10.4.3.rst | 257 +-
docs/relnotes/10.4.4.rst | 115 +-
docs/relnotes/10.4.5.rst | 146 +-
docs/relnotes/10.4.6.rst | 182 +-
docs/relnotes/10.4.7.rst | 172 +-
docs/relnotes/10.4.rst | 504 ++--
docs/relnotes/10.5.0.rst | 406 +--
docs/relnotes/10.5.1.rst | 379 ++-
docs/relnotes/10.5.2.rst | 160 +-
docs/relnotes/10.5.3.rst | 162 +-
docs/relnotes/10.5.4.rst | 165 +-
docs/relnotes/10.5.5.rst | 116 +-
docs/relnotes/10.5.6.rst | 187 +-
docs/relnotes/10.5.7.rst | 134 +-
docs/relnotes/10.5.8.rst | 130 +-
docs/relnotes/10.5.9.rst | 194 +-
docs/relnotes/10.6.0.rst | 672 ++---
docs/relnotes/10.6.1.rst | 134 +-
docs/relnotes/10.6.2.rst | 283 +--
docs/relnotes/10.6.3.rst | 124 +-
docs/relnotes/10.6.4.rst | 181 +-
docs/relnotes/10.6.5.rst | 153 +-
docs/relnotes/10.6.6.rst | 224 +-
docs/relnotes/10.6.7.rst | 87 +-
docs/relnotes/10.6.8.rst | 162 +-
docs/relnotes/10.6.9.rst | 161 +-
docs/relnotes/11.0.0.rst | 512 ++--
docs/relnotes/11.0.1.rst | 166 +-
docs/relnotes/11.0.2.rst | 104 +-
docs/relnotes/11.0.3.rst | 297 +--
docs/relnotes/11.0.4.rst | 256 +-
docs/relnotes/11.0.5.rst | 238 +-
docs/relnotes/11.0.6.rst | 179 +-
docs/relnotes/11.0.7.rst | 252 +-
docs/relnotes/11.0.8.rst | 357 ++-
docs/relnotes/11.0.9.rst | 160 +-
docs/relnotes/11.1.0.rst | 559 +++--
docs/relnotes/11.1.1.rst | 345 ++-
docs/relnotes/11.1.2.rst | 271 +-
docs/relnotes/11.1.3.rst | 519 ++--
docs/relnotes/11.1.4.rst | 272 +-
docs/relnotes/11.2.0.rst | 589 ++---
docs/relnotes/11.2.1.rst | 138 +-
docs/relnotes/11.2.2.rst | 317 ++-
docs/relnotes/12.0.0.rst | 676 ++---
docs/relnotes/12.0.1.rst | 75 +-
docs/relnotes/12.0.2.rst | 763 +++---
docs/relnotes/12.0.3.rst | 82 +-
docs/relnotes/12.0.4.rst | 547 ++--
docs/relnotes/12.0.5.rst | 177 +-
docs/relnotes/12.0.6.rst | 219 +-
docs/relnotes/13.0.0.rst | 617 ++---
docs/relnotes/13.0.1.rst | 323 ++-
docs/relnotes/13.0.2.rst | 328 ++-
docs/relnotes/13.0.3.rst | 307 ++-
docs/relnotes/13.0.4.rst | 379 ++-
docs/relnotes/13.0.5.rst | 381 ++-
docs/relnotes/13.0.6.rst | 505 ++--
docs/relnotes/17.0.0.rst | 548 +++--
docs/relnotes/17.0.1.rst | 374 ++-
docs/relnotes/17.0.2.rst | 286 +--
docs/relnotes/17.0.3.rst | 268 +-
docs/relnotes/17.0.4.rst | 208 +-
docs/relnotes/17.0.5.rst | 243 +-
docs/relnotes/17.0.6.rst | 325 ++-
docs/relnotes/17.0.7.rst | 187 +-
docs/relnotes/17.1.0.rst | 433 ++--
docs/relnotes/17.1.1.rst | 305 +--
docs/relnotes/17.1.10.rst | 269 +-
docs/relnotes/17.1.2.rst | 339 ++-
docs/relnotes/17.1.3.rst | 208 +-
docs/relnotes/17.1.4.rst | 342 ++-
docs/relnotes/17.1.5.rst | 299 +--
docs/relnotes/17.1.6.rst | 396 ++-
docs/relnotes/17.1.7.rst | 193 +-
docs/relnotes/17.1.8.rst | 138 +-
docs/relnotes/17.1.9.rst | 184 +-
docs/relnotes/17.2.0.rst | 409 +--
docs/relnotes/17.2.1.rst | 339 ++-
docs/relnotes/17.2.2.rst | 328 ++-
docs/relnotes/17.2.3.rst | 310 ++-
docs/relnotes/17.2.4.rst | 162 +-
docs/relnotes/17.2.5.rst | 232 +-
docs/relnotes/17.2.6.rst | 330 ++-
docs/relnotes/17.2.7.rst | 364 ++-
docs/relnotes/17.2.8.rst | 139 +-
docs/relnotes/17.3.0.rst | 484 ++--
docs/relnotes/17.3.1.rst | 267 +-
docs/relnotes/17.3.2.rst | 132 +-
docs/relnotes/17.3.3.rst | 222 +-
docs/relnotes/17.3.4.rst | 455 ++--
docs/relnotes/17.3.5.rst | 73 +-
docs/relnotes/17.3.6.rst | 101 +-
docs/relnotes/17.3.7.rst | 497 ++--
docs/relnotes/17.3.8.rst | 184 +-
docs/relnotes/17.3.9.rst | 203 +-
docs/relnotes/18.0.0.rst | 657 ++---
docs/relnotes/18.0.1.rst | 335 ++-
docs/relnotes/18.0.2.rst | 183 +-
docs/relnotes/18.0.3.rst | 120 +-
docs/relnotes/18.0.4.rst | 225 +-
docs/relnotes/18.1.0.rst | 530 ++--
docs/relnotes/18.2.0.rst | 75 +-
docs/relnotes/6.4.1.rst | 119 +-
docs/relnotes/6.4.2.rst | 132 +-
docs/relnotes/6.4.rst | 164 +-
docs/relnotes/6.5.1.rst | 254 +-
docs/relnotes/6.5.2.rst | 239 +-
docs/relnotes/6.5.3.rst | 209 +-
docs/relnotes/6.5.rst | 226 +-
docs/relnotes/7.0.1.rst | 188 +-
docs/relnotes/7.0.2.rst | 161 +-
docs/relnotes/7.0.3.rst | 155 +-
docs/relnotes/7.0.4.rst | 144 +-
docs/relnotes/7.0.rst | 175 +-
docs/relnotes/7.1.rst | 164 +-
docs/relnotes/7.10.1.rst | 732 +++---
docs/relnotes/7.10.2.rst | 368 ++-
docs/relnotes/7.10.3.rst | 598 ++---
docs/relnotes/7.10.rst | 5747 ++++++++++++++++++++++---------------------
docs/relnotes/7.11.1.rst | 782 +++---
docs/relnotes/7.11.2.rst | 110 +-
docs/relnotes/7.11.rst | 716 +++---
docs/relnotes/7.2.rst | 182 +-
docs/relnotes/7.3.rst | 160 +-
docs/relnotes/7.4.1.rst | 136 +-
docs/relnotes/7.4.2.rst | 125 +-
docs/relnotes/7.4.3.rst | 135 +-
docs/relnotes/7.4.4.rst | 113 +-
docs/relnotes/7.4.rst | 155 +-
docs/relnotes/7.5.1.rst | 118 +-
docs/relnotes/7.5.2.rst | 108 +-
docs/relnotes/7.5.rst | 182 +-
docs/relnotes/7.6.1.rst | 136 +-
docs/relnotes/7.6.rst | 149 +-
docs/relnotes/7.7.1.rst | 98 +-
docs/relnotes/7.7.rst | 121 +-
docs/relnotes/7.8.1.rst | 89 +-
docs/relnotes/7.8.2.rst | 252 +-
docs/relnotes/7.8.3.rst | 155 +-
docs/relnotes/7.8.rst | 118 +-
docs/relnotes/7.9.1.rst | 805 +++---
docs/relnotes/7.9.2.rst | 647 +++--
docs/relnotes/7.9.rst | 311 ++-
docs/relnotes/8.0.1.rst | 209 +-
docs/relnotes/8.0.2.rst | 215 +-
docs/relnotes/8.0.3.rst | 540 ++--
docs/relnotes/8.0.4.rst | 370 ++-
docs/relnotes/8.0.5.rst | 461 ++--
docs/relnotes/8.0.rst | 137 +-
docs/relnotes/9.0.1.rst | 289 +--
docs/relnotes/9.0.2.rst | 522 ++--
docs/relnotes/9.0.3.rst | 453 ++--
docs/relnotes/9.0.rst | 146 +-
docs/relnotes/9.1.1.rst | 369 ++-
docs/relnotes/9.1.2.rst | 399 ++-
docs/relnotes/9.1.3.rst | 413 ++--
docs/relnotes/9.1.4.rst | 547 ++--
docs/relnotes/9.1.5.rst | 185 +-
docs/relnotes/9.1.6.rst | 246 +-
docs/relnotes/9.1.7.rst | 263 +-
docs/relnotes/9.1.rst | 117 +-
docs/relnotes/9.2.1.rst | 331 ++-
docs/relnotes/9.2.2.rst | 113 +-
docs/relnotes/9.2.3.rst | 140 +-
docs/relnotes/9.2.4.rst | 131 +-
docs/relnotes/9.2.5.rst | 156 +-
docs/relnotes/9.2.rst | 426 ++--
docs/repository.rst | 379 ++-
docs/shading.rst | 336 ++-
docs/sourcedocs.rst | 60 +-
docs/sourcetree.rst | 300 ++-
docs/submittingpatches.rst | 651 +++--
docs/systems.rst | 116 +-
docs/thanks.rst | 192 +-
docs/utilities.rst | 54 +-
docs/versions.rst | 2967 +++++++++++-----------
docs/viewperf.rst | 498 ++--
docs/vmware-guest.rst | 516 ++--
docs/webmaster.rst | 34 +-
docs/xlibdriver.rst | 426 ++--
245 files changed, 37063 insertions(+), 42172 deletions(-)
diff --git a/docs/application-issues.rst b/docs/application-issues.rst
index b70d14e3d5..3ab4da4fc9 100644
--- a/docs/application-issues.rst
+++ b/docs/application-issues.rst
@@ -1,80 +1,48 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en"><head>
- <meta content="text/html; charset=utf-8" http-equiv="content-type"/>
- <title>Application Issues</title>
- <link href="mesa.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
+Application Issues
+==================
-
-
-
-
-
-<h1>Application Issues</h1>
-
-<p>
This page documents known issues with some OpenGL applications.
-</p>
-
-<h2>Topogun</h2>
+Topogun
+-------
-<p>
-<a href="http://www.topogun.com/">Topogun</a> for Linux (version 2, at least)
-creates a GLX visual without requesting a depth buffer.
-This causes bad rendering if the OpenGL driver happens to choose a visual
-without a depth buffer.
-</p>
+`Topogun <http://www.topogun.com/>`__ for Linux (version 2, at least)
+creates a GLX visual without requesting a depth buffer. This causes bad
+rendering if the OpenGL driver happens to choose a visual without a
+depth buffer.
-<p>
-Mesa 9.1.2 and later (will) support a DRI configuration option to work around
-this issue.
-Using the <a href="https://dri.freedesktop.org/wiki/DriConf">driconf</a> tool,
-set the "Create all visuals with a depth buffer" option before running Topogun.
+Mesa 9.1.2 and later (will) support a DRI configuration option to work
+around this issue. Using the
+`driconf <https://dri.freedesktop.org/wiki/DriConf>`__ tool, set the
+"Create all visuals with a depth buffer" option before running Topogun.
Then, all GLX visuals will be created with a depth buffer.
-</p>
+Old OpenGL games
+----------------
-<h2>Old OpenGL games</h2>
-
-<p>
Some old OpenGL games (approx. ten years or older) may crash during
start-up because of an extension string buffer-overflow problem.
-</p>
-<p>
-The problem is a modern OpenGL driver will return a very long string
-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>
+The problem is a modern OpenGL driver will return a very long string 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>
-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>
+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>
For example, if the game was released in 2001, do
-</p><pre>export MESA_EXTENSION_MAX_YEAR=2001
-</pre>
-before running the game.
-<p></p>
-
-
-
-<h2>Viewperf</h2>
-
-<p>
-See the <a href="viewperf.html">Viewperf issues</a> page for a detailed list
-of Viewperf issues.
-</p>
+::
+ export MESA_EXTENSION_MAX_YEAR=2001
+before running the game.
+Viewperf
+--------
-</body></html>
\ No newline at end of file
+See the `Viewperf issues <viewperf.html>`__ page for a detailed list of
+Viewperf issues.
diff --git a/docs/autoconf.rst b/docs/autoconf.rst
index 11f106256a..007252feb0 100644
--- a/docs/autoconf.rst
+++ b/docs/autoconf.rst
@@ -1,253 +1,205 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en"><head>
- <meta content="text/html; charset=utf-8" http-equiv="content-type"/>
- <title>Compilation and Installation using Autoconf</title>
- <link href="mesa.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
+Compilation and Installation using Autoconf
+===========================================
+#. `Basic Usage <#basic>`__
+#. `Driver Options <#driver>`__
+ - `Xlib Driver Options <#xlib>`__
+ - `DRI Driver Options <#dri>`__
+ - `OSMesa Driver Options <#osmesa>`__
+1. Basic Usage
+--------------
+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:
-<h1>Compilation and Installation using Autoconf</h1>
+::
-<ol>
-<li><p><a href="#basic">Basic Usage</a></p></li>
-<li><p><a href="#driver">Driver Options</a>
- </p><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>
-</li></ol>
+ ./configure
+To see a short description of all the options, type
+``./configure --help``. If you are using a development snapshot and the
+configure script does not exist, type ``./autogen.sh`` to generate it
+first. If you know the options you want to pass to ``configure``, you
+can pass them to ``autogen.sh``. It will run ``configure`` with these
+options after it is generated. Once you have run ``configure`` and set
+the options to your preference, type:
-<h2 id="basic">1. Basic Usage</h2>
+::
+
+ make
+
+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 ``make realclean`` before rebuilding.
-<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>--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>
+``--prefix=PREFIX``
+ This is the root directory where files will be installed by
+ ``make install``. The default is ``/usr/local``.
+
+``--exec-prefix=EPREFIX``
+ 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 ``${prefix}``.
+
+``--libdir=LIBDIR``
+ This option specifies the directory where the GL libraries will be
+ installed. The default is ``${exec_prefix}/lib``. It also serves as
+ the name of the library staging area in the source tree. For
+ instance, if the option ``--libdir=/usr/local/lib64`` is used, the
+ libraries will be created in a ``lib64`` directory at the top of the
+ Mesa source tree.
+
+``--sysconfdir=DIR``
+ This option specifies the directory where the configuration files
+ will be installed. The default is ``${prefix}/etc``. Currently
+ there's only one config file provided when dri drivers are enabled -
+ it's ``drirc``.
+
+``--enable-static, --disable-shared``
+ 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.
+
+``CC, CFLAGS, CXX, CXXFLAGS``
+ These environment variables control the C and C++ compilers used
+ during the build. By default, ``gcc`` and ``g++`` are used and the
+ debug/optimisation level is left unchanged.
+
+``LDFLAGS``
+ An environment variable specifying flags to pass when linking
+ programs. These should be empty and ``PKG_CONFIG_PATH`` is
+ recommended to be used instead. If needed it can be used to direct
+ the linker to use libraries in nonstandard directories. For example,
+ ``LDFLAGS="-L/usr/X11R6/lib"``.
+
+``PKG_CONFIG_PATH``
+ The ``pkg-config`` 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 ``pkg-config``. For instance, setting
+ ``PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig`` will search for package
+ metadata in ``/usr/X11R6`` before the standard directories.
-</dd><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>
+There are also a few general options for altering the Mesa build:
+
+``--enable-debug``
+ 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.
-<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>
+ Note that enabling this option can lead to noticeable loss of
+ performance.
-<p><code>--build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu</code></p>
+``--disable-asm``
+ 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.
-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.
+``--build=``
+``--host=``
+ 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:
+ ``--build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu``
-<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>
+ Note that these can vary from distribution to distribution. For more
+ information check with the `autoconf
+ manual <https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.69/html_node/Specifying-Target-Triplets.html>`__.
+ Note that you will need to correctly set ``PKG_CONFIG_PATH`` as
+ well.
-<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>
+ In some cases a single compiler is capable of handling both
+ architectures (multilib) in that case one would need to set the
+ ``CC,CXX`` variables appending the correct machine options. Seek
+ your compiler documentation for further information - `gcc machine
+ dependent
+ options <https://gcc.gnu.org/onlinedocs/gcc/Submodel-Options.html>`__
-<code>./configure CC="gcc -m32" CXX="g++ -m32" --build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu ...</code>
-</dd>
-</dl>
+ In addition to specifying correct ``PKG_CONFIG_PATH`` for the target
+ architecture, the following should be sufficient to configure
+ multilib Mesa
+ ``./configure CC="gcc -m32" CXX="g++ -m32" --build=x86_64-pc-linux-gnu --host=i686-pc-linux-gnu ...``
-<h2 id="driver">2. GL Driver Options</h2>
+2. GL Driver Options
+--------------------
-<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>
+described in more detail in the `basic installation
+instructions <install.html>`__. The Mesa driver is controlled through
+the configure options ``--enable-glx`` and ``--enable-osmesa``
+
+Xlib
+~~~~
-<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>.
-
-</p><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 -->
-</p><dl>
-<dt><code>--with-dri-driverdir=DIR</code>
-</dt><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>.
-</p></dd><dt><code>--with-dri-drivers=DRIVER,DRIVER,...</code>
-</dt><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? -->
-</p></dd><dt><code>--disable-driglx-direct</code>
-</dt><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.
-</p></dd><dt><code>--enable-glx-tls</code> </dt><dd><p>
-Enable Thread Local Storage (TLS) in
-GLX.
-</p></dd><dt><code>--with-expat=DIR</code>
-</dt><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.
-</p></dd></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 -->
-</p><dl>
-<dt><code>--with-osmesa-bits=BITS</code>
-</dt><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.
-</p></dd></dl>
-
-
-<h2 id="library">3. Library Options</h2>
-
-<p>
-The configure script provides more fine grained control over the libraries
-that will be built.
-
-</p>
-
-
-</body></html>
\ No newline at end of file
+to the option ``--enable-glx=xlib`` or ``--enable-glx=gallium-xlib``.
+
+DRI
+~~~
+
+This mode uses the DRI hardware drivers for accelerated OpenGL
+rendering. To enable use ``--enable-glx=dri --enable-dri``.
+
+``--with-dri-driverdir=DIR``
+ This option specifies the location the DRI drivers will be installed
+ to and the location libGL will search for DRI drivers. The default
+ is ``${libdir}/dri``.
+
+``--with-dri-drivers=DRIVER,DRIVER,...``
+ This option allows a specific set of DRI drivers to be built. For
+ example, ``--with-dri-drivers="swrast,i965,radeon,nouveau"``. By
+ default, the drivers will be chosen depending on the target
+ platform. See the directory ``src/mesa/drivers/dri`` 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.
+
+``--disable-driglx-direct``
+ 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.
+
+``--enable-glx-tls``
+ Enable Thread Local Storage (TLS) in GLX.
+
+``--with-expat=DIR``
+ **DEPRECATED**, use ``PKG_CONFIG_PATH`` instead.
+
+ The DRI-enabled libGL uses expat to parse the DRI configuration
+ files in ``${sysconfdir}/drirc`` and ``~/.drirc``. This option
+ allows a specific expat installation to be used. For example,
+ ``--with-expat=/usr/local`` will search for expat headers and
+ libraries in ``/usr/local/include`` and ``/usr/local/lib``,
+ respectively.
+
+OSMesa
+~~~~~~
+
+No libGL is built in this mode. Instead, the driver code is built into
+the Off-Screen Mesa (OSMesa) library. See the `Off-Screen
+Rendering <osmesa.html>`__ page for more details. It corresponds to the
+option ``--enable-osmesa``.
+
+``--with-osmesa-bits=BITS``
+ 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, ``--with-osmesa-bits=16`` will create the libOSMesa16
+ library with a 16-bit color channel.
+
+3. Library Options
+------------------
+
+The configure script provides more fine grained control over the
+libraries that will be built.
diff --git a/docs/bugs.rst b/docs/bugs.rst
index c3045cd81c..4ac64e8ef3 100644
--- a/docs/bugs.rst
+++ b/docs/bugs.rst
@@ -1,62 +1,33 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en"><head>
- <meta content="text/html; charset=utf-8" http-equiv="content-type"/>
- <title>Mesa Bug Reporting</title>
- <link href="mesa.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
+Bug Database
+============
-
-
-
-
-
-<h1>Bug Database</h1>
-
-<p>
The Mesa bug database is hosted on
-<a href="https://freedesktop.org">freedesktop.org</a>.
-The old bug database on SourceForge is no longer used.
-</p>
+`freedesktop.org <https://freedesktop.org>`__. The old bug database on
+SourceForge is no longer used.
-<p>
-To file a Mesa bug, go to
-<a href="https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa">
-Bugzilla on freedesktop.org</a>
-</p>
+To file a Mesa bug, go to `Bugzilla on
+freedesktop.org <https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa>`__
-<p>
Please follow these bug reporting guidelines:
-</p>
-<ul>
-<li>Check if a new version of Mesa is available which might have fixed
-the problem.
-</li><li>Check if your bug is already reported in the database.
-</li><li>Monitor your bug report for requests for additional information, etc.
-</li><li>Attach the output of running glxinfo or wglinfo.
-This will tell us the Mesa version, which device driver you're using, etc.
-</li><li>If you're reporting a crash, try to use your debugger (gdb) to get a stack
-trace. Also, recompile Mesa in debug mode to get more detailed information.
-</li><li>Describe in detail how to reproduce the bug, especially with games
-and applications that the Mesa developers might not be familiar with.
-</li><li>Provide an <a href="https://github.com/apitrace/apitrace">apitrace</a>
-or simple GLUT-based test program if possible.
-</li></ul>
+- Check if a new version of Mesa is available which might have fixed
+ the problem.
+- Check if your bug is already reported in the database.
+- Monitor your bug report for requests for additional information, etc.
+- Attach the output of running glxinfo or wglinfo. This will tell us
+ the Mesa version, which device driver you're using, etc.
+- If you're reporting a crash, try to use your debugger (gdb) to get a
+ stack trace. Also, recompile Mesa in debug mode to get more detailed
+ information.
+- Describe in detail how to reproduce the bug, especially with games
+ and applications that the Mesa developers might not be familiar with.
+- Provide an `apitrace <https://github.com/apitrace/apitrace>`__ or
+ simple GLUT-based test program if possible.
-<p>
Bug reports will automatically be forwarded by bugzilla to the Mesa
developer's mailing list.
-</p>
-
-<p>
-The easier a bug is to reproduce, the sooner it will be fixed.
-Please do everything you can to facilitate quickly fixing bugs.
-If your bug report is vague or your test program doesn't compile
-easily, the problem may not be fixed very quickly.
-</p>
-
-
-
-</body></html>
\ No newline at end of file
+The easier a bug is to reproduce, the sooner it will be fixed. Please do
+everything you can to facilitate quickly fixing bugs. If your bug report
+is vague or your test program doesn't compile easily, the problem may
+not be fixed very quickly.
diff --git a/docs/codingstyle.rst b/docs/codingstyle.rst
index 3485e1d7f4..026652f0ca 100644
--- a/docs/codingstyle.rst
+++ b/docs/codingstyle.rst
@@ -1,132 +1,124 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en"><head>
- <meta content="text/html; charset=utf-8" http-equiv="content-type"/>
- <title>Coding Style</title>
- <link href="mesa.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
+Coding Style
+============
-
-
-
-
-
-<h1>Coding Style</h1>
-
-<p>
Mesa is over 20 years old and the coding style has evolved over time.
-Some old parts use a style that's a bit out of date.
+Some old parts use a style that's a bit out of date. Different sections
+of mesa can use different coding style as set in the local EditorConfig
+(.editorconfig) and/or Emacs (.dir-locals.el) file. Alternatively the
+following is applicable. If the guidelines below don't cover something,
+try following the format of existing, neighboring code.
-Different sections of mesa can use different coding style as set in the local
-EditorConfig (.editorconfig) and/or Emacs (.dir-locals.el) file.
+Basic formatting guidelines
-Alternatively the following is applicable.
+- 3-space indentation, no tabs.
+- Limit lines to 78 or fewer characters. The idea is to prevent line
+ wrapping in 80-column editors and terminals. There are exceptions,
+ such as if you're defining a large, static table of information.
+- Opening braces go on the same line as the if/for/while statement. For
+ example:
+
+ ::
+
+ if (condition) {
+ foo;
+ } else {
+ bar;
+ }
+
+- Put a space before/after operators. For example, ``a = b + c;`` and
+ not ``a=b+c;``
+- This GNU indent command generally does the right thing for
+ formatting:
+
+ ::
+
+ indent -br -i3 -npcs --no-tabs infile.c -o outfile.c
+
+- | Use comments wherever you think it would be helpful for other
+ developers. Several specific cases and style examples follow. Note
+ that we roughly follow
+ `Doxygen <https://www.stack.nl/~dimitri/doxygen/>`__ conventions.
+ | Single-line comments:
+
+ ::
+
+ /* null-out pointer to prevent dangling reference below */
+ bufferObj = NULL;
+
+ Or,
+
+ ::
+
+ bufferObj = NULL; /* prevent dangling reference below */
+
+ Multi-line comment:
+
+ ::
+
+ /* If this is a new buffer object id, or one which was generated but
+ * never used before, allocate a buffer object now.
+ */
+
+ We try to quote the OpenGL specification where prudent:
+
+ ::
+
+ /* Page 38 of the PDF of the OpenGL ES 3.0 spec says:
+ *
+ * "An INVALID_OPERATION error is generated for any of the following
+ * conditions:
+ *
+ * * is zero."
+ *
+ * Additionally, page 94 of the PDF of the OpenGL 4.5 core spec
+ * (30.10.2014) also says this, so it's no longer allowed for desktop GL,
+ * either.
+ */
+
+ Function comment example:
+
+ ::
+
+ /**
+ * Create and initialize a new buffer object. Called via the
+ * ctx->Driver.CreateObject() driver callback function.
+ * \param name integer name of the object
+ * \param type one of GL_FOO, GL_BAR, etc.
+ * \return pointer to new object or NULL if error
+ */
+ struct gl_object *
+ _mesa_create_object(GLuint name, GLenum type)
+ {
+ /* function body */
+ }
+
+- Put the function return type and qualifiers on one line and the
+ function name and parameters on the next, as seen above. This makes
+ it easy to use ``grep ^function_name dir/*`` to find function
+ definitions. Also, the opening brace goes on the next line by itself
+ (see above.)
+- Function names follow various conventions depending on the type of
+ function:
+
+ ::
+
+ glFooBar() - a public GL entry point (in glapi_dispatch.c)
+ _mesa_FooBar() - the internal immediate mode function
+ save_FooBar() - retained mode (display list) function in dlist.c
+ foo_bar() - a static (private) function
+ _mesa_foo_bar() - an internal non-static Mesa function
+
+- Constants, macros and enum names are ALL\_UPPERCASE, with \_ between
+ words.
+- Mesa usually uses camel case for local variables (Ex: "localVarname")
+ while gallium typically uses underscores (Ex: "local\_var\_name").
+- Global variables are almost never used because Mesa should be
+ thread-safe.
+- Booleans. Places that are not directly visible to the GL API should
+ prefer the use of ``bool``, ``true``, and ``false`` over
+ ``GLboolean``, ``GL_TRUE``, and ``GL_FALSE``. In C code, this may
+ mean that ``#include <stdbool.h>`` needs to be added. The
+ ``try_emit_``\ \* methods in src/mesa/program/ir\_to\_mesa.cpp and
+ src/mesa/state\_tracker/st\_glsl\_to\_tgsi.cpp can serve as examples.
-If the guidelines below don't cover something, try following the format of
-existing, neighboring code.
-</p>
-<p>
-Basic formatting guidelines
-</p>
-
-<ul>
-<li>3-space indentation, no tabs.
-</li><li>Limit lines to 78 or fewer characters. The idea is to prevent line
-wrapping in 80-column editors and terminals. There are exceptions, such
-as if you're defining a large, static table of information.
-</li><li>Opening braces go on the same line as the if/for/while statement.
-For example:
-<pre> if (condition) {
- foo;
- } else {
- bar;
- }
-</pre>
-
-</li><li>Put a space before/after operators. For example, <tt>a = b + c;</tt>
-and not <tt>a=b+c;</tt>
-
-</li><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><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="https://www.stack.nl/~dimitri/doxygen/">Doxygen</a> conventions.
-<br/>
-<br/>
-Single-line comments:
-<pre> /* null-out pointer to prevent dangling reference below */
- bufferObj = NULL;
-</pre>
-Or,
-<pre> bufferObj = NULL; /* prevent dangling reference below */
-</pre>
-Multi-line comment:
-<pre> /* If this is a new buffer object id, or one which was generated but
- * never used before, allocate a buffer object now.
- */
-</pre>
-We try to quote the OpenGL specification where prudent:
-<pre> /* Page 38 of the PDF of the OpenGL ES 3.0 spec says:
- *
- * "An INVALID_OPERATION error is generated for any of the following
- * conditions:
- *
- * * <length> is zero."
- *
- * Additionally, page 94 of the PDF of the OpenGL 4.5 core spec
- * (30.10.2014) also says this, so it's no longer allowed for desktop GL,
- * either.
- */
-</length></pre>
-Function comment example:
-<pre> /**
- * Create and initialize a new buffer object. Called via the
- * ctx->Driver.CreateObject() driver callback function.
- * \param name integer name of the object
- * \param type one of GL_FOO, GL_BAR, etc.
- * \return pointer to new object or NULL if error
- */
- struct gl_object *
- _mesa_create_object(GLuint name, GLenum type)
- {
- /* function body */
- }
-</pre>
-
-</li><li>Put the function return type and qualifiers on one line and the function
-name and parameters on the next, as seen above. This makes it easy to use
-<code>grep ^function_name dir/*</code> to find function definitions. Also,
-the opening brace goes on the next line by itself (see above.)
-
-</li><li>Function names follow various conventions depending on the type of function:
-<pre> glFooBar() - a public GL entry point (in glapi_dispatch.c)
- _mesa_FooBar() - the internal immediate mode function
- save_FooBar() - retained mode (display list) function in dlist.c
- foo_bar() - a static (private) function
- _mesa_foo_bar() - an internal non-static Mesa function
-</pre>
-
-</li><li>Constants, macros and enum names are ALL_UPPERCASE, with _ between
-words.
-</li><li>Mesa usually uses camel case for local variables (Ex: "localVarname")
-while gallium typically uses underscores (Ex: "local_var_name").
-</li><li>Global variables are almost never used because Mesa should be thread-safe.
-
-</li><li>Booleans. Places that are not directly visible to the GL API
-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 <stdbool.h></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.
-
-</li></ul>
-<p></p>
-
-
-
-
-</body></html>
\ No newline at end of file
diff --git a/docs/conform.rst b/docs/conform.rst
index 84728f9ae2..fad50e68f9 100644
--- a/docs/conform.rst
+++ b/docs/conform.rst
@@ -1,700 +1,675 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en"><head>
- <meta content="text/html; charset=utf-8" http-equiv="content-type"/>
- <title>Conformance</title>
- <link href="mesa.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
-
-
+Conformance
+===========
+The SGI OpenGL conformance tests verify correct operation of OpenGL
+implementations. I, Brian Paul, have been given a copy of the tests for
+testing Mesa. The tests are not publicly available.
+This file has the latest results of testing Mesa with the OpenGL 1.2
+conformance tests. Testing with the preliminary OpenGL 1.3 tests has
+also been done. Mesa passes all the 1.3 tests.
+The tests were run using the software X11 device driver on 24-bpp and
+16-bpp displays.
-<h1>Conformance</h1>
+Mesa 4.0 and later pass all conformance tests at all path levels. Note
+that this says nothing about the conformance of hardware drivers based
+upon Mesa.
-<p>
-The SGI OpenGL conformance tests verify correct operation of OpenGL
-implementations. I, Brian Paul, have been given a copy of the tests
-for testing Mesa. The tests are not publicly available.
-</p>
-<p>
-This file has the latest results of testing Mesa with the OpenGL 1.2
-conformance tests. Testing with the preliminary OpenGL 1.3 tests has
-also been done. Mesa passes all the 1.3 tests.
-</p>
-<p>
-The tests were run using the software X11 device driver on 24-bpp
-and 16-bpp displays.
-</p>
-<p>
-Mesa 4.0 and later pass all conformance tests at all path levels.
-Note that this says nothing about the conformance of hardware drivers
-based upon Mesa.
-</p>
+::
+ COVERAGE TESTS
+ --------------
-<pre>
-COVERAGE TESTS
---------------
+ Test that all API functions accept the legal parameters and reject
+ illegal parameters. The result of each test is either pass or fail.
-Test that all API functions accept the legal parameters and reject
-illegal parameters. The result of each test is either pass or fail.
+ % covgl
+ OpenGL Coverage Test.
+ Version 1.2
-% covgl
-OpenGL Coverage Test.
-Version 1.2
+ covgl passed.
-covgl passed.
+ covgl passed at 1.1 level.
-covgl passed at 1.1 level.
-
-covgl passed at 1.2 level.
-
-covgl passed for ARB_multitexture.
-
-
-% covglu
-OpenGL GLU Coverage Test.
-Version 1.3
-
-covglu passed.
-
-covglu passed at 1.1 level.
-
-
-% covglx
-OpenGL X Coverage Test.
-Version 1.1.1
-
-covglx passed.
-
-
-% primtest -v
-Open GL Primitives Test.
-Version 1.2
-
-[lots of output deleted]
-
-292159 Combinations.
-primtest passed.
-
-
-
-
-GL CONFORMANCE TEST
-===================
-
-Render test images, read them back, then test for expected results.
-
-
-----------------------------------------------------------------------
-% conform -v 2
-
-OpenGL Conformance Test
-Version 1.2
-
-Setup Report.
- Verbose level = 2.
- Random number seed = 1.
- Path inactive.
-
-Visual Report.
- Display ID = 35. Indirect Rendering.
- Double Buffered.
- RGBA (5, 6, 5, 0).
- Stencil (8).
- Depth (16).
- Accumulation (16, 16, 16, 16).
-
-Epsilon Report.
- zero error epsilon = 0.000122.
- RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
- Depth buffer error epsilon = 0.000137.
- Stencil plane error epsilon = 0.00404.
- Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
-
-Default State test passed.
-Must Pass test passed.
-Divide By Zero test passed.
-Viewport Clamp test passed.
-Matrix Stack test passed.
-Matrix Stack Mixing test passed.
-Vertex Order test passed.
-Transformations test passed.
-Transformation Normal test passed.
-Viewport Transformation test passed.
-Buffer Clear test passed.
-Buffer Corners test passed.
-Buffer Color test passed.
-Color Ramp test passed.
-Mask test passed.
-Buffer Invariance test passed.
-Accumulation Buffer test passed.
-Select test passed.
-Feedback test passed.
-Scissor test passed.
-Alpha Plane Function test passed.
-Stencil Plane Clear test passed.
-Stencil Plane Corners test passed.
-Stencil Plane Operation test passed.
-Stencil Plane Function test passed.
-Depth Buffer Clear test passed.
-Depth Buffer Function test passed.
-Blend test passed.
-Dither test passed.
-LogicOp Function test does not exist for an RGB visual.
-DrawPixels test passed.
-CopyPixels test passed.
-Bitmap Rasterization test passed.
-Point Rasterization test passed.
-Anti-aliased Point test passed.
-Line Rasterization test passed.
-Line Stipple test passed.
-Anti-aliased Line test passed.
-Horizontal and Vertical Line test passed.
-Triangle Rasterization test passed.
-Triangle Tile test passed.
-Triangle Stipple test passed.
-Anti-aliased Triangles test passed.
-Quad Rasterization test passed.
-Polygon Face test passed.
-Polygon Cull test passed.
-Polygon Stipple test passed.
-Polygon Edge test passed.
-Ambient Material test passed.
-Ambient Scene test passed.
-Attenuation Position test passed.
-Diffuse Light test passed.
-Diffuse Material test passed.
-Diffuse Material Normal test passed.
-Diffuse Material Positioning test passed.
-Emissive Material test passed.
-Specular Exponent test passed.
-Specular Exponent Normal test passed.
-Specular Local Eye Half Angle test passed.
-Specular Light test passed.
-Specular Material test passed.
-Specular Normal test passed.
-Spot Positioning test passed.
-Spot Exponent and Positioning test passed.
-Spot Exponent and Direction test passed.
-Fog Exponential test passed.
-Fog Linear test passed.
-Texture Decal test passed.
-Texture Border test passed.
-Mipmaps Selection test passed.
-Mipmaps Interpolation test passed.
-Display Lists test passed.
-Evaluator test passed.
-Evaluator Color test passed.
-Texture Edge Clamp test passed.
-Packed Pixels test passed.
-Texture LOD test passed.
-Rescale Normal test passed.
-Color Table test passed.
-Convolution test passed.
-Convolution Border test passed.
-Histogram test passed.
-MinMax test passed.
-MultiTexture test passed.
-
-Conform passed.
-
-----------------------------------------------------------------------
-% conform -v 2 -p 1
-
-OpenGL Conformance Test
-Version 1.2
-
-Setup Report.
- Verbose level = 2.
- Random number seed = 1.
- Path level = 1.
-
-Visual Report.
- Display ID = 35. Indirect Rendering.
- Double Buffered.
- RGBA (5, 6, 5, 0).
- Stencil (8).
- Depth (16).
- Accumulation (16, 16, 16, 16).
-
-Epsilon Report.
- zero error epsilon = 0.000122.
- RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
- Depth buffer error epsilon = 0.000137.
- Stencil plane error epsilon = 0.00404.
- Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
-
-Default State test passed.
-Must Pass test passed.
-Divide By Zero test passed.
-Viewport Clamp test passed.
-Matrix Stack test passed.
-Matrix Stack Mixing test passed.
-Vertex Order test passed.
-Transformations test passed.
-Transformation Normal test passed.
-Viewport Transformation test passed.
-Buffer Clear test passed.
-Buffer Corners test passed.
-Buffer Color test passed.
-Color Ramp test passed.
-Mask test passed.
-Buffer Invariance test passed.
-Accumulation Buffer test passed.
-Select test passed.
-Feedback test passed.
-Scissor test passed.
-Alpha Plane Function test passed.
-Stencil Plane Clear test passed.
-Stencil Plane Corners test passed.
-Stencil Plane Operation test passed.
-Stencil Plane Function test passed.
-Depth Buffer Clear test passed.
-Depth Buffer Function test passed.
-Blend test passed.
-Dither test passed.
-LogicOp Function test does not exist for an RGB visual.
-DrawPixels test passed.
-CopyPixels test passed.
-Bitmap Rasterization test passed.
-Point Rasterization test passed.
-Anti-aliased Point test passed.
-Line Rasterization test passed.
-Line Stipple test passed.
-Anti-aliased Line test passed.
-Horizontal and Vertical Line test passed.
-Triangle Rasterization test passed.
-Triangle Tile test passed.
-Triangle Stipple test passed.
-Anti-aliased Triangles test passed.
-Quad Rasterization test passed.
-Polygon Face test passed.
-Polygon Cull test passed.
-Polygon Stipple test passed.
-Polygon Edge test passed.
-Ambient Material test passed.
-Ambient Scene test passed.
-Attenuation Position test passed.
-Diffuse Light test passed.
-Diffuse Material test passed.
-Diffuse Material Normal test passed.
-Diffuse Material Positioning test passed.
-Emissive Material test passed.
-Specular Exponent test passed.
-Specular Exponent Normal test passed.
-Specular Local Eye Half Angle test passed.
-Specular Light test passed.
-Specular Material test passed.
-Specular Normal test passed.
-Spot Positioning test passed.
-Spot Exponent and Positioning test passed.
-Spot Exponent and Direction test passed.
-Fog Exponential test passed.
-Fog Linear test passed.
-Texture Decal test passed.
-Texture Border test passed.
-Mipmaps Selection test passed.
-Mipmaps Interpolation test passed.
-Display Lists test passed.
-Evaluator test passed.
-Evaluator Color test passed.
-Texture Edge Clamp test passed.
-Packed Pixels test passed.
-Texture LOD test passed.
-Rescale Normal test passed.
-Color Table test passed.
-Convolution test passed.
-Convolution Border test passed.
-Histogram test passed.
-MinMax test passed.
-MultiTexture test passed.
-
-Conform passed.
-
-----------------------------------------------------------------------
-% conform -v 2 -p 2
-
-OpenGL Conformance Test
-Version 1.2
-
-Setup Report.
- Verbose level = 2.
- Random number seed = 1.
- Path level = 2.
-
-Visual Report.
- Display ID = 35. Indirect Rendering.
- Double Buffered.
- RGBA (5, 6, 5, 0).
- Stencil (8).
- Depth (16).
- Accumulation (16, 16, 16, 16).
-
-Epsilon Report.
- zero error epsilon = 0.000122.
- RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
- Depth buffer error epsilon = 0.000137.
- Stencil plane error epsilon = 0.00404.
- Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
-
-Default State test passed.
-Must Pass test passed.
-Divide By Zero test passed.
-Viewport Clamp test passed.
-Matrix Stack test passed.
-Matrix Stack Mixing test passed.
-Vertex Order test passed.
-Transformations test passed.
-Transformation Normal test passed.
-Viewport Transformation test passed.
-Buffer Clear test passed.
-Buffer Corners test passed.
-Buffer Color test passed.
-Color Ramp test passed.
-Mask test passed.
-Buffer Invariance test passed.
-Accumulation Buffer test passed.
-Select test passed.
-Feedback test passed.
-Scissor test passed.
-Alpha Plane Function test passed.
-Stencil Plane Clear test passed.
-Stencil Plane Corners test passed.
-Stencil Plane Operation test passed.
-Stencil Plane Function test passed.
-Depth Buffer Clear test passed.
-Depth Buffer Function test passed.
-Blend test passed.
-Dither test passed.
-LogicOp Function test does not exist for an RGB visual.
-DrawPixels test passed.
-CopyPixels test passed.
-Bitmap Rasterization test passed.
-Point Rasterization test passed.
-Anti-aliased Point test passed.
-Line Rasterization test passed.
-Line Stipple test passed.
-Anti-aliased Line test passed.
-Horizontal and Vertical Line test passed.
-Triangle Rasterization test passed.
-Triangle Tile test passed.
-Triangle Stipple test passed.
-Anti-aliased Triangles test passed.
-Quad Rasterization test passed.
-Polygon Face test passed.
-Polygon Cull test passed.
-Polygon Stipple test passed.
-Polygon Edge test passed.
-Ambient Material test passed.
-Ambient Scene test passed.
-Attenuation Position test passed.
-Diffuse Light test passed.
-Diffuse Material test passed.
-Diffuse Material Normal test passed.
-Diffuse Material Positioning test passed.
-Emissive Material test passed.
-Specular Exponent test passed.
-Specular Exponent Normal test passed.
-Specular Local Eye Half Angle test passed.
-Specular Light test passed.
-Specular Material test passed.
-Specular Normal test passed.
-Spot Positioning test passed.
-Spot Exponent and Positioning test passed.
-Spot Exponent and Direction test passed.
-Fog Exponential test passed.
-Fog Linear test passed.
-Texture Decal test passed.
-Texture Border test passed.
-Mipmaps Selection test passed.
-Mipmaps Interpolation test passed.
-Display Lists test passed.
-Evaluator test passed.
-Evaluator Color test passed.
-Texture Edge Clamp test passed.
-Packed Pixels test passed.
-Texture LOD test passed.
-Rescale Normal test passed.
-Color Table test passed.
-Convolution test passed.
-Convolution Border test passed.
-Histogram test passed.
-MinMax test passed.
-MultiTexture test passed.
-
-Conform passed.
-
-----------------------------------------------------------------------
-% conform -v 2 -p 3
-
-OpenGL Conformance Test
-Version 1.2
-
-Setup Report.
- Verbose level = 2.
- Random number seed = 1.
- Path level = 3.
-
-Visual Report.
- Display ID = 35. Indirect Rendering.
- Double Buffered.
- RGBA (5, 6, 5, 0).
- Stencil (8).
- Depth (16).
- Accumulation (16, 16, 16, 16).
-
-Epsilon Report.
- zero error epsilon = 0.000122.
- RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
- Depth buffer error epsilon = 0.000137.
- Stencil plane error epsilon = 0.00404.
- Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
-
-Default State test passed.
-Must Pass test passed.
-Divide By Zero test passed.
-Viewport Clamp test passed.
-Matrix Stack test passed.
-Matrix Stack Mixing test passed.
-Vertex Order test passed.
-Transformations test passed.
-Transformation Normal test passed.
-Viewport Transformation test passed.
-Buffer Clear test passed.
-Buffer Corners test passed.
-Buffer Color test passed.
-Color Ramp test passed.
-Mask test passed.
-Buffer Invariance test passed.
-Accumulation Buffer test passed.
-Select test passed.
-Feedback test passed.
-Scissor test passed.
-Alpha Plane Function test passed.
-Stencil Plane Clear test passed.
-Stencil Plane Corners test passed.
-Stencil Plane Operation test passed.
-Stencil Plane Function test passed.
-Depth Buffer Clear test passed.
-Depth Buffer Function test passed.
-Blend test passed.
-Dither test passed.
-LogicOp Function test does not exist for an RGB visual.
-DrawPixels test passed.
-CopyPixels test passed.
-Bitmap Rasterization test passed.
-Point Rasterization test passed.
-Anti-aliased Point test passed.
-Line Rasterization test passed.
-Line Stipple test passed.
-Anti-aliased Line test passed.
-Horizontal and Vertical Line test passed.
-Triangle Rasterization test passed.
-Triangle Tile test passed.
-Triangle Stipple test passed.
-Anti-aliased Triangles test passed.
-Quad Rasterization test passed.
-Polygon Face test passed.
-Polygon Cull test passed.
-Polygon Stipple test passed.
-Polygon Edge test passed.
-Ambient Material test passed.
-Ambient Scene test passed.
-Attenuation Position test passed.
-Diffuse Light test passed.
-Diffuse Material test passed.
-Diffuse Material Normal test passed.
-Diffuse Material Positioning test passed.
-Emissive Material test passed.
-Specular Exponent test passed.
-Specular Exponent Normal test passed.
-Specular Local Eye Half Angle test passed.
-Specular Light test passed.
-Specular Material test passed.
-Specular Normal test passed.
-Spot Positioning test passed.
-Spot Exponent and Positioning test passed.
-Spot Exponent and Direction test passed.
-Fog Exponential test passed.
-Fog Linear test passed.
-Texture Decal test passed.
-Texture Border test passed.
-Mipmaps Selection test passed.
-Mipmaps Interpolation test passed.
-Display Lists test passed.
-Evaluator test passed.
-Evaluator Color test passed.
-Texture Edge Clamp test passed.
-Packed Pixels test passed.
-Texture LOD test passed.
-Rescale Normal test passed.
-Color Table test passed.
-Convolution test passed.
-Convolution Border test passed.
-Histogram test passed.
-MinMax test passed.
-MultiTexture test passed.
-
-Conform passed.
-
-----------------------------------------------------------------------
-% conform -v 2 -p 4
-
-OpenGL Conformance Test
-Version 1.2
-
-Setup Report.
- Verbose level = 2.
- Random number seed = 1.
- Path level = 4.
-
-Visual Report.
- Display ID = 35. Indirect Rendering.
- Double Buffered.
- RGBA (5, 6, 5, 0).
- Stencil (8).
- Depth (16).
- Accumulation (16, 16, 16, 16).
-
-Epsilon Report.
- zero error epsilon = 0.000122.
- RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
- Depth buffer error epsilon = 0.000137.
- Stencil plane error epsilon = 0.00404.
- Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
-
-Default State test passed.
-Must Pass test passed.
-Divide By Zero test passed.
-Viewport Clamp test passed.
-Matrix Stack test passed.
-Matrix Stack Mixing test passed.
-Vertex Order test passed.
-Transformations test passed.
-Transformation Normal test passed.
-Viewport Transformation test passed.
-Buffer Clear test passed.
-Buffer Corners test passed.
-Buffer Color test passed.
-Color Ramp test passed.
-Mask test passed.
-Buffer Invariance test passed.
-Accumulation Buffer test passed.
-Select test passed.
-Feedback test passed.
-Scissor test passed.
-Alpha Plane Function test passed.
-Stencil Plane Clear test passed.
-Stencil Plane Corners test passed.
-Stencil Plane Operation test passed.
-Stencil Plane Function test passed.
-Depth Buffer Clear test passed.
-Depth Buffer Function test passed.
-Blend test passed.
-Dither test passed.
-LogicOp Function test does not exist for an RGB visual.
-DrawPixels test passed.
-CopyPixels test passed.
-Bitmap Rasterization test passed.
-Point Rasterization test passed.
-Anti-aliased Point test passed.
-Line Rasterization test passed.
-Line Stipple test passed.
-Anti-aliased Line test passed.
-Horizontal and Vertical Line test passed.
-Triangle Rasterization test passed.
-Triangle Tile test passed.
-Triangle Stipple test passed.
-Anti-aliased Triangles test passed.
-Quad Rasterization test passed.
-Polygon Face test passed.
-Polygon Cull test passed.
-Polygon Stipple test passed.
-Polygon Edge test passed.
-Ambient Material test passed.
-Ambient Scene test passed.
-Attenuation Position test passed.
-Diffuse Light test passed.
-Diffuse Material test passed.
-Diffuse Material Normal test passed.
-Diffuse Material Positioning test passed.
-Emissive Material test passed.
-Specular Exponent test passed.
-Specular Exponent Normal test passed.
-Specular Local Eye Half Angle test passed.
-Specular Light test passed.
-Specular Material test passed.
-Specular Normal test passed.
-Spot Positioning test passed.
-Spot Exponent and Positioning test passed.
-Spot Exponent and Direction test passed.
-Fog Exponential test passed.
-Fog Linear test passed.
-Texture Decal test passed.
-Texture Border test passed.
-Mipmaps Selection test passed.
-Mipmaps Interpolation test passed.
-Display Lists test passed.
-Evaluator test passed.
-Evaluator Color test passed.
-Texture Edge Clamp test passed.
-Packed Pixels test passed.
-Texture LOD test passed.
-Rescale Normal test passed.
-Color Table test passed.
-Convolution test passed.
-Convolution Border test passed.
-Histogram test passed.
-MinMax test passed.
-MultiTexture test passed.
-
-Conform passed.
-
-
-
-GLX CONFORMANCE TEST
-====================
-
-% conformx -v 2
-
-OpenGL X Conformance Test
-Version 1.1.1
-
-Setup Report.
- Verbose level = 2.
- Random number seed = 1.
- Path inactive.
-
-Visual Report.
- Display ID = 34. Direct Rendering.
- Double Buffered.
- RGBA (8, 8, 8, 0).
- Stencil (8).
- Depth (16).
- Accumulation (16, 16, 16, 16).
-
-Epsilon Report.
- zero error epsilon = 0.000122.
- RGBA error epsilon = 0.00404, 0.00404, 0.00404, 0.000122.
- Depth buffer error epsilon = 0.000137.
- Stencil plane error epsilon = 0.00404.
- Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
-
-Default State test passed.
-glReadPixels() test passed.
-Font test passed.
-
-Conformx passed.
-
-
-</pre>
+ covgl passed at 1.2 level.
-NOTE: conformx passes for all machine path levels (-p option).
+ covgl passed for ARB_multitexture.
+ % covglu
+ OpenGL GLU Coverage Test.
+ Version 1.3
+ covglu passed.
+
+ covglu passed at 1.1 level.
+
+
+ % covglx
+ OpenGL X Coverage Test.
+ Version 1.1.1
+
+ covglx passed.
+
+
+ % primtest -v
+ Open GL Primitives Test.
+ Version 1.2
+
+ [lots of output deleted]
+
+ 292159 Combinations.
+ primtest passed.
+
+
+
+
+ GL CONFORMANCE TEST
+ ===================
+
+ Render test images, read them back, then test for expected results.
+
+
+ ----------------------------------------------------------------------
+ % conform -v 2
+
+ OpenGL Conformance Test
+ Version 1.2
+
+ Setup Report.
+ Verbose level = 2.
+ Random number seed = 1.
+ Path inactive.
+
+ Visual Report.
+ Display ID = 35. Indirect Rendering.
+ Double Buffered.
+ RGBA (5, 6, 5, 0).
+ Stencil (8).
+ Depth (16).
+ Accumulation (16, 16, 16, 16).
+
+ Epsilon Report.
+ zero error epsilon = 0.000122.
+ RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
+ Depth buffer error epsilon = 0.000137.
+ Stencil plane error epsilon = 0.00404.
+ Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
+
+ Default State test passed.
+ Must Pass test passed.
+ Divide By Zero test passed.
+ Viewport Clamp test passed.
+ Matrix Stack test passed.
+ Matrix Stack Mixing test passed.
+ Vertex Order test passed.
+ Transformations test passed.
+ Transformation Normal test passed.
+ Viewport Transformation test passed.
+ Buffer Clear test passed.
+ Buffer Corners test passed.
+ Buffer Color test passed.
+ Color Ramp test passed.
+ Mask test passed.
+ Buffer Invariance test passed.
+ Accumulation Buffer test passed.
+ Select test passed.
+ Feedback test passed.
+ Scissor test passed.
+ Alpha Plane Function test passed.
+ Stencil Plane Clear test passed.
+ Stencil Plane Corners test passed.
+ Stencil Plane Operation test passed.
+ Stencil Plane Function test passed.
+ Depth Buffer Clear test passed.
+ Depth Buffer Function test passed.
+ Blend test passed.
+ Dither test passed.
+ LogicOp Function test does not exist for an RGB visual.
+ DrawPixels test passed.
+ CopyPixels test passed.
+ Bitmap Rasterization test passed.
+ Point Rasterization test passed.
+ Anti-aliased Point test passed.
+ Line Rasterization test passed.
+ Line Stipple test passed.
+ Anti-aliased Line test passed.
+ Horizontal and Vertical Line test passed.
+ Triangle Rasterization test passed.
+ Triangle Tile test passed.
+ Triangle Stipple test passed.
+ Anti-aliased Triangles test passed.
+ Quad Rasterization test passed.
+ Polygon Face test passed.
+ Polygon Cull test passed.
+ Polygon Stipple test passed.
+ Polygon Edge test passed.
+ Ambient Material test passed.
+ Ambient Scene test passed.
+ Attenuation Position test passed.
+ Diffuse Light test passed.
+ Diffuse Material test passed.
+ Diffuse Material Normal test passed.
+ Diffuse Material Positioning test passed.
+ Emissive Material test passed.
+ Specular Exponent test passed.
+ Specular Exponent Normal test passed.
+ Specular Local Eye Half Angle test passed.
+ Specular Light test passed.
+ Specular Material test passed.
+ Specular Normal test passed.
+ Spot Positioning test passed.
+ Spot Exponent and Positioning test passed.
+ Spot Exponent and Direction test passed.
+ Fog Exponential test passed.
+ Fog Linear test passed.
+ Texture Decal test passed.
+ Texture Border test passed.
+ Mipmaps Selection test passed.
+ Mipmaps Interpolation test passed.
+ Display Lists test passed.
+ Evaluator test passed.
+ Evaluator Color test passed.
+ Texture Edge Clamp test passed.
+ Packed Pixels test passed.
+ Texture LOD test passed.
+ Rescale Normal test passed.
+ Color Table test passed.
+ Convolution test passed.
+ Convolution Border test passed.
+ Histogram test passed.
+ MinMax test passed.
+ MultiTexture test passed.
+
+ Conform passed.
+
+ ----------------------------------------------------------------------
+ % conform -v 2 -p 1
+
+ OpenGL Conformance Test
+ Version 1.2
+
+ Setup Report.
+ Verbose level = 2.
+ Random number seed = 1.
+ Path level = 1.
+
+ Visual Report.
+ Display ID = 35. Indirect Rendering.
+ Double Buffered.
+ RGBA (5, 6, 5, 0).
+ Stencil (8).
+ Depth (16).
+ Accumulation (16, 16, 16, 16).
+
+ Epsilon Report.
+ zero error epsilon = 0.000122.
+ RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
+ Depth buffer error epsilon = 0.000137.
+ Stencil plane error epsilon = 0.00404.
+ Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
+
+ Default State test passed.
+ Must Pass test passed.
+ Divide By Zero test passed.
+ Viewport Clamp test passed.
+ Matrix Stack test passed.
+ Matrix Stack Mixing test passed.
+ Vertex Order test passed.
+ Transformations test passed.
+ Transformation Normal test passed.
+ Viewport Transformation test passed.
+ Buffer Clear test passed.
+ Buffer Corners test passed.
+ Buffer Color test passed.
+ Color Ramp test passed.
+ Mask test passed.
+ Buffer Invariance test passed.
+ Accumulation Buffer test passed.
+ Select test passed.
+ Feedback test passed.
+ Scissor test passed.
+ Alpha Plane Function test passed.
+ Stencil Plane Clear test passed.
+ Stencil Plane Corners test passed.
+ Stencil Plane Operation test passed.
+ Stencil Plane Function test passed.
+ Depth Buffer Clear test passed.
+ Depth Buffer Function test passed.
+ Blend test passed.
+ Dither test passed.
+ LogicOp Function test does not exist for an RGB visual.
+ DrawPixels test passed.
+ CopyPixels test passed.
+ Bitmap Rasterization test passed.
+ Point Rasterization test passed.
+ Anti-aliased Point test passed.
+ Line Rasterization test passed.
+ Line Stipple test passed.
+ Anti-aliased Line test passed.
+ Horizontal and Vertical Line test passed.
+ Triangle Rasterization test passed.
+ Triangle Tile test passed.
+ Triangle Stipple test passed.
+ Anti-aliased Triangles test passed.
+ Quad Rasterization test passed.
+ Polygon Face test passed.
+ Polygon Cull test passed.
+ Polygon Stipple test passed.
+ Polygon Edge test passed.
+ Ambient Material test passed.
+ Ambient Scene test passed.
+ Attenuation Position test passed.
+ Diffuse Light test passed.
+ Diffuse Material test passed.
+ Diffuse Material Normal test passed.
+ Diffuse Material Positioning test passed.
+ Emissive Material test passed.
+ Specular Exponent test passed.
+ Specular Exponent Normal test passed.
+ Specular Local Eye Half Angle test passed.
+ Specular Light test passed.
+ Specular Material test passed.
+ Specular Normal test passed.
+ Spot Positioning test passed.
+ Spot Exponent and Positioning test passed.
+ Spot Exponent and Direction test passed.
+ Fog Exponential test passed.
+ Fog Linear test passed.
+ Texture Decal test passed.
+ Texture Border test passed.
+ Mipmaps Selection test passed.
+ Mipmaps Interpolation test passed.
+ Display Lists test passed.
+ Evaluator test passed.
+ Evaluator Color test passed.
+ Texture Edge Clamp test passed.
+ Packed Pixels test passed.
+ Texture LOD test passed.
+ Rescale Normal test passed.
+ Color Table test passed.
+ Convolution test passed.
+ Convolution Border test passed.
+ Histogram test passed.
+ MinMax test passed.
+ MultiTexture test passed.
+
+ Conform passed.
+
+ ----------------------------------------------------------------------
+ % conform -v 2 -p 2
+
+ OpenGL Conformance Test
+ Version 1.2
+
+ Setup Report.
+ Verbose level = 2.
+ Random number seed = 1.
+ Path level = 2.
+
+ Visual Report.
+ Display ID = 35. Indirect Rendering.
+ Double Buffered.
+ RGBA (5, 6, 5, 0).
+ Stencil (8).
+ Depth (16).
+ Accumulation (16, 16, 16, 16).
+
+ Epsilon Report.
+ zero error epsilon = 0.000122.
+ RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
+ Depth buffer error epsilon = 0.000137.
+ Stencil plane error epsilon = 0.00404.
+ Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
+
+ Default State test passed.
+ Must Pass test passed.
+ Divide By Zero test passed.
+ Viewport Clamp test passed.
+ Matrix Stack test passed.
+ Matrix Stack Mixing test passed.
+ Vertex Order test passed.
+ Transformations test passed.
+ Transformation Normal test passed.
+ Viewport Transformation test passed.
+ Buffer Clear test passed.
+ Buffer Corners test passed.
+ Buffer Color test passed.
+ Color Ramp test passed.
+ Mask test passed.
+ Buffer Invariance test passed.
+ Accumulation Buffer test passed.
+ Select test passed.
+ Feedback test passed.
+ Scissor test passed.
+ Alpha Plane Function test passed.
+ Stencil Plane Clear test passed.
+ Stencil Plane Corners test passed.
+ Stencil Plane Operation test passed.
+ Stencil Plane Function test passed.
+ Depth Buffer Clear test passed.
+ Depth Buffer Function test passed.
+ Blend test passed.
+ Dither test passed.
+ LogicOp Function test does not exist for an RGB visual.
+ DrawPixels test passed.
+ CopyPixels test passed.
+ Bitmap Rasterization test passed.
+ Point Rasterization test passed.
+ Anti-aliased Point test passed.
+ Line Rasterization test passed.
+ Line Stipple test passed.
+ Anti-aliased Line test passed.
+ Horizontal and Vertical Line test passed.
+ Triangle Rasterization test passed.
+ Triangle Tile test passed.
+ Triangle Stipple test passed.
+ Anti-aliased Triangles test passed.
+ Quad Rasterization test passed.
+ Polygon Face test passed.
+ Polygon Cull test passed.
+ Polygon Stipple test passed.
+ Polygon Edge test passed.
+ Ambient Material test passed.
+ Ambient Scene test passed.
+ Attenuation Position test passed.
+ Diffuse Light test passed.
+ Diffuse Material test passed.
+ Diffuse Material Normal test passed.
+ Diffuse Material Positioning test passed.
+ Emissive Material test passed.
+ Specular Exponent test passed.
+ Specular Exponent Normal test passed.
+ Specular Local Eye Half Angle test passed.
+ Specular Light test passed.
+ Specular Material test passed.
+ Specular Normal test passed.
+ Spot Positioning test passed.
+ Spot Exponent and Positioning test passed.
+ Spot Exponent and Direction test passed.
+ Fog Exponential test passed.
+ Fog Linear test passed.
+ Texture Decal test passed.
+ Texture Border test passed.
+ Mipmaps Selection test passed.
+ Mipmaps Interpolation test passed.
+ Display Lists test passed.
+ Evaluator test passed.
+ Evaluator Color test passed.
+ Texture Edge Clamp test passed.
+ Packed Pixels test passed.
+ Texture LOD test passed.
+ Rescale Normal test passed.
+ Color Table test passed.
+ Convolution test passed.
+ Convolution Border test passed.
+ Histogram test passed.
+ MinMax test passed.
+ MultiTexture test passed.
+
+ Conform passed.
+
+ ----------------------------------------------------------------------
+ % conform -v 2 -p 3
+
+ OpenGL Conformance Test
+ Version 1.2
+
+ Setup Report.
+ Verbose level = 2.
+ Random number seed = 1.
+ Path level = 3.
+
+ Visual Report.
+ Display ID = 35. Indirect Rendering.
+ Double Buffered.
+ RGBA (5, 6, 5, 0).
+ Stencil (8).
+ Depth (16).
+ Accumulation (16, 16, 16, 16).
+
+ Epsilon Report.
+ zero error epsilon = 0.000122.
+ RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
+ Depth buffer error epsilon = 0.000137.
+ Stencil plane error epsilon = 0.00404.
+ Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
+
+ Default State test passed.
+ Must Pass test passed.
+ Divide By Zero test passed.
+ Viewport Clamp test passed.
+ Matrix Stack test passed.
+ Matrix Stack Mixing test passed.
+ Vertex Order test passed.
+ Transformations test passed.
+ Transformation Normal test passed.
+ Viewport Transformation test passed.
+ Buffer Clear test passed.
+ Buffer Corners test passed.
+ Buffer Color test passed.
+ Color Ramp test passed.
+ Mask test passed.
+ Buffer Invariance test passed.
+ Accumulation Buffer test passed.
+ Select test passed.
+ Feedback test passed.
+ Scissor test passed.
+ Alpha Plane Function test passed.
+ Stencil Plane Clear test passed.
+ Stencil Plane Corners test passed.
+ Stencil Plane Operation test passed.
+ Stencil Plane Function test passed.
+ Depth Buffer Clear test passed.
+ Depth Buffer Function test passed.
+ Blend test passed.
+ Dither test passed.
+ LogicOp Function test does not exist for an RGB visual.
+ DrawPixels test passed.
+ CopyPixels test passed.
+ Bitmap Rasterization test passed.
+ Point Rasterization test passed.
+ Anti-aliased Point test passed.
+ Line Rasterization test passed.
+ Line Stipple test passed.
+ Anti-aliased Line test passed.
+ Horizontal and Vertical Line test passed.
+ Triangle Rasterization test passed.
+ Triangle Tile test passed.
+ Triangle Stipple test passed.
+ Anti-aliased Triangles test passed.
+ Quad Rasterization test passed.
+ Polygon Face test passed.
+ Polygon Cull test passed.
+ Polygon Stipple test passed.
+ Polygon Edge test passed.
+ Ambient Material test passed.
+ Ambient Scene test passed.
+ Attenuation Position test passed.
+ Diffuse Light test passed.
+ Diffuse Material test passed.
+ Diffuse Material Normal test passed.
+ Diffuse Material Positioning test passed.
+ Emissive Material test passed.
+ Specular Exponent test passed.
+ Specular Exponent Normal test passed.
+ Specular Local Eye Half Angle test passed.
+ Specular Light test passed.
+ Specular Material test passed.
+ Specular Normal test passed.
+ Spot Positioning test passed.
+ Spot Exponent and Positioning test passed.
+ Spot Exponent and Direction test passed.
+ Fog Exponential test passed.
+ Fog Linear test passed.
+ Texture Decal test passed.
+ Texture Border test passed.
+ Mipmaps Selection test passed.
+ Mipmaps Interpolation test passed.
+ Display Lists test passed.
+ Evaluator test passed.
+ Evaluator Color test passed.
+ Texture Edge Clamp test passed.
+ Packed Pixels test passed.
+ Texture LOD test passed.
+ Rescale Normal test passed.
+ Color Table test passed.
+ Convolution test passed.
+ Convolution Border test passed.
+ Histogram test passed.
+ MinMax test passed.
+ MultiTexture test passed.
+
+ Conform passed.
+
+ ----------------------------------------------------------------------
+ % conform -v 2 -p 4
+
+ OpenGL Conformance Test
+ Version 1.2
+
+ Setup Report.
+ Verbose level = 2.
+ Random number seed = 1.
+ Path level = 4.
+
+ Visual Report.
+ Display ID = 35. Indirect Rendering.
+ Double Buffered.
+ RGBA (5, 6, 5, 0).
+ Stencil (8).
+ Depth (16).
+ Accumulation (16, 16, 16, 16).
+
+ Epsilon Report.
+ zero error epsilon = 0.000122.
+ RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
+ Depth buffer error epsilon = 0.000137.
+ Stencil plane error epsilon = 0.00404.
+ Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
+
+ Default State test passed.
+ Must Pass test passed.
+ Divide By Zero test passed.
+ Viewport Clamp test passed.
+ Matrix Stack test passed.
+ Matrix Stack Mixing test passed.
+ Vertex Order test passed.
+ Transformations test passed.
+ Transformation Normal test passed.
+ Viewport Transformation test passed.
+ Buffer Clear test passed.
+ Buffer Corners test passed.
+ Buffer Color test passed.
+ Color Ramp test passed.
+ Mask test passed.
+ Buffer Invariance test passed.
+ Accumulation Buffer test passed.
+ Select test passed.
+ Feedback test passed.
+ Scissor test passed.
+ Alpha Plane Function test passed.
+ Stencil Plane Clear test passed.
+ Stencil Plane Corners test passed.
+ Stencil Plane Operation test passed.
+ Stencil Plane Function test passed.
+ Depth Buffer Clear test passed.
+ Depth Buffer Function test passed.
+ Blend test passed.
+ Dither test passed.
+ LogicOp Function test does not exist for an RGB visual.
+ DrawPixels test passed.
+ CopyPixels test passed.
+ Bitmap Rasterization test passed.
+ Point Rasterization test passed.
+ Anti-aliased Point test passed.
+ Line Rasterization test passed.
+ Line Stipple test passed.
+ Anti-aliased Line test passed.
+ Horizontal and Vertical Line test passed.
+ Triangle Rasterization test passed.
+ Triangle Tile test passed.
+ Triangle Stipple test passed.
+ Anti-aliased Triangles test passed.
+ Quad Rasterization test passed.
+ Polygon Face test passed.
+ Polygon Cull test passed.
+ Polygon Stipple test passed.
+ Polygon Edge test passed.
+ Ambient Material test passed.
+ Ambient Scene test passed.
+ Attenuation Position test passed.
+ Diffuse Light test passed.
+ Diffuse Material test passed.
+ Diffuse Material Normal test passed.
+ Diffuse Material Positioning test passed.
+ Emissive Material test passed.
+ Specular Exponent test passed.
+ Specular Exponent Normal test passed.
+ Specular Local Eye Half Angle test passed.
+ Specular Light test passed.
+ Specular Material test passed.
+ Specular Normal test passed.
+ Spot Positioning test passed.
+ Spot Exponent and Positioning test passed.
+ Spot Exponent and Direction test passed.
+ Fog Exponential test passed.
+ Fog Linear test passed.
+ Texture Decal test passed.
+ Texture Border test passed.
+ Mipmaps Selection test passed.
+ Mipmaps Interpolation test passed.
+ Display Lists test passed.
+ Evaluator test passed.
+ Evaluator Color test passed.
+ Texture Edge Clamp test passed.
+ Packed Pixels test passed.
+ Texture LOD test passed.
+ Rescale Normal test passed.
+ Color Table test passed.
+ Convolution test passed.
+ Convolution Border test passed.
+ Histogram test passed.
+ MinMax test passed.
+ MultiTexture test passed.
+
+ Conform passed.
+
+
+
+ GLX CONFORMANCE TEST
+ ====================
+
+ % conformx -v 2
+
+ OpenGL X Conformance Test
+ Version 1.1.1
+
+ Setup Report.
+ Verbose level = 2.
+ Random number seed = 1.
+ Path inactive.
+
+ Visual Report.
+ Display ID = 34. Direct Rendering.
+ Double Buffered.
+ RGBA (8, 8, 8, 0).
+ Stencil (8).
+ Depth (16).
+ Accumulation (16, 16, 16, 16).
+
+ Epsilon Report.
+ zero error epsilon = 0.000122.
+ RGBA error epsilon = 0.00404, 0.00404, 0.00404, 0.000122.
+ Depth buffer error epsilon = 0.000137.
+ Stencil plane error epsilon = 0.00404.
+ Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
+
+ Default State test passed.
+ glReadPixels() test passed.
+ Font test passed.
+
+ Conformx passed.
-</body></html>
\ No newline at end of file
+NOTE: conformx passes for all machine path levels (-p option).
diff --git a/docs/debugging.rst b/docs/debugging.rst
index ca5f8e6c2b..e70a70fa6b 100644
--- a/docs/debugging.rst
+++ b/docs/debugging.rst
@@ -1,45 +1,21 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html lang="en"><head>
- <meta content="text/html; charset=utf-8" http-equiv="content-type"/>
- <title>Debugging Tips</title>
- <link href="mesa.css" rel="stylesheet" type="text/css"/>
-</head>
-<body>
-
-
-
-
-
-
-<h1>Debugging Tips</h1>
-
-<p>
- 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, 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 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 _mesa_error() to trap Mesa
- errors.
-</p>
-<p>
- There is a display list printing/debugging facility. See the end of
- src/dlist.c for details.
-</p>
-
-
-
-
-</body></html>
\ No newline at end of file
+Debugging Tips
+==============
+
+Normally Mesa (and OpenGL) records but does not notify the user of
+errors. It is up to the application to call ``glGetError`` to check for
+errors. Mesa supports an environment variable, MESA\_DEBUG, to help with
+debugging. If MESA\_DEBUG is defined, a message will be printed to
+stdout whenever an error occurs.
+
+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.
+
+In your debugger you can set a breakpoint in \_mesa\_error() to trap
+Mesa errors.
+
+There is a display list printing/debugging facility. See the end of
+src/dlist.c for details.
-- Truncated -- please see branch --
More information about the mesa-dev
mailing list