[Mesa-dev] [PATCH] docs: add a new page documenting known application issues

Fri Mar 29 03:50:53 PDT 2013

Looks good to me Brian.

Just a couple of comments.

----- Original Message -----
> Let's try to update this when we find other broken applications...

docs/ is growing a lot of stuff, with disparate target audiences. Maybe we could establish some sort of directory hierachary there:

 docs/apps/index.html
 docs/apps/viewperf.html
 docs/relnotes/1.2.3.4.5.html
 docs/specs/
 docs/devel/

So that target readers can more easily find stuff that's most relevant for them.

> ---
>  docs/application-issues.html |   83
>  ++++++++++++++++++++++++++++++++++++++++++
>  docs/contents.html           |    1 +
>  2 files changed, 84 insertions(+), 0 deletions(-)
>  create mode 100644 docs/application-issues.html
> 
> diff --git a/docs/application-issues.html b/docs/application-issues.html
> new file mode 100644
> index 0000000..6db0865
> --- /dev/null
> +++ b/docs/application-issues.html
> @@ -0,0 +1,83 @@
> +<!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>Application Issues</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>Application Issues</h1>
> +
> +<p>
> +This page documents known issues with some OpenGL applications.
> +</p>
> +
> +
> +<h2>Topogun</h2>
> +
> +<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>
> +
> +<p>
> +Mesa 9.1.2 and later (will) support a DRI configuration option to work
> around
> +this issue.
> +Using the <a href="http://dri.freedesktop.org/wiki/DriConf">driconf</a>
> 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>
> +

BTW, do users need to manually configure this, or will it be automatically set based on process name?

Jose