[poky] [PATCH 1/1] fetcher2/git: add document for git fetcher supported options

[Khem Raj]

On (24/05/11 14:58), Yu Ke wrote:
> CC: Khem Raj <raj.khem at gmail.com>
> CC: Darren Hart <dvhart at linux.intel.com>
> 
> Signed-off-by: Yu Ke <ke.yu at intel.com>
> ---
>  bitbake/lib/bb/fetch2/git.py |   37 ++++++++++++++++++++++++++++++++++---
>  1 files changed, 34 insertions(+), 3 deletions(-)
> 
> diff --git a/bitbake/lib/bb/fetch2/git.py b/bitbake/lib/bb/fetch2/git.py
> index 82721c6..b07298d 100644
> --- a/bitbake/lib/bb/fetch2/git.py
> +++ b/bitbake/lib/bb/fetch2/git.py
> @@ -3,6 +3,40 @@
>  """
>  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 "rsync"
> +
> +- 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

for consistency why not make rebaseable=true/false as well ?

> +
> +- 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 false
                                                                ^^^^
may be it should be in '' or quotes



> +
>  """
>  
>  #Copyright (C) 2005 Richard Purdie
> @@ -57,9 +91,6 @@ class Git(FetchMethod):
>          if 'nocheckout' in ud.parm:
>              ud.nocheckout = True
>  
> -        # 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(',')
> -- 
> 1.7.0.4
> 
> _______________________________________________
> poky mailing list
> poky at yoctoproject.org
> https://lists.yoctoproject.org/listinfo/poky

-- 
-Khem