/[gentoo]/xml/htdocs/proj/en/overlays/devguide.xml
Gentoo

Diff of /xml/htdocs/proj/en/overlays/devguide.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.18 Revision 1.19
11 <mail link="jokey">Markus Ullmann</mail> 11 <mail link="jokey">Markus Ullmann</mail>
12</author> 12</author>
13<author title="Author"> 13<author title="Author">
14 <mail link="robbat2">Robin H. Johnson</mail> 14 <mail link="robbat2">Robin H. Johnson</mail>
15</author> 15</author>
16<author title="Author">
17 <mail link="tampakrap">Theo Chatzimichos</mail>
18</author>
16 19
17<abstract>This guide helps developers understand how to use the Gentoo 20
18Overlays service.</abstract> 21<abstract>
22This guide helps developers and contributors understand how to
23use the Gentoo Overlays service.
24</abstract>
19 25
20<license/> 26<license/>
21 27
22<version>2.3</version> 28<version>2.4</version>
23<date>2009-01-18</date> 29<date>2010-05-01</date>
24 30
25<chapter> 31<chapter>
26<title>Introduction</title> 32<title>Introduction</title>
27 33
28<section> 34<section>
29<title>Audience</title> 35<title>Audience</title>
30<body> 36<body>
31<p>This document has been written for Gentoo developers and Gentoo staff members. If you are a Gentoo user, or you just want to start downloading and using overlays, please see <uri link="/proj/en/overlays/userguide.xml">the Gentoo Overlays User Guide</uri> instead.</p> 37
38<p>
39This document has been written for Gentoo developers and users that want to
40contribute. If you just want to start downloading and using overlays, please
41see the <uri link="/proj/en/overlays/userguide.xml">Gentoo Overlays User Guide</uri>
42instead.
43</p>
44
32</body> 45</body>
33</section> 46</section>
34 47
35<section> 48<section>
36<title>Who Can Use overlays.gentoo.org?</title> 49<title>Who Can Use overlays.gentoo.org?</title>
37<body> 50<body>
38<p>Any Gentoo project, or Gentoo developer, can have their own overlay hosted on (git.)overlays.gentoo.org, with the RSS feed from the changelog included on <uri link="http://overlays.gentoo.org">the overlays.gentoo.org planet</uri>.</p>
39 51
52<p>
53Any Gentoo project, Gentoo developer, or Gentoo user can have their own overlay
54hosted on *.overlays.gentoo.org, with the RSS feed from the changelog included
55on <uri link="http://overlays.gentoo.org">the overlays.gentoo.org planet</uri>.
56</p>
57
58<p>
40<p>Any User can download and use the contents of any hosted 59Any User can download and use the contents of any hosted
41overlay. If you choose, you can also give users write access to your 60overlay. If you choose, you can also give users write access to your
42overlay.</p> 61overlay.
62</p>
63
43</body> 64</body>
44</section> 65</section>
45 66
46<section> 67<section>
47<title>What Does overlays.gentoo.org Give Me?</title> 68<title>What Does overlays.gentoo.org Give Me?</title>
48<body> 69<body>
70
71<p>
49<p>The (git.)overlays.gentoo.org service currently provides:</p> 72The *.overlays.gentoo.org service currently provides:
50<ul> 73</p>
51<li><uri link="http://trac.edgewall.com">Trac</uri> (a wiki w/ integrated subversion browser), for quickly creating and maintaining documentation about your Subversion based overlay</li> 74
52<li>Publishing the changelog for your overlay on <uri link="http://overlays.gentoo.org/">the o.g.o homepage</uri>, so that everyone who's interested can see what's going on</li>
53<li><uri link="http://git.or.cz/gitwiki/Gitweb">gitweb</uri> - provides full-fledged web interface for viewing Git repositories.</li>
54</ul> 75<ul>
76 <li>
77 <uri link="http://trac.edgewall.com">Trac</uri>: a wiki with
78 integrated subversion browser), for quickly creating and maintaining
79 documentation about your Subversion based overlay
80 </li>
81 <li>
82 Publishing the changelog for your overlay on
83 <uri link="http://overlays.gentoo.org/">the o.g.o homepage</uri>, so
84 that everyone who's interested can see what's going on
85 </li>
86 <li>
87 <uri link="http://git.or.cz/gitwiki/Gitweb">Gitweb</uri>: provides
88 full-fledged web interface for viewing Git repositories.
89 </li>
90</ul>
55 91
92<p>
56<p>... all hosted on secure, backed-up Gentoo infrastructure, administered by 93... all hosted on secure, backed-up Gentoo infrastructure, administered by
57<uri link="/proj/en/infrastructure">the Gentoo Infrastructure team</uri> (hardware / base OS) and <uri link="/proj/en/overlays">the Gentoo Overlays team</uri> 94<uri link="/proj/en/infrastructure">the Gentoo Infrastructure team</uri>
58(wiki / VCS / ACLs).</p> 95(hardware / base OS) and <uri link="/proj/en/overlays">the Gentoo Overlays
96team</uri> (wiki / VCS / ACLs).
97</p>
59 98
99<p>
60<p>Each overlay has separate authentication lists for Trac, Subversion and Git. 100Each overlay has separate authentication lists for Trac, Subversion and Git.
61It's no problem at all to give someone write access to just Trac (e.g. for 101It's no problem at all to give someone write access to just Trac (e.g. for
62writing documentation) without giving them write access to Subversion.</p> 102writing documentation) without giving them write access to Subversion.
103</p>
104
63</body> 105</body>
64</section> 106</section>
65 107
66<section> 108<section>
67<title>Why Should We Use overlays.gentoo.org?</title> 109<title>Why Should We Use overlays.gentoo.org?</title>
68<body> 110<body>
111
112<p>
69<p>You don't have to. You don't have to have an overlay at all, and if you do 113You don't have to. You don't have to have an overlay at all, and if you do
70have one, you are absolutely free to host your own overlay somewhere else. 114have one, you are absolutely free to host your own overlay somewhere else.
71You don't have to host an overlay on o.g.o for it to be considered 115You don't have to host an overlay on o.g.o for it to be considered "official".
72"official".</p> 116</p>
73 117
118<p>
74<p>The advantage of using overlays.gentoo.org is that we already have everything 119The advantage of using overlays.gentoo.org is that we already have everything
75setup for you. You don't need to admin your own server, or worry about 120setup for you. You don't need to admin your own server, or worry about
76software upgrades. We take care of all of that for you.</p> 121software upgrades. We take care of all of that for you.
122</p>
123
77</body> 124</body>
78</section> 125</section>
79 126
80<section> 127<section>
81<title>When Should We Not Use overlays.gentoo.org?</title> 128<title>When Should We Not Use overlays.gentoo.org?</title>
82<body> 129<body>
130
131<p>
83<p>The purpose of o.g.o is to help bridge the gap between developers and users. 132The purpose of o.g.o is to help bridge the gap between developers and users.
84Gentoo is a community-based distribution, and we believe that our users are 133Gentoo is a community-based distribution, and we believe that our users are
85just as important a part of that community as developers are.</p> 134just as important a part of that community as developers are.
135</p>
86 136
137<p>
87<p>All of the overlays hosted on o.g.o are there for all users to download and 138All of the overlays hosted on o.g.o are there for all users to download and
88use. It's for users to make their own decision about what software they 139use. It's for users to make their own decision about what software they
89install on their computers - and that includes choosing to use your overlay. 140install on their computers - and that includes choosing to use your overlay.
90Some users will make bad decisions, and end up breaking their computer. They 141Some users will make bad decisions, and end up breaking their computer. They
91may even end up blaming Gentoo as a result. That's okay; these people 142may even end up blaming Gentoo as a result. That's okay; these people
92probably go around blaming everyone but themselves for their own 143probably go around blaming everyone but themselves for their own
93mistakes anyway, and there's probably nothing you can do to change that. 144mistakes anyway, and there's probably nothing you can do to change that.
94But that still doesn't give any of us the right to choose for them.</p> 145But that still doesn't give any of us the right to choose for them.
146</p>
95 147
148<p>
96<p>Users are free (in fact, they are encouraged) to provide constructive 149Users are free (in fact, they are encouraged) to provide constructive
97feedback about anything to do with Gentoo - including all of the overlays 150feedback about anything to do with Gentoo - including all of the overlays
98hosted on o.g.o. That feedback can come via bugs.g.o, via email to your 151hosted on o.g.o. That feedback can come via bugs.g.o, via email to your
99project team or directly to you, via the forums, or via IRC. We're not 152project team or directly to you, via the forums, or via IRC. We're not
100talking about genuinely abusive users; we have no time for those, and no-one 153talking about genuinely abusive users; we have no time for those, and no-one
101expects you to have any time for them either.</p> 154expects you to have any time for them either.
155</p>
102 156
157<warn>
103<warn>If you're not happy with users using your overlay, and / or if you don't want 158If you're not happy with users using your overlay, and / or if you don't want
104users bothering you about your overlay, then don't use o.g.o to host your 159users bothering you about your overlay, then don't use o.g.o to host your
105overlay.</warn> 160overlay, or remove your overlay from the overlays list (repositories.xml).
161</warn>
106 162
163<p>
107<p>o.g.o used to have restrictions of not being the $UPSTREAM for packages. 164o.g.o used to have restrictions of not being the $UPSTREAM for packages.
108This restriction has been adjusted. We do offer hosting as the $UPSTREAM now, 165This restriction has been adjusted. We do offer hosting as the $UPSTREAM now,
109but only for packages that are Gentoo-specific or important to the running of 166but only for packages that are Gentoo-specific or important to the running of
110Gentoo. Other hosting may be more suitable, some services in this vein are: 167Gentoo. Other hosting may be more suitable, some services in this vein are:
111<uri link="http://www.sourceforge.net/">SourceForge.net</uri>, <uri 168<uri link="http://www.sourceforge.net/">SourceForge.net</uri>, <uri
112link="http://www.berlios.de">Berlios</uri>, or Patrick's <uri 169link="http://www.berlios.de">Berlios</uri>, Patrick's <uri
113link="http://www.gentooexperimental.org">GentooExperimental.org</uri>.</p> 170link="http://www.gentooexperimental.org">GentooExperimental.org</uri>, <uri
171link="http://www.github.com">GitHub</uri> or <uri link="http://www.gitorious.org">
172Gitorious</uri>.
173</p>
174
114</body> 175</body>
115</section> 176</section>
116</chapter> 177</chapter>
117 178
118<chapter> 179<chapter>
119<title>Requesting An Overlay</title> 180<title>Requesting An Overlay</title>
120 181
121<section> 182<section>
122<title>Introduction</title> 183<title>Introduction</title>
123<body> 184<body>
124<p>There are two types of overlay - "project" overlays, and "developer" 185<p>There are three types of overlays: "project" overlays, "developer"
125overlays. The only difference between them is responsibility and 186overlays and user overlays. The only difference between them is responsibility
126accountability.</p> 187and accountability.</p>
127 188
128<impo>Before requesting an overlay, please make sure that you have read our <uri link="/proj/en/overlays/policy.xml">Policy Document</uri>. It clearly sets out what's allowed and what is not, and what your responsibilities will be.</impo> 189<impo>
190Before requesting an overlay, please make sure that you have read our
191<uri link="/proj/en/overlays/policy.xml">Policy Document</uri>. It clearly sets
192out what's allowed and what is not, and what your responsibilities will be.
193</impo>
194
129</body> 195</body>
130</section> 196</section>
131 197
132<section> 198<section>
133<title>Project Overlays</title> 199<title>Project Overlays</title>
134<body> 200<body>
135<p>"Project" overlays are overlays for official Gentoo projects. An example is <uri link="http://overlays.gentoo.org/proj/php">the PHP Overlay</uri>.</p>
136 201
202<p>
203"Project" overlays are overlays for official Gentoo projects. An example is
204<uri link="http://overlays.gentoo.org/proj/php">the PHP Overlay</uri>.
205</p>
206
207<p>
137<p>An official Gentoo project is a project that has a project page on 208An official Gentoo project is a project that has a project page on
138www.gentoo.org, and that has an elected lead. (This definition comes from the 209www.gentoo.org, and that has an elected lead. (This definition comes from the
139metastructure document). The project lead(s) are responsible for the project overlay, including its contents, and any problems it causes other Gentoo projects and developers.</p> 210metastructure document). The project lead(s) are responsible for the project
211overlay, including its contents, and any problems it causes other Gentoo projects
212and developers.
213</p>
140 214
215<p>
141<p>To request a SVN project overlay, the project's lead just needs to pop into 216To request a SVN project overlay, the project's lead just needs to pop into
142#gentoo-overlays on IRC and ask for an overlay to be created. Or, if he/she 217#gentoo-overlays on IRC and ask for an overlay to be created. Or, if he/she
143prefers, drop an email to overlays@gentoo.org. We'll take care of the rest, 218prefers, drop an email to overlays@gentoo.org. We'll take care of the rest,
144including granting write access to all the members of your project (as listed 219including granting write access to all the members of your project (as listed
145on your project page).</p> 220on your project page).
221</p>
146 222
223<p>
147<p>To request a Git project overlay, just visit the <uri 224To request a Git project overlay, just visit the <uri
148link="http://git.overlays.gentoo.org">git.overlays</uri> site, and follow the 225link="http://git.overlays.gentoo.org">git.overlays</uri> site, and follow the
149setup instructions, emailing the completed template as directed.</p> 226setup instructions, emailing the completed template as directed.
227</p>
150 228
229<p>
151<p>For an SVN request, we will:</p> 230For an SVN request, we will:
231</p>
232
152<ul> 233<ul>
234 <li>
153<li>create your overlay (trac site + svn)</li> 235 create your overlay (trac site + svn)
236 </li>
237 <li>
154<li>add your overlay's RSS feed to the o.g.o homepage</li> 238 add your overlay's RSS feed to the o.g.o homepage
239 </li>
240 <li>
155<li>create an o.g.o account for you if you don't already have one</li> 241 create an o.g.o account for you if you don't already have one
242 </li>
243 <li>
156<li>give you write access to your overlay's Trac wiki and Subversion 244 give you write access to your overlay's Trac wiki and Subversion
157repository</li> 245 repository
246 </li>
247 <li>
158<li>give write access to all project members who already have an o.g.o 248 give write access to all project members who already have an o.g.o
159account</li> 249 account
160</ul> 250 </li>
161
162<p>For an Git request, we will:</p>
163<ul> 251</ul>
252
253<p>
254For an Git request, we will:
255</p>
256
257<ul>
258 <li>
164<li>create your overlay (git, gitweb, no trac)</li> 259 create your overlay (git, gitweb, no trac)
260 </li>
261 <li>
165<li>add your overlay's RSS feed to the o.g.o homepage</li> 262 add your overlay's RSS feed to the o.g.o homepage
263 </li>
264 <li>
166<li>create an git.o.g.o account for you if you don't already have one</li> 265 create an git.o.g.o account for you if you don't already have one
266 </li>
267 <li>
167<li>give you write access to your overlays Git repository</li> 268 give you write access to your overlays Git repository
269 </li>
270 <li>
168<li>give write access to all project members who already have an o.g.o account</li> 271 give write access to all project members who already have an o.g.o account
272 </li>
169</ul> 273</ul>
170 274
171</body> 275</body>
172</section> 276</section>
173 277
174<section> 278<section>
175<title>Developer Overlays</title> 279<title>Developer Overlays</title>
176<body> 280<body>
177 281
282<p>
178<p>"Developer" overlays are overlays owned by individual Gentoo developers. One 283"Developer" overlays are overlays owned by individual Gentoo developers. One
179 example is <uri link="http://overlays.gentoo.org/dev/beandog">beandog's overlay</uri>.</p> 284example is <uri link="http://overlays.gentoo.org/dev/beandog">beandog's
285overlay</uri>.
286</p>
180 287
288<p>
181<p>If you have an @gentoo.org email address, and you've passed the ebuild quiz, 289If you have an @gentoo.org email address, and you've passed the ebuild quiz,
182then you can have your own developer overlay on o.g.o.</p> 290then you can have your own developer overlay on o.g.o.
291</p>
183 292
293<p>
184<p>To request a SVN developer overlay, just pop into #gentoo-overlays on IRC 294To request a SVN developer overlay, just pop into #gentoo-overlays on IRC
185and ask for an overlay to be created for you. Or, if you prefer, drop an email 295and ask for an overlay to be created for you. Or, if you prefer, drop an email
186to overlays@gentoo.org.</p> 296to overlays@gentoo.org.
297</p>
187 298
299<p>
188<p>To request a Git developer overlay, just visit the <uri 300To request a Git developer overlay, just visit the <uri
189link="http://git.overlays.gentoo.org">git.overlays</uri> site, and follow the 301link="http://git.overlays.gentoo.org">git.overlays</uri> site, and follow the
190setup instructions, emailing the completed template as directed.</p> 302setup instructions, emailing the completed template as directed.
303</p>
191 304
305<p>
192<p>For an SVN request, we will:</p> 306For an SVN request, we will:
307</p>
308
193<ul> 309<ul>
310 <li>
194<li>create your overlay (trac site + svn)</li> 311 create your overlay (trac site + svn)
312 </li>
313 <li>
195<li>add your overlay's RSS feed to the o.g.o homepage</li> 314 add your overlay's RSS feed to the o.g.o homepage
315 </li>
316 <li>
196<li>create an o.g.o account for you if you don't have one already</li> 317 create an o.g.o account for you if you don't have one already
318 </li>
319 <li>
197<li>give you write access to your overlay's Trac wiki and Subversion 320 give you write access to your overlay's Trac wiki and Subversion
198repository</li> 321 repository
199</ul> 322 </li>
200
201<p>For an Git request, we will:</p>
202<ul> 323</ul>
324
325<p>
326For an Git request, we will:
327</p>
328
329<ul>
330 <li>
203<li>create your overlay (git, gitweb, no trac)</li> 331 create your overlay (git, gitweb, no trac)
332 </li>
333 <li>
204<li>add your overlay's RSS feed to the o.g.o homepage</li> 334 add your overlay's RSS feed to the o.g.o homepage
335 </li>
336 <li>
205<li>create an git.o.g.o account for you if you don't already have one</li> 337 create an git.o.g.o account for you if you don't already have one
338 </li>
339 <li>
206<li>give you write access to your overlays Git repository</li> 340 give you write access to your overlays Git repository
341 </li>
207</ul> 342</ul>
343
208</body> 344</body>
209</section> 345</section>
210 346
211<section> 347<section>
212<title>A Word About Accounts</title> 348<title>A Word About Accounts</title>
213<body> 349<body>
350
351<p>
214<p>Because o.g.o is designed to support a blend of both Gentoo developers and 352Because o.g.o is designed to support a blend of both Gentoo developers and
215Gentoo users, we don't create 'real' system-level accounts on the o.g.o host. 353Gentoo users, we don't create 'real' system-level accounts on the o.g.o host.
216</p> 354</p>
217 355
218<impo>You do *not* have SSH access to o.g.o.</impo> 356<impo>You do *not* have SSH access to o.g.o.</impo>
357
219</body> 358</body>
220</section> 359</section>
221</chapter> 360</chapter>
222 361
223<chapter> 362<chapter>
224<title>Working With Your Overlay</title> 363<title>Working With Your Overlay</title>
225 364
226<section> 365<section>
227<title>Introduction</title> 366<title>Introduction</title>
228<body> 367<body>
368
369<p>
229<p>You can access your overlay as soon as it has been created. Project and 370You can access your overlay as soon as it has been created. Project and
230developer overlays have different URLs, so that everyone can tell one from the 371developer overlays have different URLs, so that everyone can tell one from the
231other, but otherwise they are identical in every way.</p> 372other, but otherwise they are identical in every way.
373</p>
232 374
375<p>
233<p>There are *no* read restrictions on overlays or wikis. Everyone has full 376There are *no* read restrictions on overlays or wikis. Everyone has full
234read access to all overlays and wikis. If you need a 'secret' overlay of some 377read access to all overlays and wikis. If you need a 'secret' overlay of some
235kind, then o.g.o is not for you.</p> 378kind, then o.g.o is not for you.
379</p>
380
236</body> 381</body>
237</section> 382</section>
238 383
239<section> 384<section>
240<title>Accessing Project Overlays</title> 385<title>Accessing Project Overlays</title>
241<body> 386<body>
387
388<p>
242<p>If your project overlay is called 'foo', your Trac wiki site will be 389If your project overlay is called 'foo', your Trac wiki site will be
243here: http://overlays.gentoo.org/proj/foo/</p> 390here: http://overlays.gentoo.org/proj/foo/
391</p>
244 392
393<p>
245<p>To checkout your Subversion repository, use:</p> 394To checkout your Subversion repository, use:
246<pre caption="Checkout your project overlay">svn co https://overlays.gentoo.org/svn/proj/foo/</pre> 395</p>
247 396
397<pre caption="Checkout your project overlay">
398svn co https://overlays.gentoo.org/svn/proj/foo/</pre>
399
400<p>
248<p>While you may perform read-only actions via unsecure HTTP, you must perform 401While you may perform read-only actions via unsecure HTTP, you must perform
249all commits via HTTPS. If you need to switch between modes, use:</p> 402all commits via HTTPS. If you need to switch between modes, use:
250<pre caption="Switching your project overlay from HTTP to HTTPS">svn sw --relocate http://overlays.gentoo.org/svn/proj/foo/ https://overlays.gentoo.org/svn/proj/foo/</pre> 403</p>
251 404
252<p>We maintain <uri link="http://overlays.gentoo.org/proj/">a full list of project overlays hosted on overlays.gentoo.org</uri>.</p> 405<pre caption="Switching your project overlay from HTTP to HTTPS">
406svn sw --relocate http://overlays.gentoo.org/svn/proj/foo/
407https://overlays.gentoo.org/svn/proj/foo/</pre>
408
409<p>
410We maintain <uri link="http://overlays.gentoo.org/proj/">a full list of
411project overlays hosted on overlays.gentoo.org</uri>.
412</p>
413
253</body> 414</body>
254</section> 415</section>
255 416
256<section> 417<section>
257<title>Accessing Developer Overlays</title> 418<title>Accessing Developer Overlays</title>
258<body> 419<body>
420
421<p>
259<p>If your Gentoo email address is 'foo@gentoo.org', your Trac wiki site will be 422If your Gentoo email address is 'foo@gentoo.org', your Trac wiki site will be
260here: http://overlays.gentoo.org/dev/foo/</p> 423here: http://overlays.gentoo.org/dev/foo/
424</p>
261 425
426<p>
262<p>To checkout your Subversion repository, use:</p> 427To checkout your Subversion repository, use:
263<pre caption="Checkout your developer overlay">svn co https://overlays.gentoo.org/svn/dev/foo/</pre> 428</p>
264 429
430<pre caption="Checkout your developer overlay">svn co
431https://overlays.gentoo.org/svn/dev/foo/</pre>
432
433<p>
265<p>While you may perform read-only actions via unsecure HTTP, you must perform 434While you may perform read-only actions via unsecure HTTP, you must perform
266all commits via HTTPS. If you need to switch between modes, use:</p> 435all commits via HTTPS. If you need to switch between modes, use:
267<pre caption="Switching your developer overlay from HTTP to HTTPS">svn sw --relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.gentoo.org/svn/dev/foo/</pre> 436</p>
268 437
269<p>We maintain <uri link="http://overlays.gentoo.org/dev/">a full list of developer overlays hosted on overlays.gentoo.org</uri>.</p> 438<pre caption="Switching your developer overlay from HTTP to HTTPS">svn sw
439--relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.gentoo.org/svn/dev/foo/</pre>
440
441<p>
442We maintain <uri link="http://overlays.gentoo.org/dev/">a full list of
443developer overlays hosted on overlays.gentoo.org</uri>.
444</p>
445
270</body> 446</body>
271</section> 447</section>
272 448
273<section> 449<section>
274<title>Getting Started With Trac</title> 450<title>Getting Started With Trac</title>
275<body> 451<body>
276<p>Your overlay comes with <uri link="http://trac.edgewall.com">Trac</uri>. Trac is a wiki, a subversion repository browser, and a bug tracking system that's 452
453<p>
454Your overlay comes with <uri link="http://trac.edgewall.com">Trac</uri>.
455Trac is a wiki, a subversion repository browser, and a bug tracking system that's
277very popular with open source developers.</p> 456very popular with open source developers.
457</p>
278 458
279<p>We have disabled the bug tracking system in Trac. Use <uri link="http://bugs.gentoo.org">Gentoo's bugzilla</uri> for bug tracking your overlay.</p> 459<p>
460We have disabled the bug tracking system in Trac. Use <uri
461link="http://bugs.gentoo.org">Gentoo's bugzilla</uri> for bug tracking your
462overlay.
463</p>
280 464
281<p>Your overlay's RSS feed - the one that is shown on <uri link="http://overlays.gentoo.org">the o.g.o homepage</uri> - comes from Trac's Timeline page or GitWeb's summary.</p> 465<p>
466Your overlay's RSS feed - the one that is shown on <uri
467link="http://overlays.gentoo.org">the o.g.o homepage</uri> - comes from Trac's
468Timeline page or GitWeb's summary.
469</p>
282 470
283</body> 471</body>
284</section> 472</section>
285 473
286<section> 474<section>
287<title>Getting Started With Subversion</title> 475<title>Getting Started With Subversion</title>
288<body> 476<body>
477
289<p>The advantages of Subversion over CVS include real versioning of directories, full changeset support, and it's much easier to do branching if you need to. The main disadvantage of Subversion is that it is slower than CVS, and that a local Subversion checkout requires more disk space.</p> 478<p>The advantages of Subversion over CVS include real versioning of directories, full changeset support, and it's much easier to do branching if you need to. The main disadvantage of Subversion is that it is slower than CVS, and that a local Subversion checkout requires more disk space.</p>
290 479
291<p>If you have never used Subversion before, the online book is an excellent way to learn Subversion. You can buy it in dead-tree format too if you prefer.</p> 480<p>If you have never used Subversion before, the online book is an excellent way to learn Subversion. You can buy it in dead-tree format too if you prefer.</p>
292 481
293<p>Here are some basic commands to get you started.</p> 482<p>Here are some basic commands to get you started.</p>

Legend:
Removed from v.1.18  
changed lines
  Added in v.1.19

  ViewVC Help
Powered by ViewVC 1.1.20