Introduction

=20 -2.3 -2009-01-18 +2.4 +2010-05-01 =20 Introduction @@ -28,89 +34,144 @@

Audience -

This document has been written for Gentoo developers and Gentoo staff= members. If you are a Gentoo user, or you just want to start downloadin= g and using overlays, please see the Gentoo Overlays User Guide instead.

+ +

+This document has been written for Gentoo developers and users that want= to +contribute. If you just want to start downloading and using overlays, pl= ease +see the Gentoo Overlays Us= er Guide +instead. +

=20

Who Can Use overlays.gentoo.org? -

Any Gentoo project, or Gentoo developer, can have their own overlay h= osted on (git.)overlays.gentoo.org, with the RSS feed from the changelog = included on the overlays.gentoo.= org planet.

=20 -

Any User can download and use the contents of any hosted +

+Any Gentoo project, Gentoo developer, or Gentoo user can have their own = overlay +hosted on *.overlays.gentoo.org, with the RSS feed from the changelog in= cluded +on the overlays.gentoo.org plan= et. +

+ +

+Any User can download and use the contents of any hosted overlay. If you choose, you can also give users write access to your -overlay.

+overlay. +

=20

What Does overlays.gentoo.org Give Me? -

The (git.)overlays.gentoo.org service currently provides:

+ +

+The *.overlays.gentoo.org service currently provides: +

Trac (a wiki w/ integra= ted subversion browser), for quickly creating and maintaining documentati= on about your Subversion based overlay
Publishing the changelog for your overlay on the o.g.o homepage, so that everyone who's inter= ested can see what's going on
gitweb - provide= s full-fledged web interface for viewing Git repositories.
+ Trac: a wiki with=20 + integrated subversion browser), for quickly creating and maintaining + documentation about your Subversion based overlay +
+ Publishing the changelog for your overlay on + the o.g.o homepage, = so + that everyone who's interested can see what's going on +
+ Gitweb: provides + full-fledged web interface for viewing Git repositories. +

=20 -

... all hosted on secure, backed-up Gentoo infrastructure, administer= ed by -the Gentoo Infrastructure team (hardware / base OS) and the Gentoo Ov= erlays team -(wiki / VCS / ACLs).

+... all hosted on secure, backed-up Gentoo infrastructure, administered = by +the Gentoo Infrastructure team +(hardware / base OS) and the Gentoo Over= lays +team (wiki / VCS / ACLs). +

=20 -

Each overlay has separate authentication lists for Trac, Subversion a= nd Git. +

+Each overlay has separate authentication lists for Trac, Subversion and = Git. It's no problem at all to give someone write access to just Trac (e.g. f= or -writing documentation) without giving them write access to Subversion. +writing documentation) without giving them write access to Subversion. +

=20

Why Should We Use overlays.gentoo.org? -

You don't have to. You don't have to have an overlay at all, and if = you do + +

+You don't have to. You don't have to have an overlay at all, and if you= do have one, you are absolutely free to host your own overlay somewhere els= e. -You don't have to host an overlay on o.g.o for it to be considered -"official".

+You don't have to host an overlay on o.g.o for it to be considered "offi= cial". +

=20 -

The advantage of using overlays.gentoo.org is that we already have ev= erything +

+The advantage of using overlays.gentoo.org is that we already have every= thing setup for you. You don't need to admin your own server, or worry about -software upgrades. We take care of all of that for you.

+software upgrades. We take care of all of that for you. +

=20

When Should We Not Use overlays.gentoo.org? -

The purpose of o.g.o is to help bridge the gap between developers and= users. + +

+The purpose of o.g.o is to help bridge the gap between developers and us= ers. Gentoo is a community-based distribution, and we believe that our users = are -just as important a part of that community as developers are.

+just as important a part of that community as developers are. +

=20 -

All of the overlays hosted on o.g.o are there for all users to downlo= ad and +

+All of the overlays hosted on o.g.o are there for all users to download = and use. It's for users to make their own decision about what software they install on their computers - and that includes choosing to use your over= lay. -Some users will make bad decisions, and end up breaking their computer. = They -may even end up blaming Gentoo as a result. That's okay; these people +Some users will make bad decisions, and end up breaking their computer. = They +may even end up blaming Gentoo as a result. That's okay; these people probably go around blaming everyone but themselves for their own mistakes anyway, and there's probably nothing you can do to change that. -But that still doesn't give any of us the right to choose for them.

+But that still doesn't give any of us the right to choose for them. +

=20 -

Users are free (in fact, they are encouraged) to provide constructive +

+Users are free (in fact, they are encouraged) to provide constructive feedback about anything to do with Gentoo - including all of the overlay= s hosted on o.g.o. That feedback can come via bugs.g.o, via email to your project team or directly to you, via the forums, or via IRC. We're not talking about genuinely abusive users; we have no time for those, and no= -one -expects you to have any time for them either.

+expects you to have any time for them either. +

=20 -If you're not happy with users using your overlay, and / or if you= don't want + +If you're not happy with users using your overlay, and / or if you don't= want users bothering you about your overlay, then don't use o.g.o to host you= r -overlay. +overlay, or remove your overlay from the overlays list (repositories.xml= ). + =20 -

o.g.o used to have restrictions of not being the $UPSTREAM for packag= es. +

+o.g.o used to have restrictions of not being the $UPSTREAM for packages. This restriction has been adjusted. We do offer hosting as the $UPSTREAM= now, but only for packages that are Gentoo-specific or important to the runni= ng of Gentoo. Other hosting may be more suitable, some services in this vein a= re: SourceForge.net, Berlios, or Patrick's GentooExperimental.org.=

+link=3D"http://www.berlios.de">Berlios, Patrick's GentooExperimental.org,= GitHub or +Gitorious. +

@@ -121,51 +182,94 @@

Introduction -

There are two types of overlay - "project" overlays, and "developer" -overlays. The only difference between them is responsibility and -accountability.

There are three types of overlays: "project" overlays, "developer" +overlays and user overlays. The only difference between them is responsi= bility +and accountability.

+ + +Before requesting an overlay, please make sure that you have read our +Policy Document. It cle= arly sets +out what's allowed and what is not, and what your responsibilities will = be. + =20 -Before requesting an overlay, please make sure that you have read = our Policy Document. It= clearly sets out what's allowed and what is not, and what your responsib= ilities will be.

=20

Project Overlays -

"Project" overlays are overlays for official Gentoo projects. An exa= mple is the PHP Overlay= .

=20 -

An official Gentoo project is a project that has a project page on -www.gentoo.org, and that has an elected lead. (This definition comes fr= om the -metastructure document). The project lead(s) are responsible for the pr= oject overlay, including its contents, and any problems it causes other G= entoo projects and developers.

+"Project" overlays are overlays for official Gentoo projects. An example= is +the PHP Overlay. +

=20 -

To request a SVN project overlay, the project's lead just needs to po= p into +

+An official Gentoo project is a project that has a project page on +www.gentoo.org, and that has an elected lead. (This definition comes fro= m the +metastructure document). The project lead(s) are responsible for the pr= oject +overlay, including its contents, and any problems it causes other Gentoo= projects +and developers. +

+ +

+To request a SVN project overlay, the project's lead just needs to pop i= nto #gentoo-overlays on IRC and ask for an overlay to be created. Or, if he= /she prefers, drop an email to overlays@gentoo.org. We'll take care of the r= est, including granting write access to all the members of your project (as l= isted -on your project page).

+on your project page). +

=20 -

To request a Git project overlay, just visit the +To request a Git project overlay, just visit the git.overlays site, and fol= low the -setup instructions, emailing the completed template as directed.

+setup instructions, emailing the completed template as directed. +

+ +

+For an SVN request, we will: +

=20 -

For an SVN request, we will:

create your overlay (trac site + svn)
add your overlay's RSS feed to the o.g.o homepage
create an o.g.o account for you if you don't already have one
give you write access to your overlay's Trac wiki and Subversion -repository
give write access to all project members who already have an o.g.o -account

- -

For an Git request, we will:

create your overlay (git, gitweb, no trac)
add your overlay's RSS feed to the o.g.o homepage
create an git.o.g.o account for you if you don't already have one -
give you write access to your overlays Git repository
give write access to all project members who already have an o.g.o a= ccount
+ create your overlay (trac site + svn) +
+ add your overlay's RSS feed to the o.g.o homepage +
+ create an o.g.o account for you if you don't already have one +
+ give you write access to your overlay's Trac wiki and Subversion + repository +
+ give write access to all project members who already have an o.g.o + account +

+ +

+For an Git request, we will: +

+ +

+ create your overlay (git, gitweb, no trac) +
+ add your overlay's RSS feed to the o.g.o homepage +
+ create an git.o.g.o account for you if you don't already have one +
+ give you write access to your overlays Git repository +
+ give write access to all project members who already have an o.g.o a= ccount +

=20 @@ -175,47 +279,82 @@ Developer Overlays =20 -

"Developer" overlays are overlays owned by individual Gentoo develope= rs. One - example is beandog= 's overlay.

+"Developer" overlays are overlays owned by individual Gentoo developers.= One +example is beandog'= s +overlay. +

=20 -

If you have an @gentoo.org email address, and you've passed the ebuil= d quiz, -then you can have your own developer overlay on o.g.o.

+If you have an @gentoo.org email address, and you've passed the ebuild q= uiz, +then you can have your own developer overlay on o.g.o. +

=20 -

To request a SVN developer overlay, just pop into #gentoo-overlays on= IRC +

+To request a SVN developer overlay, just pop into #gentoo-overlays on IR= C and ask for an overlay to be created for you. Or, if you prefer, drop a= n email -to overlays@gentoo.org.

+to overlays@gentoo.org. +

=20 -

To request a Git developer overlay, just visit the +To request a Git developer overlay, just visit the git.overlays site, and fol= low the -setup instructions, emailing the completed template as directed.

+setup instructions, emailing the completed template as directed. +

+ +

+For an SVN request, we will: +

=20 -

For an SVN request, we will:

create your overlay (trac site + svn)
add your overlay's RSS feed to the o.g.o homepage
create an o.g.o account for you if you don't have one already
give you write access to your overlay's Trac wiki and Subversion -repository
+ create your overlay (trac site + svn) +
+ add your overlay's RSS feed to the o.g.o homepage +
+ create an o.g.o account for you if you don't have one already +
+ give you write access to your overlay's Trac wiki and Subversion + repository +

=20 -

For an Git request, we will:

+For an Git request, we will: +

create your overlay (git, gitweb, no trac)
add your overlay's RSS feed to the o.g.o homepage
create an git.o.g.o account for you if you don't already have one -
give you write access to your overlays Git repository
+ create your overlay (git, gitweb, no trac) +
+ add your overlay's RSS feed to the o.g.o homepage +
+ create an git.o.g.o account for you if you don't already have one +
+ give you write access to your overlays Git repository +

=20

A Word About Accounts -

Because o.g.o is designed to support a blend of both Gentoo developer= s and + +

+Because o.g.o is designed to support a blend of both Gentoo developers a= nd Gentoo users, we don't create 'real' system-level accounts on the o.g.o = host.

=20 You do *not* have SSH access to o.g.o. +

@@ -226,59 +365,108 @@

Introduction -

You can access your overlay as soon as it has been created. Project = and + +

+You can access your overlay as soon as it has been created. Project and developer overlays have different URLs, so that everyone can tell one fr= om the -other, but otherwise they are identical in every way.

+other, but otherwise they are identical in every way. +

=20 -

There are *no* read restrictions on overlays or wikis. Everyone has = full +

+There are *no* read restrictions on overlays or wikis. Everyone has ful= l read access to all overlays and wikis. If you need a 'secret' overlay o= f some -kind, then o.g.o is not for you.

+kind, then o.g.o is not for you. +

=20

Accessing Project Overlays -

If your project overlay is called 'foo', your Trac wiki site will be -here: http://overlays.gentoo.org/proj/foo/

=20 -

To checkout your Subversion repository, use:

svn co https://overlays.g=
entoo.org/svn/proj/foo/

+If your project overlay is called 'foo', your Trac wiki site will be +here: http://overlays.gentoo.org/proj/foo/ +

+ +

+To checkout your Subversion repository, use: +

=20 -

While you may perform read-only actions via unsecure HTTP, you must p= erform -all commits via HTTPS. If you need to switch between modes, use:

svn s=
w --relocate http://overlays.gentoo.org/svn/proj/foo/ https://overlays.ge=
ntoo.org/svn/proj/foo/

+svn co https://overlays.gentoo.org/svn/proj/foo/

+ +

+While you may perform read-only actions via unsecure HTTP, you must perf= orm +all commits via HTTPS. If you need to switch between modes, use: +

+ +

+svn sw --relocate http://overlays.gentoo.org/svn/proj/foo/
+https://overlays.gentoo.org/svn/proj/foo/

+ +

+We maintain a full list o= f +project overlays hosted on overlays.gentoo.org. +

=20 -

We maintain a full lis= t of project overlays hosted on overlays.gentoo.org.

=20

Accessing Developer Overlays -

If your Gentoo email address is 'foo@gentoo.org', your Trac wiki site= will be -here: http://overlays.gentoo.org/dev/foo/

=20 -

To checkout your Subversion repository, use:

svn co https://overlays=
.gentoo.org/svn/dev/foo/

+If your Gentoo email address is 'foo@gentoo.org', your Trac wiki site wi= ll be +here: http://overlays.gentoo.org/dev/foo/ +

=20 -

While you may perform read-only actions via unsecure HTTP, you must p= erform -all commits via HTTPS. If you need to switch between modes, use:

svn=
 sw --relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.g=
entoo.org/svn/dev/foo/

+To checkout your Subversion repository, use: +

+ +

svn co
+https://overlays.gentoo.org/svn/dev/foo/

+ +

+While you may perform read-only actions via unsecure HTTP, you must perf= orm +all commits via HTTPS. If you need to switch between modes, use: +

+ +

svn=
 sw
+--relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.gent=
oo.org/svn/dev/foo/

+ +

+We maintain a full list of +developer overlays hosted on overlays.gentoo.org. +

=20 -

We maintain a full list= of developer overlays hosted on overlays.gentoo.org.

=20

Getting Started With Trac -

Your overlay comes with Trac. Trac is a wiki, a subversion repository browser, and a bug trackin= g system that's -very popular with open source developers.

=20 -

We have disabled the bug tracking system in Trac. Use Gentoo's bugzilla for bug tracking your over= lay.

+Your overlay comes with Trac. +Trac is a wiki, a subversion repository browser, and a bug tracking syst= em that's +very popular with open source developers. +

=20 -

Your overlay's RSS feed - the one that is shown on the o.g.o homepage - comes from Trac's Timel= ine page or GitWeb's summary.

+We have disabled the bug tracking system in Trac. Use Gentoo's bugzilla for bug tracking= your +overlay. +

+ +

+Your overlay's RSS feed - the one that is shown on the o.g.o homepage - comes fro= m Trac's +Timeline page or GitWeb's summary. +

=20

@@ -286,6 +474,7 @@

Getting Started With Subversion +

The advantages of Subversion over CVS include real versioning of dire= ctories, 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 th= an CVS, and that a local Subversion checkout requires more disk space. =20

If you have never used Subversion before, the online book is an excel= lent way to learn Subversion. You can buy it in dead-tree format too if = you prefer.

1.24 xml/htdocs/proj/en/overlays/index.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/ove= rlays/index.xml?rev=3D1.24&view=3Dmarkup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/ove= rlays/index.xml?rev=3D1.24&content-type=3Dtext/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/ove= rlays/index.xml?r1=3D1.23&r2=3D1.24 Index: index.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/overlays/index.xml,v retrieving revision 1.23 retrieving revision 1.24 diff -u -r1.23 -r1.24 --- index.xml 23 Sep 2010 20:01:55 -0000 1.23 +++ index.xml 20 Nov 2010 13:29:23 -0000 1.24 @@ -6,10 +6,11 @@ Overlays Gentoo Overlays Team -2008-10-30 +2010-05-01 =20 -The Gentoo Overlays team is responsible for the administration and overl= ays.gentoo.org website. +The Gentoo Overlays team is responsible for the administration of the ov= erlays +and the *.overlays.gentoo.org websites. =20 @@ -19,7 +20,10 @@

=20

-The Gentoo Overlays team looks after (git.)overlays.gentoo.org. We work= with infra to provide the service to Gentoo projects and developers. We= create and administer individual overlays. We keep abreast of changes i= n the needs of anyone running an overlay, so that we can keep the service= useful to everyone who wants to use it. +The Gentoo Overlays team looks after *.overlays.gentoo.org websites. We = work with +infra to provide the service to Gentoo projects and developers. We creat= e and administer +individual overlays. We keep abreast of changes in the needs of anyone r= unning an +overlay, so that we can keep the service useful to everyone who wants to= use it.

=20 @@ -38,8 +42,8 @@ =20 The Overlays Policy -Developers' Guide To Gentoo Overlays (wo= rk in progress) -Users' Guide To Gentoo Overlays (work i= n progress) +Developers' Guide To Gentoo Overlays +Users' Guide To Gentoo Overlays =20 1.137 xml/htdocs/proj/en/overlays/repositories.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/ove= rlays/repositories.xml?rev=3D1.137&view=3Dmarkup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/ove= rlays/repositories.xml?rev=3D1.137&content-type=3Dtext/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/ove= rlays/repositories.xml?r1=3D1.136&r2=3D1.137 Index: repositories.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/overlays/repositories.xm= l,v retrieving revision 1.136 retrieving revision 1.137 diff -u -r1.136 -r1.137 --- repositories.xml 13 Nov 2010 00:50:39 -0000 1.136 +++ repositories.xml 20 Nov 2010 13:29:23 -0000 1.137 @@ -1,5 +1,5 @@ - + @@ -2635,6 +2635,17 @@ git://git.thousandparsec.net/git/gentoo-overlay= .git http://git.thousandparsec.net/gitweb/gitweb.cgi?p=3Dgentoo-ove= rlay.git;a=3Datom + + tmacedo + User Overlay + http://github.com/tmacedo/portage + + tftfmacedo@gmail.com + Tiago Macedo + + git://github.com/tmacedo/portage.git + https://github.com/tmacedo/portage/commits/master.atom + toolchain Toolchain ebuilds that are unsuitable for the tree. Sna= pshots,