/[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.15 Revision 1.16
7<author title="Author"> 7<author title="Author">
8 <mail link="stuart">Stuart Herbert</mail> 8 <mail link="stuart">Stuart Herbert</mail>
9</author> 9</author>
10<author title="Author"> 10<author title="Author">
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 16
17<abstract>This guide helps developers understand how to use the Gentoo 17<abstract>This guide helps developers understand how to use the Gentoo
18Overlays service.</abstract> 18Overlays service.</abstract>
19 19
20<license/> 20<license/>
21 21
22<version>2.2</version> 22<version>2.3</version>
23<date>2008-10-30</date> 23<date>2009-01-18</date>
24 24
25<chapter> 25<chapter>
26<title>Introduction</title> 26<title>Introduction</title>
27 27
28<section> 28<section>
29<title>Audience</title> 29<title>Audience</title>
30<body> 30<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> 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>
32</body> 32</body>
33</section> 33</section>
34 34
35<section> 35<section>
36<title>Who Can Use overlays.gentoo.org?</title> 36<title>Who Can Use overlays.gentoo.org?</title>
37<body> 37<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> 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>
293<p>Here are some basic commands to get you started.</p> 293<p>Here are some basic commands to get you started.</p>
294<pre caption="Checking out your overlay">svn co https://overlays.gentoo.org/proj/php</pre> 294<pre caption="Checking out your overlay">svn co https://overlays.gentoo.org/proj/php</pre>
295<pre caption="Seeing which files need committing">svn status</pre> 295<pre caption="Seeing which files need committing">svn status</pre>
296<pre caption="Adding files to your overlay">svn add my.ebuild</pre> 296<pre caption="Adding files to your overlay">svn add my.ebuild</pre>
297<pre caption="Committing your changes">svn commit -m 'My changelog entry'</pre> 297<pre caption="Committing your changes">svn commit -m 'My changelog entry'</pre>
298 298
299</body> 299</body>
300</section> 300</section>
301 301
302<section> 302<section>
303<title>Layman</title> 303<title>Layman</title>
304<body> 304<body>
305<p>We are telling users to use layman to download and manage your overlay. 305<p>We are telling users to use layman to download and manage your overlay.
306layman is a utility written by <mail link="wrobel@gentoo.org">Gunnar Wrobel</mail> which makes it very easy for users to work with overlays.</p> 306layman is a utility written by <mail link="wrobel@gentoo.org">Gunnar Wrobel</mail> which makes it very easy for users to work with overlays.</p>
307 307
308<p>To get started with using layman, see <uri link="http://www.gentoo.org/news/en/gwn/20060522-newsletter.xml">Gentoo Weekly News for 22nd May</uri>, <uri link="http://gentoo-wiki.com/TIP_Overlays#layman">this article on Gentoo-Wiki.com</uri>, or the man page that comes with layman.</p> 308<p>
309To get started with using layman, see <uri
310link="http://layman.sourceforge.net/">the homepage documentation</uri>, the <uri
311link="http://www.gentoo.org/news/en/gwn/20060522-newsletter.xml">Gentoo Weekly
312News for 22nd May</uri> or read <c>man layman</c>.
313</p>
309</body> 314</body>
310</section> 315</section>
311 316
312<section> 317<section>
313<title>Auto-Sync From Portage</title> 318<title>Auto-Sync From Portage</title>
314<body> 319<body>
315<p>Your packages in the Portage tree are always at risk of being changed without 320<p>Your packages in the Portage tree are always at risk of being changed without
316you knowing about it in advance. Arch teams need to be able to keyword 321you knowing about it in advance. Arch teams need to be able to keyword
317packages (and fix arch-specific brokenness), the QA team fix perceived 322packages (and fix arch-specific brokenness), the QA team fix perceived
318standards violations, and occaisionally developers will edit packages that 323standards violations, and occaisionally developers will edit packages that
319they shouldn't.</p> 324they shouldn't.</p>
320 325
321<p>You need to make sure that the changes made in Portage aren't lost the next 326<p>You need to make sure that the changes made in Portage aren't lost the next
322time you copy your packages from your overlay back into Portage.</p> 327time you copy your packages from your overlay back into Portage.</p>
323 328

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.16

  ViewVC Help
Powered by ViewVC 1.1.20