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

Fri Mar 29 07:30:54 PDT 2013

On 03/29/2013 04:50 AM, Jose Fonseca wrote:
> 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.

Yeah, we could do that, but it would also involve updating a bunch of 
links in the documents too.  Someday.

>
>> ---
>>   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?

Manually.  Though the DRI conf tool can be used to set it 
per-application, I believe.

-Brian