<abstract>This guide helps developers understand how to use the Gentoo

20

12

Overlays service.</abstract>

21

<abstract>

22

This guide helps developers and contributors understand how to

23

use the Gentoo Overlays service.

24

</abstract>

13

25

14

<license/>

26

<license/>

15

27

16

<version>1.0</version>

28

<version>2.4</version>

17

<date>2006-07-29</date>

29

<date>2010-05-01</date>

18

30

19

<chapter>

31

<chapter>

20

<title>Introduction</title>

32

<title>Introduction</title>

21

33

22

<section>

34

<section>

23

<title>Audience</title>

35

<title>Audience</title>

24

<body>

36

<body>

25

<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>

26

</body>

27

</section>

28

37

29

<section>

38

<p>

30

<title>What is overlays.gentoo.org?</title>

39

This document has been written for Gentoo developers and users that want to

31

<body>

40

contribute. If you just want to start downloading and using overlays, please

32

<p><uri link="http://overlays.gentoo.org">overlays.gentoo.org</uri> provides social workspaces to allow Gentoo projects, developers and users to collaborate together on tomorrow's Gentoo packages. We do this by hosting overlays for Gentoo projects, and overlays for Gentoo developers.</p>

<p>Any Gentoo project, or Gentoo developer, can have their own overlay hosted on overlays.gentoo.org, with the RSS feed from the changelog included on <uri link="http://overlays.gentoo.org">the overlays.gentoo.org homepage</uri>.</p>

40

51

41

<p>Any Gentoo staff member or user (ie, anyone who doesn't have write access to

52

<p>

42

the main Portage package tree) can download and use the contents of any hosted

53

Any Gentoo project, Gentoo developer, or Gentoo user can have their own overlay

54

hosted on *.overlays.gentoo.org, with the RSS feed from the changelog included

<p>There are two types of overlay - "project" overlays, and "developer"

185

<p>There are three types of overlays: "project" overlays, "developer"

124

overlays. The only difference between them is responsibility and

186

overlays and user overlays. The only difference between them is responsibility

125

accountability.</p>

187

and accountability.</p>

126

188

127

<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>

<p>We have installed several Trac macros, which we hope will make your wiki even more useful to you. If you come across any additional macros that you'd like to see installed, please let us know, and we'll take a look at them.</p>

<li><uri link="http://trac-hacks.org/wiki/FootNoteMacro">FootNote</uri> - adds support for adding footnotes to a page</li>

268

<li><uri link="http://trac-hacks.org/wiki/TocMacro">TOC</uri> - adds support for publishing a Table of Contents on a page</li>

269

</ul>

270

470

271

</body>

471

</body>

272

</section>

472

</section>

273

473

274

<section>

474

<section>

275

<title>Getting Started With Subversion</title>

475

<title>Getting Started With Subversion</title>

276

<body>

476

<body>

277

<p>Your overlay comes with <uri link="http://subversion.tigris.org">Subversion</uri>, a modern alternative to CVS. 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>

278

477

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>

479

279

<p>If you have never used Subversion before, the <uri link="http://svnbook.red-bean.com/">online book</uri> 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>

<p>We are telling users to use layman to download and manage your overlay.

494

<p>We are telling users to use layman to download and manage your overlay.

294

layman 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>

495

layman 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>

295

496

296

<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>