Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / mesa3d / d23fefe217b9fcd55a143cee5f2978d1b190e27d / . / docs / repository.html
blob: 7e515a6da54114091613b550fcaa15698ee89ffb [file] [log] [blame]
Brian464e3632006-12-05 16:14:14 -0700[diff] [blame]1<HTML>
2
Brian Paul1a366702010-02-05 13:18:31 -0700[diff] [blame]3<TITLE>Code Repository</TITLE>
Brian464e3632006-12-05 16:14:14 -0700[diff] [blame]4
5<link rel="stylesheet" type="text/css" href="mesa.css"></head>
6
7<BODY>
8
9<h1>Code Repository</h1>
10
11<p>
Brian Pauld23fefe2010-02-11 09:02:53 -0700[diff] [blame^]12Mesa uses <a href="http://git.or.cz/"target="_parent">git</a>
Brian464e3632006-12-05 16:14:14 -0700[diff] [blame]13as its source code management system.
Brian464e3632006-12-05 16:14:14 -0700[diff] [blame]14</p>
15
16The master git repository is hosted on
17<a href="http://www.freedesktop.org" target="_parent">freedesktop.org</a>.
18</p>
19
20<p>
21You may access the repository either as an
22<a href="#anonymous">anonymous user</a> (read-only) or as a
23<a href="#developer">developer</a>
24(read/write).
25</p>
26
27<p>
28You may also
29<a href="http://gitweb.freedesktop.org/?p=mesa/mesa.git"
30target="_parent">browse the git repository</a>.
31</p>
32
33
34<a name="anonymous">
35<H2>Anonymous git Access</H2>
36
37<p>
38To get the Mesa sources anonymously (read-only):
39</p>
40
41<ol>
42<li>Install the git software on your computer if needed.<br><br>
43<li>Get an initial, local copy of the repository with:
44 <pre>
45 git clone git://anongit.freedesktop.org/git/mesa/mesa
46 </pre>
47<li>Later, you can update your tree from the master repository with:
48 <pre>
49 git pull origin
50 </pre>
51</ol>
52
53
54<a name="developer">
55<H2>Developer git Access</H2>
56
57<p>
58Mesa developers need to first have an account on
59<a href="http://www.freedesktop.org" target="_parent">freedesktop.org</a>.
60To get an account, please ask Brian or the other Mesa developers for
61permission.
62Then, if there are no objections, follow this
63<a href="http://www.freedesktop.org/wiki/AccountRequests" target="_parent">
64procedure</a>.
65</p>
66
67<p>
68Once your account is established:
69</p>
70
71<ol>
72<li>Install the git software on your computer if needed.<br><br>
73<li>Get an initial, local copy of the repository with:
74 <pre>
75 git clone git+ssh://username@git.freedesktop.org/git/mesa/mesa
76 </pre>
77 Replace <em>username</em> with your actual login name.<br><br>
78<li>Later, you can update your tree from the master repository with:
79 <pre>
80 git pull origin
81 </pre>
82</ol>
83
84
Brianddbfa8c2008-02-28 08:03:04 -0700[diff] [blame]85<H2>Windows Users</H2>
86
87<p>
88If you're <a href="http://git.or.cz/gitwiki/WindowsInstall" target="_parent">
89using git on Windows</a> you'll want to enable automatic CR/LF conversion in
90your local copy of the repository:
91</p>
92<pre>
93 git config --global core.autocrlf true
94</pre>
95
96<p>
97This will cause git to convert all text files to CR+LF on checkout,
98and to LF on commit.
99</p>
100<p>
101Unix users don't need to set this option.
102</p>
103<br>
104
105
Brian464e3632006-12-05 16:14:14 -0700[diff] [blame]106<a name="developer">
107<H2>Development Branches</H2>
108
109<p>
110At any given time, there may be several active branches in Mesa's
111repository.
112Generally, the trunk contains the latest development (unstable)
113code while a branch has the latest stable code.
114</p>
115
116<p>
Brian18e9ca52007-02-20 09:24:06 -0700[diff] [blame]117The command <code>git-branch</code> will list all available branches.
118</p>
119
120<p>
121Questions about branch status/activity should be posted to the
122mesa3d-dev mailing list.
Brian464e3632006-12-05 16:14:14 -0700[diff] [blame]123</p>
124
125
126</body>
127</html>
128
129