diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 1b1c055d58..fc36af4adf 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -9598,15 +9598,17 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" helps the package manager distinguish which package is the most recent one in cases where many packages have the same PV (i.e. PKGV). - Packages have the same PV usually - when the package manager installs the same upstream version - and some of the packages include packaging fixes. + A component having many packages with the same + PV usually means that the packages all + install the same upstream version, but with later + (PR) version packages including + packaging fixes. PR does not need to be increased for changes that do not change the package contents or metadata. - Because, manually managing PR can be + Because manually managing PR can be cumbersome and error-prone, an automated solution exists. See the "Working With a PR Service"