Gentoo Development Guide

GIT-2.ECLASS

Section: portage (5)
Updated: Jun 2013
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_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

This document was created by man2html, using the manual pages.
Time: 03:25:03 GMT, June 19, 2013