mirror of
https://git.yoctoproject.org/poky
synced 2026-05-09 17:39:31 +00:00
Update the documentation for SRCPV
The variable SRCPV is deprecated since 4.3. Instead of including SRCPV in PV, including the sign "+" is enough for bitbake to add the source control information to PKGV during the packaging phase. Update the documentation for SRCPV and the places where it was used. When instructions previously referred to SRCPV, replace by mentioning to include "+" in the assignment. In most examples, "+git" is added to PV as it is the most popular SCM. Simply adding "+" is also possible, although it is better practice to include the SCM name, so give that example. Update the gcompat example with l3afpad as it didn't include "+git" in its PV definition anymore. (From yocto-docs rev: 3866c09cc0460d25fefc0c831affd89633cf8a7b) Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> (cherry picked from commit ee16c96202e5027d1a8d7e89e11c25f127c78326) Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
committed by
Steve Sakoman
parent
bca4068948
commit
e82dc2ad3c
@@ -12,10 +12,13 @@ revision number for changes. Currently, you can do this with Apache
|
||||
Subversion (SVN), Git, and Bazaar (BZR) repositories.
|
||||
|
||||
To enable this behavior, the :term:`PV` of
|
||||
the recipe needs to reference
|
||||
:term:`SRCPV`. Here is an example::
|
||||
the recipe needs to include a ``+`` sign in its assignment.
|
||||
Here is an example::
|
||||
|
||||
PV = "1.2.3+git${SRCPV}"
|
||||
PV = "1.2.3+git"
|
||||
|
||||
:term:`Bitbake` later includes the source control information in :term:`PKGV`
|
||||
during the packaging phase.
|
||||
|
||||
Then, you can add the following to your
|
||||
``local.conf``::
|
||||
|
||||
@@ -291,13 +291,13 @@ another example that specifies these types of files, see the
|
||||
|
||||
Another way of specifying source is from an SCM. For Git repositories,
|
||||
you must specify :term:`SRCREV` and you should specify :term:`PV` to include
|
||||
the revision with :term:`SRCPV`. Here is an example from the recipe
|
||||
``meta/recipes-core/musl/gcompat_git.bb``::
|
||||
a ``+`` sign in its definition. Here is an example from the recipe
|
||||
:oe_git:`meta/recipes-sato/l3afpad/l3afpad_git.bb </openembedded-core/tree/meta/recipes-sato/l3afpad/l3afpad_git.bb>`::
|
||||
|
||||
SRC_URI = "git://git.adelielinux.org/adelie/gcompat.git;protocol=https;branch=current"
|
||||
SRC_URI = "git://github.com/stevenhoneyman/l3afpad.git;branch=master;protocol=https"
|
||||
|
||||
PV = "1.0.0+1.1+git${SRCPV}"
|
||||
SRCREV = "af5a49e489fdc04b9cf02547650d7aeaccd43793"
|
||||
PV = "0.8.18.1.11+git"
|
||||
SRCREV ="3cdccdc9505643e50f8208171d9eee5de11a42ff"
|
||||
|
||||
If your :term:`SRC_URI` statement includes URLs pointing to individual files
|
||||
fetched from a remote server other than a version control system,
|
||||
|
||||
@@ -84,10 +84,6 @@ the following:
|
||||
|
||||
- :term:`PR`: The recipe revision.
|
||||
|
||||
- :term:`SRCPV`: The OpenEmbedded
|
||||
build system uses this string to help define the value of :term:`PV` when
|
||||
the source code revision needs to be included in it.
|
||||
|
||||
- :yocto_wiki:`PR Service </PR_Service>`: A
|
||||
network-based service that helps automate keeping package feeds
|
||||
compatible with existing package manager applications such as RPM,
|
||||
@@ -256,15 +252,14 @@ the software::
|
||||
|
||||
SRCREV = "${AUTOREV}"
|
||||
|
||||
Furthermore, you need to reference :term:`SRCPV` in :term:`PV` in order to
|
||||
Furthermore, you need to include a ``+`` sign in :term:`PV` in order to
|
||||
automatically update the version whenever the revision of the source
|
||||
code changes. Here is an example::
|
||||
|
||||
PV = "1.0+git${SRCPV}"
|
||||
PV = "1.0+git"
|
||||
|
||||
The OpenEmbedded build system substitutes :term:`SRCPV` with the following:
|
||||
|
||||
.. code-block:: none
|
||||
The OpenEmbedded build system will automatically add the source control
|
||||
information to the end of the variable :term:`PKGV`, in this format::
|
||||
|
||||
AUTOINC+source_code_revision
|
||||
|
||||
|
||||
Reference in New Issue
Block a user