From 3466f2193a0668e2bae7822a5b864e4d43561c2e Mon Sep 17 00:00:00 2001 From: Yu Ke Date: Tue, 24 May 2011 14:22:52 +0800 Subject: [PATCH] fetch2/git: add document for git fetcher supported options (Bitbake rev: d424ecd751f80a7aecec26e1a0cbd2a1b38e076b) Signed-off-by: Yu Ke Signed-off-by: Richard Purdie --- bitbake/lib/bb/fetch2/git.py | 38 +++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/bitbake/lib/bb/fetch2/git.py b/bitbake/lib/bb/fetch2/git.py index a05402a311..3b8965e49c 100644 --- a/bitbake/lib/bb/fetch2/git.py +++ b/bitbake/lib/bb/fetch2/git.py @@ -3,6 +3,41 @@ """ BitBake 'Fetch' git implementation +git fetcher support the SRC_URI with format of: +SRC_URI = "git://some.host/somepath;OptionA=xxx;OptionB=xxx;..." + +Supported SRC_URI options are: + +- branch + The git branch to retrieve from. The default is "master" + + this option also support multiple branches fetching, branches + are seperated by comma. in multiple branches case, the name option + must have the same number of names to match the branches, which is + used to specify the SRC_REV for the branch + e.g: + SRC_URI="git://some.host/somepath;branch=branchX,branchY;name=nameX,nameY" + SRCREV_nameX = "xxxxxxxxxxxxxxxxxxxx" + SRCREV_nameY = "YYYYYYYYYYYYYYYYYYYY" + +- tag + The git tag to retrieve. The default is "master" + +- protocol + The method to use to access the repository. Common options are "git", + "http", "file" and "rsync". The default is "git" + +- rebaseable + rebaseable indicates that the upstream git repo may rebase in the future, + and current revision may disappear from upstream repo. This option will + reminder fetcher to preserve local cache carefully for future use. + The default value is "0", set rebaseable=1 for rebaseable git repo + +- nocheckout + Don't checkout source code when unpacking. set this option for the recipe + who has its own routine to checkout code. + The default is "0", set nocheckout=1 if needed. + """ #Copyright (C) 2005 Richard Purdie @@ -55,9 +90,6 @@ class Git(FetchMethod): ud.nocheckout = ud.parm.get("nocheckout","0") == "1" - # rebaseable means the upstream git repo may rebase in the future, - # and current revision may disappear from upstream repo - # rebaseable is false by default. set rebaseable=1 in SRC_URI if rebaseable. ud.rebaseable = ud.parm.get("rebaseable","0") == "1" branches = ud.parm.get("branch", "master").split(',')