Difference between revisions of "Creating Your Own Overlay"

From Funtoo
Jump to navigation Jump to search
(initial commit)
 
m (more details)
Line 2: Line 2:
{{warning|page is incomplete, yell @ [[User:Threesixes|Threesixes]] ([[User talk:Threesixes|talk]]) in irc to finish it.  moving it over from forums because it's completely unreadable there.}}
{{warning|page is incomplete, yell @ [[User:Threesixes|Threesixes]] ([[User talk:Threesixes|talk]]) in irc to finish it.  moving it over from forums because it's completely unreadable there.}}


{{console|body=###i##mkdir /var/overlay}}
{{console|body=###i## mkdir /var/overlay}}


Change the /var/overlay user and group to your own, everyone has the root user, and root group, so we'll use root for the example, though it should be changed to the primary unprivileged account used to edit the ebuilds.  Clone the skeleton from github
Change the /var/overlay user and group to your own, everyone has the root user, and root group, so we'll use root for the example, though it should be changed to the primary unprivileged account used to edit the ebuilds.  Clone the skeleton from github.  Change the repo name from skeleton to your own repo name as you want to see it when emerging.


{{console|body=###i## chown root:root /var/overlay && cd /var/overlay
{{console|body=###i## chown root:root /var/overlay && cd /var/overlay
git clone http://git.funtoo.org/skeleton-overlay/ local}}
###i## git clone http://git.funtoo.org/skeleton-overlay/ local && cd local
echo "myoverlayname" > /var/overlay/local/profiles/repo_name}}
add to make.conf{{file|name=/etc/portage/make.conf|lang=|desc=Insert the local overlay|body=
 
PORTDIR_OVERLAY="/var/overlay/local"
Change the readme message to what you want to show up on the front page of your repo:
 
{{file|name=/var/overlay/local/README.rst|lang=|desc=Set the github front page message|body=
This overlay is from so and so funtoo user.  Order a $15/month container today @ funtoo.org
}}  
}}  


Line 18: Line 21:
###i## mv package.ebuild /var/overlay/local/cat-egory/package/package.ebuild}}
###i## mv package.ebuild /var/overlay/local/cat-egory/package/package.ebuild}}


Add your overlay to make.conf:
{{file|name=/etc/portage/make.conf|lang=|desc=Insert the local overlay|body=
PORTDIR_OVERLAY="/var/overlay/local"
}}


{{warning|below not finished}}
{{warning|below not finished}}

Revision as of 01:29, May 3, 2015

This page intends to get your local overlay going, show how to revision bump a package, and sync your goodies to github.

   Warning

page is incomplete, yell @ Threesixes (talk) in irc to finish it. moving it over from forums because it's completely unreadable there.

root # mkdir /var/overlay

Change the /var/overlay user and group to your own, everyone has the root user, and root group, so we'll use root for the example, though it should be changed to the primary unprivileged account used to edit the ebuilds. Clone the skeleton from github. Change the repo name from skeleton to your own repo name as you want to see it when emerging.

root # chown root:root /var/overlay && cd /var/overlay
root # git clone http://git.funtoo.org/skeleton-overlay/ local && cd local
echo "myoverlayname" > /var/overlay/local/profiles/repo_name

Change the readme message to what you want to show up on the front page of your repo:

   /var/overlay/local/README.rst - Set the github front page message
This overlay is from so and so funtoo user.  Order a $15/month container today @ funtoo.org

Insert portage structure category & package directories. For example i want to fix compiz fusion to include an old ebuild of the 0.8.8 series, i would mkdir -p /var/overlay/local/x11-wm/compiz-fusion then copy the ebuild i found online to the directory. /var/overlay/local/x11-wm/compiz-fusion/compiz-fusion-0.8.8.ebuild is where the ebuild would sit.

root # mkdir -p /var/overlay/local/cat-egory/package
root # mv package.ebuild /var/overlay/local/cat-egory/package/package.ebuild

Add your overlay to make.conf:

   /etc/portage/make.conf - Insert the local overlay
PORTDIR_OVERLAY="/var/overlay/local"
   Warning

below not finished

mv Manifest /home/overlays/local/cat-egory/package/ cp package-version.ebuild package-newversion.ebuild wget package-newversion.tar.gz -O /usr/portage/distfiles/package-newversion.tar.bz2 ebuild *.ebuild manifest

to git up your repository to push to github: make ssh keys and upload them to github or else entering your password will get very old very quick. cd /home/overlays/local git init git add . git commit -m 'First commit' git remote add origin git@github.com:666threesixes666/tripsix.git git remote set-url origin git@github.com:666threesixes666/tripsix.git git remote -v git push origin master

  1. subsequent updates

git add . && git commit -m 'updates' && git push origin master