| Message ID | 20251223101757.1057188-4-corentin.guillevic@smile.fr |
|---|---|
| State | New |
| Headers | show |
| Series | [v5,1/4] bitbake-setup: add inline URI | expand |
Hi, On Tue Dec 23, 2025 at 11:17 AM CET, Corentin Guillevic via lists.openembedded.org wrote: > The property 'uri' is a simplification of the property 'remotes'. It is > used to provide only one URI. > > Signed-off-by: Corentin Guillevic <corentin.guillevic@smile.fr> > --- > .../bitbake-user-manual-environment-setup.rst | 12 +++++++----- > 1 file changed, 7 insertions(+), 5 deletions(-) > > diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst > index ec1bdeecd..b3588f27d 100644 > --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst > +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst > @@ -673,11 +673,7 @@ They contain the following sections: > "sources": { > "bitbake": { > "git-remote": { > - "remotes": { > - "origin": { > - "uri": "https://git.openembedded.org/bitbake" > - } > - }, Can you please port this deleted example under the description of the "remotes" property? We still want to show how someone can configure this property. It would be nice if you could showcase another remote name, so it highlights why this option could be used instead of the simplified "uri" option. Something like: "git-remote": { "remotes": { "origin": { "uri": "https://git.openembedded.org/bitbake" }, "contrib": { "uri": "https://git.openembedded.org/bitbake-contrib" } }, } And then explain how one or the other can be used with bitbake-setup (I have no clue). This also makes the "remotes" option optional, so you need to update its description. > + "uri": "https://git.openembedded.org/bitbake", > "branch": "master", > "rev": "master" > }, > @@ -716,6 +712,12 @@ They contain the following sections: > - ``branch`` (**required**): the Git branch, used to check that the > specified ``rev`` is indeed on that branch. > > + - ``uri`` (*optional*): a URI that follows the git URI syntax. Can replace the s/Can/You can/ > + ``remotes`` structure if only one URI is provided. Despite this, ``uri`` and > + ``remotes`` can still be used together. > + > + See https://git-scm.com/docs/git-clone#_git_urls for more information. > + > - ``local`` (*optional*): specifies a path on local disk that should be symlinked > to under ``layers/``. This is useful for local development, where some layer > or other component used in a build is managed separately, but should still be Thanks, Antonin
diff --git a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst index ec1bdeecd..b3588f27d 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-environment-setup.rst @@ -673,11 +673,7 @@ They contain the following sections: "sources": { "bitbake": { "git-remote": { - "remotes": { - "origin": { - "uri": "https://git.openembedded.org/bitbake" - } - }, + "uri": "https://git.openembedded.org/bitbake", "branch": "master", "rev": "master" }, @@ -716,6 +712,12 @@ They contain the following sections: - ``branch`` (**required**): the Git branch, used to check that the specified ``rev`` is indeed on that branch. + - ``uri`` (*optional*): a URI that follows the git URI syntax. Can replace the + ``remotes`` structure if only one URI is provided. Despite this, ``uri`` and + ``remotes`` can still be used together. + + See https://git-scm.com/docs/git-clone#_git_urls for more information. + - ``local`` (*optional*): specifies a path on local disk that should be symlinked to under ``layers/``. This is useful for local development, where some layer or other component used in a build is managed separately, but should still be
The property 'uri' is a simplification of the property 'remotes'. It is used to provide only one URI. Signed-off-by: Corentin Guillevic <corentin.guillevic@smile.fr> --- .../bitbake-user-manual-environment-setup.rst | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-)