Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / mesa3d / d9d84068e76bf1f6dcf578e39636d3100e6348a0 / . / docs / helpwanted.html
blob: 6d6058eb5180353d4bdcd3d9a66470a5ad6e4c96 [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 Bollecd5c7c2012-06-12 09:05:03 +0200[diff] [blame]10<h1>Help Wanted / To-Do List</h1>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]11
12<p>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]13We can always use more help with the Mesa project.
14Here are some specific ideas and areas where help would be appreciated:
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]15</p>
16
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]17<ol>
Brian7f80dc12007-10-31 09:44:01 -0600[diff] [blame]18<li>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]19<b>Driver patching and testing.</b>
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]20Patches are often posted to the <a href="http://lists.freedesktop.org/mailman/listinfo/mesa-dev" target="_parent">mesa-dev mailing list</a>, but aren't
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]21immediately checked into git because not enough people are testing them.
22Just applying patches, testing and reporting back is helpful.
23<li>
24<b>Driver debugging.</b>
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]25There are plenty of open bugs in the <a href="https://bugs.freedesktop.org/describecomponents.cgi?product=Mesa" target="_parent">bug database</a>.
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]26<li>
27<b>Remove aliasing warnings.</b>
28Enable gcc -Wstrict-aliasing=2 -fstrict-aliasing and track down aliasing
Brian7f80dc12007-10-31 09:44:01 -0600[diff] [blame]29issues in the code.
30<li>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]31<b>Windows driver building, testing and maintenance.</b>
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]32Fixing MSVC builds.
Brian7f80dc12007-10-31 09:44:01 -0600[diff] [blame]33<li>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]34<b>Maintenance and testing of lesser-used drivers.</b>
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]35Drivers such as i810, mach64, mga, r128, savage, sis, tdfx, unichrome, etc that aren't being maintained are being
36deprecated starting in Mesa 8.0.<br>
37They have to be ported to DRI2 to be accepted in mesa master again.
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]38<li>
39<b>Contribute more tests to
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]40<a href="http://people.freedesktop.org/~nh/piglit/" target="_parent">Piglit</a>.</b>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]41<li>
42<b>Automatic testing.
43</b>
44It would be great if someone would set up an automated system for grabbing
Andreas Boll24eebf42012-06-25 21:54:08 +0200[diff] [blame]45the latest Mesa code and run tests (such as piglit) then report issues to
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]46the mailing list.
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]47</ol>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]48
Andreas Bolld9d84062012-06-26 20:47:05 +0200[diff] [blame^]49<p>
50You can find some further To-do lists here:
51</p>
52<ul>
53 <li><a href="http://cgit.freedesktop.org/mesa/mesa/tree/docs/GL3.txt"
54 target="_parent"><b>GL3.txt</b></a></li>
55 <li><a href="http://cgit.freedesktop.org/mesa/mesa/tree/src/gallium/docs/llvm-todo.txt"
56 target="_parent"><b>LLVMpipe - todo</b></a></li>
57 <li><a href="http://dri.freedesktop.org/wiki/MissingFunctionality"
58 target="_parent"><b>MissingFunctionality</b></a></li>
59 <li><a href="http://dri.freedesktop.org/wiki/R300ToDo"
60 target="_parent"><b>R300ToDo</b></a></li>
61</ul>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]62
63<p>
Brian Paulb6c41fd2009-01-22 09:58:52 -0700[diff] [blame]64If you want to do something new in Mesa, first join the Mesa developer's
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]65mailing list.
66Then post a message to propose what you want to do, just to make sure
67there's no issues.
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]68</p>
69
Andreas Bolldf2be222012-06-12 09:05:22 +0200[diff] [blame]70<p>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]71Anyone is welcome to contribute code to the Mesa project.
72By doing so, it's assumed that you agree to the code's licensing terms.
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]73</p>
74
75<p>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]76Finally:
Andreas Bolldf2be222012-06-12 09:05:22 +0200[diff] [blame]77</p>
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]78
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]79<ol>
Brian Paulf9010722005-02-10 15:18:26 +0000[diff] [blame]80<li>Try to write high-quality code that follows the existing style.
81<li>Use uniform indentation, write comments, use meaningful identifiers, etc.
82<li>Test your code thoroughly. Include test programs if appropriate.
Brian Paul0b27ace2003-03-08 17:38:57 +0000[diff] [blame]83</ol>
84
85
Andreas Bollecd5c7c2012-06-12 09:05:03 +0200[diff] [blame]86</body>
87</html>