Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / mesa3d / ca90cde81eb48a50286193c6bbef9ef47c70a0c6 / . / docs / helpwanted.html
blob: 859e65c88b18efd6df05236cfd30d69d6c048ffb [file] [log] [blame]
Andreas Bollecd5c7c2012-06-12 09:05:03 +0200[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html lang="en">
3<head>
4 <meta http-equiv="content-type" content="text/html; charset=utf-8">
5 <title>Help Wanted</title>
6 <link rel="stylesheet" type="text/css" href="mesa.css">
7</head>
8<body>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]9
Andreas Bollb5da52a2012-09-18 18:57:02 +0200[diff] [blame]10<div class="header">
11 <h1>The Mesa 3D Graphics Library</h1>
12</div>
13
14<iframe src="contents.html"></iframe>
15<div class="content">
16
Andreas Bollecd5c7c2012-06-12 09:05:03 +0200[diff] [blame]17<h1>Help Wanted / To-Do List</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]18
19<p>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]20We can always use more help with the Mesa project.
21Here are some specific ideas and areas where help would be appreciated:
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]22</p>
23
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]24<ol>
Brian7f80dc12007-10-31 09:44:01 -0600[diff] [blame]25<li>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]26<b>Driver patching and testing.</b>
Andreas Bolla73c59b2012-09-18 19:31:28 +0200[diff] [blame]27Patches are often posted to the <a href="http://lists.freedesktop.org/mailman/listinfo/mesa-dev">mesa-dev mailing list</a>, but aren't
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]28immediately checked into git because not enough people are testing them.
29Just applying patches, testing and reporting back is helpful.
30<li>
31<b>Driver debugging.</b>
Andreas Bolla73c59b2012-09-18 19:31:28 +0200[diff] [blame]32There are plenty of open bugs in the <a href="https://bugs.freedesktop.org/describecomponents.cgi?product=Mesa">bug database</a>.
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]33<li>
34<b>Remove aliasing warnings.</b>
35Enable gcc -Wstrict-aliasing=2 -fstrict-aliasing and track down aliasing
Brian7f80dc12007-10-31 09:44:01 -0600[diff] [blame]36issues in the code.
37<li>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]38<b>Windows driver building, testing and maintenance.</b>
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]39Fixing MSVC builds.
Brian7f80dc12007-10-31 09:44:01 -0600[diff] [blame]40<li>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]41<b>Contribute more tests to
Andreas Bolla73c59b2012-09-18 19:31:28 +0200[diff] [blame]42<a href="http://piglit.freedesktop.org/">Piglit</a>.</b>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]43<li>
44<b>Automatic testing.
45</b>
46It would be great if someone would set up an automated system for grabbing
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]47the latest Mesa code and run tests (such as piglit) then report issues to
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]48the mailing list.
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]49</ol>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]50
Andreas Bolld9d84062012-06-26 20:47:05 +0200[diff] [blame]51<p>
52You can find some further To-do lists here:
53</p>
Andreas Boll48e4eb62012-10-02 14:05:44 +0200[diff] [blame]54
55<p>
56<b>Common To-Do lists:</b>
57</p>
Andreas Bolld9d84062012-06-26 20:47:05 +0200[diff] [blame]58<ul>
Andreas Boll48e4eb62012-10-02 14:05:44 +0200[diff] [blame]59 <li><a href="http://cgit.freedesktop.org/mesa/mesa/tree/docs/GL3.txt">
60 <b>GL3.txt</b></a> - Status of OpenGL 3.x / 4.x features in Mesa.</li>
61 <li><a href="http://dri.freedesktop.org/wiki/MissingFunctionality">
62 <b>MissingFunctionality</b></a> - Detailed information about missing OpenGL features.</li>
63</ul>
64
65<p>
66<b>Driver specific To-Do lists:</b>
67</p>
68<ul>
69 <li><a href="http://cgit.freedesktop.org/mesa/mesa/tree/src/gallium/docs/llvm-todo.txt">
70 <b>LLVMpipe</b></a> - Software driver using LLVM for runtime code generation.</li>
71 <li><a href="http://dri.freedesktop.org/wiki/RadeonsiToDo">
72 <b>radeonsi</b></a> - Driver for AMD Southern Island.</li>
73 <li><a href="http://dri.freedesktop.org/wiki/R600ToDo">
74 <b>r600g</b></a> - Driver for ATI/AMD R600 - Northern Island.</li>
75 <li><a href="http://dri.freedesktop.org/wiki/R300ToDo">
76 <b>r300g</b></a> - Driver for ATI R300 - R500.</li>
77 <li><a href="http://cgit.freedesktop.org/mesa/mesa/tree/src/gallium/drivers/i915/TODO">
78 <b>i915g</b></a> - Driver for Intel i915/i945.</li>
Andreas Bolld9d84062012-06-26 20:47:05 +0200[diff] [blame]79</ul>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]80
81<p>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]82If you want to do something new in Mesa, first join the Mesa developer's
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]83mailing list.
84Then post a message to propose what you want to do, just to make sure
85there's no issues.
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]86</p>
87
Andreas Bolldf2be222012-06-12 09:05:22 +0200[diff] [blame]88<p>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]89Anyone is welcome to contribute code to the Mesa project.
90By doing so, it's assumed that you agree to the code's licensing terms.
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]91</p>
92
93<p>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]94Finally:
Andreas Bolldf2be222012-06-12 09:05:22 +0200[diff] [blame]95</p>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]96
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]97<ol>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]98<li>Try to write high-quality code that follows the existing style.
99<li>Use uniform indentation, write comments, use meaningful identifiers, etc.
100<li>Test your code thoroughly. Include test programs if appropriate.
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]101</ol>
102
Andreas Bollb5da52a2012-09-18 18:57:02 +0200[diff] [blame]103</div>
Andreas Bollecd5c7c2012-06-12 09:05:03 +0200[diff] [blame]104</body>
105</html>