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