Gentoo Development Guide

GIT-2.ECLASS

Section: portage (5)
Updated: Aug 2014
Index Return to Main Contents
 

NAME

git-2.eclass - Eclass for fetching and unpacking git repositories.  

DESCRIPTION

Eclass for easing maitenance of live ebuilds using git as remote repository. Eclass support working with git submodules and branching.  

FUNCTIONS

git-2_src_unpack
Default git src_unpack function.
 

ECLASS VARIABLES

EGIT_USE_GIT_R3
Use git-r3 backend instead of classic git-2 behavior. This is intended for early testing of git-r3 and is to be set in make.conf.
EGIT_SOURCEDIR
This variable specifies destination where the cloned data are copied to.

EGIT_SOURCEDIR="${S}"

EGIT_STORE_DIR
Storage directory for git sources.

EGIT_STORE_DIR="${DISTDIR}/egit-src"

EGIT_HAS_SUBMODULES
If non-empty this variable enables support for git submodules in our checkout. Also this makes the checkout to be non-bare for now.
EGIT_OPTIONS
Variable specifying additional options for fetch command.
EGIT_MASTER
Variable for specifying master branch. Usefull when upstream don't have master branch or name it differently.

EGIT_MASTER="master"

EGIT_PROJECT
Variable specifying name for the folder where we check out the git repository. Value of this variable should be unique in the EGIT_STORE_DIR as otherwise you would override another repository.

EGIT_PROJECT="${EGIT_REPO_URI##*/}"

EGIT_DIR
Directory where we want to store the git data. This variable should not be overriden.

EGIT_DIR="${EGIT_STORE_DIR}/${EGIT_PROJECT}"

EGIT_REPO_URI (REQUIRED)
URI for the repository e.g. http://foo, git://bar

It can be overriden via env using packagename_LIVE_REPO variable.

Support multiple values: EGIT_REPO_URI="git://a/b.git http://c/d.git"

EVCS_OFFLINE
If non-empty this variable prevents performance of any online operations.
EGIT_BRANCH
Variable containing branch name we want to check out. It can be overriden via env using packagename_LIVE_BRANCH variable.

EGIT_BRANCH="${EGIT_MASTER}"

EGIT_COMMIT
Variable containing commit hash/tag we want to check out. It can be overriden via env using packagename_LIVE_COMMIT variable.

EGIT_COMMIT="${EGIT_BRANCH}"

EGIT_REPACK
If non-empty this variable specifies that repository will be repacked to save space. However this can take a REALLY LONG time with VERY big repositories.
EGIT_PRUNE
If non-empty this variable enables pruning all loose objects on each fetch. This is useful if upstream rewinds and rebases branches often.
EGIT_NONBARE
If non-empty this variable specifies that all checkouts will be done using non bare repositories. This is useful if you can't operate with bare checkouts for some reason.
EGIT_NOUNPACK
If non-empty this variable bans unpacking of ${A} content into the srcdir. Default behaviour is to unpack ${A} content.
 

MAINTAINERS

Michał Górny <mgorny@gentoo.org>
Donnie Berkholz <dberkholz@gentoo.org>
 

REPORTING BUGS

Please report bugs via http://bugs.gentoo.org/  

FILES

/usr/portage/eclass/git-2.eclass  

SEE ALSO

ebuild(5)
http://sources.gentoo.org/eclass/git-2.eclass?view=log


 

Index

NAME
DESCRIPTION
FUNCTIONS
ECLASS VARIABLES
MAINTAINERS
REPORTING BUGS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 03:25:21 GMT, August 01, 2014