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"