Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 481430 - Git Overlays Repo Request - dev/wschlich
Summary: Git Overlays Repo Request - dev/wschlich
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Infrastructure
Classification: Unclassified
Component: Gentoo Overlays (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Overlays Project
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-08-17 09:52 UTC by Wolfram Schlich (RETIRED)
Modified: 2013-08-22 05:25 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Wolfram Schlich (RETIRED) gentoo-dev 2013-08-17 09:52:36 UTC
Category: dev
Name: dev/wschlich
Description: Developer overlay
Owner: Wolfram Schlich (wschlich)
Committers: wschlich

TIA,
Wolfram
Comment 1 Wolfram Schlich (RETIRED) gentoo-dev 2013-08-21 11:38:37 UTC
Just wondering whether my creation of this bug might have been unnoticed due to the status I created it with...? Changing it to UNCONFIRMED for now.
Comment 2 Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2013-08-21 11:51:38 UTC
Your dev overlay "wchlich" is almost ready.
Please read (all of) this guide to get it to work.

If you have any question we'll be here to help.


In this Guide
=============
- Your overlay versus betagarden
- The Initial Push
- After That
  - Online Browsing
  - Getting into Layman
  - Keeping your overlay healthy


Your overlay versus betagarden
==============================
First: what is betagarden?  betagarden is a special overlay that

 - any Gentoo developer is welcome to contribute to
   (you have write permissions to betagarden already)

 - is dedicated to ebuilds not important or good enough
   (i.e. of beta quality) for the main tree.  Normally, a package
   appears in either betagarden or the main tree, but not both.

Some of the ebuilds you would normally put into your developer overlay fit betagarden better.  The rule of thumb is:

  If an ebuild (or the related upstream software) is known to be
  broken or quite experimental: put it in your developer overlay.
  All else: put it in betagarden.

Thanks!

Benefits include:

 - Other Gentoo developers can fix and bump your ebuilds for you

 - People do not need to keep another overlay around for just a single
   package they care about.  That may reduce reluctance to use your
   ebuilds with some people.


The Initial Push
================

First, before anybody can clone from your overlay an initial push is needed.

0) If you start with an empty repository be sure to setup your identity:

     # git init
     # git config user.name 'first last'
     # git config user.email foo@example.org
     [..]

1) Once you have ebuilds in there please set profiles/repo_name to
   'wschlich' in order to make it a valid overlay.

     # mkdir profiles
     # echo "wschlich" > profiles/repo_name
     # git add profiles/repo_name
     # git commit

2) Now you are ready to push.  Proposed way of doing is this:

     # git remote add overlays-gentoo-org \
           git+ssh://git@git.overlays.gentoo.org/dev/wschlich.git
     # git push overlays-gentoo-org master


After That
==========

Online Browsing
---------------
After the inital push you can browse your overlay online at:
http://git.overlays.gentoo.org/gitweb/?p=dev/wschlich.git;a=summary


Getting into Layman
-------------------
We have scripts to get hosted overlay into Layman easily: no need to write XML on your end.  Just let us know that you did complete the procedure from "The Initial Push" to get added.

Once it's in the Layman registry its content will be indexed at http://gpo.zugaina.org/ and two dedicated views of your overlay will appear at http://gentoo-overlays.zugaina.org/wschlich/ and http://gpo.zugaina.org/Overlays/wschlich/, too.


Keeping your overlay healthy
----------------------------
A few rules of thumb help to keep your overlay most useful to you and others:

 - If you package newer versions of software that is packaged in Gentoo
   already, try to get the version in Gentoo updated, too.
   (If there is no bump request on https://bugs.gentoo.org/ please file
   one and share patches you may have produced.)

 - If you apply custom patches make sure that you never use the very
   same revision that is used in Gentoo, e.g. if you use the ebuild
   of app-arch/bzip2-1.0.6-r3 do not call it app-arch/bzip2-1.0.6-r3
   in your overlay to avoid confusion.

A tool called "overlint" can support you with that process:

  # sudo emerge -av app-portage/overlint

For a quick introduction to overlint see http://blog.hartwork.org/?p=1667 .
Comment 3 Wolfram Schlich (RETIRED) gentoo-dev 2013-08-21 19:53:12 UTC
Thanks Theo!

Unfortunately, I cannot push:

[wschlich@zephyr(pts/9):wschlich.git]$ git push overlays-gentoo-org master
W access for dev/wschlich DENIED to wschlich
(Or there may be no repository at the given path. Did you spell it correctly?)
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
>>> last exit code: 128
[wschlich@zephyr(pts/9):wschlich.git]$ 

Cheers,
Wolfram
Comment 4 Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2013-08-21 22:27:30 UTC
It was a typo in my side, it should be fine now
Comment 5 Wolfram Schlich (RETIRED) gentoo-dev 2013-08-22 05:25:16 UTC
Yep, it does, thanks Theo! :-)